All of lore.kernel.org
 help / color / mirror / Atom feed
* [Qemu-devel] [PATCH] proto: add 'shift' extension.
@ 2016-09-26 12:46 Vladimir Sementsov-Ogievskiy
  2016-09-26 12:51 ` Paolo Bonzini
                   ` (3 more replies)
  0 siblings, 4 replies; 23+ messages in thread
From: Vladimir Sementsov-Ogievskiy @ 2016-09-26 12:46 UTC (permalink / raw)
  To: qemu-devel, qemu-block, nbd-general
  Cc: alex, eblake, kwolf, pbonzini, stefanha, w, den, vsementsov

This extension allows big requests for TRIM and WRITE_ZEROES through
special 'shift' parameter, which means that offset and length should be
shifted left by several bits.

This is needed for efficient clearing large regions of the disk (up to
the whole disk).

Signed-off-by: Vladimir Sementsov-Ogievskiy <vsementsov@virtuozzo.com>
---

Here mentioned WRITE_ZEROES command which is only an experemental
extension for now.

To dicuss:
NBD_OPT_SHIFT Data. It can be reduced to 8 bits actually... Are some
   reserved bits needed here?

 doc/proto.md | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/doc/proto.md b/doc/proto.md
index 2de3a6a..6fd1b16 100644
--- a/doc/proto.md
+++ b/doc/proto.md
@@ -682,6 +682,8 @@ The field has the following format:
   experimental `WRITE_ZEROES` [extension](https://github.com/yoe/nbd/blob/extension-write-zeroes/doc/proto.md).
 - bit 7, `NBD_FLAG_SEND_DF`: defined by the experimental `STRUCTURED_REPLY`
   [extension](https://github.com/yoe/nbd/blob/extension-structured-reply/doc/proto.md).
+- bit 8, `NBD_FLAG_SEND_SHIFT` : exposes support for `NBD_CMD_FLAG_SHIFT` and
+  `NBD_OPT_SHIFT`
 
 Clients SHOULD ignore unknown flags.
 
@@ -765,6 +767,15 @@ of the newstyle negotiation.
 
     Defined by the experimental `INFO` [extension](https://github.com/yoe/nbd/blob/extension-info/doc/proto.md).
 
+- `NBD_OPT_SHIFT` (10)
+
+    Defines shift used to calculate request offset and length if
+    `NBD_CMD_FLAG_SHIFT` is set.
+
+    Data:
+
+    - 32 bits, shift (unsigned); Must not be larger than 32.
+
 #### Option reply types
 
 These values are used in the "reply type" field, sent by the server
@@ -872,7 +883,13 @@ valid may depend on negotiation during the handshake phase.
   [extension](https://github.com/yoe/nbd/blob/extension-write-zeroes/doc/proto.md).
 - bit 2, `NBD_CMD_FLAG_DF`; defined by the experimental `STRUCTURED_REPLY`
   [extension](https://github.com/yoe/nbd/blob/extension-structured-reply/doc/proto.md).
-
+- bit 3, `NBD_CMD_FLAG_SHIFT`; This flag is valid for `NBD_CMD_TRIM` and
+  `NBD_CMD_WRITE_ZEROES`. If this flag is set the server shifts request
+  *length* and *offset* left by N bits, where N is defined by `NBD_OPT_SHIFT`
+  option or is assumed to be 16 bits by default if `NBD_OPT_SHIFT` option is
+  not specified. If after shift `(offset + length)` exceeds disk size, length
+  should be reduced to `(<disk size> - offset)`. However, `(offset + length)`
+  must not exceed disk size by more than `(1 << N) - 1`.
 
 #### Request types
 
-- 
1.8.3.1

^ permalink raw reply related	[flat|nested] 23+ messages in thread

end of thread, other threads:[~2016-09-28  9:32 UTC | newest]

Thread overview: 23+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-09-26 12:46 [Qemu-devel] [PATCH] proto: add 'shift' extension Vladimir Sementsov-Ogievskiy
2016-09-26 12:51 ` Paolo Bonzini
2016-09-26 13:53   ` Vladimir Sementsov-Ogievskiy
2016-09-26 13:54     ` Paolo Bonzini
2016-09-26 14:06       ` Alex Bligh
2016-09-26 20:35   ` Eric Blake
2016-09-26 14:05 ` Alex Bligh
2016-09-26 20:21 ` Eric Blake
2016-09-26 23:41   ` [Qemu-devel] [Nbd] " Wouter Verhelst
2016-09-27  7:36     ` Alex Bligh
2016-09-27  9:43 ` [Qemu-devel] " Denis V. Lunev
2016-09-27 10:15   ` Paolo Bonzini
2016-09-27 10:25     ` Denis V. Lunev
2016-09-27 12:07       ` Paolo Bonzini
2016-09-27 13:28         ` Denis V. Lunev
2016-09-27 17:04           ` Paolo Bonzini
2016-09-27 18:59             ` Denis V. Lunev
2016-09-28  8:34               ` Kevin Wolf
2016-09-28  8:37                 ` Denis V. Lunev
2016-09-28  8:56                   ` Kevin Wolf
2016-09-28  9:00                     ` Vladimir Sementsov-Ogievskiy
2016-09-28  9:32                       ` Kevin Wolf
2016-09-27 13:46         ` Denis V. Lunev

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.