From: Sitsofe Wheeler <sitsofe@yahoo.com>
To: qemu-devel@nongnu.org
Cc: qemu-trivial@nongnu.org, Paolo Bonzini <pbonzini@redhat.com>
Subject: [Qemu-trivial] [PATCH 2/2] qemu-nbd: Minor texi updates
Date: Wed, 30 Dec 2015 19:57:44 +0000 [thread overview]
Message-ID: <20151230195744.GA26893@sucs.org> (raw)
In-Reply-To: <20151230195338.GA25149@sucs.org>
- Change some spacing.
- Remove duplicate entry for --format.
- Reword --discard documentation.
- Add --detect-zeroes documentation.
Signed-off-by: Sitsofe Wheeler <sitsofe@yahoo.com>
---
qemu-nbd.texi | 22 ++++++++++++++--------
1 file changed, 14 insertions(+), 8 deletions(-)
diff --git a/qemu-nbd.texi b/qemu-nbd.texi
index 26cc985..ac4e613 100644
--- a/qemu-nbd.texi
+++ b/qemu-nbd.texi
@@ -1,6 +1,6 @@
@example
@c man begin SYNOPSIS
-usage: qemu-nbd [OPTION]... @var{filename}
+usage: qemu-nbd [OPTION]... @var{filename}
@c man end
@end example
@@ -22,8 +22,9 @@ offset into the image
interface to bind to (default @samp{0.0.0.0})
@item -k, --socket=@var{path}
Use a unix socket with path @var{path}
-@item -f, --format=@var{format}
-Set image format as @var{format}
+@item -f, --format=@var{fmt}
+force the use of the block driver for format @var{fmt} instead of
+auto-detecting
@item -r, --read-only
export read-only
@item -P, --partition=@var{num}
@@ -44,17 +45,22 @@ the emulator's @code{-drive cache=...} option for allowed values.
choose asynchronous I/O mode between @samp{threads} (the default)
and @samp{native} (Linux only).
@item --discard=@var{discard}
-toggles whether @dfn{discard} (also known as @dfn{trim} or @dfn{unmap})
-requests are ignored or passed to the filesystem. The default is no
-(@samp{--discard=ignore}).
+controls whether @dfn{discard} (also known as @dfn{trim} or @dfn{unmap})
+requests are ignored or passed to the filesystem. @var{discard} is one of
+@samp{ignore} (or @samp{off}), @samp{unmap} (or @samp{on}). The default is
+@samp{ignore}.
+@item --detect-zeroes=@var{detect-zeroes}
+enables the automatic conversion of plain zero writes by the OS to driver
+specific optimized zero write commands. @var{detect-zeroes} is one of
+@samp{off}, @samp{on} or @samp{unmap}. @samp{unmap}
+converts a zero write to an unmap operation and can only be used if
+@var{discard} is set to @samp{unmap}. The default is @samp{off}.
@item -c, --connect=@var{dev}
connect @var{filename} to NBD device @var{dev}
@item -d, --disconnect
disconnect the specified device
@item -e, --shared=@var{num}
device can be shared by @var{num} clients (default @samp{1})
-@item -f, --format=@var{fmt}
-force block driver for format @var{fmt} instead of auto-detecting
@item -t, --persistent
don't exit on the last connection
@item -v, --verbose
--
2.4.3
--
Sitsofe | http://sucs.org/~sits/
WARNING: multiple messages have this Message-ID (diff)
From: Sitsofe Wheeler <sitsofe@yahoo.com>
To: qemu-devel@nongnu.org
Cc: qemu-trivial@nongnu.org, Paolo Bonzini <pbonzini@redhat.com>
Subject: [Qemu-devel] [PATCH 2/2] qemu-nbd: Minor texi updates
Date: Wed, 30 Dec 2015 19:57:44 +0000 [thread overview]
Message-ID: <20151230195744.GA26893@sucs.org> (raw)
In-Reply-To: <20151230195338.GA25149@sucs.org>
- Change some spacing.
- Remove duplicate entry for --format.
- Reword --discard documentation.
- Add --detect-zeroes documentation.
Signed-off-by: Sitsofe Wheeler <sitsofe@yahoo.com>
---
qemu-nbd.texi | 22 ++++++++++++++--------
1 file changed, 14 insertions(+), 8 deletions(-)
diff --git a/qemu-nbd.texi b/qemu-nbd.texi
index 26cc985..ac4e613 100644
--- a/qemu-nbd.texi
+++ b/qemu-nbd.texi
@@ -1,6 +1,6 @@
@example
@c man begin SYNOPSIS
-usage: qemu-nbd [OPTION]... @var{filename}
+usage: qemu-nbd [OPTION]... @var{filename}
@c man end
@end example
@@ -22,8 +22,9 @@ offset into the image
interface to bind to (default @samp{0.0.0.0})
@item -k, --socket=@var{path}
Use a unix socket with path @var{path}
-@item -f, --format=@var{format}
-Set image format as @var{format}
+@item -f, --format=@var{fmt}
+force the use of the block driver for format @var{fmt} instead of
+auto-detecting
@item -r, --read-only
export read-only
@item -P, --partition=@var{num}
@@ -44,17 +45,22 @@ the emulator's @code{-drive cache=...} option for allowed values.
choose asynchronous I/O mode between @samp{threads} (the default)
and @samp{native} (Linux only).
@item --discard=@var{discard}
-toggles whether @dfn{discard} (also known as @dfn{trim} or @dfn{unmap})
-requests are ignored or passed to the filesystem. The default is no
-(@samp{--discard=ignore}).
+controls whether @dfn{discard} (also known as @dfn{trim} or @dfn{unmap})
+requests are ignored or passed to the filesystem. @var{discard} is one of
+@samp{ignore} (or @samp{off}), @samp{unmap} (or @samp{on}). The default is
+@samp{ignore}.
+@item --detect-zeroes=@var{detect-zeroes}
+enables the automatic conversion of plain zero writes by the OS to driver
+specific optimized zero write commands. @var{detect-zeroes} is one of
+@samp{off}, @samp{on} or @samp{unmap}. @samp{unmap}
+converts a zero write to an unmap operation and can only be used if
+@var{discard} is set to @samp{unmap}. The default is @samp{off}.
@item -c, --connect=@var{dev}
connect @var{filename} to NBD device @var{dev}
@item -d, --disconnect
disconnect the specified device
@item -e, --shared=@var{num}
device can be shared by @var{num} clients (default @samp{1})
-@item -f, --format=@var{fmt}
-force block driver for format @var{fmt} instead of auto-detecting
@item -t, --persistent
don't exit on the last connection
@item -v, --verbose
--
2.4.3
--
Sitsofe | http://sucs.org/~sits/
next prev parent reply other threads:[~2015-12-30 21:17 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-12-30 19:54 [Qemu-trivial] [PATCH 1/2] qemu-nbd: Fix unintended texi verbatim formatting Sitsofe Wheeler
2015-12-30 19:54 ` [Qemu-devel] " Sitsofe Wheeler
2015-12-30 19:57 ` Sitsofe Wheeler [this message]
2015-12-30 19:57 ` [Qemu-devel] [PATCH 2/2] qemu-nbd: Minor texi updates Sitsofe Wheeler
2016-01-04 18:16 ` [Qemu-trivial] " Eric Blake
2016-01-04 18:16 ` Eric Blake
2016-01-05 7:44 ` [Qemu-trivial] " Sitsofe Wheeler
2016-01-05 7:44 ` Sitsofe Wheeler
2016-01-04 18:09 ` [Qemu-trivial] [Qemu-devel] [PATCH 1/2] qemu-nbd: Fix unintended texi verbatim formatting Eric Blake
2016-01-04 18:09 ` Eric Blake
2016-01-11 8:07 ` [Qemu-trivial] " Michael Tokarev
2016-01-11 8:07 ` [Qemu-devel] " Michael Tokarev
2016-01-11 8:08 ` [Qemu-trivial] " Michael Tokarev
2016-01-11 8:08 ` [Qemu-devel] " Michael Tokarev
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20151230195744.GA26893@sucs.org \
--to=sitsofe@yahoo.com \
--cc=pbonzini@redhat.com \
--cc=qemu-devel@nongnu.org \
--cc=qemu-trivial@nongnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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.