Command Reference

语言：简体中文 ｜ Command-Reference-EN

Shell 命令参考（233 条命令）

按注册每个命令的源文件分组 - 树结构即领域结构。在运行中的系统内使用 help -a（按字母顺序）或 help -w（按工作包）。

中文控制台层（8）

• chinese - 中文支持状态（字体/编码/渲染/输入法）
• chinesetest - 运行完整的中文支持回归测试套件
• encoding - 编解码器状态（gb2312/utf-8/ascii）
• encoding-test - 快速编解码器往返检查（完整版：chinesetest）
• font - 列出已注册的字体和活动渲染器
• font-test - 在控制台上渲染混合 CJK/ASCII 示例行
• ime - 拼音输入法状态；"ime -i" 打开交互式控制台行
• ime-test - 快速输入法音节解析检查

内核核心命令（55）

• ahci - AHCI 控制器/端口状态
• ata - ATA（PIO + 总线主控 DMA）状态
• checkupdate - 通过 /etc/opencube.conf 检查更新（http/https）
• checkupdate_test - 更新检查自测（URL/JSON 单元 + 实时探测）
• clear - 清屏
• config - 读写系统配置（config list|get|set|restore|path）
• config_test - 配置子系统自测（write/read/get_all/delete/restore）
• cr3test - 测试 CR3 切换
• cryptotest - 使用 NIST 向量测试 AES/SHA-256/HMAC
• dhtest - DH 模幂运算 1024 位（Oakley Group 1）计时 + 正确性
• dskstat - 显示块设备
• echo - 回显文本
• exc - 运行异常自测（#DE/#UD/#PF）
• fatmount - 挂载 FAT32（fatmount <dev> <path>）
• fatstat - 显示 FAT32 统计
• frag - 显示内存碎片
• fstest - 运行 VFS 自测（mkdir/write/read/ls）
• halt - 停止内核
• heap - 显示内核堆统计
• heapbounds - 堆边界回归测试（BUG-0140 包装 / BUG-0141 上限）
• heaptest - 通过 100 次分配测试堆开销
• help - 显示此消息
• irqabitest - IRQ 入口 ABI 回归测试（BUG-0137 对齐 / BUG-0138 DF）
• kill - 终止任务（kill <tid>）
• l1test - 使用运行中的进程测试 L1 job_create/job_list/job_control
• lang - 显示或设置 Shell 输出语言（lang [en|zh]）
• ldd - 列出动态依赖（ldd <program>）
• mem - 显示物理内存统计
• memtest - 运行内存测试（PMM + 堆）
• mounts - 列出 VFS 挂载表（mount 的别名）
• multi - 生成 3 个任务交错输出
• nice - 更改优先级（nice <tid> <prio>）
• nvme - NVMe 控制器/队列状态
• pftest - 测试缺页异常处理
• pmmrace - BUG-0043 复现：PMM 位图竞争 线程-vs-IRQ
• poweroff - shutdown 的别名
• ps - 列出所有任务
• reboot - 重启机器（reboot）
• rollback - 回滚到槽位 A（rollback）
• run - 运行用户程序（hello/badapp/loop/fork_test/.../dyn_test/so_test/dyn_hello/
• sched - 显示调度器统计
• shutdown - 关机（刷新 + ACPI/Bochs/APM 端口）
• sleep - 延迟 N 秒（sleep <sec>）
• spawn - 生成测试内核线程
• ssh - SSH 客户端连接（ssh <ip> [port] [user] [password]）
• sshd - SSH 服务器（sshd [port=22] [user=oc] [password=oc]）
• stats - 显示中断/定时器统计
• syncstat - 显示同步原语统计
• synctest - 测试同步原语（自旋锁/互斥锁/信号量）
• timer - 注册一个 500ms 单次定时器
• uname - 打印操作系统名称（uname [-a|-s|-r|-m]）
• update - 检查 + 安装系统更新（update [local <pkg> | --local <pkg> | --status]）
• vmkernelpt - VMM PT-所有权回归测试（BUG-0136）
• vmmap - 显示地址空间映射
• vmtest - 运行虚拟内存测试

网络（16）

• arp - 显示 ARP 缓存
• dhcp - 通过 DHCP 获取 IP
• dns - 解析域名（dns <name> [aaaa|cname|mx|txt|ns|srv]）
• dnstest - DNS 记录类型自测（A/AAAA/MX/TXT/NS/SRV 实时）
• firewall - 显示/添加/删除防火墙规则（链、状态、策略、连接跟踪）
• ifconfig - 显示网络接口信息
• ip - 显示/设置 IP 地址
• lspci - 列出 PCI 设备
• netstat - 显示网络统计和套接字
• nf_test - netfilter 自测（规则、连接跟踪、策略、实际路径）
• ping - 发送 ICMP 回显（ping <host>）
• route - 显示/添加/删除路由表（route add <dst> <mask> <gw>）
• tcpcc_test - CUBIC 拥塞控制自测向量
• tcpstats - 显示 TCP 可靠性统计（cwnd、rto 等）
• tcptest - TCP 选项协商自测（MSS/WScale/SACK/TS 实时）
• wget - 通过 HTTP 下载文件（wget <host> [port] [path]）

蓝牙（1）

• bt - 蓝牙：状态/USB/UART/测试（HCI/L2CAP/RFCOMM/SDP/SPP/HID）

摄像头（UVC）（2）

• uvc - 摄像头子系统状态（UVC 设备、格式、帧）
• uvctest - 摄像头自测（JPEG 解码、UVC 描述符解析、核心）

芯片组（ACPI/PCI/i2c）（16）

• acpi - 转储 ACPI 表（RSDP/FADT/DSDT/MCFG）
• acpidev - 列出 ACPI 命名空间设备（AML）
• acpipow - ACPI 电源状态（S1-S5/SCI/GPE/FACS）
• acpitest - AML 解释器自测 + DSDT 检查
• i2cdetect - 扫描 I2C/SMBus 总线上的设备
• i2cget - 读取 I2C 字节（i2cget <bus> <addr> [reg]）
• i2cset - 写入 I2C 字节（i2cset <bus> <addr> <reg> <val>）
• i2ctest - I2C 核心/控制器自测
• msitest - LAPIC 自 IPI + MSI/MSI-X 设备触发测试
• pcibars - 列出带大小 BAR 的 PCI 设备
• pcidump - 转储 PCI 配置空间（pcidump <b:d.f>）
• pcie - PCIe MMCONFIG 状态 + 能力遍历
• smbus - 从扫描中列出 SMBus 设备
• smbustest - SMBus 协议测试（字节/字/块）
• touchpad - 触摸板状态 + 待处理的手势事件
• touchtest - 多点触控流水线自测（点击/滚动/捏合/滑动）

Shell 核心（内置）（6）

• alias - 设置/显示别名
• export - 设置环境变量（export NAME=value）
• nano - nano 风格编辑器（nano <file>; ^O 保存 ^X 退出）
• set - 列出环境变量
• unalias - 删除别名
• vi - vi 编辑器，双模式（hjkl 移动，i/a/o 插入，ESC，:w :q :wq :q!）

崩溃恢复和转储（3）

• crashlog - 显示最近的异常崩溃
• crashtest - 触发内核崩溃测试（panic/exc/pf/assert/wd/dump/policy）
• dumpinfo - 显示核心转储状态（大小/持久化/头部）

磁盘、分区、文件系统（7）

• fsck - 文件系统检查
• lsblk - 列出块设备
• mkfs.exfat - 格式化 exFAT (mkfs.exfat <dev> confirm)
• mkfs.ext4 - 格式化 ext4 (mkfs.ext4 <dev> confirm)
• mkfs.fat32 - 格式化 FAT32 (mkfs.fat32 <dev> confirm)
• parted - 显示分区表 (parted [dev])
• sync - 刷新磁盘缓存

磁盘/存储测试 (8)

• ahci_test - WP-10a：AHCI 初始化/端口/读写测试
• ata_dma_test - WP-10a：ATA 总线主控 DMA 测试 + PIO 时序
• disk_rw_test - WP-10a：单个设备上的往返读写测试 (disk_rw_test <dev>)
• fs_mount_test - WP-10a：mkfs+mount FAT32 文件往返测试 (fs_mount_test <dev>)
• nvme_test - WP-10a：NVMe 初始化/队列/读写测试
• partition_test - WP-10a：MBR+GPT 解析测试 (partition_test [dev])
• real_hw_test - WP-10a：真实硬件检测报告
• virtio_blk_test - WP-10a：virtio-blk 容量 + 读写测试

文件与编辑器 (18)

• cat - 打印文件内容 (cat <file>)
• cd - 切换目录 (cd [path])
• cp - 复制文件 (cp <src> <dst>)
• df - 显示磁盘/挂载使用情况
• du - 目录使用情况 (du [path])
• edit - 行编辑器 (edit <file>; :i :d :p :w :q :wq)
• grep - 过滤匹配模式的行 (grep <pattern> [file])
• ls - 列出目录 (ls [path])
• mkdir - 创建目录 (mkdir <path>)
• mount - 列出挂载，或挂载文件系统：mount <type> <device> <path>
• mv - 移动/重命名文件 (mv <src> <dst>)
• pwd - 打印当前工作目录
• rm - 删除文件 (rm <file>)
• rmdir - 删除目录 (rmdir <path>)
• touch - 创建空文件 (touch <path>)
• tree - 目录树视图 (tree [path])
• umount - 卸载 (umount <path>)
• write - 向文件写入文本 (write <path> <text>)

健康监控 (3)

• health - 系统健康监控器 (health [watch|export])
• health export - 将健康 JSON 写入 /var/log/health.json
• health watch - 实时健康监控，1 秒刷新 (ENTER 退出)

红外 (2)

• ir - 红外状态 (CIR/SIR 设备、载波、计数器)
• irtest - 红外自检 (NEC/RC5/RC6/SIRC 往返测试)

内核日志 (klog) (3)

• dmesg - 显示内核日志环 (dmesg [N])
• logcat - 过滤内核日志 (logcat -l lvl -m mod -k key -t sec -n N [-f])
• logctl - 控制内核日志 (logctl status|level|enable|disable|clear|flush|rotate|e

网络接口测试 (18)

• bcm57xx - BCM57xx 网卡状态
• bcm57xx_test - WP-10b：BCM57xx 存在性/链路/发送-接收测试
• e1000e - e1000e 网卡状态
• e1000e_test - WP-10b：e1000e 初始化/链路/发送-接收测试
• igb - igb 网卡状态
• igb_test - WP-10b：igb 初始化/链路/发送-接收测试
• ixgbe - ixgbe 网卡状态
• ixgbe_test - WP-10b：ixgbe 存在性/链路/发送-接收测试
• nic_rw_test - WP-10b：所有网卡上的发送/接收正确性测试
• other_nic_test - WP-10b：传统网卡 (3c59x/nForce/AR81xx/Yukon)
• rtl810x - RTL810x 网卡状态
• rtl810x_test - WP-10b：RTL810x 存在性/链路/发送-接收测试
• rtl8125 - RTL8125 网卡状态
• rtl8125_test - WP-10b：RTL8125 存在性/链路/发送-接收测试
• rtl8139 - RTL8139 网卡状态
• rtl8139_test - WP-10b：RTL8139 初始化/链路/发送-接收测试
• rtl8168 - RTL8168 网卡状态
• rtl8168_test - WP-10b：RTL8168 存在性/链路/发送-接收测试

并行端口 (4)

• gameport - 游戏端口状态 (轴、按钮、校准)
• gameporttest - 游戏端口自检 (轴读取、按钮、校准)
• parallel - 并行端口状态 (IEEE 1284 模式、计数器)
• paralleltest - 并行端口自检 (SPP 写入、EPP 周期、ECP 探测)

电源管理测试 (6)

• halt_test - 验证停止路径 (通过 'halt' 进行实时停止)
• help_a_test - 验证 help -a A-Z 排序
• help_default_test - 验证默认 help A-Z 排序
• help_wp_test - 验证 help -w 组排序
• poweroff_test - 真实关机尝试 (QEMU 退出)
• reboot_test - 验证重启路径 (通过 'reboot' 进行实时重启)

SCSI (2)

• scsi - SCSI 状态 (HBAs、目标、容量、块名称)
• scsitest - SCSI 自检 (CDB 金标准、解析器、实时目标)

声音测试 (17)

• ac97 - AC'97 状态
• ac97_test - AC'97 初始化/播放测试
• audio_rw_test - 每个卡上的播放/停止往返测试
• es1370 - ES1370/1371 状态
• es1370_test - ES1370 初始化/播放测试
• hda - Intel HDA 状态
• hda_test - Intel HDA 初始化/编解码器/播放测试
• play - 播放测试音 (play [rate])
• sample_rate_test - 44100/48000 速率配置测试
• sb16 - Sound Blaster 16 状态
• sb16_test - SB16 初始化/播放测试
• sound - 列出已注册的声卡
• usb_audio_test - USB 音频初始化/播放测试
• usbaudio - USB 音频状态
• virtio_snd_test - virtio-snd 初始化/播放测试
• virtiosnd - virtio-snd 状态
• volume - 获取/设置音量 (volume [0-100])

时间源 (4)

• hpet - HPET：功能 + 计数器 + 单次/周期性 IRQ8 测试
• pmtimer - ACPI PM 计时器：读取 + PIT 校准 + 回绕测试
• rtc - CMOS RTC：时间 + 状态 + UIE/PIE/报警中断测试
• tsc - TSC：读取 + PIT/HPET/PMTimer 校准 + 延迟测试

OTA 更新测试 (10)

• ab_partition_test - A/B 磁盘发现 + 槽位 + 标志 (WP-10u)
• real_update_test - 端到端更新阶段 1 (WP-10u)
• update_check_test - 使用包字段更新清单检查 (WP-10u)
• update_download_test - 下载更新包 (WP-10u)
• update_install_test - 将包安装到槽位 B (WP-10u)
• update_local_test - 通过 cmd_update --local 的离线更新流程 (WP-10u)
• update_pkg_test - gzip/DEFLATE + tar 单元测试 (WP-10u)
• update_rollback_test - 启动标志 + 回滚 (WP-10u)
• update_status_test - ota_update_get_status 覆盖 (WP-10u)
• update_verify_test - 包的 SHA256 验证 (WP-10u)

USB 测试 (9)

• usb - USB 主机/设备 + 类驱动状态
• usb_core_test - USB 核心不变性 + 实时传输
• usb_hotplug_test - USB 热插拔 (usb_hotplug_test [wait-new N|wait-leave N])
• usb_hub_test - USB 外部集线器 + 子设备
• usb_kbd_test - USB HID 键盘存在性 + 注入
• usb_mouse_test - USB HID 鼠标存在性 + 事件消耗
• usb_serial_test - USB 串行 TX/RX 往返测试
• usb_storage_test - USB MSC 驱动器容量/读写/分区
• usbdev - USB 设备详情 (usbdev [槽位])

看门狗 (1)

• watchdog - 看门狗状态/控制（硬件 TCO/WDAT + 监控槽位 + 策略测试）

无线 (1)

• wifi - 无线：状态/扫描/测试/SDIO（802.11 系列族 + SDIO 总线）

存储与块设备 (4)

• abcfg - 显示 grub.cfg 文件的 A/B 磁盘/安装写入
• abdisk - 创建可启动的 A/B 更新磁盘（abdisk <dev>; 会销毁数据）
• grub-install - 写入 GRUB BIOS 引导加载器（grub-install <dev>）
• install - 将运行中的系统安装到磁盘（install <dev>; 会销毁数据）

TUI（终端用户界面）(9)

• tui - 全屏 TUI 主菜单（方向键/Tab/Enter/Esc）
• tui-drv - 驱动设置 TUI（tui-hw 的别名；可选页面名称）
• tui-ext - TUI L1 扩展实验室：自检 + 注册表
• tui-hw - 硬件配置 TUI（可选：页面名称）
• tui-net - 无线网络 TUI（WiFi + 蓝牙）
• tui-sys - 系统设置 TUI（主机/网络/存储/用户/安全/更新/日志/TUI）
• tui-sysinfo - 系统信息 TUI（可选：页面名称）
• tui-test - 运行 TUI 自检套件（输入/预期/实际/判定）
• tui-time - 时间 TUI：时钟/源/设置 RTC/时区