[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PATCH v2 1/3] NBD proto: add "Command flags" section
From: |
Eric Blake |
Subject: |
[Qemu-devel] [PATCH v2 1/3] NBD proto: add "Command flags" section |
Date: |
Tue, 29 Mar 2016 17:00:58 -0600 |
From: Pavel Borzenkov <address@hidden>
Add separate "Command flags" section to make it clear which flags are
currently defined by the protocol.
Signed-off-by: Pavel Borzenkov <address@hidden>
Reviewed-by: Roman Kagan <address@hidden>
Signed-off-by: Denis V. Lunev <address@hidden>
CC: Wouter Verhelst <address@hidden>
CC: Alex Bligh <address@hidden>
Message-Id: <address@hidden>
[rearrange subsections to parallel Handshake phase, add more details]
Signed-off-by: Eric Blake <address@hidden>
---
doc/proto.md | 14 ++++++++++++++
1 file changed, 14 insertions(+)
diff --git a/doc/proto.md b/doc/proto.md
index aaae0a2..3d49162 100644
--- a/doc/proto.md
+++ b/doc/proto.md
@@ -411,6 +411,20 @@ case that data is an error message suitable for display to
the user.
### Transmission phase
+#### Command flags
+
+This field of 16 bits is sent by the client with every request and provides
+additional information to the server to execute the command. Refer to
+the "Request types" section below for more details about how a given flag
+affects a particular command. Clients MUST NOT set a command flag bit
+that is not documented for the particular command; and whether a flag is
+valid may depend on negotiation during the handshake phase.
+
+- bit 0, `NBD_CMD_FLAG_FUA`; valid during `NBD_CMD_WRITE`. SHOULD be
+ set to 1 if the client requires "Force Unit Access" mode of
+ operation. MUST NOT be set unless export flags included
+ `NBD_FLAG_SEND_FUA`.
+
#### Request types
The following request types exist:
--
2.5.5
- [Qemu-devel] [PATCH v2 2/3] doc: Mention proper use of handle, (continued)
- [Qemu-devel] [PATCH v2 2/3] doc: Mention proper use of handle, Eric Blake, 2016/03/29
- [Qemu-devel] [PATCH v2 3/3] doc: Propose Structured Read extension, Eric Blake, 2016/03/29
- Re: [Qemu-devel] [PATCH v2 3/3] doc: Propose Structured Read extension, Eric Blake, 2016/03/29
- Re: [Qemu-devel] [PATCH v2 3/3] doc: Propose Structured Read extension, Alex Bligh, 2016/03/30
- Re: [Qemu-devel] [PATCH v2 3/3] doc: Propose Structured Read extension, Eric Blake, 2016/03/30
- Re: [Qemu-devel] [Nbd] [PATCH v2 3/3] doc: Propose Structured Read extension, Wouter Verhelst, 2016/03/30
- Re: [Qemu-devel] [Nbd] [PATCH v2 3/3] doc: Propose Structured Read extension, Eric Blake, 2016/03/30
- Re: [Qemu-devel] [Nbd] [PATCH v2 3/3] doc: Propose Structured Read extension, Wouter Verhelst, 2016/03/30
- Re: [Qemu-devel] [PATCH v2 3/3] doc: Propose Structured Read extension, Alex Bligh, 2016/03/30
- Re: [Qemu-devel] [Nbd] [PATCH v2 3/3] doc: Propose Structured Read extension, Wouter Verhelst, 2016/03/30
[Qemu-devel] [PATCH v2 1/3] NBD proto: add "Command flags" section,
Eric Blake <=
Re: [Qemu-devel] [Nbd] [PATCH v2 0/3] NBD Structured Read, Wouter Verhelst, 2016/03/30