[Qemu-devel] [PATCH 0/0] Add description on NBD URL to manpage

[Qemu-devel] [PATCH 0/0] Add description on NBD URL to manpage

[Ronnie Sahlberg]

Please find a patch to add a description of the NBD URL to the manpage.
This describes both TCP and domain socket syntax.
(I could not actually test the domain syntax case since my nbd-server 
crashes:-( )

regards
ronnie sahlberg

[Qemu-devel] [PATCH] Documentation: Describe NBD URL syntax

[Ronnie Sahlberg]

This patch adds a short description of how to specify a NBD device
to QEMU.
Syntax for both TCP and Unix Domain Sockets are provided as well
as examples.

Signed-off-by: Ronnie Sahlberg <ronniesahlberg@gmail.com>
---
 qemu-options.hx |   21 +++++++++++++++++++++
 1 files changed, 21 insertions(+), 0 deletions(-)

diff --git a/qemu-options.hx b/qemu-options.hx
index 7c434f8..564ae3f 100644
--- a/qemu-options.hx
+++ b/qemu-options.hx
@@ -1757,6 +1757,27 @@ qemu --drive file=iscsi://192.0.2.1/iqn.2001-04.com.example/1
 iSCSI support is an optional feature of QEMU and only available when
 compiled and linked against libiscsi.
 
+@item NBD
+QEMU supports NBD (Network Block Devices) both using TCP protocol as well
+as Unix Domain Sockets.
+
+Syntax for specifying a NDB device using TCP
+``nbd:<server-ip>:<port>[:exportname=<export>]''
+
+Syntax for specifying a NDB device using Unix Domain Sockets
+``nbd:unix:<domain-socket>[:exportname=<export>]''
+
+
+Example for TCP
+@example
+qemu --drive file=nbd:192.0.2.1:30000
+@end example
+
+Example for Unix Domain Sockets
+@example
+qemu --drive file=nbd:unix:/tmp/nbd-socket
+@end example
+
 @end table
 ETEXI
 
-- 
1.7.3.1

Re: [Qemu-devel] [PATCH] Documentation: Describe NBD URL syntax

[Kevin Wolf]

Am 27.10.2011 11:33, schrieb Ronnie Sahlberg:
> This patch adds a short description of how to specify a NBD device
> to QEMU.
> Syntax for both TCP and Unix Domain Sockets are provided as well
> as examples.
> 
> Signed-off-by: Ronnie Sahlberg <ronniesahlberg@gmail.com>

Thanks, applied to the block branch.

Kevin

Re: [Qemu-devel] [PATCH] Documentation: Describe NBD URL syntax

[Eric Sunshine]

On Oct 27, 2011, at 5:33 AM, Ronnie Sahlberg wrote:
> This patch adds a short description of how to specify a NBD device
> to QEMU.
> Syntax for both TCP and Unix Domain Sockets are provided as well
> as examples.
>
> Signed-off-by: Ronnie Sahlberg <ronniesahlberg@gmail.com>
> ---
> qemu-options.hx |   21 +++++++++++++++++++++
> 1 files changed, 21 insertions(+), 0 deletions(-)
>
> diff --git a/qemu-options.hx b/qemu-options.hx
> index 7c434f8..564ae3f 100644
> --- a/qemu-options.hx
> +++ b/qemu-options.hx
> @@ -1757,6 +1757,27 @@ qemu --drive file=iscsi://192.0.2.1/iqn. 
> 2001-04.com.example/1
> iSCSI support is an optional feature of QEMU and only available when
> compiled and linked against libiscsi.
>
> +@item NBD
> +QEMU supports NBD (Network Block Devices) both using TCP protocol  
> as well
> +as Unix Domain Sockets.
> +
> +Syntax for specifying a NDB device using TCP
> +``nbd:<server-ip>:<port>[:exportname=<export>]''
> +
> +Syntax for specifying a NDB device using Unix Domain Sockets
> +``nbd:unix:<domain-socket>[:exportname=<export>]''

On the two "Syntax for..." lines: s/NDB/NBD/

-- ES