zzcat man page on DragonFly
[printable version]
zzcat(1) zzcat(1)
NAME
zzcat - concatenate files using different instruction sequences
SYNOPSIS
zzcat [-AbdeEntTv] [-r loops] [-x sequence] [FILE]...
zzcat -l | --list
zzcat -h | --help
zzcat -V | --version
DESCRIPTION
The zzcat utility reads files sequentially, writing them to the stan‐
dard output. The user can decide which sequence of library calls is
used to seek and read data.
zzcat is primarily used as a debugging tool for zzuf, because it can
emulate different programs' ways to read files.
OPTIONS
-A, --show-all
Equivalent to -vET.
-b, --number-nonblank
Number nonempty output lines.
-d, --debug
Output debugging information.
-e Equivalent to -vET.
-E, --show-ends
Display $ at end of each line.
-n, --number
Number all output lines.
-r, --repeat=loops
Concatenate all files loops times.
-t Equivalent to -vT.
-T, --show-tabs
Display TAB characters as ^I.
-v, --show-nonprinting
Use ^ and M- notation, except for LFD and TAB.
-x, --execute=sequence
Read a file or a stream using the instruction sequence specified
in sequence.
Instructions are executed sequentially until the end of the pro‐
gram. End-of-file is not an exit condition, except where the
feof keyword is used:
fread(1,10); feof(1); fread(1,10)
Loops are permitted using the repeat keyword. Again, feof can be
used to prematurely break out of a loop:
repeat(10000, fgetc() feof(1))
Instructions can be separated by spaces, commas or semicolons.
A list of all available instructions and control keywords can be
obtained using this command:
zzcat -l
If no sequence is specified, the following default sequence is
used:
repeat(-1, fread(1,32768), feof(1))
-l, --list
Display the list of supported keywords and functions and exit.
-h, --help
Display a short help message and exit.
-V, --version
Output version information and exit.
EXAMPLES
Read the first 1000 bytes of f, then exit:
zzcat -x 'fread(1,1000)' f
Read the first four bytes of f, using four different instructions:
zzcat -x 'getc(),fgetc(),getc_unlocked(),_IO_getc()' f
Read f entirely, by calling getc() repeatedly until end-of-file is
reached:
zzcat -x 'repeat(-1, getc(), feof(1))' f
Read f entirely, in chunks of 32768 bytes until end-of-file is reached:
zzcat -x 'repeat(-1, fread(1,32768), feof(1))' f
SEE ALSO
zzuf(3), libzzuf(3)
AUTHOR
Copyright © 2002-2010 Sam Hocevar <sam@hocevar.net>.
zzcat and this manual page are free software. They come without any
warranty, to the extent permitted by applicable law. You can redis‐
tribute them and/or modify them under the terms of the Do What The Fuck
You Want To Public License, Version 2, as published by Sam Hocevar. See
http://sam.zoy.org/wtfpl/COPYING for more details.
zzuf's webpage can be found at http://caca.zoy.org/wiki/zzuf. An over‐
view of the architecture and inner works is at
http://caca.zoy.org/wiki/zzuf/internals.
zzcat 0.13 2010-01-07 zzcat(1)
[top]
List of man pages available for DragonFly
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
|
Vote for polarhome
|
