NAME

SYNOPSIS

DESCRIPTION

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 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:

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

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

AUTHOR

zzcat 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.