Skip to main content
MVH Kernel provides a set of system information and control commands that let you query kernel identity, read the hardware clock, manage shell behaviour, run self-tests, and trigger a clean hardware reboot — all from the mvh> prompt. Two additional commands, faulttest and faulttest page, deliberately halt the kernel so you can validate the exception-handling path.

​
uname

Print the kernel name, hostname, version, and architecture on a single line. Syntax
Example

​
version

Print detailed version information: kernel name, version string, architecture, and binary format. Syntax
Example

​
hostname

Display the system hostname. Syntax
Example

​
whoami

Display the current user identity. MVH Kernel runs entirely in kernel mode, so this always returns root. Syntax
Example

​
about

Display a formatted panel with product name, kernel version, architecture, website, active language, keyboard layout, loaded drivers, and the MIT license notice. Syntax
Example

​
date

Read the current date and time from the CMOS real-time clock (RTC) and display it in YYYY-MM-DD HH:MM:SS UTC format. Syntax
Example

​
uptime

Print how long the system has been running since boot. The output is formatted as days (if non-zero), hours, minutes, and seconds. Syntax
Example

​
ticks

Print the raw PIT tick counter and the timer frequency. The PIT is configured at 100 Hz, so the tick value increments 100 times per second. Syntax
Example

​
echo

Print the supplied text to the shell, followed by a newline. All characters after echo are passed through verbatim. Syntax
Example

​
sleep

Pause shell execution for a given number of milliseconds. The maximum allowed value is 60 000 ms (60 seconds). Syntax
Example
If you supply a value greater than 60 000 or a non-numeric argument, the shell prints Usage: sleep <milliseconds>, maximum 60000.

​
language

Show available shell languages or switch to a different one immediately. All subsequent shell output uses the chosen language. Syntax
Supported codes Example
Running language without an argument lists all available codes and marks the currently active one with [active].

​
clear / cls

Clear the VGA text screen. Both clear and cls produce the same result. After clearing, the shell prints a brief confirmation message and re-displays the mvh> prompt. Syntax

​
reboot

Perform a staged hardware reboot. The sequence locks the shell, stops keyboard input, disables CPU interrupts, prepares the reset controller, and then issues the hardware reset. Each stage is displayed on screen with progress dots and a green [OK] indicator. Syntax
Example

​
selftest

Run the full kernel self-test suite. Each sub-test prints [PASS] or [FAIL] followed by its name. A summary line at the end confirms whether all tests passed. Syntax
Tests included Example

​
synctest

Test the atomic operations, spinlock, and mutex foundations in isolation. This is a subset of what selftest covers, useful for quickly verifying the synchronisation primitives after a change. Syntax
Example

​
faulttest

Trigger a deliberate int3 breakpoint exception to validate the exception-handling path for exceptions that carry no CPU error code. The kernel captures the exception, produces a full register and stack-trace dump on VGA and serial output, and halts. Syntax
Example

​
faulttest page

Trigger a deliberate unmapped-page access at virtual address 0x40000000 to validate page-fault exception handling and verify that the CR2 register (faulting address) is correctly reported in the panic dump. The kernel halts after displaying the dump. Syntax
Example
faulttest and faulttest page intentionally halt the kernel. Running either command ends your session — you will need to reboot to use the shell again. Use these commands only when you want to validate the exception-handling path, verify panic output formatting, or confirm that CR2 is reported correctly on a page fault.