update terminology used in code

Author: UriHerrera

README.md

@@ -4,15 +4,23 @@
 
 # Introduction
 
-VxM (pronounced as its individual letters) is a specialized hypervisor orchestrator for **Nitrux**. It transforms a multi-GPU workstation into a "Twin Engine" system, allowing you to run Linux (Host) and Windows (Guest) simultaneously on separate GPUs with near-native performance.
+VxM is a hypervisor orchestration utility for Nitrux, engineered to enable concurrent, hardware-accelerated guest execution on multi-GPU workstations. Leveraging VFIO PCI passthrough, it enforces IOMMU isolation to dedicate discrete graphics resources to guest domains.
 
-Unlike traditional virtual machines that emulate graphics or use translation layers, VxM uses **VFIO Passthrough** to give the Guest OS complete, exclusive control over your secondary GPU.
+This architecture circumvents virtualization overhead and emulation layers, granting the guest OS direct hardware control for bare-metal performance characteristics within Nitrux’s immutable infrastructure.
 
 ## Features
 
-* Zero graphics virtualization.
-* Instantly toggle your keyboard and mouse without hardware switches.
-* Dynamically unbinds your dGPU from the host kernel and attaches it to the VM on demand.
+- **Evdev Input Arbitration**: Implements zero-latency input-linux passthrough with grab_all=on and ctrl-ctrl interrupt handling.
+
+- **Dynamic VFIO Binding**: Runtime driver override to vfio-pci with automatic host rebinding, BDF normalization, and IOMMU group validation.
+
+- **DDC/CI Automation**: Writes VCP 0x60 commands to the monitor bus to trigger input source switching on VM state changes.
+
+- **Latency Optimization**: Auto-provisions hugepages and initializes IVSHMEM (/dev/shm/looking-glass) for low-latency frame relay.
+
+- **Firmware/TPM Lifecycle**: Heuristic detection for matching OVMF CODE/VARS pairs and managed swtpm socket execution for guest OS compatibility.
+
+- **Rootless Model**: Unprivileged QEMU execution with privileged pre-flight hardware preparation.
 
 ## System Requirements
 
@@ -23,14 +31,14 @@ Unlike traditional virtual machines that emulate graphics or use translation lay
     * **Required:** Two separate GPUs (e.g., Integrated AMD/Intel + Discrete Radeon/Nvidia).
 
 > [!WARNING]
-> VxM doesn't support Single-GPU setups.
+> VxM doesn't support single-GPU setups.
 
 * **Motherboard:**
     * IOMMU (VT-d / AMD-Vi) enabled in BIOS.
     * UEFI Boot enabled.
 
 * **Display:**
-    * A monitor with two inputs (e.g., DP for Linux, HDMI for Windows) OR two separate monitors.
+    * A monitor with two inputs (e.g., DP for host OS, HDMI for guest OS) OR two separate monitors.
 
 # Licensing
 
@@ -44,4 +52,4 @@ If you find problems with the contents of this repository, please create an issu
 
 Before submitting a bug, you should look at the [existing bug reports](https://github.com/Nitrux/vxm/issues) to verify that no one has reported the bug already.
 
-©2026 Nitrux Latinoamericana S.C.
+©2026 Nitrux Latinoamericana S.C.

src/Config.h

@@ -24,8 +24,8 @@ namespace Config
     const std::filesystem::path RomsDir = VxmDir / "roms";
 
     // Files
-    const std::filesystem::path WindowsImage = ImageDir / "win.img";
-    const std::filesystem::path WindowsIso = IsoDir / "win_install.iso";
+    const std::filesystem::path GuestImage = ImageDir / "guest.img";
+    const std::filesystem::path GuestIso = IsoDir / "guest_install.iso";
     const std::filesystem::path VirtioIso = IsoDir / "virtio_drivers.iso";
 
     // OVMF Firmware Paths - Multiple possible locations

src/ProfileManager.h

@@ -30,8 +30,8 @@ struct Profile
     // DDC/CI monitor switching
     bool ddcEnabled = false;           // Enable DDC/CI monitor switching
     std::string ddcMonitor;            // Monitor identifier (e.g., "DP-1", "HDMI-1")
-    uint8_t ddcHostInput = 0x0F;       // Input source for Linux (default: DP-1)
-    uint8_t ddcGuestInput = 0x11;      // Input source for Windows (default: HDMI-1)
+    uint8_t ddcHostInput = 0x0F;       // Input source for host OS (default: DP-1)
+    uint8_t ddcGuestInput = 0x11;      // Input source for guest OS (default: HDMI-1)
 };
 
 class ProfileManager

src/VirtualMachine.cpp

@@ -222,9 +222,9 @@ bool VirtualMachine::checkRequirements() const
     std::cout << "[VxM] Found OVMF CODE: " << Config::OvmfCodePath << std::endl;
     std::cout << "[VxM] Found OVMF VARS: " << Config::OvmfVarsTemplatePath << std::endl;
 
-    // 2. Check Windows ISO
-    if (!fs::exists(Config::WindowsIso)) {
-        std::cerr << "[Error] Windows ISO not found at: " << Config::WindowsIso << std::endl;
+    // 2. Check Guest OS ISO
+    if (!fs::exists(Config::GuestIso)) {
+        std::cerr << "[Error] Guest OS ISO not found at: " << Config::GuestIso << std::endl;
         return false;
     }
 
@@ -589,7 +589,7 @@ void VirtualMachine::initializeCrate()
     fs::create_directories(Config::TpmStateDir);
 
     // Create C: Drive using fork/exec to avoid command injection
-    if (!fs::exists(Config::WindowsImage)) {
+    if (!fs::exists(Config::GuestImage)) {
         std::cout << "[VxM] Creating C: Drive (" << Config::DiskSizeGb << "GB)..." << std::endl;
 
         pid_t pid = fork();
@@ -600,7 +600,7 @@ void VirtualMachine::initializeCrate()
             std::string sizeArg = std::to_string(Config::DiskSizeGb) + "G";
             execlp("qemu-img", "qemu-img", "create", "-f", "raw",
                    "-o", "preallocation=full",
-                   Config::WindowsImage.string().c_str(),
+                   Config::GuestImage.string().c_str(),
                    sizeArg.c_str(), nullptr);
             // If execlp returns, it failed
             std::cerr << "[Error] Failed to execute qemu-img" << std::endl;
@@ -612,7 +612,7 @@ void VirtualMachine::initializeCrate()
             if (!WIFEXITED(status) || WEXITSTATUS(status) != 0) {
                 throw std::runtime_error("Failed to create disk image.");
             }
-            fixFileOwnership(Config::WindowsImage);
+            fixFileOwnership(Config::GuestImage);
         }
     }
 
@@ -662,20 +662,19 @@ void VirtualMachine::initializeCrate()
         }
     }
 
-    // Check for Windows ISO and provide guidance
-    if (!fs::exists(Config::WindowsIso)) {
-        std::cout << "\n[VxM] Windows ISO not found." << std::endl;
-        std::cout << "      Please obtain a Windows installation ISO and place it at:" << std::endl;
-        std::cout << "      " << Config::WindowsIso << std::endl;
-        std::cout << "\n      You can download Windows 11 from:" << std::endl;
-        std::cout << "      https://www.microsoft.com/software-download/windows11" << std::endl;
-        std::cout << "\n      For Windows 10:" << std::endl;
-        std::cout << "      https://www.microsoft.com/software-download/windows10ISO" << std::endl;
-        
-        std::cout << "\n      [Tip] For better VM performance, consider using a playbook to" << std::endl;
-        std::cout << "            debloat Windows, such as:" << std::endl;
-        std::cout << "            - AtlasOS: https://atlasos.net" << std::endl;
-        std::cout << "            - ReviOS:  https://revi.cc" << std::endl;
+    // Check for Guest OS ISO and provide guidance
+    if (!fs::exists(Config::GuestIso)) {
+        std::cout << "\n[VxM] Guest OS ISO not found." << std::endl;
+        std::cout << "      Please obtain an installation ISO and place it at:" << std::endl;
+        std::cout << "      " << Config::GuestIso << std::endl;
+        std::cout << "\n      For a guest OS, you can use:" << std::endl;
+        std::cout << "      - Windows 11: https://www.microsoft.com/software-download/windows11" << std::endl;
+        std::cout << "      - Windows 10: https://www.microsoft.com/software-download/windows10ISO" << std::endl;
+        std::cout << "      - Or any other OS that supports UEFI boot" << std::endl;
+
+        std::cout << "\n      [Tip] For better VM performance, consider optimized OS variants:" << std::endl;
+        std::cout << "            - AtlasOS: https://atlasos.net (Windows-based)" << std::endl;
+        std::cout << "            - ReviOS:  https://revi.cc (Windows-based)" << std::endl;
     }
 
     // Provide guidance about GPU ROM files for reset bug
@@ -925,10 +924,10 @@ void VirtualMachine::start()
         std::cerr << "[Warning] No input devices found. You will have no control over the VM!" << std::endl;
     }
 
-    // 4. Start TPM 2.0 emulator for Windows 11 compatibility
+    // 4. Start TPM 2.0 emulator for guest OS compatibility
     m_tpmPid = startTpmEmulator();
     if (m_tpmPid < 0) {
-        std::cerr << "[Warning] Failed to start TPM emulator. Windows 11 may not install." << std::endl;
+        std::cerr << "[Warning] Failed to start TPM emulator. Some guest OSes may require TPM support." << std::endl;
     }
 
     // STATE PERSISTENCE:
@@ -1000,12 +999,12 @@ void VirtualMachine::start()
 
     // Disk (using virtio-blk, no SCSI controller needed)
     args.push_back("-drive");
-    args.push_back("if=none,id=disk0,cache=none,format=raw,aio=native,file=" + Config::WindowsImage.string());
+    args.push_back("if=none,id=disk0,cache=none,format=raw,aio=native,file=" + Config::GuestImage.string());
     args.push_back("-device"); args.push_back("virtio-blk-pci,drive=disk0");
 
     // ISOs
     args.push_back("-drive");
-    args.push_back("file=" + Config::WindowsIso.string() + ",media=cdrom,index=0");
+    args.push_back("file=" + Config::GuestIso.string() + ",media=cdrom,index=0");
     args.push_back("-drive");
     args.push_back("file=" + Config::VirtioIso.string() + ",media=cdrom,index=1");