Package: blktrace / 1.1.0-2+deb9u1

man.patch Patch series | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
Last-Update: 2015-03-25
Forwarded: no
Author: Dmitry Smirnov <onlyjob@member.fsf.org>
Description: man page lintianisation: hyphen-used-as-minus-sign

--- a/iowatcher/iowatcher.1
+++ b/iowatcher/iowatcher.1
@@ -14,15 +14,15 @@
 .TP
 \fB--help\fP
 Print a brief usage summary.
 .TP
-\fB-d, --device\fP \fIdevice\fP
+\fB-d, \--device\fP \fIdevice\fP
 Controls which device you are tracing.  You can only trace one device at a time for now.  It is sent directly to blktrace, and only needed when you are making a new trace.
 .TP
-\fB-D, --blktrace-destination\fP \fIdestination\fP
+\fB-D, \--blktrace-destination\fP \fIdestination\fP
 Destination for blktrace.
 .TP
-\fB-p, --prog\fP
+\fB-p, \--prog\fP
 Run a program while blktrace is run. The program and its arguments must be
 specified after all other options.  Note that this option previously required
 the program to be given as a single argument but it now tells \fBiowatcher\fP
 to expect extra arguments which it should be run during the trace.
@@ -31,69 +31,69 @@
 End option parsing. If \fB--prog\fP is specified, everything after \fB--\fP is
 the program to be run. This can be useful if the program name could otherwise
 be mistaken for an option.
 .TP
-\fB-K, --keep-movie-svgs\fP
+\fB-K, \--keep-movie-svgs\fP
 Keep the SVG files generated for movie mode.
 .TP
-\fB-t, --trace\fP \fIpath\fP
+\fB-t, \--trace\fP \fIpath\fP
 Specify the name of the file or directory in which blktrace output is located.
 \fBiowatcher\fP uses a dump from blkparse, so this option tries to guess the
 name of the corresponding per-CPU blktrace data files if the dump file doesn't
 already exist.  To add multiple traces to a given graph, you can specify
 \fB--trace\fP more than once.  If \fIpath\fP is a directory, \fBiowatcher\fP
 will use the name of the directory as the base name of the dump file and all
 trace files found inside the directory will be processed.
 .TP
-\fB-l, --label\fP \fIlabel\fP
+\fB-l, \--label\fP \fIlabel\fP
 Sets a label in the graph for a trace file.  The labels are added in the same order as the trace files.
 .TP
-\fB-m, --movie\fP \fI[style]\fP
+\fB-m, \--movie\fP \fI[style]\fP
 Create a movie.  The file format depends on the extension used in the \fB-o\fP
 \fIfile\fP option.  If you specify an .ogv or .ogg extension, the result will
 be Ogg Theora video, if png2theora is available.  If you use an .mp4 extension,
 the result will be an mp4 video if avconv is available.  You can use any other
 extension, but the end result will be an mp4.  The accepted \fIstyle\fP values
 are \fBspindle\fP for a circular disc-like effect (default) or \fBrect\fP for a
 rectangular graph style.
 .TP
-\fB-T, --title\fP \fItitle\fP
+\fB-T, \--title\fP \fItitle\fP
 Set a \fItitle\fP to be placed at the top of the graph.
 .TP
-\fB-o, --output\fP \fIfile\fP
+\fB-o, \--output\fP \fIfile\fP
 Output filename for the SVG image or video. The video format used will depend
 on the file name extension. See \fB--movie\fP for details.
 .TP
-\fB-r, --rolling\fP \fIseconds\fP
+\fB-r, \--rolling\fP \fIseconds\fP
 Control the duration for the rolling average.  \fBiowatcher\fP tries to smooth out bumpy graphs by averaging the current second with seconds from the past.  Larger numbers here give you flatter graphs.
 .TP
-\fB-h, --height\fP \fIheight\fP
+\fB-h, \--height\fP \fIheight\fP
 Set the height of each graph
 .TP
-\fB-w, --width\fP \fIwidth\fP
+\fB-w, \--width\fP \fIwidth\fP
 Set the width of each graph
 .TP
-\fB-c, --columns\fP \fIcolumns\fP
+\fB-c, \--columns\fP \fIcolumns\fP
 Number of columns in graph output
 .TP
-\fB-x, --xzoom\fP \fImin:max\fP
+\fB-x, \--xzoom\fP \fImin:max\fP
 Limit processed time range to \fImin:max\fP.
 .TP
-\fB-y, --yzoom\fP \fImin:max\fP
+\fB-y, \--yzoom\fP \fImin:max\fP
 Limit processed sectors to \fImin:max\fP.
 .TP
-\fB-a, --io-plot-action\fP \fIaction\fP
+\fB-a, \--io-plot-action\fP \fIaction\fP
 Plot \fIaction\fP (one of Q, D, or C) in the IO graph.
 .TP
-\fB-P, --per-process-io\fP
+\fB-P, \--per-process-io\fP
 Distinguish between processes in the IO graph.
 .TP
-\fB-O, --only-graph\fP \fIgraph\fP
+\fB-O, \--only-graph\fP \fIgraph\fP
 Add a single graph to the output (see section \fBGRAPHS\fP for options).  By
 default all graphs are included. Use \fB-O\fP to generate only the required
 graphs.  \fB-O\fP may be used more than once.
 .TP
-\fB-N, --no-graph\fP \fItype\fP
+\fB-N, \--no-graph\fP \fItype\fP
 Remove a single graph from the output (see section \fBGRAPHS\fP for options).
 This option may be used more than once.
 .SH GRAPHS
 Values accepted by the \fB-O\fP and \fB-N\fP options are:
@@ -103,39 +103,39 @@
 .SH EXAMPLES
 Generate graph from the existing trace.dump:
 .PP
 .RS
-# iowatcher -t trace
+# iowatcher \-t trace
 .RE
 .PP
 Skip the IO graph:
 .PP
 .RS
-# iowatcher -t trace.dump -o trace.svg -N io
+# iowatcher \-t trace.dump \-o trace.svg \-N io
 .RE
 .PP
 Only graph tput and latency:
 .PP
 .RS
-# iowatcher -t trace.dump -o trace.svg -O tput -O latency
+# iowatcher \-t trace.dump \-o trace.svg \-O tput \-O latency
 .RE
 .PP
 Generate a graph from two runs, and label them:
 .PP
 .RS
-# iowatcher -t ext4.dump -t xfs.dump -l Ext4 -l XFS -o trace.svg
+# iowatcher \-t ext4.dump \-t xfs.dump \-l Ext4 \-l XFS \-o trace.svg
 .RE
 .PP
 Run a fio benchmark and store the trace in trace.dump, add a title to the top, use /dev/sda for blktrace:
 .PP
 .RS
-# iowatcher -d /dev/sda -t trace.dump -T 'Fio Benchmark' -p fio some_job_file
+# iowatcher \-d /dev/sda \-t trace.dump \-T 'Fio Benchmark' \-p fio some_job_file
 .RE
 .PP
 Make a movie from an existing trace:
 .PP
 .RS
-# iowatcher -t trace --movie -o trace.mp4
+# iowatcher \-t trace \--movie \-o trace.mp4
 .RE
 
 .SH AUTHORS
 iowatcher was created and is maintained by Chris Mason.