Skip to content

Command Reference EN

Jump to bottom
Z User edited this page Oct 23, 2026 · 1 revision

Language: English ｜ Command-Reference

Shell command reference (233 commands)

Grouped by the source file that registers each command - the tree structure is the domain structure. Inside a running system use help -a (alphabetical) or help -w (by work package).

Chinese console layer (8)

  • chinese - chinese support status (font/encoding/render/ime)
  • chinesetest - run the full Chinese support regression suite
  • encoding - encoding codec status (gb2312/utf-8/ascii)
  • encoding-test - quick codec round-trip check (full: chinesetest)
  • font - list registered fonts and the active renderer
  • font-test - render a mixed CJK/ASCII sample row on the console
  • ime - pinyin IME status; "ime -i" opens the interactive console line
  • ime-test - quick IME syllable resolution check

Kernel core commands (55)

  • ahci - AHCI controller/port status
  • ata - ATA (PIO + Bus-Master DMA) status
  • checkupdate - check for updates via /etc/opencube.conf (http/https)
  • checkupdate_test - update check self-test (URL/JSON units + live probe)
  • clear - clear screen
  • config - read/write system config (config list|get|set|restore|path)
  • config_test - config subsystem self-test (write/read/get_all/delete/restore)
  • cr3test - test CR3 switching
  • cryptotest - test AES/SHA-256/HMAC with NIST vectors
  • dhtest - DH modexp 1024-bit (Oakley Group 1) timing + correctness
  • dskstat - show block devices
  • echo - echo the text back
  • exc - run exception self-test (#DE/#UD/#PF)
  • fatmount - mount FAT32 (fatmount <dev> <path>)
  • fatstat - show FAT32 stats
  • frag - show memory fragmentation
  • fstest - run VFS self-test (mkdir/write/read/ls)
  • halt - halt the kernel
  • heap - show kernel heap stats
  • heapbounds - heap bounds regression (BUG-0140 wrap / BUG-0141 ceiling)
  • heaptest - test heap overhead with 100 allocs
  • help - show this message
  • irqabitest - IRQ-entry ABI regression (BUG-0137 align / BUG-0138 DF)
  • kill - kill a task (kill <tid>)
  • l1test - test L1 job_create/job_list/job_control with running process
  • lang - show or set the shell output language (lang [en|zh])
  • ldd - list dynamic dependencies (ldd <program>)
  • mem - show physical memory stats
  • memtest - run memory test (PMM + heap)
  • mounts - list VFS mount table (alias for mount)
  • multi - spawn 3 tasks with interleaved output
  • nice - change priority (nice <tid> <prio>)
  • nvme - NVMe controller/queue status
  • pftest - test page fault handling
  • pmmrace - BUG-0043 repro: PMM bitmap race thread-vs-IRQ
  • poweroff - alias of shutdown
  • ps - list all tasks
  • reboot - reboot the machine (reboot)
  • rollback - roll back to slot A (rollback)
  • run - run a user program (hello/badapp/loop/fork_test/.../dyn_test/so_test/dyn_hello/
  • sched - show scheduler stats
  • shutdown - power off (flush + ACPI/Bochs/APM ports)
  • sleep - delay for N seconds (sleep <sec>)
  • spawn - spawn a test kernel thread
  • ssh - SSH client connect (ssh <ip> [port] [user] [password])
  • sshd - SSH server (sshd [port=22] [user=oc] [password=oc])
  • stats - show interrupt/timer stats
  • syncstat - show sync primitive stats
  • synctest - test sync primitives (spinlock/mutex/sem)
  • timer - register a 500ms one-shot timer
  • uname - print OS name (uname [-a|-s|-r|-m])
  • update - check + install system update (update [local <pkg> | --local <pkg> | --status])
  • vmkernelpt - VMM PT-ownership regression (BUG-0136)
  • vmmap - show address space mappings
  • vmtest - run virtual memory test

Networking (16)

  • arp - show ARP cache
  • dhcp - get IP via DHCP
  • dns - resolve domain name (dns <name> [aaaa|cname|mx|txt|ns|srv])
  • dnstest - DNS record-type self-test (A/AAAA/MX/TXT/NS/SRV live)
  • firewall - show/add/del firewall rules (chains, states, policies, conntrack)
  • ifconfig - show network interface info
  • ip - show/set IP address
  • lspci - list PCI devices
  • netstat - show network statistics and sockets
  • nf_test - netfilter self-test (rules, conntrack, policies, real-path)
  • ping - send ICMP echo (ping <host>)
  • route - show/add/del routing table (route add <dst> <mask> <gw>)
  • tcpcc_test - CUBIC congestion control self-test vectors
  • tcpstats - show TCP reliability stats (cwnd, rto, etc.)
  • tcptest - TCP option negotiation self-test (MSS/WScale/SACK/TS live)
  • wget - download file via HTTP (wget <host> [port] [path])

Bluetooth (1)

  • bt - bluetooth: status/usb/uart/test (HCI/L2CAP/RFCOMM/SDP/SPP/HID)

Cameras (UVC) (2)

  • uvc - camera subsystem status (UVC devices, formats, frames)
  • uvctest - camera self test (JPEG decode, UVC descriptor parse, core)

Chipset (ACPI/PCI/i2c) (16)

  • acpi - dump ACPI tables (RSDP/FADT/DSDT/MCFG)
  • acpidev - list ACPI namespace devices (AML)
  • acpipow - ACPI power status (S1-S5/SCI/GPE/FACS)
  • acpitest - AML interpreter self-test + DSDT checks
  • i2cdetect - scan I2C/SMBus buses for devices
  • i2cget - read I2C byte (i2cget <bus> <addr> [reg])
  • i2cset - write I2C byte (i2cset <bus> <addr> <reg> <val>)
  • i2ctest - I2C core/controller self-test
  • msitest - LAPIC self-IPI + MSI/MSI-X device fire test
  • pcibars - list PCI devices with sized BARs
  • pcidump - dump PCI config space (pcidump <b:d.f>)
  • pcie - PCIe MMCONFIG state + capability walk
  • smbus - list SMBus devices from the scan
  • smbustest - SMBus protocol test (byte/word/block)
  • touchpad - touchpad status + pending gesture events
  • touchtest - multitouch pipeline self-test (tap/scroll/pinch/swipe)

Shell core (built-ins) (6)

  • alias - set/show aliases
  • export - set env var (export NAME=value)
  • nano - nano-style editor (nano <file>; ^O save ^X exit)
  • set - list env vars
  • unalias - remove an alias
  • vi - vi editor, two-mode (hjkl move, i/a/o insert, ESC, :w :q :wq :q!)

Crash recovery and dumps (3)

  • crashlog - show last exception crashes
  • crashtest - trigger kernel crash tests (panic/exc/pf/assert/wd/dump/policy)
  • dumpinfo - show core dump status (size/persisted/header)

Disks, partitions, filesystems (7)

  • fsck - filesystem check
  • lsblk - list block devices
  • mkfs.exfat - format exFAT (mkfs.exfat <dev> confirm)
  • mkfs.ext4 - format ext4 (mkfs.ext4 <dev> confirm)
  • mkfs.fat32 - format FAT32 (mkfs.fat32 <dev> confirm)
  • parted - show partition table (parted [dev])
  • sync - flush disk cache

Disk/storage tests (8)

  • ahci_test - WP-10a: AHCI init/ports/read-write test
  • ata_dma_test - WP-10a: ATA Bus-Master DMA test + PIO timing
  • disk_rw_test - WP-10a: rw round-trip on one device (disk_rw_test <dev>)
  • fs_mount_test - WP-10a: mkfs+mount FAT32 file round-trip (fs_mount_test <dev>)
  • nvme_test - WP-10a: NVMe init/queues/read-write test
  • partition_test - WP-10a: MBR+GPT parse test (partition_test [dev])
  • real_hw_test - WP-10a: real-hardware detection report
  • virtio_blk_test - WP-10a: virtio-blk capacity + read/write test

Files and the editor (18)

  • cat - print file contents (cat <file>)
  • cd - change directory (cd [path])
  • cp - copy file (cp <src> <dst>)
  • df - show disk/mount usage
  • du - directory usage (du [path])
  • edit - line editor (edit <file>; :i :d :p :w :q :wq)
  • grep - filter lines matching pattern (grep <pattern> [file])
  • ls - list directory (ls [path])
  • mkdir - make directory (mkdir <path>)
  • mount - list mounts, or mount a fs: mount <type> <device> <path>
  • mv - move/rename file (mv <src> <dst>)
  • pwd - print working directory
  • rm - delete file (rm <file>)
  • rmdir - remove directory (rmdir <path>)
  • touch - create empty file (touch <path>)
  • tree - tree view of directory (tree [path])
  • umount - unmount (umount <path>)
  • write - write text to file (write <path> <text>)

Health monitoring (3)

  • health - system health monitor (health [watch|export])
  • health export - write health JSON to /var/log/health.json
  • health watch - live health monitor, 1 s refresh (ENTER exits)

Infrared (2)

  • ir - infrared status (CIR/SIR devices, carrier, counters)
  • irtest - infrared self test (NEC/RC5/RC6/SIRC round trips)

Kernel log (klog) (3)

  • dmesg - show the kernel log ring (dmesg [N])
  • logcat - filter the kernel log (logcat -l lvl -m mod -k key -t sec -n N [-f])
  • logctl - control the kernel log (logctl status|level|enable|disable|clear|flush|rotate|e

Network interface tests (18)

  • bcm57xx - BCM57xx NIC status
  • bcm57xx_test - WP-10b: BCM57xx presence/link/send-recv test
  • e1000e - e1000e NIC status
  • e1000e_test - WP-10b: e1000e init/link/send-recv test
  • igb - igb NIC status
  • igb_test - WP-10b: igb init/link/send-recv test
  • ixgbe - ixgbe NIC status
  • ixgbe_test - WP-10b: ixgbe presence/link/send-recv test
  • nic_rw_test - WP-10b: send/recv correctness on all NICs
  • other_nic_test - WP-10b: legacy NICs (3c59x/nForce/AR81xx/Yukon)
  • rtl810x - RTL810x NIC status
  • rtl810x_test - WP-10b: RTL810x presence/link/send-recv test
  • rtl8125 - RTL8125 NIC status
  • rtl8125_test - WP-10b: RTL8125 presence/link/send-recv test
  • rtl8139 - RTL8139 NIC status
  • rtl8139_test - WP-10b: RTL8139 init/link/send-recv test
  • rtl8168 - RTL8168 NIC status
  • rtl8168_test - WP-10b: RTL8168 presence/link/send-recv test

Parallel port (4)

  • gameport - game port status (axes, buttons, calibration)
  • gameporttest - game port self test (axis reads, buttons, calibration)
  • parallel - parallel port status (IEEE 1284 modes, counters)
  • paralleltest - parallel self test (SPP write, EPP cycles, ECP probe)

Power management tests (6)

  • halt_test - verify halt path (live halt via 'halt')
  • help_a_test - verify help -a A-Z ordering
  • help_default_test - verify default help A-Z ordering
  • help_wp_test - verify help -w group ordering
  • poweroff_test - real power-off attempt (QEMU exits)
  • reboot_test - verify reboot path (live reset via 'reboot')

SCSI (2)

  • scsi - SCSI status (HBAs, targets, capacity, blk names)
  • scsitest - SCSI self test (CDB goldens, parsers, live target)

Sound tests (17)

  • ac97 - AC'97 status
  • ac97_test - AC'97 init/play test
  • audio_rw_test - play/stop round-trip on every card
  • es1370 - ES1370/1371 status
  • es1370_test - ES1370 init/play test
  • hda - Intel HDA status
  • hda_test - Intel HDA init/codec/play test
  • play - play a test tone (play [rate])
  • sample_rate_test - 44100/48000 rate configuration test
  • sb16 - Sound Blaster 16 status
  • sb16_test - SB16 init/play test
  • sound - list registered sound cards
  • usb_audio_test - USB audio init/play test
  • usbaudio - USB audio status
  • virtio_snd_test - virtio-snd init/play test
  • virtiosnd - virtio-snd status
  • volume - get/set volume (volume [0-100])

Time sources (4)

  • hpet - HPET: caps + counter + one-shot/periodic IRQ8 tests
  • pmtimer - ACPI PM timer: read + PIT calibration + wrap tests
  • rtc - CMOS RTC: time + status + UIE/PIE/alarm interrupt tests
  • tsc - TSC: reads + PIT/HPET/PMTimer calibration + delay test

OTA update tests (10)

  • ab_partition_test - A/B disk discovery + slots + flags (WP-10u)
  • real_update_test - end-to-end update phase 1 (WP-10u)
  • update_check_test - update manifest check with package fields (WP-10u)
  • update_download_test - download the update package (WP-10u)
  • update_install_test - install the package into slot B (WP-10u)
  • update_local_test - offline update flow via cmd_update --local (WP-10u)
  • update_pkg_test - gzip/DEFLATE + tar unit tests (WP-10u)
  • update_rollback_test - boot flags + rollback (WP-10u)
  • update_status_test - ota_update_get_status coverage (WP-10u)
  • update_verify_test - SHA256 verification of the package (WP-10u)

USB tests (9)

  • usb - USB hosts/devices + class driver status
  • usb_core_test - USB core invariants + live transfers
  • usb_hotplug_test - USB hot-plug (usb_hotplug_test [wait-new N|wait-leave N])
  • usb_hub_test - USB external hub + children
  • usb_kbd_test - USB HID keyboard presence + injection
  • usb_mouse_test - USB HID mouse presence + event drain
  • usb_serial_test - USB serial TX/RX round
  • usb_storage_test - USB MSC drive capacity/rw/partitions
  • usbdev - USB device detail (usbdev [slot])

Watchdog (1)

  • watchdog - watchdog status/control (hw TCO/WDAT + monitored slots + policy tests)

Wireless (1)

  • wifi - wireless: status/scan/test/sdio (802.11 families + SDIO bus)

Storage and block devices (4)

  • abcfg - show the grub.cfg files abdisk/install write
  • abdisk - create a bootable A/B update disk (abdisk <dev>; destroys data)
  • grub-install - write the GRUB BIOS boot loader (grub-install <dev>)
  • install - install the running system to a disk (install <dev>; destroys data)

TUI (terminal UI) (9)

  • tui - full-screen TUI main menu (arrows/Tab/Enter/Esc)
  • tui-drv - driver setup TUI (alias of tui-hw; page name optional)
  • tui-ext - TUI L1 extension lab: selftest + registries
  • tui-hw - hardware configuration TUI (optional: page name)
  • tui-net - wireless network TUI (WiFi + Bluetooth)
  • tui-sys - system settings TUI (host/net/storage/user/security/update/log/tui)
  • tui-sysinfo - system information TUI (optional: page name)
  • tui-test - run the TUI self-test suite (input/expected/actual/verdict)
  • tui-time - time TUI: clock/sources/set RTC/timezone

Clone this wiki locally