Skip to content
This repository has been archived by the owner on Jul 11, 2024. It is now read-only.

Commit

Permalink
Added usage with screenshots
Browse files Browse the repository at this point in the history
  • Loading branch information
memN0ps committed Jun 26, 2024
1 parent 6d707a9 commit 554dd4a
Show file tree
Hide file tree
Showing 5 changed files with 33 additions and 0 deletions.
33 changes: 33 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,39 @@ sc.exe query matrix
sc.exe start matrix
```

## Usage

1. **Setup for VMware Workstation**
- Build the Project: Follow the build instructions provided in the previous sections to compile the project.

2. **Set Up VMware Workstation**
- Configure the VMware serial port for debugging.

![VMware Serial Port Settings](./images/vmware_serial.png)
**Figure 1: VMware Serial Port Settings**

- Ensure that `"Virtualize Intel VT-x/EPT or AMD-V/RVI"` is enabled and `"Virtualize IOMMU (IO memory management unit)"` is enabled.

![VMware Processors Settings](./images/vmware_processors.png)
**Figure 2: VMware Processors Settings**

3. **Copy the Driver**
- Copy the `matrix.sys` driver to the `C:\Windows\System32\drivers` directory.

4. **VMware Serial Port Debugging**
- Execute the PowerShell script in the Serial Port Debugging section to open the serial port.

5. **Load the Hypervisor**
- Use the `load.ps1` PowerShell script shown in the Service Management section to create and start the hypervisor service.

![Load Hypervisor](./images/hypervisor_load.png)
**Figure 3: Load Hypervisor**

### PoC

![Hypervisor PoC](./images/hypervisor_poc.png)
**Figure 4: Logs and Windbg PoC**

## Acknowledgments, References, and Motivation

Big thanks to the amazing people and resources that have shaped this project. A special shout-out to everyone listed below. While I didn't use all these resources in my work, they've been goldmines of information, super helpful for anyone diving into hypervisor development, including me.
Expand Down
Binary file added images/hypervisor_load.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/hypervisor_poc.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/vmware_processors.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/vmware_serial.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 554dd4a

Please sign in to comment.