source: zzuf/trunk/doc/zzcat.1.in @ 4255

Last change on this file since 4255 was 4255, checked in by Sam Hocevar, 11 years ago

Improve the default zzcat sequence to improve performance.

File size: 2.2 KB
Line 
1.TH zzcat 1 "2010-01-07" "zzcat @PACKAGE_VERSION@"
2.SH NAME
3zzcat \- debugging tool for zzuf
4.SH SYNOPSIS
5\fBzzcat\fR [\fB\-AbeEntTv\fR] [\fB\-x\fR \fIsequence\fR] [\fIFILE\fR]...
6.br
7\fBzzcat \-l\fR | \fB\-\-list\fR
8.br
9\fBzzcat \-h\fR | \fB\-\-help\fR
10.br
11\fBzzcat \-V\fR | \fB\-\-version\fR
12.SH DESCRIPTION
13.PP
14The \fBzzcat\fR utility reads files sequentially, writing them to the
15standard output. The user can decide which sequence of library calls is
16used to seek and read data.
17
18\fBzzcat\fR is primarily used as a debugging tool for \fBzzuf\fR.
19.SH USAGE
20.PP
21\fB    zzcat -x "fread(1,10000)" /dev/zero\fR
22.SH OPTIONS
23.TP
24\fB\-A\fR, \fB\-\-show\-all\fR
25Equivalent to \fB\-vET\fR.
26.TP
27\fB\-b\fR, \fB\-\-number\-nonblank\fR
28Number nonempty output lines.
29.TP
30\fB\-e\fR
31Equivalent to \fB\-vET\fR.
32.TP
33\fB\-E\fR, \fB\-\-show\-ends\fR
34Display $ at end of each line.
35.TP
36\fB\-n\fR, \fB\-\-number\fR
37Number all output lines.
38.TP
39\fB\-t\fR
40Equivalent to \fB\-vT\fR.
41.TP
42\fB\-T\fR, \fB\-\-show\-tabs\fR
43Display TAB characters as ^I.
44.TP
45\fB\-v\fR, \fB\-\-show\-nonprinting\fR
46Use ^ and M- notation, except for LFD and TAB.
47.TP
48\fB\-x\fR, \fB\-\-execute\fR=\fIsequence\fR
49Read a file or a stream using the instruction sequence specified in
50\fIsequence\fR.
51
52If no sequence is specified, the following default sequence is used:
53
54\fB    repeat(\-1, fread(1,32768), feof(1))
55.TP
56\fB\-l\fR, \fB\-\-list\fR
57Display the list of supported keywords and functions and exit.
58.TP
59\fB\-h\fR, \fB\-\-help\fR
60Display a short help message and exit.
61.TP
62\fB\-V\fR, \fB\-\-version\fR
63Output version information and exit.
64.SH EXAMPLES
65.PP
66To do.
67.SH SEE ALSO
68.PP
69\fBzzuf(3)\fR, \fBlibzzuf(3)\fR
70.SH AUTHOR
71.PP
72Copyright \(co 2002\-2010 Sam Hocevar <sam@hocevar.net>.
73.PP
74\fBzzcat\fR and this manual page are free software. They come without any
75warranty, to the extent permitted by applicable law. You can redistribute
76them and/or modify them under the terms of the Do What The Fuck You Want
77To Public License, Version 2, as published by Sam Hocevar. See
78\fBhttp://sam.zoy.org/wtfpl/COPYING\fR for more details.
79.PP
80\fBzzuf\fR's webpage can be found at \fBhttp://caca.zoy.org/wiki/zzuf\fR.
81An overview of the architecture and inner works is at
82\fBhttp://caca.zoy.org/wiki/zzuf/internals\fR.
Note: See TracBrowser for help on using the repository browser.