Introduction to the npu-smi Command (for Version 1.0.11-1.0.15)
- Introduction
- Querying Help Information
- Querying the Tool Version
- Commands for Information Query (info)
- Querying Basic Information
- Querying Details
- Querying Information About a Chip
- Querying the Monitoring Data of All Chips
- Querying the Monitoring Data of a Chip
- Querying All NPU Devices
- Querying the Mapping Information of All Chips
- Querying the Common Information of All Chips
- Querying the Flash Information of All Chips
- Querying the Flash Information of a Chip
- Querying the Memory Information of All Chips
- Querying the Memory Information of a Chip
- Querying the Statistics of All Chips
- Querying the Statistics of a Chip
- Querying the Temperatures of All Chips
- Querying the Temperature of a Chip
- Querying the Power of All Chips
- Querying the Power of a Chip
- Querying the Voltage of All Chips
- Querying the Voltage of a Chip
- Querying the Health Status of All Chips
- Querying the Health Status of a Chip
- Querying MCU Monitoring Information
- Querying the SSH Enabling Status of All Chips
- Querying the SSH Enabling Status of a Chip
- Querying the ECC Error Counts of All Chips
- Querying the ECC Error Counts of a Chip
- Querying the ECC Enable Status
- Querying the p2p Enable Status
- Querying the Boot Area of a Chip
- Querying the Sensor Information of a Chip
- Querying the System Time of a Chip
- Checking the IIC Channel Between the NPU and the MCU
- Querying the Product Type
- Querying the Product Type of a Chip
- Querying Matrix Process Monitoring Data of a Chip
- Querying a User Certificate
- Querying Customized Information
- Querying the IP Address of an AI Chip
- Querying the PCIe Error Counts of All Chips
- Querying the PCIe Error Counts of a Chip
- Querying the Container Sharing Mode of All Chips
- Querying the Container Sharing Mode of a Chip
- Querying the Computing Power Level of a Chip
- Querying the Number of AI CPUs and Ctrl CPUs on a Chip
- Querying the Number of AI CPUs, Ctrl CPUs, and Data CPUs of All Chips
- Querying the Number of AI CPUs, Ctrl CPUs, and Data CPUs of a Specified Chip
- Querying vNPUs of a Chip
- Querying the First Power-On Time of an NPU
- Querying the Memory Usage of Processes on All Chips
- Querying the Memory Usage of Processes on a Chip
- Querying the Length of Service Data Asynchronously Copied by a Specified Chip
- Commands for Settings (set)
- Collecting Logs
- Resetting the Standard PCIe Card
- Resetting a Chip
- Setting MCU Monitoring
- Setting the Boot Area
- Powering On or Off the HDD
- Enabling or Disabling SSH for All Chips
- Enabling or Disabling SSH for a Chip
- Enabling or Disabling ECC
- Configuring a User Certificate
- Configuring Custom Information
- Setting the IP Information of an AI Chip
- Clearing the PCIe Error Counts of All Chips
- Clearing the PCIe Error Count of a Chip
- Setting the Function of Clearing the ECC Error Counts of All Chips
- Setting the Function of Clearing the ECC Error Count of a Chip
- Setting the Container Sharing Mode for All Chips
- Setting the Container Sharing Mode for a Chip
- Setting the Computing Power Level for a Chip
- Setting the Number of AI CPUs for a Chip
- Setting the Numbers of AI CPUs, Ctrl CPUs, and Data CPUs for All Chips
- Setting the Numbers of AI CPUs, Ctrl CPUs, and Data CPUs for a Specified Chip
- Creating vNPUs for a Chip
- Destroying vNPUs of a Chip
- Revoking a Key
- Setting the Length of the Service Data Asynchronously Copied by a Specified Chip
- Commands for Upgrade (upgrade)
- Commands for Clearing (clear)
Introduction
The npu-smi tool is used to collect device information, check device health status, configure devices, upgrade firmware, and clear device information.
- In table Deployment scenarios in this document, Y indicates that the feature is supported, N indicates that the feature is not supported, and N/A indicates that the feature is not involved.
- The examples in this document are for reference only. The actual command output prevails.
- The npu-smi command cannot be used concurrently by multiple threads.
Querying Help Information
Function
The npu-smi -h | --help command is used to display the help information about the tool.
Syntax
npu-smi -h
Parameters
None
Usage Instruction
Table 10-1 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Displays the help information about npu-smi.
npu-smi -h
Usage: npu-smi <Command|-h|-v> [Options...] npu-smi Command: -h This command's help information --help This command's help information -v Show npu-smi version information info Show hardware details set Modify device configuration properties clear Clear device information upgrade Upgrade MCU firmware
Output Description
Field |
Description |
---|---|
-h |
Displays the help information about the command. |
--help |
Displays the help information about the command. |
-v |
Specifies the npu-smi version information. |
info |
Displays hardware details. |
set |
Sets device attributes. |
clear |
Clears device information. |
upgrade |
Upgrades the MCU firmware. |
Querying the Tool Version
Function
The npu-smi -v command is used to query the version of the npu-smi tool.
Syntax
npu-smi -v
Parameters
None
Usage Instruction
Table 10-3 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the version of the npu-smi tool.
npu-smi -v
npu-smi version: 22.0.0
Output Description
Field |
Description |
---|---|
npu-smi version |
Specifies the npu-smi version information. |
Commands for Information Query (info)
Querying Basic Information
Function
The npu-smi info command is used to query basic information about all devices.
Syntax
npu-smi info
Parameters
None
Usage Instruction
Table 10-5 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query basic information of all devices.
npu-smi info
+----------------------------------------------------------------------------------------------------+ | npu-smi 21.0.4 Version: 21.0.4.B030 | +-------------------+-----------------+--------------------------------------------------------------+ | NPU Name | Health | Power(W) Temp(C) Hugepages-Usage(page) | | Chip Device | Bus-Id | AICore(%) Memory-Usage(MB) | +===================+=================+==============================================================+ | 6 310 | OK | 12.8 73 0 / 970 | | 0 3 | 0000:89:00.0 | 0 2703 / 8192 | +-------------------+-----------------+--------------------------------------------------------------+ | 6 310 | OK | 12.8 74 0 / 970 | | 1 4 | 0000:8A:00.0 | 0 2867 / 8192 | +-------------------+-----------------+--------------------------------------------------------------+ | 6 310 | OK | 12.8 70 0 / 970 | | 2 5 | 0000:8B:00.0 | 0 2867 / 8192 | +-------------------+-----------------+--------------------------------------------------------------+ | 6 310 | OK | 12.8 65 0 / 970 | | 3 6 | 0000:8C:00.0 | 0 2867 / 8192 | +===================+=================+==============================================================+
Output Description
Field |
Description |
---|---|
npu-smi |
Version of the npu-smi tool. |
Version |
Driver version. |
NPU |
Device ID. |
Name |
Chip name. |
Health |
Chip health status. The status can be OK, Warning, Alarm, Critical, or UNKNOWN. |
Power(W) |
Chip power (unit: W). |
Temp(C) |
Chip temperature (unit: °C). |
Hugepages-Usage(page) |
Number of used huge pages. The size of each page is 2048 KB. |
Chip |
Chip ID. |
Device |
Chip number. |
Bus-Id |
Bus ID. |
AICore(%) |
AI Core usage. |
Memory-Usage(MB) |
Memory usage. |
Note: Hugepages-Usage(page) supports only NPU 21.0.4 and later versions. |
Querying Details
Function
The npu-smi info -t board -i id command is used to query the details about a device.
Syntax
npu-smi info -t board -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
- This command cannot be used to query the firmware version and slot ID as a non-root user.
- Table 10-7 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the details about device 0.
npu-smi info -t board -i 0
NPU ID : 0 Product Name : IT21DMPB01 Model : NA Manufacturer : Huawei Serial Number : 033EFS10J7000021 Software Version : 21.0.2.b050 Firmware Version : 1.78.23.0.230 Board ID : 0xaa PCB ID : A BOM ID : 0 PCIe Bus Info : 0000:80:10.0 Slot ID : 6 Class ID : NA PCI Vendor ID : 0x19E5 PCI Device ID : 0xD100 Subsystem Vendor ID : 0x0200 Subsystem Device ID : 0x0100 Chip Count : 4 Faulty Chip Count : 0
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Product Name |
Product name. |
Model |
Product model. |
Manufacturer |
Manufacturer. |
Serial Number |
Product serial number (SN). |
Software Version |
Driver version. |
Firmware Version |
Firmware version. |
Board ID |
Board ID. |
PCB ID |
PCB ID. |
BOM ID |
BOM ID. |
PCIe Bus Info |
PCIe bus information. |
Slot ID |
Slot ID. |
Class ID |
Class ID. |
PCI Vendor ID |
PCI vendor ID. |
PCI Device ID |
PCI device ID. |
Subsystem Vendor ID |
Subsystem vendor ID. |
Subsystem Device ID |
Subsystem device ID. |
Chip Count |
Number of chips. |
Faulty Chip Count |
Number of faulty chips. |
Querying Information About a Chip
Function
The npu-smi info -t board -i id -c chip_id command is used to query the information about a chip on a device.
Syntax
npu-smi info -t board -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
This command cannot be used by a non-root user to query the NPU firmware version.
Table 10-9 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the detailed information about chip 0 on device 0.
npu-smi info -t board -i 0 -c 0
NPU ID : 0 Chip ID : 0 Chip Type : Ascend Chip Name : 310 Chip Version : V100 Board ID : 0xc8 PCB ID : NA BOM ID : 0 Die ID : V100, 27C56594 02110808 84D1A253 0100A8C0 8D100023 Chip Position ID : 3 PCIe Bus Info : 0000:89:00.0 Firmware Version : 1.78.23.2.230
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip ID |
Chip ID. |
Chip Type |
Chip type. |
Chip Name |
Chip name. |
Chip Version |
Chip version. |
Board ID |
If chip_id is set to 0, 1, 2, or 3, this parameter indicates the NPU ID. If chip_id is set to 4, this parameter indicates the board ID. |
PCB ID |
PCB version. The value is always displayed as NA. |
BOM ID |
BOM ID. |
Die ID |
Chip die ID. |
Chip Position ID |
Chip position. |
PCIe Bus Info |
PCIe bus information. |
Firmware Version |
Firmware version. |
Querying the Monitoring Data of All Chips
Function
The npu-smi info watch command is used to query the monitoring data of all chips on all devices.
The npu-smi info watch -i id command is used to query the monitoring data of all chips on a device.
Syntax
npu-smi info watch
npu-smi info watch -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
- Table 10-11 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
- Query the monitoring data of all chips on all devices.
npu-smi info watch
NpuID(Idx) ChipId(Idx) Pwr(W) Temp(C) AI Core(%) AI Cpu(%) Ctrl Cpu(%) Memory(%) Memory BW(%) 1 0 12.8 47 0 0 0 8 0 1 1 12.8 45 0 0 0 8 0 1 2 12.8 45 0 0 0 8 0 1 3 12.8 44 0 0 0 8 0 2 0 12.8 47 0 0 0 8 0 2 1 12.8 47 0 0 0 9 0 2 2 12.8 46 0 0 0 9 0 2 3 12.8 44 0 0 0 9 0
- Query the monitoring data of all chips on a device.
npu-smi info watch -i 0
NpuID(Idx) ChipId(Idx) Pwr(W) Temp(C) AI Core(%) AI Cpu(%) Ctrl Cpu(%) Memory(%) Memory BW(%) 0 0 12.8 78 0 0 0 7 0 0 1 12.8 77 0 0 0 7 0 0 2 12.8 76 0 0 0 7 0 0 3 12.8 77 0 0 0 7 0
Output Description
Field |
Description |
---|---|
NpuID(Idx) |
Device ID. |
ChipId(Idx) |
Chip ID. |
Pwr(W) |
Power (unit: W). |
Temp(C) |
Temperature (unit: °C). |
AI Core(%) |
AI Core usage. |
AI Cpu(%) |
AI CPU usage. |
Ctrl Cpu(%) |
Ctrl CPU usage. |
Memory(%) |
Memory usage. |
Memory BW(%) |
Memory bandwidth usage. |
Querying the Monitoring Data of a Chip
Function
The npu-smi info watch -i id -c chip_id -d delay_seconds -s watch_type command is used to query the monitoring data of a chip.
Syntax
npu-smi info watch -i id -c chip_id -d delay_seconds -s watch_type
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
delay_seconds |
Delay of each query operation in seconds. The value ranges from 1 to 100. The default value is 1. |
watch_type |
Type of the monitored data.
|
Usage Instruction
- Table 10-13 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the monitoring data of chip 0 on device 0.
npu-smi info watch -i 0 -c 0 -d 5 -s ptaicmb
NpuID(Idx) ChipId(Idx) Pwr(W) Temp(C) AI Core(%) AI Cpu(%) Ctrl Cpu(%) Memory(%) Memory BW(%) 0 0 12.8 70 0 0 0 34 0 0 0 12.8 70 0 0 0 34 0 0 0 12.8 70 0 0 0 34 0 0 0 12.8 70 0 0 0 34 0
Output Description
Field |
Description |
---|---|
NpuID(Idx) |
Device ID. |
ChipId(Idx) |
Chip ID. |
Pwr(W) |
Power (unit: W). |
Temp(C) |
Temperature (unit: °C). |
AI Core(%) |
AI Core usage. |
AI Cpu(%) |
AI CPU usage. |
Ctrl Cpu(%) |
Ctrl CPU usage. |
Memory(%) |
Memory usage. |
Memory BW(%) |
Memory bandwidth usage. |
Querying All NPU Devices
Function
The npu-smi info -l command is used to query all NPU devices.
Syntax
npu-smi info -l
Parameters
None
Usage Instruction
The product name and serial number fields cannot be queried on a Docker container.
Example
Query information about all NPUs.
npu-smi info -l
Card Count : 1 NPU ID : 6 Product Name : IT21DMPB01 Serial Number : 033EFS10J7000021 Chip Count : 4
Output Description
Field |
Description |
---|---|
Card Count |
Number of NPUs. |
NPU ID |
Device ID. |
Product Name |
Product name. |
Serial Number |
Product SN. |
Chip Count |
Number of chips. |
Querying the Mapping Information of All Chips
Function
The npu-smi info -m command is used to query the mapping information of all chips.
Syntax
npu-smi info -m
Parameters
None
Usage Instruction
- The MCU information is not displayed on a Docker container.
- Table 10-17 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
npu-smi info -m
NPU ID Chip ID Chip Logic ID Chip Name 6 0 0 MiniD 6 1 1 MiniD 6 2 2 MiniD 6 3 3 MiniD 6 4 - Mcu
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip ID |
Chip ID. |
Chip Logic ID |
Chip logic ID. |
Chip Name |
Chip name. |
Querying the Common Information of All Chips
Function
The npu-smi info -t common -i id command is used to query the common information of all chips.
Syntax
npu-smi info -t common -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
- Table 10-19 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the common information of all chips on device 0.
npu-smi info -t common -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Memory Usage Rate(%) : 33 Aicore Usage Rate(%) : 0 Temperature(C) : 68 Rated Power Dissipation(W) : 12.8 Chip ID : 1 Memory Usage Rate(%) : 35 Aicore Usage Rate(%) : 0 Temperature(C) : 69 Rated Power Dissipation(W) : 12.8 Chip ID : 2 Memory Usage Rate(%) : 35 Aicore Usage Rate(%) : 0 Temperature(C) : 65 Rated Power Dissipation(W) : 12.8 Chip ID : 3 Memory Usage Rate(%) : 35 Aicore Usage Rate(%) : 0 Temperature(C) : 60 Rated Power Dissipation(W) : 12.8 Chip Name : MCU Temperature(C) : 56 Power Dissipation(W) : 18.0
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Memory Usage Rate(%) |
Memory usage. |
Aicore Usage Rate(%) |
AI Core usage. |
Temperature(C) |
Temperature (unit: °C). |
Chip Name |
Chip name. |
Power Dissipation(W) |
Power (unit: W). |
Rated Power Dissipation(W) |
Rated power (unit: W). |
Querying the Flash Information of All Chips
Function
The npu-smi info -t flash -i id command is used to query the flash information of all chips.
Syntax
npu-smi info -t flash -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-21 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the flash information of all chips on device 0.
npu-smi info -t flash -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Flash Count : 1 Flash ID : 624427202 Manufacturer ID : 0xC2 Capacity(MB) : 16 Chip ID : 1 Flash Count : 1 Flash ID : 624427202 Manufacturer ID : 0xC2 Capacity(MB) : 16 Chip ID : 2 Flash Count : 1 Flash ID : 624427202 Manufacturer ID : 0xC2 Capacity(MB) : 16 Chip ID : 3 Flash Count : 1 Flash ID : 624427202 Manufacturer ID : 0xC2 Capacity(MB) : 16
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Flash Count |
Flash count. |
Flash ID |
Flash ID. |
Manufacturer ID |
Manufacturer ID. |
Capacity(MB) |
Capacity (unit: MB). |
Querying the Flash Information of a Chip
Function
The npu-smi info -t flash -i id -c chip_id command is used to query the flash information of a chip.
Syntax
npu-smi info -t flash -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
Table 10-23 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the flash information of chip 0 on device 0.
npu-smi info -t flash -i 0 -c 0
Flash Count : 1 Flash ID : 624427202 Manufacturer ID : 0xC2 Capacity(MB) : 16
Output Description
Field |
Description |
---|---|
Flash Count |
Flash count. |
Flash ID |
Flash ID |
Manufacturer ID |
Manufacturer ID. |
Capacity(MB) |
Capacity (unit: MB). |
Querying the Memory Information of All Chips
Function
npu-smi info -t memory -i id command is used to query the memory information of all chips.
Syntax
npu-smi info -t memory -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
- Table 10-25 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the memory information of all chips on device 0.
npu-smi info -t memory -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Capacity(MB) : 8192 Clock Speed(MHz) : 1600 Chip ID : 1 Capacity(MB) : 8192 Clock Speed(MHz) : 1600 Chip ID : 2 Capacity(MB) : 8192 Clock Speed(MHz) : 1600 Chip ID : 3 Capacity(MB) : 8192 Clock Speed(MHz) : 1600
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Capacity(MB) |
Capacity (unit: MB). |
Clock Speed(MHz) |
Clock frequency (unit: MHz). |
Querying the Memory Information of a Chip
Function
The npu-smi info -t memory -i id -c chip_id command is used to query the memory information of a chip.
Syntax
npu-smi info -t memory -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
Table 10-27 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the memory information of chip 0 on device 0.
npu-smi info -t memory -i 0 -c 0
Capacity(MB) : 8192 Clock Speed(MHz) : 1600
Output Description
Field |
Description |
---|---|
Capacity(MB) |
Capacity (unit: MB). |
Clock Speed(MHz) |
Clock frequency (unit: MHz). |
Querying the Statistics of All Chips
Function
The npu-smi info -t usages -i id command is used to query the statistics of all chips.
Syntax
npu-smi info -t usages -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
- Table 10-29 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the statistics of all chips on device 0.
npu-smi info -t usages -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Memory Capacity(MB) : 8192 Memory Usage Rate(%) : 38 Hugepages Total(page) : 970 Hugepages Usage Rate(%) : 0 Aicore Usage Rate(%) : 50 Aicpu Usage Rate(%) : 3 Ctrlcpu Usage Rate(%) : 0 Memory Bandwidth Usage Rate(%) : 13 Chip ID : 1 Memory Capacity(MB) : 8192 Memory Usage Rate(%) : 40 Hugepages Total(page) : 970 Hugepages Usage Rate(%) : 0 Aicore Usage Rate(%) : 0 Aicpu Usage Rate(%) : 1 Ctrlcpu Usage Rate(%) : 0 Memory Bandwidth Usage Rate(%) : 4 Chip ID : 2 Memory Capacity(MB) : 8192 Memory Usage Rate(%) : 39 Hugepages Total(page) : 970 Hugepages Usage Rate(%) : 0 Aicore Usage Rate(%) : 0 Aicpu Usage Rate(%) : 1 Ctrlcpu Usage Rate(%) : 0 Memory Bandwidth Usage Rate(%) : 3 Chip ID : 3 Memory Capacity(MB) : 8192 Memory Usage Rate(%) : 39 Hugepages Total(page) : 970 Hugepages Usage Rate(%) : 0 Aicore Usage Rate(%) : 55 Aicpu Usage Rate(%) : 0 Ctrlcpu Usage Rate(%) : 0 Memory Bandwidth Usage Rate(%) : 13
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Memory Capacity(MB) |
Memory capacity (unit: MB). |
Memory Usage Rate(%) |
Memory usage. |
Hugepages Total(page) |
Total number of huge pages. The size of each page is 2048 KB. |
Hugepages Usage Rate(%) |
Huge page usage. |
Aicore Usage Rate(%) |
AI Core usage. |
Aicpu Usage Rate(%) |
AI CPU usage. |
Ctrlcpu Usage Rate(%) |
Ctrl CPU usage. |
Memory Bandwidth Usage Rate(%) |
Memory bandwidth usage. |
Note: Hugepages Total(page) and Hugepages Usage Rate(%) are supported only by NPU 21.0.4 and later versions. |
Querying the Statistics of a Chip
Function
The npu-smi info -t usages -i id -c chip_id command is used to query the statistics of a chip.
Syntax
npu-smi info -t usages -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
- Table 10-31 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the statistics about chip 0 on device 0.
npu-smi info -t usages -i 0 -c 0
Memory Capacity(MB) : 8192 Memory Usage Rate(%) : 30 Hugepages Total(page) : 970 Hugepages Usage Rate(%) : 0 Aicore Usage Rate(%) : 5 Aicpu Usage Rate(%) : 1 Ctrlcpu Usage Rate(%) : 0 Memory Bandwidth Usage Rate(%) : 12
Output Description
Field |
Description |
---|---|
Memory Capacity(MB) |
Memory capacity (unit: MB). |
Memory Usage Rate(%) |
Memory usage. |
Hugepages Total(page) |
Total number of huge pages. The size of each page is 2048 KB. |
Hugepages Usage Rate(%) |
Huge page usage. |
Aicore Usage Rate(%) |
AI Core usage. |
Aicpu Usage Rate(%) |
AI CPU usage. |
Ctrlcpu Usage Rate(%) |
Ctrl CPU usage. |
Memory Bandwidth Usage Rate(%) |
Memory bandwidth usage. |
Note: Hugepages Total(page) and Hugepages Usage Rate(%) are supported only by NPU 21.0.4 and later versions. |
Querying the Temperatures of All Chips
Function
The npu-smi info -t temp -i id command is used to query the temperatures of all chips.
Syntax
npu-smi info -t temp -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
The MCU information is not displayed on a Docker container.
Example
Query the temperatures of all chips on device 0.
npu-smi info -t temp -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Temperature (C) : 67 Chip ID : 1 Temperature (C) : 67 Chip ID : 2 Temperature (C) : 64 Chip ID : 3 Temperature (C) : 58 Temperature (C) : 55 Chip Name : MCU
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Temperature (C) |
Temperature (unit: °C). |
Chip Name |
Chip name. |
Querying the Temperature of a Chip
Function
The npu-smi info -t temp -i id -c chip_id command is used to query the temperature of a chip.
Syntax
npu-smi info -t temp -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-35 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the temperature of chip 0 on device 0.
npu-smi info -t temp -i 0 -c 0
Temperature (C) : 68
Output Description
Field |
Description |
---|---|
Temperature (C) |
Temperature (unit: °C). |
Querying the Power of All Chips
Function
The npu-smi info -t power -i id command is used to query the power of all chips.
Syntax
npu-smi info -t power -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
The MCU information is not displayed on a Docker container.
Example
Query the power of all chips on device 0.
npu-smi info -t power -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Rated Power Dissipation(W) : 12.8 Chip ID : 1 Rated Power Dissipation(W) : 12.8 Chip ID : 2 Rated Power Dissipation(W) : 12.8 Chip ID : 3 Rated Power Dissipation(W) : 12.8 Power Dissipation(W) : 17.0 Chip Name : MCU
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Rated Power Dissipation(W) |
Rated power (unit: W). |
Power Dissipation(W) |
Real-time power (unit: W). |
Chip Name |
Chip name. |
Querying the Power of a Chip
Function
The npu-smi info -t power -i id -c chip_id command is used to query the power of a chip.
Syntax
npu-smi info -t power -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-39 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the power of chip 0 on device 0.
npu-smi info -t power -i 0 -c 0
Rated Power Dissipation(W) : 12.8
Output Description
Field |
Description |
---|---|
Rated Power Dissipation(W) |
Rated power (unit: W). |
Querying the Voltage of All Chips
Function
The npu-smi info -t volt -i id command is used to query the voltage of all chips.
Syntax
npu-smi info -t volt -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
The MCU information is not displayed on a Docker container.
Example
Query the voltage of all chips on device 0.
npu-smi info -t volt -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Voltage(V) : 0.80 Chip ID : 1 Voltage(V) : 0.80 Chip ID : 2 Voltage(V) : 0.80 Chip ID : 3 Voltage(V) : 0.80 Voltage(V) : NA Chip Name : MCU
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Voltage(V) |
Voltage (unit: V). |
Chip Name |
Chip name. |
Querying the Voltage of a Chip
Function
The npu-smi info -t volt -i id -c chip_id command is used to query the voltage of a chip.
Syntax
npu-smi info -t volt -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info --l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-43 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the voltage of chip 0 on device 0.
npu-smi info -t volt -i 0 -c 0
Voltage(V) : 0.80
Output Description
Field |
Description |
---|---|
Voltage(V) |
Voltage (unit: V). |
Querying the Health Status of All Chips
Function
The npu-smi info -t health -i id command is used to query the health status of all chips.
Syntax
npu-smi info -t health -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
The MCU status is not displayed on a Docker container.
Example
Query the health status of all chips on device 0.
npu-smi info -t health -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Health : OK Chip ID : 1 Health : OK Chip ID : 2 Health : OK Chip ID : 3 Health : OK Health : OK Chip Name : MCU
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Health |
Chip health status. The status can be OK, Warning, Alarm, Critical, or UNKNOWN. |
Chip Name |
Chip name. |
Querying the Health Status of a Chip
Function
The npu-smi info -t health -i id -c chip_id command is used to query the health status of a chip.
Syntax
npu-smi info -t health -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-47 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the health status of chip 0 on device 0.
npu-smi info -t health -i 0 -c 0
Health Status : OK Error Code : NA Error Information : NA
Output Description
Field |
Description |
---|---|
Health Status |
Chip health status. The status can be OK, Warning, Alarm, Critical, or UNKNOWN. |
Error Code |
Error code. |
Error Information |
Error message. |
Querying MCU Monitoring Information
Function
The npu-smi info -t mcu-monitor -i id -c chip_id command is used to query MCU monitoring information.
Syntax
npu-smi info -t mcu-monitor -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-49 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
npu-smi info -t mcu-monitor -i 0 -c 1
This device does not support querying mcu-monitor.
Output Description
None
Querying the SSH Enabling Status of All Chips
Function
The npu-smi info -t ssh-enable -i id command is used to query the SSH enabling status of all chips.
Syntax
npu-smi info -t ssh-enable -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-50 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the SSH enabling status of all chips on device 0.
npu-smi info -t ssh-enable -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 SSH-Enable Status : False Chip ID : 1 SSH-Enable Status : True Chip ID : 2 SSH-Enable Status : True Chip ID : 3 SSH-Enable Status : True
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
SSH-Enable Status |
SSH enabling status of a chip. The value can be False or True. |
Querying the SSH Enabling Status of a Chip
Function
The npu-smi info -t ssh-enable -i id -c chip_id command is used to query the SSH enabling status of a chip.
Syntax
npu-smi info -t ssh-enable -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
Table 10-52 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the SSH enabling status of chip 0 on device 0.
npu-smi info -t ssh-enable -i 0 -c 0
SSH-Enable Status : False
Output Description
Field |
Description |
---|---|
SSH-Enable Status |
SSH enabling status of a chip. The value can be False or True. |
Querying the ECC Error Counts of All Chips
Function
The npu-smi info -t ecc -i id command is used to query the ECC error counts of all chips.
Syntax
npu-smi info -t ecc -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-54 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the ECC error counts of all chips on device 0.
npu-smi info -t ecc -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Single-bit Error Count : 0 Double-bit Error Count : 0 Chip ID : 1 Single-bit Error Count : 0 Double-bit Error Count : 0 Chip ID : 2 Single-bit Error Count : 0 Double-bit Error Count : 0 Chip ID : 3 Single-bit Error Count : 0 Double-bit Error Count : 0
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Single-bit Error Count |
Single-bit error count. |
Double-bit Error Count |
Multi-bit error count. |
Querying the ECC Error Counts of a Chip
Function
The npu-smi info -t ecc -i id -c chip_id command is used to query the ECC error counts of a chip.
Syntax
npu-smi info -t ecc -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
Table 10-56 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the ECC error counts of chip 0 on device 0.
npu-smi info -t ecc -i 0 -c 0
Single-bit Error Count : 0 Double-bit Error Count : 0
Output Description
Field |
Description |
---|---|
Single-bit Error Count |
Single-bit error count. |
Double-bit Error Count |
Multi-bit error count. |
Querying the ECC Enable Status
Function
The npu-smi info -t ecc-enable -i id command is used to query the ECC enable status of an NPU.
Syntax
npu-smi info -t ecc-enable -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-58 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the ECC enable status of device 0.
npu-smi info -t ecc-enable -i 0
ECC-Enable Status : True
Output Description
Field |
Description |
---|---|
ECC-Enable Status |
ECC enable status of DDR. The value can be False or True. |
Querying the p2p Enable Status
Function
The npu-smi info -t p2p-enable -i id command is used to query the p2p enable status of an NPU.
Syntax
npu-smi info -t p2p-enable -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-60 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the p2p enable status of device 0.
npu-smi info -t p2p-enable -i 0
P2P-Enable Status : False
Output Description
Field |
Description |
---|---|
P2P-Enable Status |
p2p enable status. The value can be False or True. |
Querying the Boot Area of a Chip
Function
The npu-smi info -t boot-area -i id -c chip_id command is used to query the boot area of a chip.
Syntax
npu-smi info -t boot-area -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-62 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the boot area 0 of device 0.
npu-smi info -t boot-area -i 0 -c 0
This device does not support querying boot-area.
Output Description
None
Querying the Sensor Information of a Chip
Function
The npu-smi info -t sensors -i id -c chip_id command is used to query the sensor information of a chip.
Syntax
npu-smi info -t sensors -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-63 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the sensor information of chip 0 on device 0.
npu-smi info -t sensors -i 0 -c 0
This device does not support querying sensors.
Output Description
None
Querying the System Time of a Chip
Function
The npu-smi info -t sys-time -i id -c chip_id command is used to query the system time of a chip.
Syntax
npu-smi info -t sys-time -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-64 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the system time of chip 0 on device 0.
npu-smi info -t sys-time -i 0 -c 0
This device does not support querying sys-time.
Output Description
None
Checking the IIC Channel Between the NPU and the MCU
Function
The npu-smi info -t i2c_check -i id command is used to check whether the IIC channel between the NPU and the MCU is normal.
Syntax
npu-smi info -t i2c_check -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-65 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Check the IIC channel between device 0 and the MCU.
npu-smi info -t i2c_check -i 0
Checking... Please do not interrupt! MiniD 1 to MCU iic channel status: OK MiniD 3 to MCU iic channel status: OK MCU to miniD 0 iic channel status: OK MCU to miniD 1 iic channel status: OK MCU to miniD 2 iic channel status: OK MCU to miniD 3 iic channel status: OK
Output Description
Field |
Description |
---|---|
miniD 1 to MCU iic channel status |
Status of the I2C channel between miniD 1 and the MCU of the NPU. The value can be OK, Fault, or Unknown. |
miniD 3 to MCU iic channel status |
Status of the I2C channel between miniD 3 and the MCU of the NPU. The value can be OK, Fault, or Unknown. |
MCU to miniD 0 iic channel status |
Status of the I2C channel between miniD 0 and the MCU of the NPU. The value can be OK, Fault, or Unknown. |
MCU to miniD 1 iic channel status |
Status of the I2C channel between miniD 1 and the MCU of the NPU. The value can be OK, Fault, or Unknown. |
MCU to miniD 2 iic channel status |
Status of the I2C channel between miniD 2 and the MCU of the NPU. The value can be OK, Fault, or Unknown. |
MCU to miniD 3 iic channel status |
Status of the I2C channel between miniD 3 and the MCU of the NPU. The value can be OK, Fault, or Unknown. |
Querying the Product Type
Function
The npu-smi info -t product -i id command is used to query the product type.
Syntax
npu-smi info -t product -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-67 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the product type of device 0. The following product model is only an example.
npu-smi info -t product -i 0
Product Type : Atlas 300I Model 3000
Output Description
Field |
Description |
---|---|
Product Type |
Product type. |
Querying the Product Type of a Chip
Function
The npu-smi info -t product -i id -c chip_id command is used to query the product type of a chip.
Syntax
npu-smi info -t product -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
Table 10-69 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the product type of chip 0 on device 0. The following product model is only an example.
npu-smi info -t product -i 0 -c 0
Product Type : Atlas 300I Model 3000
Output Description
Field |
Description |
---|---|
Product Type |
Product type. |
Querying Matrix Process Monitoring Data of a Chip
Function
The npu-smi info proc -i id -c chip_id -d delay_seconds command is used to query the Matrix process monitoring data of a specified chip.
Syntax
npu-smi info proc -i id -c chip_id -d delay_seconds
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
delay_seconds |
Delay of each query operation in seconds. The value ranges from 1 to 100, in seconds. The default value is 1. |
Usage Instruction
Table 10-71 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the Matrix process monitoring data of chip 0 on device 0 every 2 seconds.
npu-smi info proc -i 0 -c 0 -d 2
This device does not support querying proc info.
Output Description
None
Querying a User Certificate
Function
The npu-smi info -t license -i id command is used to query a user certificate.
Syntax
npu-smi info -t license -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Example
Obtain the certificate of device 0.
npu-smi info -t license -i 0
License : testjn
Output Description
Field |
Description |
---|---|
License |
User certificate. |
Querying Customized Information
Function
The npu-smi info -t customized-info -i id command is used to query customized information.
Syntax
npu-smi info -t customized-info -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-74 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Obtain the customized information about device 0.
npu-smi info -t customized-info -i 0
This device does not support querying customized-info.
Output Description
None
Querying the IP Address of an AI Chip
Function
The npu-smi info -t ip -i id -c chip_id command is used to query the IP address of an AI chip.
Syntax
npu-smi info -t ip -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
Table 10-75 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the IP address of AI chip 0 on device 0.
npu-smi info -t ip -i 0 -c 0
ip : 192.168.5.199 netmask : 255.255.255.0
Output Description
Field |
Description |
---|---|
ip |
IP address. |
netmask |
Subnet mask. |
Querying the PCIe Error Counts of All Chips
Function
The npu-smi info -t err-count -i id command is used to query the PCIe error counts of all chips.
The npu-smi info -t pcie-err -i id command is used to query the PCIe error counts of all chips.
Syntax
npu-smi info -t err-count -i id
npu-smi info -t pcie-err -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-77 describes the product forms, application scenarios, user permissions, and OSs supported by the npu-smi info -t err-count -i id command.
Product Form |
Linux Physical Machine |
Linux Container |
Windows OS |
|
Root User |
Running User Group (Non-root User) |
Root User |
Administrator |
|
Atlas 300I inference card (model 3000) |
Y |
Y |
Y |
N/A |
Table 10-78 describes the product forms, application scenarios, user permissions, and OSs supported by the npu-smi info -t pcie-err -i id command.
Example
Query the PCIe error counts of all chips on device 0.
npu-smi info -t err-count -i 0
NPU ID : 0 Chip Count : 4 Chip ID : 0 Pcs Rx Error Count : 0 Phy Lane Error Count : 0 Dl Lcrc Error Count : 0 Dl Dcrc Error Count : 0 Chip ID : 1 Pcs Rx Error Count : 0 Phy Lane Error Count : 0 Dl Lcrc Error Count : 0 Dl Dcrc Error Count : 0 Chip ID : 2 Pcs Rx Error Count : 0 Phy Lane Error Count : 0 Dl Lcrc Error Count : 0 Dl Dcrc Error Count : 0 Chip ID : 3 Pcs Rx Error Count : 0 Phy Lane Error Count : 0 Dl Lcrc Error Count : 0 Dl Dcrc Error Count : 0
npu-smi info -t pcie-err -i 0
This device does not support querying pcie-err.
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Pcs Rx Error Count |
Number of PCS RX errors. |
Phy Lane Error Count |
Number of physical channel errors. |
Dl Lcrc Error Count |
Number of Dl LCRC errors. |
Dl Dcrc Error Count |
Number of Dl DCCRC errors. |
Chip ID |
Chip ID. |
Querying the PCIe Error Counts of a Chip
Function
The npu-smi info -t err-count -i id -c chip_id command is used to query the PCIe error counts of a chip.
The npu-smi info -t pcie-err -i id -c chip_id command is used to query the PCIe error counts of a chip.
Syntax
npu-smi info -t err-count -i id -c chip_id
npu-smi info -t pcie-err -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. The npu-smi info -t err-count -i id -c chip_id command does not support a specified MCU. |
Usage Instruction
Table 10-80 describes the product forms, application scenarios, user permissions, and OSs supported by the npu-smi info -t err-count -i id -c chip_id command.
Product Form |
Linux Physical Machine |
Linux Container |
Windows OS |
|
Root User |
Running User Group (Non-root User) |
Root User |
Administrator |
|
Atlas 300I inference card (model 3000) |
Y |
Y |
Y |
N/A |
Table 10-81 describes the product forms, application scenarios, user permissions, and OSs supported by the npu-smi info -t pcie-err -i id -c chip_id command.
Example
Query the PCIe error counts of chip 0 on device 0.
npu-smi info -t err-count -i 0 -c 0
Pcs Rx Error Count : 0 Phy Lane Error Count : 0 Dl Lcrc Error Count : 0 Dl Dcrc Error Count : 0
npu-smi info -t pcie-err -i 0 -c 0
This device does not support querying pcie-err.
Output Description
Field |
Description |
---|---|
Pcs Rx Error Count |
Number of PCS RX errors. |
Phy Lane Error Count |
Number of physical channel errors. |
Dl Lcrc Error Count |
Number of Dl LCRC errors. |
Dl Dcrc Error Count |
Number of Dl DCCRC errors. |
Querying the Container Sharing Mode of All Chips
Function
The npu-smi info -t device-share -i id command is used to query the container sharing mode of all chips.
Syntax
npu-smi info -t device-share -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Table 10-83 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the container sharing mode of all chips on device 0.
npu-smi info -t device-share -i 0
This device does not support querying device-share.
Output Description
None
Querying the Container Sharing Mode of a Chip
Function
The npu-smi info -t device-share -i id -c chip_id command is used to query the container sharing mode of a specified chip.
Syntax
npu-smi info -t device-share -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-84 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the container sharing mode of chip 0 on device 0.
npu-smi info -t device-share -i 0 -c 0
This device does not support querying device-share.
Output Description
None
Querying the Computing Power Level of a Chip
Function
The npu-smi info -t nve-level -i id -c chip_id command is used to query the computing power level of a chip.
Syntax
npu-smi info -t nve-level -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-85 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the computing power level of chip 0 on device 0.
npu-smi info -t nve-level -i 0 -c 0
This device does not support querying nve-level.
Output Description
None
Querying the Number of AI CPUs and Ctrl CPUs on a Chip
Function
The npu-smi info -t aicpu-config -i id -c chip_id command is used to query the number of AI CPUs and Ctrl CPUs on a chip.
Syntax
npu-smi info -t aicpu-config -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-86 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the number of AI CPUs and Ctrl CPUs on chip 0 in device 0.
npu-smi info -t aicpu-config -i 0 -c 0
This device does not support querying aicpu-config.
Output Description
None
Querying the Number of AI CPUs, Ctrl CPUs, and Data CPUs of All Chips
Function
The npu-smi info -t cpu-num-cfg -i id command is used to query the number of AI CPUs, Ctrl CPUs, and data CPUs of all chips.
Syntax
npu-smi info -t cpu-num-cfg -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
- This command applies only to NPU 22.0.0 or later.
- Table 10-87 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the number of AI CPUs, Ctrl CPUs, and data CPUs of all chips on device 0.
npu-smi info -t cpu-num-cfg -i 0
This device does not support querying cpu-num-cfg.
Output Description
None
Querying the Number of AI CPUs, Ctrl CPUs, and Data CPUs of a Specified Chip
Function
The npu-smi info -t cpu-num-cfg -i id -c chip_id command is used to query the number of AI CPUs, Ctrl CPUs, and data CPUs of a specified chip.
Syntax
npu-smi info -t cpu-num-cfg -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
- This command applies only to NPU 22.0.0 or later.
- Table 10-88 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the number of AI CPUs, Ctrl CPUs, and data CPUs of chip 0 on device 0.
npu-smi info -t cpu-num-cfg -i 0 -c 0
This device does not support querying cpu-num-cfg.
Output Description
None
Querying vNPUs of a Chip
Function
The npu-smi info -t info-vnpu -i id -c chip_id command is used to query the vNPU information of a chip.
Syntax
npu-smi info -t info-vnpu -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
- The computing power allocation feature applies only to teaching scenarios in colleges.
- Table 10-89 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the vNPU information of chip 0 on device 0.
npu-smi info -t info-vnpu -i 0 -c 0
This device does not support querying info-vnpu.
Output Description
None
Querying the First Power-On Time of an NPU
Function
The npu-smi info -t first-power-on-date -i id command is used to query the time when an NPU was powered on for the first time.
Syntax
npu-smi info -t first-power-on-date -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
This command applies only to NPU 21.0.4 or later.
If the NPU's first power-on time is not recorded, run this command 24 hours later.
Table 10-90 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
npu-smi info -t first-power-on-date -i 0
This device does not support querying first-power-on-date.
Output Description
None
Querying the Memory Usage of Processes on All Chips
Function
The npu-smi info -t proc-mem -i id command is used to query the memory usage of processes on all chips.
Syntax
npu-smi info -t proc-mem -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
This command applies only to NPU 21.0.4 or later.
Table 10-91 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the memory usage of processes on all chips on device 0.
npu-smi info -t proc-mem -i 0
NPU ID : 4 Chip Count : 4 Chip ID : 0 Process id:26280 Process name:hlt_host_devmm_ Process memory(B):95105024 Process id:26284 Process name:hlt_host_devmm_ Process memory(B):95109120 Process id:26288 Process name:hlt_host_devmm_ Process memory(B):95105024 Chip ID : 1 Process id:26285 Process name:hlt_host_devmm_ Process memory(B):95105024 Process id:26281 Process name:hlt_host_devmm_ Process memory(B):95105024 Chip ID : 2 Process id:26282 Process name:hlt_host_devmm_ Process memory(B):95105024 Process id:26286 Process name:hlt_host_devmm_ Process memory(B):95105024 Chip ID : 3 Process id:26287 Process name:hlt_host_devmm_ Process memory(B):95105024 Process id:26283 Process name:hlt_host_devmm_ Process memory(B):95105024
Output Description
Field |
Description |
---|---|
NPU ID |
Device ID. |
Chip Count |
Number of chips. |
Chip ID |
Chip ID. |
Process id |
Process ID. |
Process name |
Process name. |
Process memory(B) |
Memory occupied by a process (unit: byte). |
Querying the Memory Usage of Processes on a Chip
Function
The npu-smi info -t proc-mem -i id -c chip_id command is used to query the memory usage of processes on a chip.
Syntax
npu-smi info -t proc-mem -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
This command applies only to NPU 21.0.4 or later.
Table 10-93 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the memory usage of processes on chip 0 on device 0.
npu-smi info -t proc-mem -i 0 -c 0
Process id:38329 Process name:hlt_host_devmm_ Process memory(B):100683776 Process id:38321 Process name:hlt_host_devmm_ Process memory(B):100646912
Output Description
Field |
Description |
---|---|
Process id |
Process ID. |
Process name |
Process name. |
Process memory(B) |
Memory occupied by a process (unit: byte). |
Querying the Length of Service Data Asynchronously Copied by a Specified Chip
Function
The npu-smi info -t vnpu-svm -i id -c chip_id command is used to query the length of the service data asynchronously copied by a specified chip.
Syntax
npu-smi info -t vnpu-svm -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
- This command applies only to NPU 22.0.0 or later.
- Table 10-95 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Query the length of the service data asynchronously copied by chip 0 on device 0.
npu-smi info -t vnpu-svm -i 0 -c 0
This device does not support querying vnpu-svm.
Output Description
None
Commands for Settings (set)
Collecting Logs
Function
The npu-smi set -t collect-log -i id command is used to collect MCU logs. The logs are stored in /run/mcu_log.
Syntax
npu-smi set -t collect-log -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
Do not upgrade the MCU when collecting logs.
The system does not automatically delete log files. To prevent log files from occupying drive space, you are advised to manually delete them after downloading them.
Table 10-96 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Collect MCU logs of device 0.
npu-smi set -t collect-log -i 0
type(0): file_len(203808)--offset(203808) [100].Logs collected successfully,(0). type(1): file_len(102026)--offset(102026) [100].Logs collected successfully,(1). type(2): file_len(101376)--offset(101376) [100].Logs collected successfully,(2).
Output Description
None
Resetting the Standard PCIe Card
Software Preparations
The standard PCIe card reset function in out-of-band mode depends on IPMItool. Download the tool and load the driver in advance.
- Download IPMItool.
- CentOS and EulerOS: yum install ipmitool
- Ubuntu: apt-get install ipmitool
- Load the drivers.
modprobe ipmi_si
modprobe ipmi_devintf
modprobe ipmi_msghandler
- Run the lsmod | grep ipmi command to check whether the drivers have been loaded. If the drivers fail to be loaded, perform 2 to reload them.
Function
The npu-smi set -t reset -i id [-m 1] command is used to reset a device in in-band mode.
The npu-smi set -t reset -i id command is used to reset a device in out-of-band mode.
Syntax
npu-smi set -t reset -i id [-m 1]
npu-smi set -t reset -i id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
Usage Instruction
- Do not run this command when services are running.
- In the preceding command, [-m 1] indicates an optional parameter. If this parameter is used, the device is reset in in-band mode. Otherwise, the device is reset in out-of-band mode.
- Windows supports only in-band reset.
- The standard PCIe card reset in out-of-band mode depends on the iBMC. To ensure the reset function, upgrade the iBMC to the latest version.
- After the device is reset successfully, wait for at least 20 seconds before querying information about this device or other devices and chips.
- Table 10-97 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Reset device 0 in out-of-band mode.
npu-smi set -t reset -i 0
Resetting the standard PCIe card or NPU chip may cause a system hang or abnormal reset during service running. Are you sure you want to continue resetting?(Y/N) y Message : resetting ... Status : OK Message : Reset card successfully.
Reset device 0 in in-band mode.
npu-smi set -t reset -i 0 -m 1
Resetting the standard PCIe card or NPU chip may cause a system hang or abnormal reset during service running. Are you sure you want to continue resetting?(Y/N) y Message : resetting ... Status : OK Message : Reset card successfully.
Output Description
Field |
Description |
---|---|
Status |
Reset status. The value can be OK or Fail. |
Message |
Reset message |
Resetting a Chip
Software Preparations
The chip reset function in out-of-band mode depends on IPMItool. Download the tool and load the driver in advance.
- Download IPMItool.
- CentOS and EulerOS: yum install ipmitool
- Ubuntu: apt-get install ipmitool
- Load the drivers.
modprobe ipmi_si
modprobe ipmi_devintf
modprobe ipmi_msghandler
- Run the lsmod | grep ipmi command to check whether the drivers have been loaded. If the drivers fail to be loaded, perform 2 to reload them.
Function
The npu-smi set -t reset -i id -c chip_id [-m 1] command is used to reset a chip in in-band mode.
The npu-smi set -t reset -i id -c chip_id command is used to reset a specified chip in out-of-band mode.
Syntax
npu-smi set -t reset -i id -c chip_id [-m 1]
npu-smi set -t reset -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
Usage Instruction
- Do not run this command when services are running.
- In the preceding command, [-m 1] indicates an optional parameter. If this parameter is used, the specified chip is reset in in-band mode. If this parameter is not used, the specified chip is reset in out-of-band mode.
- The chip reset in out-of-band mode depends on the iBMC. To ensure the reset function, upgrade the iBMC to the latest version.
- After the chip is reset successfully, wait for at least 20s before querying information about this chip or other chips.
- Windows supports only in-band reset.
- Table 10-99 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Reset chip 0 of device 0 in out-of-band mode.
npu-smi set -t reset -i 0 -c 0
Resetting the standard PCIe card or NPU chip may cause a system hang or abnormal reset during service running. Are you sure you want to continue resetting?(Y/N) y Message : resetting ... Status : OK Message : Reset chip successfully.
Reset chip 0 of device 0 in in-band mode.
npu-smi set -t reset -i 0 -c 0 -m 1
Resetting the standard PCIe card or NPU chip may cause a system hang or abnormal reset during service running. Are you sure you want to continue resetting?(Y/N) y Message : resetting ... Status : OK Message : Reset chip successfully.
Output Description
Field |
Description |
---|---|
Message |
Reset message |
Status |
Reset status. The value can be OK or Fail. |
Setting MCU Monitoring
Function
The npu-smi set -t mcu-monitor -i id -c chip_id -d value command is used to set the MCU monitoring status.
Syntax
npu-smi set -t mcu-monitor -i id -c chip_id -d value
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
value |
MCU monitoring setting.
|
Usage Instruction
Table 10-101 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Enable MCU monitoring for device 0.
npu-smi set -t mcu-monitor -i 0 -c 1 -d 1
This device does not support setting mcu-monitor.
Output Description
None
Setting the Boot Area
Function
The npu-smi set -t boot-area -i id -c chip_id command is used to set the boot area.
Syntax
npu-smi set -t boot-area -i id -c chip_id
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
Usage Instruction
Table 10-102 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Set the boot area of device 0.
npu-smi set -t boot-area -i 0 -c 0
This device does not support setting boot-area.
Output Description
None
Powering On or Off the HDD
Function
The npu-smi set -t disk-power -i id -c chip_id -d value command is used to power on or off the HDD using the MCU.
Syntax
npu-smi set -t disk-power -i id -c chip_id -d value
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. |
value |
Power status of the HDD. The value is 0 or 1.
|
Usage Instruction
- Table 10-103 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Power on or off the HDD using the MCU.
npu-smi set -t disk-power -i 0 -c 0 -d 1
This device does not support setting disk-power.
Output Description
None
Enabling or Disabling SSH for All Chips
Function
The npu-smi set -t ssh-enable -i id -d value command is used to enable or disable SSH for all chips of a device.
Syntax
npu-smi set -t ssh-enable -i id -d value
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
value |
SSH setting. The value can be:
|
Usage Instruction
- After enabling SSH for all chips, you need to reset them for the configurations to take effect. For details, see Resetting the Standard PCIe Card.
- If you enable the SSH service, change the SSH login password of the device (including the passwords of the HwHiAiUser and root users) immediately.
- The SSH service will not be automatically disabled due to configuration persistency. You are advised to manually disable it in a timely manner after using it.
- Table 10-104 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Enable SSH for all chips on device 0.
npu-smi set -t ssh-enable -i 0 -d 1
[WARNING]: Enabling SSH will raise the safety risks. Status : OK Message : The ssh-enable of the card is set successfully. Reset card for the configuration to take effect.
Output Description
Field |
Description |
---|---|
Status |
Command output. The value can be Fail or OK. |
Message |
SSH enabling message |
Enabling or Disabling SSH for a Chip
Function
The npu-smi set -t ssh-enable -i id -c chip_id -d value command is used to enable or disable SSH for a specified chip.
Syntax
npu-smi set -t ssh-enable -i id -c chip_id -d value
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
chip_id |
Chip ID. The chip ID is obtained by running the npu-smi info -m command. This command does not apply to a specified MCU. |
value |
SSH setting. The value can be:
|
Usage Instruction
- After enabling SSH for a chip, you need to reset it for the configuration to take effect. For details, see Resetting a Chip.
- If you enable the SSH service, change the SSH login password of the device (including the passwords of the HwHiAiUser and root users) immediately.
- The SSH service will not be automatically disabled due to configuration persistency. You are advised to manually disable it in a timely manner after using it.
- Table 10-106 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Disable SSH for chip 0 on device 0.
npu-smi set -t ssh-enable -i 0 -c 0 -d 0
Status : OK Message : The ssh-enable of the chip is set successfully. Reset chip for the configuration to take effect.
Output Description
Field |
Description |
---|---|
Status |
Command output. The value can be OK or Fail. |
Message |
Message displayed after the command is executed |
Enabling or Disabling ECC
Function
The npu-smi set -t ecc-enable -i id -d value command is used to enable or disable the ECC function for all chips.
Syntax
npu-smi set -t ecc-enable -i id -d value
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
value |
ECC setting.
|
Usage Instruction
- After enabling ECC for all chips, you need to reset them for the configurations to take effect. For details, see Resetting the Standard PCIe Card.
- The ECC mode is disabled by default. If the ECC mode is enabled, some performance will deteriorate. Therefore, exercise caution when enabling the ECC mode.
- Table 10-108 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Enable ECC for device 0.
npu-smi set -t ecc-enable -i 0 -d 1
Status : OK Message : The ecc-enable is set successfully. Reset card for the configuration to take effect.
Output Description
Field |
Description |
---|---|
Status |
Command output. The value can be OK or Fail. |
Message |
Message displayed after the command is executed |
Configuring a User Certificate
Function
The npu-smi set -t license -i id -f "license" command is used to configure a user certificate. The certificate can be configured only once. Otherwise, the configuration fails.
Syntax
npu-smi set -t license -i id -f "license"
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
license |
Certificate content. The value is a string of 1 to 255 bytes. NOTE:
Some special characters in Linux shell commands indicate reserved fields. For example, $$ indicates the shell process ID, and $? indicates the exit status of the previous command. If special characters need to be set, you need to escape the special characters. |
Usage Instruction
Table 10-110 describes the product forms, application scenarios, user permissions, and OSs supported by this command.
Example
Set the certificate of device 0 to abcde.
npu-smi set -t license -i 0 -f "abcde"
Status : OK Message : The license of the card is set successfully.
Output Description
Field |
Description |
---|---|
Status |
Command output. The value can be OK or Fail. |
Message |
Message displayed after the command is executed |
Configuring Custom Information
Function
The npu-smi set -t customized-info -i id -f customized info command is used to configure custom information. The custom information can be configured only once. Otherwise, the configuration fails.
Syntax
npu-smi set -t customized-info -i id -f customized info
Parameters
Parameter |
Description |
---|---|
id |
Device ID. The NPU ID obtained by running the npu-smi info -l command is the device ID. |
customized info |
Customized information. The value is a string of 1 to 255 bytes. NOTE:
Some special characters in Linux shell commands indicate reserved fields. For example, $$ indicates the shell process ID, and $? indicates the exit status of the previous command. If special characters need to be set, you need to escape the special characters. |
Usage Instruction
Table 10-112 describes the product forms, application scenarios, user permissions, and OSs supported by this command.