NAME¶
zzat - concatenate files using different instruction sequences
SYNOPSIS¶
zzat [
-AbdeEntTv] [
-r loops] [
-x
sequence] [
FILE]...
zzat -l |
--list
zzat -h |
--help
zzat -V |
--version
DESCRIPTION¶
The
zzat utility reads files sequentially, writing them to the standard
output. The user can decide which sequence of library calls is used to seek
and read data.
zzat 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 program.
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:
zzat -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:
zzat -x 'fread(1,1000)' f
Read the first four bytes of f, using four different instructions:
zzat -x 'getc(),fgetc(),getc_unlocked(),_IO_getc()' f
Read f entirely, by calling
getc() repeatedly until end-of-file is
reached:
zzat -x 'repeat(-1, getc(), feof(1))' f
Read f entirely, in chunks of 32768 bytes until end-of-file is reached:
zzat -x 'repeat(-1, fread(1,32768), feof(1))' f
SEE ALSO¶
zzuf(3),
libzzuf(3)
AUTHOR¶
Copyright © 2002-2010 Sam Hocevar <sam@hocevar.net>.
zzat and this manual page are free software. They come without any
warranty, to the extent permitted by applicable law. You can redistribute 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
overview of the architecture and inner works is at
http://caca.zoy.org/wiki/zzuf/internals.