admin/MiniVisorPkg
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Fix markdown style errors

Browse Source
This commit is contained in:
Satoshi Tanda
2020-02-25 16:48:01 -08:00
parent cb07599011
commit 3245a658a7
2 changed files with 33 additions and 58 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
README.md
View File

@@ -7,19 +7,17 @@ This is a research hypervisor written as a UEFI and Windows driver for the educa
This MiniVisor, as a UEFI driver, provides the ability to inspect system activities even before the operating system boots, while as a Windows driver, allows developers to debug it with familiar tools like WinDbg.
Showcase
---------
* Loading the hypervisor from the UEFI shell.
![Readme_Showcase1.jpg](Docs/Resources/Readme_Showcase1.jpg)
![Readme_Showcase1.jpg](Docs/Resources/Readme_Showcase1.jpg)
* Logging boot activities and interacting with the guest.
![Readme_Showcase2.jpg](Docs/Resources/Readme_Showcase2.jpg)
![Readme_Showcase2.jpg](Docs/Resources/Readme_Showcase2.jpg)
* Booting Ubuntu on a bare-metal.
![Readme_Showcase3.jpg](Docs/Resources/Readme_Showcase3.jpg)
![Readme_Showcase3.jpg](Docs/Resources/Readme_Showcase3.jpg)
Motivation
-----------
@@ -30,27 +28,25 @@ There are numerous open source hypervisors with small and easy-to-study implemen
Given the universality of UEFI systems on the AMD64 ecosystem and the unique ability to monitor, attack and protect the system throughout operating system startup on bare-metal systems, the authors believe that having the understanding and being able to develop this type of hypervisors are valuable for research.
System Requirements
--------------------
Common Requirements:
- Intel VT-x and EPT supported processors
* Intel VT-x and EPT supported processors
Requirements for the UEFI driver:
- UEFI-based system
- 64bit Windows 10, IoT Core, or Ubuntu to boot
* UEFI-based system
* 64bit Windows 10, IoT Core, or Ubuntu to boot
Requirements for the Windows driver:
- 64bit Windows 7 and 10
* 64bit Windows 7 and 10
See [Building and Debugging](Docs/Building_and_Debugging.md) for testing.
Advantages and Use Cases
-------------------------
While this project does not implement any immediately useful features, UEFI-based hypervisors have multiple advantages over Windows driver-based ones and can implement unique features.
While this project does not implement or designed for any immediately useful features, UEFI-based hypervisors have multiple advantages over Windows driver-based ones and can implement unique features.
* No need of disabling Hyper-V (Virtualization Based Security) to run the custom hypervisor
* No need of enabling the test-signing mode
@@ -59,13 +55,12 @@ While this project does not implement any immediately useful features, UEFI-base
* Detecting bootkit and early system modification
* Implementing operating system agnostic solutions
Acknowledgments
----------------
The authors thank for creators and maintainers of the following projects:
- [Bareflank](https://github.com/Bareflank/hypervisor) and [STM](https://github.com/jyao1/STM) -- for publishing UEFI-base hypervisors with the relatively small codebase.
- [zpp_hypervisor](https://github.com/eyalz800/zpp_hypervisor) -- for making me realize that writing UEFI-based hypervisors is viable.
- [EfiGuard](https://github.com/Mattiwatti/EfiGuard) -- for clean codebase and rich documentation for UEFI development newbies.
- [hvpp](https://github.com/wbenny/hvpp) -- for few techniques required for the UEFI environment.
- [ia32-doc](https://github.com/wbenny/ia32-doc) -- for saving me from defining thousands of constants and structures by hand.
* [Bareflank](https://github.com/Bareflank/hypervisor) and [STM](https://github.comjyao1/STM) -- for publishing UEFI-base hypervisors with the relatively small codebase.
* [zpp_hypervisor](https://github.com/eyalz800/zpp_hypervisor) -- for making me realize that writing UEFI-based hypervisors is viable.
* [EfiGuard](https://github.com/Mattiwatti/EfiGuard) -- for clean codebase and rich documentation for UEFI development newbies.
* [hvpp](https://github.com/wbenny/hvpp) -- for few techniques required for the UEFI environment.
* [ia32-doc](https://github.com/wbenny/ia32-doc) -- for saving me from defining thousands of constants and structures by hand.