参数说明

--help | -h

查询帮助信息。

--info

查询软件包构建信息。

--list

查询软件包文件列表。

--check

检查软件包的一致性和完整性。

--quiet

静默安装或升级，跳过交互式信息。

使用此参数安装或升级时，将默认签署华为企业业务最终用户许可协议（EULA）。

--nox11

不使用x11模式运行。

--noexec

解压软件包到当前目录，但不执行安装脚本。配套--extract=<path>使用，格式为：

--noexec --extract=<path>。

--extract=<path>

解压软件包中文件到指定目录。

--tar arg1 [arg2 ...]

对软件包执行tar命令，使用tar后面的参数作为命令的参数。例如执行--tar xvf命令，解压run安装包的内容到当前目录。

--install

安装软件包。后面可以指定安装路径--install-path=<path>，也可以不指定安装路径，直接安装到默认路径下。

--devel

仅软件包toolkit，nnrt，kernels支持使用该参数。

按照开发模式安装软件包，即只安装开发环境需安装的文件。

--full

仅软件包toolkit支持使用该参数。

支持在无驱动场景下实现全量安装。

--install-path=<path>

指定安装、升级和卸载路径，需配合安装、升级和卸载参数使用。当环境上已存在全局配置文件“ascend_cann_install.info”时，该参数指定的路径必须与全局配置文件中保存的安装路径保持一致。如用户想更换安装路径，请删除全局配置文件“ascend_cann_install.info”或者修改全局配置文件内的安装路径为指定路径，同时建议卸载原路径下的CANN软件包。

可在如下目录查看是否存在该文件：

• root用户：/etc/Ascend
• 非root用户：${HOME}/Ascend

若不指定，将安装到默认路径下：

• 若使用root用户安装，默认安装路径为：/usr/local/Ascend。
• 若使用非root用户安装，则默认安装路径为：${HOME}/Ascend。

若通过该参数指定了安装目录，root用户需要对指定的安装路径有755权限，非root用户需要750权限。

--install-for-all

仅软件包toolkit、nnrt、nnae、kernels、tfplugin支持使用该参数。

安装或升级时，允许其他用户具有安装群组的权限。

当安装或者升级携带该参数时，软件包中创建的目录及文件，其他用户权限=安装群组权限。

该参数需要与--install、--devel、--upgrade等其中一个参数配合使用，例如：

./软件包名.run --install --install-for-all

--force

仅软件包toolkit、nnrt、nnae、kernels、tfplugin支持使用该参数。

强制安装、升级命令。当安装、升级检测不通过导致安装或升级失败时，则会提示用户使用该参数跳过安装检测，使用后方可安装或升级成功。

该参数需要配合安装和升级类参数（“--install”、“--upgrade”、“--devel”或“--full”）一起使用。

--feature

仅软件包toolkit、nnrt、nnae、kernels支持使用该参数。

toolkit、nnrt、nnae安装/升级时和kernels安装时可以通过该参数指定某些特性。

• toolkit、nnrt、nnae软件包当前取值仅支持输入“ascendc”，表示只安装公共必选的文件和已标识AscendC算子开发特性的文件，未标识AscendC算子开发特性的文件会跳过不安装。需注意，ascendc特性在只包括Kernel开发（基于Kernel Launch算子工程，通过基础调用（Kernel Launch）方式调用算子），不包含ACLNN开发（通过单算子API执行的方式开发单算子调用应用）。

  该参数需要与“--install”、“--devel”、“--full”、“--upgrade”配合使用，例如./xx.run --install --feature=ascendc。

• kernels软件包当前取值范围如下，支持单个或者多个特性同时输入：
  • aclnn_ops_infer：由于推理库依赖数学库，所以安装时如果携带了该参数，表示安装公共必选的文件、已标识aclnn_ops_infer特性（即NN网络算子推理库）的文件和已标识aclnn_math特性（即数学库）的文件。
  • aclnn_ops_train：由于训练库依赖推理库、随机数算子库和数学库，所以安装时如果携带了该参数，表示安装公共必选的文件、已标识aclnn_ops_train特性（即NN网络算子训练库）的文件、已标识aclnn_ops_infer特性（即NN网络算子推理库）的文件、已标识aclnn_rand特性（即随机数算子库）的文件和已标识aclnn_math特性（即数学库）的文件。
  • aclnn_math：表示只安装公共必选的文件和已标识aclnn_math特性（即数学库）的文件。
  • aclnn_rand：表示只安装公共必选的文件和已标识aclnn_rand特性（即随机数算子库）的文件。
  说明：

  • 如上各个库对应的算子接口范围请参考《CANN AscendCL应用软件开发指南 (C&C++)》的“AscendCL API参考>单算子API执行>NN类算子接口 > 算子归属领域”“。
  • 多次选择特性安装时，新特性为增量安装，不会覆盖已安装特性。

--whitelist=<feature_type>

仅软件包toolkit和nnae支持使用该参数。

可选安装白名单，用于在执行安装或升级的时候指定部分可选安装特性，需根据参数功能配合“--install”和“--upgrade”一起使用。

• nnae：仅安装nnae包相关特性，用于支持离线推理、在线推理、训练以及IR构图场景。仅支持toolkit包使用。
• nnrt：仅安装nnrt包相关特性，用于支持离线推理场景。仅支持toolkit包使用。
• hccl：仅安装hccl基础依赖包和nnrt包，主要用于多机多卡推理场景，支持toolkit和nnae包使用。
• hccl-only：仅安装hccl基础依赖包，支持toolkit和nnae包使用。
• atc：仅安装ATC转换工具特性，用于支持模型编译、模型转换。仅支持toolkit包使用。
• devtools：仅安装开发工具包，主要为调测、仿真工具。选择安装该特性时请配套安装nnae。仅支持toolkit包使用。

--chip=<chip_type>

仅软件包toolkit、nnrt、nnae支持使用该参数。未指定此参数时，默认安装软件包内的全部AICPU算子包。

指定处理器类型，以便在安装过程中选择匹配的软件（如AICPU算子包）。chip_type可选范围如下（以软件包toolkit为例）：

• Ascend310，表示Atlas 200/300/500 推理产品的EP模式。
• Ascend310P，表示Atlas 推理系列产品（Ascend 310P AI处理器）。
• Ascend910，表示Atlas 训练系列产品。
• Ascend310-minirc，表示Atlas 200/300/500 推理产品的RC模式。
• Ascend，用于兼容早期CANN版本，不建议用户使用。

--upgrade

仅软件包toolkit、nnrt、nnae、kernels、tfplugin支持使用该参数。

升级已安装的软件，支持在低版本升级至高版本场景下使用。

如果需要从高版本回退至低版本，需卸载高版本后重新安装所需版本。

--feature-list=<feature>

仅软件包toolkit、nnae支持使用该参数。

指定升级特性。仅支持升级使用，参数仅支持输入“Acclibs”（独立升级算子包），如“--feature-list=Acclibs”。

该参数需要配合“--upgrade”一起使用。

--uninstall

卸载已安装的软件。

--type=<package_type>

仅软件包kernels支持使用该参数。

指定已安装的CANN软件包类型，用于在执行安装（--install）时指定跟随安装的软件包（“nnae”、“nnrt”“toolkit”），以识别到具体的安装目录。该参数需要配合“--install”或“--upgrade”一起使用。

--version

仅软件包toolkit、nnrt、nnae、kernels、tfplugin支持使用该参数。

查询版本信息。