Skip to main content

sydost-memvol

Toy emulator of memory volumes shared between virtual machines. A volume is a part of one VM's RAM that other VMs may access through a protocol label (shared memory, RDMA, vhost-user) instead of memory ballooning or hot-plug. The package is a teaching model: it does not touch hypervisors or real memory, and all random processes come from a seeded generator.

Russian version: README.ru.md. Documentation: docs/en/model.md and docs/ru/model.md.

Install

pip install sydost-memvol

Python 3.11 to 3.14. No runtime dependencies.

Quick start

from sydost_memvol import SimConfig, VirtualMachine, simulate

vms = [VirtualMachine(f"vm{i}", ram_gb=32.0, export_share=0.5) for i in range(1, 5)]
result = simulate(vms, SimConfig(steps=200, seed=1, revoke_lag=2, attack_rate=0.05))
print(result.summary["mean_utilization"], result.summary["shortage_gb_steps"])

Command line:

python -m sydost_memvol --vms 4 --ram 32 --steps 200 --seed 1

What the model contains

  • VirtualMachine: name, RAM in GB, share of idle memory it exports.
  • MemoryVolume and Grant: a volume owned by one VM, grants with rights ro or rw and an optional revocation step.
  • VolumeManager: one step of the policy. It sizes volumes from the previous step's demand, borrows memory for shortages and schedules revocation after revoke_lag steps.
  • DemandProcess: mean-reverting random demand with bursts.
  • simulate: a run that also draws access attempts and classifies them as blocked, inside the revocation window (exposed), or legitimate.

Limits

Outputs are model outputs, not measurements. The protocol label does not change any calculation. Attack attempts are only counted. The package contains no exploit code.

Development

uv sync
uv run ruff check .
uv run pytest

License

MIT. Authors: Andrey Ferubko and Oleg Kazakov (Bryansk State Engineering-Technological University).

Metadata

Release files for sydost-memvol 0.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sydost-memvol 0.0.1
File Size Uploaded Provenance Actions
sydost_memvol-0.0.1.tar.gz 9.2 kB Without provenance Details for sydost_memvol-0.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sydost-memvol 0.0.1
File Interpreter ABI Platform Actions
sydost_memvol-0.0.1-py3-none-any.whl Python 3 none any Details for sydost_memvol-0.0.1-py3-none-any.whl

Total release size: 21.3 kB

Release files / sydost_memvol-0.0.1.tar.gz

Download URL sydost_memvol-0.0.1.tar.gz
Size 9.2 kB
Tags Source
SHA-256 checksum
How to use checksums
bb2ef9f65fb7e9f240ce541d6e04e293a31955dc5ad29c4bc6dbd7af82ee3073
BLAKE2b-256 checksum
How to use checksums
e65ccbcc53fd12fefceec5e934c76f081c166f10786073b3ed51c620a89122a6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.9 {"installer":{"name":"uv","version":"0.11.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / sydost_memvol-0.0.1-py3-none-any.whl

Download URL sydost_memvol-0.0.1-py3-none-any.whl
Size 12.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0be280aa0ee3af26e125097ca4c02b1d46fe74418473de32ff4c52afda382b3b
BLAKE2b-256 checksum
How to use checksums
2fdad918e1a57e59443685fe4c5a50eb83defbb3c75501aafe491f677630257b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.9 {"installer":{"name":"uv","version":"0.11.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Security for sydost-memvol 0.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page