参数说明/常用命令
参数说明
软件包支持根据命令行完成一键式安装,各个命令之间可以配合使用,用户根据安装需要选择对应参数完成安装,所有参数都是可选参数。
安装命令格式: ./xx.run [options]
详细参数请参见表1。
- 软件包中的xx请根据实际情况进行替换。
- 如果通过./xx.run --help命令查询出的参数未解释在如下表格,则说明该参数预留或适用于其他芯片版本,用户无需关注。
参数 |
说明 |
---|---|
--help或者-h |
查看帮助。 |
--info |
显示数据包详细信息。 |
--list |
导出安装包文件列表。 |
--check |
校验软件包的完整性。 |
--quiet |
静默安装,跳过交互式信息。 使用该参数进行安装时,若安装目录权限大于755,则会提示安全风险,用户自行选择终止安装或选择其他权限为755的安装目录重新安装。 使用示例:./xx.run --full --quiet
说明:
Driver和Firmware软件包在使用该参数时,不能与--uninstall配合使用。 |
--nox11 |
安装过程中不弹出图形终端窗口。 使用示例:./xx.run --full --nox11
说明:
该参数预留,暂不使用。 |
--noexec |
不执行安装脚本。配套--extract=path使用。格式为:--noexec --extract=path |
--extract=<path> |
解压缩安装包中文件到指定目录。使用该参数时,用户无需手动建立指定的目录,解压过程中会自动创建,例如: --noexec --extract=./package,则命令执行后会自动将解压后的内容放在package目录。 |
--tar arg1 [arg2 …] |
对安装包执行tar命令,使用tar后面的参数作为命令的参数。例如执行--tar xvf命令,解压软件包的内容到当前目录。 |
--full |
完整安装类型:安装所有文件。 |
--run |
运行态类型:只安装运行场景需安装的文件。 |
--devel |
开发态类型:包含用户开发时需要用到的头文件。 Firmware包不支持该参数。 |
--docker |
容器场景下安装,仅用于driver包,其他软件包默认按full模式。 |
--upgrade |
升级。
|
--install-username=<username> |
首次安装:可以指定运行用户名,若不指定,则默认是HwHiAiUser。 覆盖安装:沿用上次运行用户名。
说明:
|
--install-usergroup=<usergroup> |
首次安装:可以指定运行用户组,若不指定,则默认是HwHiAiUser。 覆盖安装:沿用上次运行用户组。
说明:
该参数需要配合“--install-username=<username>”一起使用,并且usergroup需要与创建的用户组(创建运行用户)保持一致。 |
--install-path=<path> |
指定安装目录,如不指定:
若通过该参数指定了安装路径,运行用户需要对指定的安装路径有可读写权限。安装路径支持大小写字母(a-z,A-Z)、数字(0-9)、下划线(_)、中划线(-)、句点(.(非相对路径))、单个/(文件名或目录不支持/)。
说明:
Firmware安装不支持指定路径,共用Driver的安装路径。 |
--install-for-all |
安装时,允许其他用户具有安装群组的权限。 当安装携带该参数时,软件包中创建的目录及文件,其他用户权限=安装群组权限。 首次安装过程中如果使用了--install-for-all参数,覆盖安装中也需要保留--install-for-all参数。 使用示例:./xx.run --full --install-for-all
说明:
|
--reset |
恢复初始化配置(该参数只适用于Firmware包):
说明:
|
--uninstall |
卸载。 |
--version |
查询版本号。 |
举例说明:
- full模式下安装
- 不指定安装目录:./xx.run --full
- 指定安装目录:./xx.run --full --install-path=安装路径
- docker模式下安装(仅支持driver包)
- 不指定安装目录:./xx.run --docker
- 指定安装目录./xx.run --docker --install-path=安装路径
- run模式下安装
- 不指定安装目录:./xx.run --run
- 指定安装目录:./xx.run --run --install-path=安装路径
- 开发态模式下安装
- 不指定安装目录:./xx.run --devel
- 指定安装目录:./xx.run --devel --install-path=安装路径