Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
zzcat(1)		     General Commands Manual			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 standard
     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  emu-
     late 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 ob-
	    tained 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 (C) 2002-2010 Sam Hocevar <sam@hocevar.net>.

     zzcat and this manual page are free software. They come  without  any  war-
     ranty, 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 Pub-
     lic    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/in-
     ternals.

zzcat 0.13			   2010-01-07				zzcat(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=zzcat&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help