Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/asamy/ksm
A fast, hackable and simple x64 VT-x hypervisor for Windows and Linux. Builtin userspace sandbox and introspection engine.
https://github.com/asamy/ksm
hypervisor introspect kernel linux reverse-engineering sandbox virtualization windows x86-64
Last synced: 1 day ago
JSON representation
A fast, hackable and simple x64 VT-x hypervisor for Windows and Linux. Builtin userspace sandbox and introspection engine.
- Host: GitHub
- URL: https://github.com/asamy/ksm
- Owner: asamy
- License: gpl-2.0
- Created: 2016-07-13T20:15:04.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2021-10-20T19:32:29.000Z (about 3 years ago)
- Last Synced: 2024-12-13T16:51:12.080Z (9 days ago)
- Topics: hypervisor, introspect, kernel, linux, reverse-engineering, sandbox, virtualization, windows, x86-64
- Language: C
- Homepage: https://asamy.github.io/ksm/
- Size: 1.18 MB
- Stars: 837
- Watchers: 57
- Forks: 182
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ksm v1.6-dev [](https://travis-ci.org/asamy/ksm) [](https://ci.appveyor.com/project/asamy/ksm) 
[](https://www.bountysource.com/teams/ksm?utm_source=ksm&utm_medium=shield&utm_campaign=raised)
A really simple and lightweight x64 hypervisor written in C for Intel processors.
KSM has a self-contained physical memory introspection engine and userspace physical
memory virtualization which can be enabled at compiletime.
Currently, KSM runs on Windows and Linux kernels natively, and aims to support
macOS by 2017, if you want to port KSM see `Documentation/SPEC.rst` for more information.
**Note**: You can find Windows 10 precompiled binaries [here](https://ci.appveyor.com/project/asamy/ksm).
## Purpose
Unlike other hypervisors (e.g. KVM, XEN, etc.), KSM's purpose is not to run
other Operating Systems, instead, KSM can be used as an extra layer of
protection to the existing running OS. This type of virtualization is usually
seen in Anti-viruses, or sandboxers or even Viruses. KSM also supports
nesting, that means it can emulate other hardware-assisted virtualization tools
(VT-x).
## Usage under Linux (+sandbox)
[](https://asciinema.org/a/10cu6v7c6l0j4532cww8tq1a1)
## Features
- IDT Shadowing
- EPT violation #VE (Disabled when unavailable - At least Broadwell required)
- EPTP switching VMFUNC (Emulated when unavailable - At least Haswell required)
- APIC virtualization (Experimental, do not use)
- VMX Nesting (Experimental, do not use)
- Builtin Userspace physical memory sandboxer (Optional)
- Builtin Introspection engine (Optional)
## Requirements
- An Intel processor (with VT-x and EPT support)
- A working C compiler (GCC or Microsoft compiler aka CL are supported)
## Supported Kernels
- Windows NT kernel (7/8/8.1/10)
- Linux kernel (tested under 3.16, 4.8.13 and mainline)
## Documentation
- [Building](https://github.com/asamy/ksm/blob/master/Documentation/BUILDING.rst)
- [Contributions](https://github.com/asamy/ksm/blob/master/Documentation/CONTRIBUTIONS.rst)
- [Specification](https://github.com/asamy/ksm/blob/master/Documentation/SPEC.rst)
- [TODO](https://github.com/asamy/ksm/blob/master/Documentation/TODO.rst)
## Module integration
Few modular examples are included to illustrate usage, those are:
- `epage.c` - A shadow executale page hooking mechanism using multiple EPTP.
- `introspect.c` - A small and stupid physical memory introspection engine using EPT.
- `sandbox.c` - A small, incomplete and simple userspace physical memory sandbox.
See Documentation/BUILDING.rst on how to enable those modules while building.
## Issues (bugs, features, etc.)
Feel free to use Github Issues, there is an Issue Template to help you file
things as required.
## References
- Linux kernel (KVM)
- HyperPlatform
- XEN
## License
GPL v2, see LICENSE file. Note that some code is thirdparty, respective
licenses and/or copyright should be there, if you think otherwise, feel free to mail me.