mirror of https://github.com/rust-vmm/vhost-device.git synced 2025-12-26 22:48:17 +00:00

History

dependabot[bot] e9013f4735 build(deps): bump the vhost-device group with 11 updates Bumps the vhost-device group with 11 updates: \| Package \| From \| To \| \| --- \| --- \| --- \| \| [clap](https://github.com/clap-rs/clap) \| `4.4.11` \| `4.4.12` \| \| [thiserror](https://github.com/dtolnay/thiserror) \| `1.0.50` \| `1.0.56` \| \| [tempfile](https://github.com/Stebalien/tempfile) \| `3.8.1` \| `3.9.0` \| \| [nix](https://github.com/nix-rust/nix) \| `0.26.4` \| `0.27.1` \| \| [async-trait](https://github.com/dtolnay/async-trait) \| `0.1.74` \| `0.1.77` \| \| [clang-sys](https://github.com/KyleMayes/clang-sys) \| `1.6.1` \| `1.7.0` \| \| [home](https://github.com/rust-lang/cargo) \| `0.5.5` \| `0.5.9` \| \| [is-terminal](https://github.com/sunfishcode/is-terminal) \| `0.4.9` \| `0.4.10` \| \| [memchr](https://github.com/BurntSushi/memchr) \| `2.6.4` \| `2.7.1` \| \| [pkg-config](https://github.com/rust-lang/pkg-config-rs) \| `0.3.27` \| `0.3.28` \| \| [winnow](https://github.com/winnow-rs/winnow) \| `0.5.26` \| `0.5.31` \| Updates `clap` from 4.4.11 to 4.4.12 - [Release notes](https://github.com/clap-rs/clap/releases) - [Changelog](https://github.com/clap-rs/clap/blob/master/CHANGELOG.md) - [Commits](https://github.com/clap-rs/clap/compare/v4.4.11...v4.4.12) Updates `thiserror` from 1.0.50 to 1.0.56 - [Release notes](https://github.com/dtolnay/thiserror/releases) - [Commits](https://github.com/dtolnay/thiserror/compare/1.0.50...1.0.56) Updates `tempfile` from 3.8.1 to 3.9.0 - [Changelog](https://github.com/Stebalien/tempfile/blob/master/CHANGELOG.md) - [Commits](https://github.com/Stebalien/tempfile/compare/v3.8.1...v3.9.0) Updates `nix` from 0.26.4 to 0.27.1 - [Changelog](https://github.com/nix-rust/nix/blob/master/CHANGELOG.md) - [Commits](https://github.com/nix-rust/nix/compare/v0.26.4...v0.27.1) Updates `async-trait` from 0.1.74 to 0.1.77 - [Release notes](https://github.com/dtolnay/async-trait/releases) - [Commits](https://github.com/dtolnay/async-trait/commits) Updates `clang-sys` from 1.6.1 to 1.7.0 - [Release notes](https://github.com/KyleMayes/clang-sys/releases) - [Changelog](https://github.com/KyleMayes/clang-sys/blob/master/CHANGELOG.md) - [Commits](https://github.com/KyleMayes/clang-sys/compare/v1.6.1...v1.7.0) Updates `home` from 0.5.5 to 0.5.9 - [Changelog](https://github.com/rust-lang/cargo/blob/master/CHANGELOG.md) - [Commits](https://github.com/rust-lang/cargo/commits) Updates `is-terminal` from 0.4.9 to 0.4.10 - [Commits](https://github.com/sunfishcode/is-terminal/compare/v0.4.9...v0.4.10) Updates `memchr` from 2.6.4 to 2.7.1 - [Commits](https://github.com/BurntSushi/memchr/compare/2.6.4...2.7.1) Updates `pkg-config` from 0.3.27 to 0.3.28 - [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.27...0.3.28) Updates `winnow` from 0.5.26 to 0.5.31 - [Changelog](https://github.com/winnow-rs/winnow/blob/main/CHANGELOG.md) - [Commits](https://github.com/winnow-rs/winnow/compare/v0.5.26...v0.5.31) --- updated-dependencies: - dependency-name: clap dependency-type: direct:production update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: thiserror 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: nix dependency-type: direct:production update-type: version-update:semver-minor dependency-group: vhost-device - dependency-name: async-trait dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: clang-sys dependency-type: indirect update-type: version-update:semver-minor dependency-group: vhost-device - dependency-name: home dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: is-terminal dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device - dependency-name: memchr 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: winnow dependency-type: indirect update-type: version-update:semver-patch dependency-group: vhost-device ... Signed-off-by: dependabot[bot] <support@github.com> [sgarzare] vhost-device-input: enabled `ioctl` feature of `nix` crate to fix a build issue since it is now needed to use ioctl's macro like `ioctl_read_buf`, etc. Signed-off-by: Stefano Garzarella <sgarzare@redhat.com>		2024-01-02 09:42:42 +01:00
..
src	tree-wide: use new `serve` convenience function	2023-11-20 13:05:48 +05:30
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 11 updates	2024-01-02 09:42:42 +01:00
CHANGELOG.md	Move all crates to workspace root	2023-10-16 12:03:57 +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.