mirror of https://github.com/rust-vmm/vhost-device.git synced 2026-01-08 20:57:35 +00:00

History

dependabot[bot] d0a7a9dd82 build(deps): bump the vhost-device group with 10 updates Bumps the vhost-device group with 10 updates: \| Package \| From \| To \| \| --- \| --- \| --- \| \| [libc](https://github.com/rust-lang/libc) \| `0.2.158` \| `0.2.159` \| \| [tempfile](https://github.com/Stebalien/tempfile) \| `3.12.0` \| `3.13.0` \| \| [autocfg](https://github.com/cuviper/autocfg) \| `1.3.0` \| `1.4.0` \| \| [cc](https://github.com/rust-lang/cc-rs) \| `1.1.21` \| `1.1.22` \| \| [once_cell](https://github.com/matklad/once_cell) \| `1.19.0` \| `1.20.1` \| \| [pkg-config](https://github.com/rust-lang/pkg-config-rs) \| `0.3.30` \| `0.3.31` \| \| [regex](https://github.com/rust-lang/regex) \| `1.10.6` \| `1.11.0` \| \| [regex-automata](https://github.com/rust-lang/regex) \| `0.4.7` \| `0.4.8` \| \| [regex-syntax](https://github.com/rust-lang/regex) \| `0.8.4` \| `0.8.5` \| \| [serde_spanned](https://github.com/toml-rs/toml) \| `0.6.7` \| `0.6.8` \| Updates `libc` from 0.2.158 to 0.2.159 - [Release notes](https://github.com/rust-lang/libc/releases) - [Changelog](https://github.com/rust-lang/libc/blob/0.2.159/CHANGELOG.md) - [Commits](https://github.com/rust-lang/libc/compare/0.2.158...0.2.159) Updates `tempfile` from 3.12.0 to 3.13.0 - [Changelog](https://github.com/Stebalien/tempfile/blob/master/CHANGELOG.md) - [Commits](https://github.com/Stebalien/tempfile/compare/v3.12.0...v3.13.0) Updates `autocfg` from 1.3.0 to 1.4.0 - [Commits](https://github.com/cuviper/autocfg/compare/1.3.0...1.4.0) Updates `cc` from 1.1.21 to 1.1.22 - [Release notes](https://github.com/rust-lang/cc-rs/releases) - [Changelog](https://github.com/rust-lang/cc-rs/blob/main/CHANGELOG.md) - [Commits](https://github.com/rust-lang/cc-rs/compare/cc-v1.1.21...cc-v1.1.22) Updates `once_cell` from 1.19.0 to 1.20.1 - [Changelog](https://github.com/matklad/once_cell/blob/master/CHANGELOG.md) - [Commits](https://github.com/matklad/once_cell/compare/v1.19.0...v1.20.1) Updates `pkg-config` from 0.3.30 to 0.3.31 - [Changelog](https://github.com/rust-lang/pkg-config-rs/blob/master/CHANGELOG.md) - [Commits](https://github.com/rust-lang/pkg-config-rs/compare/0.3.30...0.3.31) Updates `regex` from 1.10.6 to 1.11.0 - [Release notes](https://github.com/rust-lang/regex/releases) - [Changelog](https://github.com/rust-lang/regex/blob/master/CHANGELOG.md) - [Commits](https://github.com/rust-lang/regex/compare/1.10.6...1.11.0) Updates `regex-automata` from 0.4.7 to 0.4.8 - [Release notes](https://github.com/rust-lang/regex/releases) - [Changelog](https://github.com/rust-lang/regex/blob/master/CHANGELOG.md) - [Commits](https://github.com/rust-lang/regex/commits) Updates `regex-syntax` from 0.8.4 to 0.8.5 - [Release notes](https://github.com/rust-lang/regex/releases) - [Changelog](https://github.com/rust-lang/regex/blob/master/CHANGELOG.md) - [Commits](https://github.com/rust-lang/regex/commits) Updates `serde_spanned` from 0.6.7 to 0.6.8 - [Commits](https://github.com/toml-rs/toml/compare/serde_spanned-v0.6.7...serde_spanned-v0.6.8) --- updated-dependencies: - dependency-name: libc dependency-type: direct:production update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: tempfile dependency-type: direct:production update-type: version-update:semver-minor dependency-group: vhost-device - dependency-name: autocfg dependency-type: indirect update-type: version-update:semver-minor dependency-group: vhost-device - dependency-name: cc dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: once_cell dependency-type: indirect update-type: version-update:semver-minor dependency-group: vhost-device - dependency-name: pkg-config dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: regex dependency-type: indirect update-type: version-update:semver-minor dependency-group: vhost-device - dependency-name: regex-automata dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: regex-syntax dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: serde_spanned dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device ... Signed-off-by: dependabot[bot] <support@github.com>		2024-09-30 09:50:29 +02:00
..
src	chore: fix clippy warnings	2024-09-25 10:27:44 +03:00
test	Move all crates to workspace root	2023-10-16 12:03:57 +05:30
ARCHITECTURE.md	Move all crates to workspace root	2023-10-16 12:03:57 +05:30
Cargo.toml	build(deps): bump the vhost-device group with 10 updates	2024-09-30 09:50:29 +02:00
CHANGELOG.md	chore: standardize changelogs	2024-07-24 19:37:19 +05:30
LICENSE-APACHE	Move all crates to workspace root	2023-10-16 12:03:57 +05:30
LICENSE-BSD-3-Clause	Move all crates to workspace root	2023-10-16 12:03:57 +05:30
README.md	Move all crates to workspace root	2023-10-16 12:03:57 +05:30

README.md

vhost-device-scsi

This is a Rust implementation of a vhost-device-scsi daemon.

Usage

Run the vhost-device-scsi daemon:

vhost-device-scsi -r --socket-path /tmp/vhost-user-scsi.sock /path/to/image.raw /path/to/second-image.raw ...

Run QEMU:

qemu-system-x86_64 ... \
  -device vhost-user-scsi-pci,num_queues=1,param_change=off,chardev=vus \
  -chardev socket,id=vus,path=/tmp/vhost-user-scsi.sock \
  # must match total guest meory
  -object memory-backend-memfd,id=mem,size=384M,share=on \
  -numa node,memdev=mem

Limitations

We are currently only supporting a single request queue and do not support dynamic reconfiguration of LUN parameters (VIRTIO_SCSI_F_CHANGE).

Features

This crate is a work-in-progress. Currently, it's possible to mount and read up to 256 read-only raw disk images. Some features we might like to add at some point, roughly ordered from sooner to later:

Write support. This should just be a matter of implementing the WRITE command, but there's a bit of complexity around writeback caching we need to make sure we get right.
Support more LUNs. virtio-scsi supports up to 16384 LUNs per target. After 256, the LUN encoding format is different; it's nothing too complicated, but I haven't gotten around to implementing it.
Concurrency. Currently, we process SCSI commands one at a time. Eventually, it'd be a good idea to use threads or some fancy async/io_uring stuff to concurrently handle multiple commands. virtio-scsi also allows for multiple request queues, allowing the guest to submit requests from multiple cores in parallel; we should support that.
iSCSI passthrough. This shouldn't be too bad, but it might be a good idea to decide on a concurrency model (threads or async) before we spend too much time here.