[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PULL 5/9] docs: Update preferred NBD device syntax
From: |
Eric Blake |
Subject: |
[Qemu-devel] [PULL 5/9] docs: Update preferred NBD device syntax |
Date: |
Thu, 5 Sep 2019 13:21:28 -0500 |
Mention the preferred URI form, especially since NBD is trying to
standardize that form: https://lists.debian.org/nbd/2019/06/msg00012.html
Signed-off-by: Eric Blake <address@hidden>
Message-Id: <address@hidden>
Reviewed-by: John Snow <address@hidden>
---
qemu-doc.texi | 11 +++++++++--
1 file changed, 9 insertions(+), 2 deletions(-)
diff --git a/qemu-doc.texi b/qemu-doc.texi
index 577d1e837640..ec460f1d7af5 100644
--- a/qemu-doc.texi
+++ b/qemu-doc.texi
@@ -297,9 +297,16 @@ qemu-system-i386 -drive
file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
@item NBD
QEMU supports NBD (Network Block Devices) both using TCP protocol as well
-as Unix Domain Sockets.
+as Unix Domain Sockets. With TCP, the default port is 10809.
-Syntax for specifying a NBD device using TCP
+Syntax for specifying a NBD device using TCP, in preferred URI form:
+``nbd://<server-ip>[:<port>]/[<export>]''
+
+Syntax for specifying a NBD device using Unix Domain Sockets; remember
+that '?' is a shell glob character and may need quoting:
+``nbd+unix:///[<export>]?socket=<domain-socket>''
+
+Older syntax that is also recognized:
``nbd:<server-ip>:<port>[:exportname=<export>]''
Syntax for specifying a NBD device using Unix Domain Sockets
--
2.21.0
- [Qemu-devel] [PULL 0/9] NBD patches through 2019-09-05, Eric Blake, 2019/09/05
- [Qemu-devel] [PULL 1/9] nbd: Advertise multi-conn for shared read-only connections, Eric Blake, 2019/09/05
- [Qemu-devel] [PULL 2/9] nbd: Use g_autofree in a few places, Eric Blake, 2019/09/05
- [Qemu-devel] [PULL 3/9] nbd: Tolerate more errors to structured reply request, Eric Blake, 2019/09/05
- [Qemu-devel] [PULL 4/9] block: workaround for unaligned byte range in fallocate(), Eric Blake, 2019/09/05
- [Qemu-devel] [PULL 5/9] docs: Update preferred NBD device syntax,
Eric Blake <=
- [Qemu-devel] [PULL 8/9] nbd: Implement client use of NBD FAST_ZERO, Eric Blake, 2019/09/05
- [Qemu-devel] [PULL 7/9] nbd: Prepare for NBD_CMD_FLAG_FAST_ZERO, Eric Blake, 2019/09/05
- [Qemu-devel] [PULL 6/9] nbd: Improve per-export flag handling in server, Eric Blake, 2019/09/05
- [Qemu-devel] [PULL 9/9] nbd: Implement server use of NBD FAST_ZERO, Eric Blake, 2019/09/05
- Re: [Qemu-devel] [PULL 0/9] NBD patches through 2019-09-05, Eric Blake, 2019/09/05