Metadata-Version: 2.4
Name: hvlib
Version: 1.2.2
Summary: Python wrapper for hvlib.dll (Hyper-V memory manager library)
Author: Arthur Khudyaev
License-Expression: CC-BY-NC-ND-4.0
Keywords: hyper-v,virtualization,memory,debugging,windows,exdi
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: Microsoft :: Windows :: Windows 11
Classifier: Topic :: System :: Emulators
Classifier: Topic :: Software Development :: Debuggers
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Dynamic: license-file

# hvlib — Hyper-V memory manager library for Python

Python wrapper (`ctypes`) around `hvlib.dll` — a Hyper-V memory manager
library for reading/writing guest OS (Windows or Unix) memory and controlling VM
state from the Windows host.

[hvlib docs](https://github.com/gerhart01/LiveCloudKd/tree/master/LiveCloudKdSdk) and [python wrapper for hvlib docs](https://github.com/gerhart01/LiveCloudKd/tree/master/LiveCloudKdPy)  

Requires Windows x64 with Hyper-V, and the bundled `hvmm.sys` kernel
driver (loaded automatically by `hvlib.dll`).

## Installation

```
pip install hvlib
```

## Usage

```python
import hvlib

vm = hvlib.hvlib("")  # empty string = use the DLL bundled with this package
vm_ops = vm.GetPreferredSettings()
vm.EnumPartitions(vm_ops)
handle = vm.SelectPartition(0)
buf = vm.ReadPhysicalMemoryBlock(handle, 0x1000, 0x100)
```

## License

Copyright (c) 2019 Arthur Khudyaev. Licensed under
[CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/),
with a commercial-use addendum — see
[LICENSE.txt](https://github.com/gerhart01/LiveCloudKd/blob/master/LiveCloudKdSdk/LICENSE.txt)
for the full terms.
