From: Jens Axboe <axboe@suse.de>
Date: Wed, 15 Feb 2006 08:33:45 +0000 (+0100)
Subject: [PATCH] blktrace/README: update to include description of new net parameters
X-Git-Tag: blktrace-0.99.1~43
X-Git-Url: https://git.kernel.dk/?a=commitdiff_plain;h=f531b94dbe7948e479a6cfa838cda9fb3c321f0c;p=blktrace.git

[PATCH] blktrace/README: update to include description of new net parameters
---

diff --git a/README b/README
index 5f79e36..7236966 100644
--- a/README
+++ b/README
@@ -60,6 +60,10 @@ $ blktrace -d <dev> [ -r relay_path ] [ -o output ] [ -k ] [ -w time ]
 
 	-b Sub buffer size in KiB.
 	-n Number of sub buffers.
+	-l Run in network listen mode (blktrace server)
+	-h Run in network client mode, connecting to the given host
+	-p Network port to use (default 8462)
+	-s Make the network client use sendfile() to transfer data
 	-V Print program version info.
 
 $ blkparse -i <input> [ -o <output> ] [ -b rb_batch ] [ -s ] [ -t ] [ -q ]
@@ -142,13 +146,16 @@ and blkparse:
 
 This has a small risk of displaying some traces a little out of sync, since
 it will do batch sorts of input events. Similarly, you can do traces over
-the network with eg netcat:
+the network. The network 'server' must run:
 
-% blktrace -d /dev/sda -o - | netcat parsehost portno
-% netcat -l -p portno tracehost | blkparse -i -
+% blktrace -l
+
+to listen to incoming blktrace connections, while the client should use
+
+% blktrace -d /dev/sda -h <server hostname>
+
+to connect and transfer data over the network.
 
-Which will send the traces from tracehost to parsehost over the network on
-the defined port number.
 
 Documentation
 -------------
diff --git a/blktrace.c b/blktrace.c
index 23f7fc3..2cd1105 100644
--- a/blktrace.c
+++ b/blktrace.c
@@ -1356,7 +1356,11 @@ static char usage_str[] = \
 	"\t-A Give trace mask as a single value. See documentation\n" \
 	"\t-b Sub buffer size in KiB\n" \
 	"\t-n Number of sub buffers\n" \
-	"\t-v Print program version info\n\n";
+	"\t-l Run in network listen mode (blktrace server)\n" \
+	"\t-h Run in network client mode, connecting to the given host\n" \
+	"\t-p Network port to use (default 8462)\n" \
+	"\t-s Make the network client use sendfile() to transfer data\n" \
+	"\t-V Print program version info\n\n";
 
 static void show_usage(char *program)
 {