# MVH Cloud

## Docs

- [MVH Kernel: x86_64 Bare-Metal Kernel — Introduction](https://kernel.mvhcloud.com/introduction.md): MVH Kernel is an independent ELF64 kernel for x86_64. Learn what it provides, its capabilities, known limitations, and how documentation is maintained.
- [Get Started: Build and Boot MVH Kernel from Source](https://kernel.mvhcloud.com/quickstart.md): Build and boot MVH Kernel from source in three steps. Requires GCC with x86_64 support, GNU Make, and GNU ld. Output is build/kernel.elf.
- [Building MVH Kernel from Source: Flags and Targets](https://kernel.mvhcloud.com/building.md): Step-by-step guide to compiling MVH Kernel. Covers toolchain requirements, build flags, output artifacts, and the Makefile targets.
- [MVH Kernel Architecture Overview: Layers and Components](https://kernel.mvhcloud.com/concepts/architecture.md): Understand how MVH Kernel is structured: HAL, memory subsystem, VFS, task registry, interrupt layer, device manager, and the interactive shell.
- [MVH Kernel Memory Model: PMM, VMM, Flags, and Heap](https://kernel.mvhcloud.com/concepts/memory-model.md): How MVH Kernel manages physical pages, virtual address mappings, and the kernel heap — including page flags, heap canaries, and security protections.
- [MVH Kernel Boot Requirements: Bootloader Setup Guide](https://kernel.mvhcloud.com/concepts/boot-requirements.md): Bootloader prerequisites for MVH Kernel: 64-bit Long Mode, identity-mapped first GiB of RAM, total memory size in KiB, and the kernel entry point symbol.
- [MVH Kernel Interactive Shell Commands — Complete Reference](https://kernel.mvhcloud.com/shell/overview.md): MVH Kernel includes an interactive shell with 50+ built-in commands. Access filesystem, diagnostics, system info, and more at the mvh> prompt.
- [MVH Kernel Filesystem Shell Commands — Full Reference](https://kernel.mvhcloud.com/shell/filesystem.md): Reference for all filesystem shell commands: ls, cd, pwd, mkdir, touch, write, append, cat, rm, rmdir, mount, and df. Includes usage examples.
- [MVH Kernel Diagnostics Shell Commands — Full Reference](https://kernel.mvhcloud.com/shell/diagnostics.md): Reference for kernel diagnostics commands: meminfo, heapinfo, cpuinfo, features, irqstat, pagetable, dmesg, ps, devices, lspci, statics, and more.
- [MVH Kernel System and Control Shell Commands Reference](https://kernel.mvhcloud.com/shell/system.md): Reference for system info and control commands: uname, date, uptime, echo, sleep, reboot, selftest, synctest, language, and faulttest.
- [MVH Kernel Driver Overview: All 17 Registered Drivers](https://kernel.mvhcloud.com/drivers/overview.md): MVH Kernel ships 17 built-in drivers covering VGA text output, serial UART, PS/2 keyboard, x86 CPU, CMOS RTC, PCI config, and more.
- [MVH Kernel VGA Text Driver: Display and Cursor Output](https://kernel.mvhcloud.com/drivers/vga.md): The VGA text driver gives MVH Kernel an 80×25 display with 16-color support, hardware cursor sync, and automatic scrolling for shell and panic output.
- [Serial UART Driver: 16550 Serial Output in MVH Kernel](https://kernel.mvhcloud.com/drivers/serial.md): MVH Kernel's 16550 UART serial driver mirrors all shell and kernel log output to COM1, making it ideal for QEMU debugging and headless operation.
- [PS/2 Keyboard Driver: Input Handling in MVH Kernel](https://kernel.mvhcloud.com/drivers/keyboard.md): MVH Kernel uses a PS/2 keyboard driver with English US layout, Shift modifier, and Caps Lock. Keyboard input feeds the interactive shell.
- [CPU Driver: x86 CPUID, FPU, MSR, and Thermal in MVH Kernel](https://kernel.mvhcloud.com/drivers/cpu.md): MVH Kernel's CPU drivers handle CPUID detection, FPU/SSE/AVX setup, MSR access, hardware RNG, and Intel DTS or AMD northbridge/SMN temperature readings.
- [MVH Kernel PCI Config and CMOS RTC Driver Reference](https://kernel.mvhcloud.com/drivers/pci-rtc.md): MVH Kernel's PCI driver scans config space and lists devices via lspci. The CMOS RTC driver reads the hardware clock, accessible through the date command.
- [MVH Kernel Release History and Changelog (All Versions)](https://kernel.mvhcloud.com/changelog.md): Full release history for MVH Kernel. Covers versions 1.0, 1.1, 1.1.1, and 1.1.2 with detailed lists of features, fixes, and changes per release.
- [Physical Memory Manager API Reference — MVH Kernel](https://kernel.mvhcloud.com/api/pmm.md): Reference for the MVH Kernel Physical Memory Manager API: pmm_init, pmm_alloc_pages, pmm_free_pages, pmm_get_stats, and pmm_self_test with usage examples.
- [Virtual Memory Manager API — vmm_map_page and Page Flags](https://kernel.mvhcloud.com/api/vmm.md): Reference for the MVH Kernel VMM API: vmm_init, vmm_map_page, vmm_unmap_page, vmm_query_page, vmm_mapped_pages. Covers all VMM_* page flag constants.
- [Kernel Heap API — kmalloc, kfree, and Heap Statistics](https://kernel.mvhcloud.com/api/heap.md): Reference for the MVH Kernel heap API: heap_init, kmalloc, kfree, heap_get_stats, heap_validate, and heap_self_test with canary protection.
- [VFS API — Virtual Filesystem Interface in MVH Kernel](https://kernel.mvhcloud.com/api/vfs.md): Reference for the MVH Kernel VFS API: vfs_init, vfs_chdir, vfs_pwd, vfs_list, vfs_mkdir, vfs_touch, vfs_write, vfs_read, vfs_remove. The VFS root is RAMFS.
- [RAMFS Filesystem API — Low-Level FS Functions in MVH Kernel](https://kernel.mvhcloud.com/api/fs.md): Reference for the MVH Kernel RAMFS API: fs_init, fs_chdir, fs_pwd, fs_list, fs_mkdir, fs_touch, fs_write, fs_read, fs_remove. Prefer vfs_* for general use.
- [HAL API — Hardware Abstraction Layer in MVH Kernel](https://kernel.mvhcloud.com/api/hal.md): MVH Kernel HAL: hal_init, hal_keyboard_read, hal_clock_read, hal_pci_scan, hal_ticks, hal_uptime_seconds, hal_timer_frequency, hal_sleep_ms, hal_reboot.
- [CPU API — CPUID, Capabilities, Security State, and RNG](https://kernel.mvhcloud.com/api/cpu.md): Reference for the MVH Kernel CPU API: cpu_get_info, cpu_get_capabilities, cpu_get_security_state, cpu_read_tsc, cpu_random64, cpu_rdmsr, cpu_wrmsr.
- [Interrupt API — IDT, PIC, and IRQ Statistics in MVH Kernel](https://kernel.mvhcloud.com/api/interrupt.md): MVH Kernel interrupt API: interrupt_init, interrupt_enable, interrupt_disable, exception_dispatch, interrupt_count, interrupt_total, and spurious count.
- [Device Manager API — Hardware Devices in MVH Kernel](https://kernel.mvhcloud.com/api/device.md): MVH Kernel device manager reference: device_manager_init, device_register, device_list, device_count, and device_type_name. Supports up to 32 devices.
- [MVH Kernel Task Registry — PID and Execution State](https://kernel.mvhcloud.com/api/task.md): Reference for the MVH Kernel task registry: task_init, task_count, task_list, and task_state_name. Tracks up to 16 tasks by PID, priority, and state.
- [Kernel Log API — Ring Buffer Logging in MVH Kernel](https://kernel.mvhcloud.com/api/log.md): Reference for the MVH Kernel log API: klog_init, klog_write, klog_write_category, klog_set_console, klog_copy, and klog_size for ring buffer logging.
- [Kernel Panic API — MVH Kernel Halt and Diagnostics](https://kernel.mvhcloud.com/api/panic.md): Reference for the MVH Kernel panic API: kernel_panic, kernel_panic_exception, and exception_frame_t. Both panic functions are noreturn and halt the system.