summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorRichard W.M. Jones <rjones@redhat.com>2019-08-02 18:03:52 +0100
committerJens Axboe <axboe@kernel.dk>2019-08-02 11:05:28 -0600
commitf2d6de5d997b039cebac9c34912871baa5e12d49 (patch)
treedf7a7f4cd0d3a4ffafc461d560b3c2aaba667a1c
parent34a8f35f0854cd3627952187da73616a39165367 (diff)
downloadfio-f2d6de5d997b039cebac9c34912871baa5e12d49.tar.gz
fio-f2d6de5d997b039cebac9c34912871baa5e12d49.tar.bz2
nbd: Document the NBD-specific uri parameter
Signed-off-by: Richard W.M. Jones <rjones@redhat.com> Signed-off-by: Jens Axboe <axboe@kernel.dk>
-rw-r--r--HOWTO11
-rw-r--r--fio.116
2 files changed, 26 insertions, 1 deletions
diff --git a/HOWTO b/HOWTO
index 955ea43c..41b959d1 100644
--- a/HOWTO
+++ b/HOWTO
@@ -1999,7 +1999,7 @@ I/O engine
**libiscsi**
Read and write iscsi lun with libiscsi.
**nbd**
- Synchronous read and write a Network Block Device (NBD).
+ Read and write a Network Block Device (NBD).
I/O engine specific parameters
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -2301,6 +2301,15 @@ with the caveat that when used on the command line, they must come after the
turns on verbose logging from libcurl, 2 additionally enables
HTTP IO tracing. Default is **0**
+.. option:: uri=str : [nbd]
+
+ Specify the NBD URI of the server to test. The string
+ is a standard NBD URI
+ (see https://github.com/NetworkBlockDevice/nbd/tree/master/doc).
+ Example URIs: nbd://localhost:10809
+ nbd+unix:///?socket=/tmp/socket
+ nbds://tlshost/exportname
+
I/O depth
~~~~~~~~~
diff --git a/fio.1 b/fio.1
index 30b17f02..97371d77 100644
--- a/fio.1
+++ b/fio.1
@@ -2022,6 +2022,22 @@ blocksize=8k will write 16 sectors with each command. fio will still
generate 8k of data for each command butonly the first 512 bytes will
be used and transferred to the device. The writefua option is ignored
with this selection.
+.RE
+.RE
+.TP
+.BI (nbd)uri \fR=\fPstr
+Specify the NBD URI of the server to test.
+The string is a standard NBD URI (see
+\fIhttps://github.com/NetworkBlockDevice/nbd/tree/master/doc\fR).
+Example URIs:
+.RS
+.RS
+.TP
+\fInbd://localhost:10809\fR
+.TP
+\fInbd+unix:///?socket=/tmp/socket\fR
+.TP
+\fInbds://tlshost/exportname\fR
.SS "I/O depth"
.TP