Skip to main content
MVH Kernel exposes a rich set of diagnostics commands that give you direct visibility into the physical memory allocator, the kernel heap, CPU capabilities, interrupt counters, page-table state, and the structured kernel log. You can run every command at the mvh> prompt without any arguments unless documented otherwise.

​
meminfo

Print a detailed breakdown of physical memory from the PMM (Physical Memory Manager), including page-level counters and allocator statistics. Syntax
Output includes
  • MemTotal / MemUsed / MemAvailable — physical memory in KiB
  • Reserved — pages reserved by the kernel image and hardware
  • HeapTotal / HeapUsed — kernel heap in KiB
  • PageAlloc / PageFree — total page allocation and free request counts
  • PageFailures — count of failed page allocation attempts
  • PagePeak — peak number of pages in use simultaneously
  • MappedPages — current VMM-mapped page count
Example

​
free

Print a concise one-line memory summary covering both physical pages and heap allocations. Syntax
Example

​
heapinfo

Print extended kernel heap statistics, including fragmentation information and error counters introduced in v1.1.2. Syntax
Output includes Example

​
heaptest

Run the built-in heap allocator self-test. The test performs a series of allocations, writes, reads, and frees to verify that the allocator is functioning correctly. Syntax
Example

​
cpuinfo

Display extended CPU diagnostics. This command combines the CPU panel from statics with additional low-level fields added in v1.1.2, including TSC frequency, XSAVE area size, microcode version, and a hardware-RNG sample. Syntax
Output includes
CPU temperature reading requires Intel Digital Thermal Sensor MSRs, AMD Family 10h–16h northbridge Tctl, or AMD Family 17h–1Ah SMN Tctl. QEMU does not expose a usable thermal sensor, so the field reports not available from this CPU/platform in emulated environments.
Example

​
features

List every CPUID capability flag and the active kernel protection settings. Each line shows [yes] or [ no] next to the feature name and a short description. Syntax
Reported flags CPU hardware features: FPU, TSC, MSR, APIC, MMX, SSE, SSE2, SSE3, SSSE3, SSE4.1, SSE4.2, AES, AVX, AVX2, AVX-512F, XSAVE, RDRAND, RDSEED, x2APIC, PAT, MTRR, NX, LONG MODE. Kernel protection summary line reports: WP (supervisor write-protect), NX, SMEP, SMAP, UMIP. Example

​
irqstat

Print per-vector interrupt statistics. Counters are read atomically with interrupts briefly disabled to avoid a torn read. Syntax
Output includes Example

​
pagetable

Query the VMM page table for a set of key virtual addresses and display their physical address mappings and page flags. The addresses probed are: 0x0 (null guard, expected unmapped), 0x1000, the kernel end address, and the page-aligned kernel end address. Syntax
Example
The null page at VA 0x0 is unmapped by design — accessing it generates a page fault, which is captured by the exception handler.

​
pagetest

Run the VMM (Virtual Memory Manager) self-test. The test exercises dynamic 4 KiB page mapping, unmapping, and lookup, and verifies that the null-page guard is correctly enforced. Syntax
Example

​
dmesg

Dump the kernel log ring buffer. The ring holds up to 16 KiB of structured, timestamped entries written by the kernel during boot and operation. Each entry includes a log level (INFO, WARN, ERROR) and an optional category tag. Syntax
Example

​
ps

List all registered kernel tasks. Each row shows the PID, priority, execution state, task name, and the PIT tick at which the task was created. Syntax
Task states: UNUSED, RUNNING, READY, SLEEPING, STOPPED. Example

​
devices

List all devices registered in the kernel device registry, showing the device ID, type, name, and online/offline status. Syntax
Example

​
lspci

Scan the PCI configuration space and list every discovered device with its bus/slot/function address, vendor and device IDs, and a class name. Syntax
Example
If no PCI devices are found, the shell prints No PCI devices found.

​
drivers

List all drivers compiled into the kernel and their responsibilities. Syntax
Example

​
statics

Open the full-screen live system monitor. The monitor displays a RAM usage bar with used/free/total figures in MiB, and a per-core CPU status panel listing each logical processor’s execution state. Press Q or Ctrl+C to exit and return to the mvh> prompt. Syntax
Use statics to get a quick overview of memory pressure and CPU topology. The panel shows actual execution state rather than simulated usage bars, so the values are accurate.

​
paniccodes

List all stable kernel panic codes and their meanings. These codes appear in the top line of a kernel panic dump on both VGA and the serial console, making them easy to identify in crash logs. Syntax
Example
A crash dump includes the panic code, the exception vector, decoded hardware error-code flags, control registers (CR0–CR4), all general-purpose registers (RAX–R15, RIP, RFLAGS), and a bounded frame-pointer stack trace.