2. 安装及使用方法

2.1. 安装包安装与卸载

曦云系列GPU驱动包安装过程中会默认安装mx-smi工具。驱动包安装完成后，mx-smi工具放置在 /opt/mxdriver/bin/ 目录下，并会在 /usr/bin 目录下创建软链接。

曦云系列GPU的驱动卸载后，mx-smi工具会自动卸载。驱动卸载参见《曦云^® 系列通用计算GPU驱动安装指南》。

若需在容器中使用mx-smi，可在运行容器时传入以下参数：

docker run -v --device=/dev/dri -v /opt/mxdriver/bin/mx-smi:/opt/mxdriver/bin/mx-smi <IMAGE-ID>

其中 --device=/dev/dri 将主机上的沐曦设备挂载到容器， -v /opt/mxdriver/bin/mx-smi:/opt/mxdriver/bin/mx-smi 将mx-smi工具挂载到容器。

以上方式仅可在容器中用 /opt/mxdriver/bin/mx-smi 执行一些查询类的命令，如需执行设置类的命令，需在启动容器时添加 --privileged=true。

mx-smi是一个Linux命令行工具，其调用遵守如下格式。

mx-smi [选项1 [参数1]] [参数2] …

驱动包安装后， /opt/mxdriver/share/mxsmi/mxsmi_completion.sh 为mx-smi命令补全脚本，可以实现mx-smi命令自动补全。

需确保系统已安装bash-completion包，以Ubuntu为例，执行以下命令安装：

dpkg -i bash-completion

若为当前用户临时使用：

source /opt/mxdriver/share/mxsmi/mxsmi_completion.sh

若对所有用户生效（需root权限），复制脚本到 /etc/bash_completion.d/ 目录并重新登录：

cp /opt/mxdriver/share/mxsmi/mxsmi_completion.sh /etc/bash_completion.d/