Skip to content

Split device spec to its individual files

Parav Pandit virtio-comment virtio-dev 4 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v4 Latest20 patches 7 repliesIn review
  2. v320 patches 11 repliesSuperseded
  3. v220 patches 9 repliesSuperseded
Earlier versions · 1
VersionPostedPatchesRepliesStatus
v120 patches25 repliesSuperseded

Changes in v4 from the cover letter

- renamed mem-balloon directory to just balloon
- renamed network to net, block to blk
- fixed several hunks placed in wrong patches
- dropped virtio- prefix from the directories

Patches in v4 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/20virtio-net: Maintain network device spec in separate directoryconformance.tex content.tex device-types/net/description.tex +2 more+1630 -16270 replies
2/20virtio-net: Fix spelling errorsdevice-types/net/description.tex+2 -20 replies
3/20virtio-blk: Maintain block device spec in separate directoryconformance.tex content.tex device-types/blk/description.tex +2 more+1332 -13320 replies
4/20virtio-console: Maintain console device spec in separate directoryconformance.tex content.tex device-types/console/description.tex +2 more+250 -2500 replies
5/20virtio-entropy: Maintain entropy device spec in separate directoryconformance.tex content.tex device-types/entropy/description.tex +2 more+59 -590 replies
6/20virtio-mem-balloon: Maintain mem balloon device spec in separate directoryconformance.tex content.tex device-types/balloon/description.tex +2 more+661 -6611 reply
7/20virtio-scsi: Maintain scsi host device spec in separate directoryconformance.tex content.tex device-types/scsi/description.tex +2 more+731 -7320 replies
8/20virtio-gpu: Maintain gpu device spec in separate directoryconformance.tex content.tex device-types/gpu/description.tex +1 more+10 -100 replies
9/20virtio-input: Maintain input device spec in separate directoryconformance.tex content.tex device-types/input/description.tex +2 more+19 -190 replies
10/20virtio-crypto: Maintain crypto device spec in separate directoryconformance.tex content.tex device-types/crypto/description.tex +2 more+30 -300 replies
11/20virtio-vsock: Maintain socket device spec in separate directoryconformance.tex content.tex device-types/vsock/description.tex +2 more+22 -221 reply
12/20virtio-fs: Maintain file system device spec in separate directoryconformance.tex content.tex device-types/fs/description.tex +2 more+22 -220 replies
13/20virtio-rpmb: Maintain rpmb device spec in separate directoryconformance.tex content.tex device-types/rpmb/description.tex +2 more+23 -220 replies
14/20virtio-iommu: Maintain iommu device spec in separate directoryconformance.tex content.tex device-types/iommu/description.tex +2 more+36 -360 replies
15/20virtio-sound: Maintain sound device spec in separate directoryconformance.tex content.tex device-types/sound/description.tex +2 more+32 -320 replies
16/20virtio-mem: Maintain memory device spec in separate directoryconformance.tex content.tex device-types/mem/description.tex +2 more+29 -290 replies
17/20virtio-i2c: Maintain i2c device spec in separate directoryconformance.tex content.tex device-types/i2c/description.tex +2 more+17 -170 replies
18/20virtio-scmi: Maintain scmi device spec in separate directoryconformance.tex content.tex device-types/scmi/description.tex +2 more+21 -210 replies
19/20virtio-gpio: Maintain gpio device spec in separate directoryconformance.tex content.tex device-types/gpio/description.tex +2 more+21 -220 replies
20/20virtio-pmem: Maintain pmem device spec in separate directoryconformance.tex content.tex device-types/pmem/description.tex +2 more+19 -180 replies

Reviews trailers per patch

1 of 20 patches has a Reviewed-by or Acked-by of their own; the series has one for all of them.

PatchStefano GarzarellaMichael S. Tsirkin
SeriesA-b
1/20
2/20
3/20
4/20
5/20
6/20
7/20
8/20
9/20
10/20
11/20R-b
12/20
13/20
14/20
15/20
16/20
17/20
18/20
19/20
20/20

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v4 thread

Cover letter [virtio-comment] [PATCH v4 00/20] Split device spec to its individual files

Relatively several of the recent device specifications are maintained in their own specification file. Such separate files enables better maintenance of the specification overall.
However, several of the initial virtio device specifications are located in single file.

Hence, split them into their individual files.

Additionally, each device's driver and device conformance is present in one giant conformance file all together.

As Michael suggest's move this device and driver conformance section adjacent to device specification in each device specific directory. This further makes device specification self-contained.

Added patch to fix spelling errors in network device specification which was inherited from its previous file location.

Patches do not change any part of the specification outcome except fixing the spelling errors.
It only changes how the specification is maintained.

patch summary:
-------------
patch 1 to 7 creates new files for moving devices spec out of content and conformance files.
patch 8 to 20 move existing dedicated file spec to new directory and creates per device,driver conformance file for each device.

changelog:
----------
v3->v4:
- renamed mem-balloon directory to just balloon
- renamed network to net, block to blk
- fixed several hunks placed in wrong patches
- dropped virtio- prefix from the directories
v2->v3:
- file name changed from device.tex to description.tex
- use input instead of import to insert a file
v1->v2:
- removed extra blank lines in network and block device files
- added missing device conformance link for rpmb, sound, i2c and gpio devices
v0->v1:
- move device spec to their own directory
- added split files for conformance and placed them adjacent to device spec
- added patch to fix spelling errors in network device

Parav Pandit (20):
virtio-net: Maintain network device spec in separate directory
virtio-net: Fix spelling errors
virtio-blk: Maintain block device spec in separate directory
virtio-console: Maintain console device spec in separate directory
virtio-entropy: Maintain entropy device spec in separate directory
virtio-mem-balloon: Maintain mem balloon device spec in separate
directory
virtio-scsi: Maintain scsi host device spec in separate directory
virtio-gpu: Maintain gpu device spec in separate directory
virtio-input: Maintain input device spec in separate directory
virtio-crypto: Maintain crypto device spec in separate directory
virtio-vsock: Maintain socket device spec in separate directory
virtio-fs: Maintain file system device spec in separate directory
virtio-rpmb: Maintain rpmb device spec in separate directory
virtio-iommu: Maintain iommu device spec in separate directory
virtio-sound: Maintain sound device spec in separate directory
virtio-mem: Maintain memory device spec in separate directory
virtio-i2c: Maintain i2c device spec in separate directory
virtio-scmi: Maintain scmi device spec in separate directory
virtio-gpio: Maintain gpio device spec in separate directory
virtio-pmem: Maintain pmem device spec in separate directory

 conformance.tex                               |  456 +-
 content.tex                                   | 4561 +----------------
 device-types/balloon/description.tex          |  634 +++
 device-types/balloon/device-conformance.tex   |   12 +
 device-types/balloon/driver-conformance.tex   |   12 +
 device-types/blk/description.tex              | 1313 +++++
 device-types/blk/device-conformance.tex       |    8 +
 device-types/blk/driver-conformance.tex       |    8 +
 device-types/console/description.tex          |  231 +
 device-types/console/device-conformance.tex   |    8 +
 device-types/console/driver-conformance.tex   |    8 +
 .../crypto/description.tex                    |    0
 device-types/crypto/device-conformance.tex    |   13 +
 device-types/crypto/driver-conformance.tex    |   14 +
 device-types/entropy/description.tex          |   42 +
 device-types/entropy/device-conformance.tex   |    7 +
 device-types/entropy/driver-conformance.tex   |    7 +
 .../fs/description.tex                        |    0
 device-types/fs/device-conformance.tex        |    9 +
 device-types/fs/driver-conformance.tex        |   10 +
 .../gpio/description.tex                      |    0
 device-types/gpio/device-conformance.tex      |    9 +
 device-types/gpio/driver-conformance.tex      |    9 +
 .../gpu/description.tex                       |    0
 device-types/gpu/device-conformance.tex       |    8 +
 .../i2c/description.tex                       |    0
 device-types/i2c/device-conformance.tex       |    7 +
 device-types/i2c/driver-conformance.tex       |    7 +
 .../input/description.tex                     |    0
 device-types/input/device-conformance.tex     |    8 +
 device-types/input/driver-conformance.tex     |    8 +
 .../iommu/description.tex                     |    0
 device-types/iommu/device-conformance.tex     |   16 +
 device-types/iommu/driver-conformance.tex     |   17 +
 .../mem/description.tex                       |    0
 device-types/mem/device-conformance.tex       |   13 +
 device-types/mem/driver-conformance.tex       |   13 +
 device-types/net/description.tex              | 1594 ++++++
 device-types/net/device-conformance.tex       |   16 +
 device-types/net/driver-conformance.tex       |   17 +
 .../pmem/description.tex                      |    0
 device-types/pmem/device-conformance.tex      |    9 +
 device-types/pmem/driver-conformance.tex      |    7 +
 .../rpmb/description.tex                      |    0
 device-types/rpmb/device-conformance.tex      |   13 +
 device-types/rpmb/driver-conformance.tex      |    7 +
 .../scmi/description.tex                      |    0
 device-types/scmi/device-conformance.tex      |   10 +
 device-types/scmi/driver-conformance.tex      |    8 +
 device-types/scsi/description.tex             |  709 +++
 device-types/scsi/device-conformance.tex      |   10 +
 device-types/scsi/driver-conformance.tex      |    9 +
 .../sound/description.tex                     |    0
 device-types/sound/device-conformance.tex     |   16 +
 device-types/sound/driver-conformance.tex     |   13 +
 .../vsock/description.tex                     |    0
 device-types/vsock/device-conformance.tex     |    9 +
 device-types/vsock/driver-conformance.tex     |   10 +
 58 files changed, 4964 insertions(+), 4961 deletions(-)
 create mode 100644 device-types/balloon/description.tex
 create mode 100644 device-types/balloon/device-conformance.tex
 create mode 100644 device-types/balloon/driver-conformance.tex
 create mode 100644 device-types/blk/description.tex
 create mode 100644 device-types/blk/device-conformance.tex
 create mode 100644 device-types/blk/driver-conformance.tex
 create mode 100644 device-types/console/description.tex
 create mode 100644 device-types/console/device-conformance.tex
 create mode 100644 device-types/console/driver-conformance.tex
 rename virtio-crypto.tex => device-types/crypto/description.tex (100%)
 create mode 100644 device-types/crypto/device-conformance.tex
 create mode 100644 device-types/crypto/driver-conformance.tex
 create mode 100644 device-types/entropy/description.tex
 create mode 100644 device-types/entropy/device-conformance.tex
 create mode 100644 device-types/entropy/driver-conformance.tex
 rename virtio-fs.tex => device-types/fs/description.tex (100%)
 create mode 100644 device-types/fs/device-conformance.tex
 create mode 100644 device-types/fs/driver-conformance.tex
 rename virtio-gpio.tex => device-types/gpio/description.tex (100%)
 create mode 100644 device-types/gpio/device-conformance.tex
 create mode 100644 device-types/gpio/driver-conformance.tex
 rename virtio-gpu.tex => device-types/gpu/description.tex (100%)
 create mode 100644 device-types/gpu/device-conformance.tex
 rename virtio-i2c.tex => device-types/i2c/description.tex (100%)
 create mode 100644 device-types/i2c/device-conformance.tex
 create mode 100644 device-types/i2c/driver-conformance.tex
 rename virtio-input.tex => device-types/input/description.tex (100%)
 create mode 100644 device-types/input/device-conformance.tex
 create mode 100644 device-types/input/driver-conformance.tex
 rename virtio-iommu.tex => device-types/iommu/description.tex (100%)
 create mode 100644 device-types/iommu/device-conformance.tex
 create mode 100644 device-types/iommu/driver-conformance.tex
 rename virtio-mem.tex => device-types/mem/description.tex (100%)
 create mode 100644 device-types/mem/device-conformance.tex
 create mode 100644 device-types/mem/driver-conformance.tex
 create mode 100644 device-types/net/description.tex
 create mode 100644 device-types/net/device-conformance.tex
 create mode 100644 device-types/net/driver-conformance.tex
 rename virtio-pmem.tex => device-types/pmem/description.tex (100%)
 create mode 100644 device-types/pmem/device-conformance.tex
 create mode 100644 device-types/pmem/driver-conformance.tex
 rename virtio-rpmb.tex => device-types/rpmb/description.tex (100%)
 create mode 100644 device-types/rpmb/device-conformance.tex
 create mode 100644 device-types/rpmb/driver-conformance.tex
 rename virtio-scmi.tex => device-types/scmi/description.tex (100%)
 create mode 100644 device-types/scmi/device-conformance.tex
 create mode 100644 device-types/scmi/driver-conformance.tex
 create mode 100644 device-types/scsi/description.tex
 create mode 100644 device-types/scsi/device-conformance.tex
 create mode 100644 device-types/scsi/driver-conformance.tex
 rename virtio-sound.tex => device-types/sound/description.tex (100%)
 create mode 100644 device-types/sound/device-conformance.tex
 create mode 100644 device-types/sound/driver-conformance.tex
 rename virtio-vsock.tex => device-types/vsock/description.tex (100%)
 create mode 100644 device-types/vsock/device-conformance.tex
 create mode 100644 device-types/vsock/driver-conformance.tex
Signature · 18 lines
2.26.2


This publicly archived list offers a means to provide input to the
OASIS Virtual I/O Device (VIRTIO) TC.

In order to verify user consent to the Feedback License terms and
to minimize spam in the list archive, subscription is required
before posting.

Subscribe: [email protected]
Unsubscribe: [email protected]
List help: [email protected]
List archive: https://lists.oasis-open.org/archives/virtio-comment/
Feedback License: https://www.oasis-open.org/who/ipr/feedback_license.pdf
List Guidelines: https://www.oasis-open.org/policies-guidelines/mailing-lists
Committee: https://www.oasis-open.org/committees/virtio/
Join OASIS: https://www.oasis-open.org/join/