# cpup
#### 命令功能
cpup命令用于查询系统CPU的占用率，并以百分比显示占用率。
#### 命令格式
cpup \[*mode* \] \[*taskID*\]
#### 参数说明
表1参数说明 
| 参数     | 参数说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | 取值范围                                                                                      |
|:---|:---|:---|
| mode   | - 缺省：显示系统最近10s的CPU占用率  - 0：显示系统最近10s的CPU占用率  - 1：显示系统最近1s的CPU占用率  - 其他数字：显示系统启动至今总的CPU占用率   | \[0,0xFFFF\] 或0xFFFFFFFF |
| taskID | 任务ID号                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | \[0,0xFFFF\] 或0xFFFFFFFF |
   
#### 使用指南
- 参数缺省时，显示系统最近10s的CPU占用率。
- 只输入一个参数时，该参数为mode，显示系统相应时间的CPU占用率。
- 输入两个参数时，第一个参数为mode，第二个参数为taskID，显示指定任务ID的任务在相应时间的CPU占用率。
- 该功能需要使能CPU占用率模块，可以通过make menuconfig使能，菜单路径为：
  ```
  Kernel ---> Enable Extend Kernel ---> Enable Cpup
  ```
  想更多的了解CPU占用率模块，参见[CPU占用率](https://support.huaweicloud.com/maintenance-LiteOS/zh-cn_topic_0312244419.html#ZH-CN_TOPIC_0312244419)。
  
 
#### 使用实例
举例：
输入cpup 1 1
#### 输出说明
执行cpup 1 1，显示ID为1的任务最近1s的CPU占用率：
```
Huawei LiteOS # cpup 1 1
TaskId 1 CpuUsage in 1s: 78.7
```