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

FreeBSD Manual Pages

  
 
  

home | help
lizard(1)			 User Commands			     lizard(1)

NAME
       lizard, unlizard, lizardcat - Compress or decompress .liz files

SYNOPSIS
       lizard [OPTIONS]	[-|INPUT-FILE] <OUTPUT-FILE>

       unlizard	is equivalent to lizard	-d
       lizardcat is equivalent to lizard -dc

       When  writing  scripts that need	to decompress files, it	is recommended
       to always use the name lizard with appropriate arguments	(lizard	-d  or
       lizard -dc) instead of the names	unlizard and lizardcat.

DESCRIPTION
       lizard  is  an  extremely fast lossless compression algorithm, based on
       byte-aligned  LZ77  family  of  compression  scheme.    lizard	offers
       compression  speeds of 400 MB/s per core, linearly scalable with	multi-
       core CPUs.  It features	an  extremely  fast  decoder,  with  speed  in
       multiple	 GB/s  per  core, typically reaching RAM speed limit on	multi-
       core systems.  The native file format is	the .liz format.

       lizard supports a command line syntax  similar  but  not	 identical  to
       gzip(1).	  Differences  are  :  lizard preserve original	files ;	lizard
       file1 file2 means : compress file1 into file2 ; lizard file shows real-
       time statistics during compression .

       Default behaviors can be	modified by opt-in commands, described	below.
       lizard --quiet --multiple more closely mimics gzip behavior.

   Concatenation of .liz files
       It is possible to concatenate .liz files	as is.	lizard will decompress
       such files as if	they were a single .liz	file. For example:
	 lizard	file1  > foo.liz
	 lizard	file2 >> foo.liz
	then
	 lizardcat foo.liz
	is equivalent to :
	 cat file1 file2

OPTIONS
   Short commands concatenation
       In  some	cases, some options can	be expressed using short command -x or
       long  command  --long-word  .   Short  commands	can  be	  concatenated
       together.  For  example,	 -d  -c	 is equivalent to -dc .	 Long commands
       cannot be concatenated.	They must be clearly separated by a space.

   Multiple commands
       When multiple contradictory commands are	issued on a same command line,
       only the	latest one will	be applied.

   Operation mode
       -z, --compress
	      Compress.	 This is the default operation mode when no  operation
	      mode  option  is	specified , no other operation mode is implied
	      from  the	 command   name	  (for	 example,   unlizard   implies
	      --decompress  ),	nor  from  the input file name (for example, a
	      file extension .liz implies --decompress by  default).   -z  can
	      also  be used to force compression of an already compressed .liz
	      file.

       -d, --decompress, --uncompress
	      Decompress.  --decompress	is also	the default operation when the
	      input filename has an .liz extensionq

       -t, --test
	      Test the integrity of compressed .liz files.   The  decompressed
	      data is discarded.  No files are created nor removed.

   Operation modifiers
       -1
	       fast compression	(default)

       -9
	       high compression

       -f, --[no-]force
	       This option has several effects:

	      	 If  the  target  file	already	 exists,  overwrite it without
		 prompting.

	      	 When used with	--decompress and lizard	cannot	recognize  the
		 type  of  the	source	file,  copy  the  source file as is to
		 standard output.  This	allows lizardcat --force  to  be  used
		 like  cat(1)  for  files  that	 have not been compressed with
		 lizard.

       -c, --stdout, --to-stdout
	       force write to standard output, even if it is the console

       -m, --multiple
	       Multiple	file names.
	       By default, the second filename	is  used  as  the  destination
	      filename for the compressed file.
	       With  -m	 , you can specify any number of input filenames. Each
	      of them will be compressed independently,	and the	resulting name
	      of each compressed file will be filename.liz

       -B#
	       block size [4-7](default	: 7)
	       B1  =  128KB,  B2=256KB,	 B3=1MB,  B4=4MB,  B5=16MB,   B6=64MB,
	      B7=256MB

       -BD
	       block dependency	(improves compression ratio on small blocks)

       --[no-]frame-crc
	       select frame checksum (default:enabled)

       --[no-]content-size
	       header includes original	size (default:not present)
	       Note : this option can only be activated	when the original size
	      can  be determined, hence	for a file. It won't work with unknown
	      source size, such	as stdin or pipe.

       --[no-]sparse
	       sparse mode  support  (default:enabled  on  file,  disabled  on
	      stdout)

       -l
	       use Legacy format (useful for Linux Kernel compression)

   Other options
       -v, --verbose
	       verbose mode

       -q, --quiet
	       suppress	 warnings  and	real-time statistics; specify twice to
	      suppress errors too

       -h/-H
	       display help/long help and exit

       -V, --version
	       display Version number and exit

       -k, --keep
	       Don't delete source file.  This is default behavior anyway,  so
	      this option is just for compatibility with gzip/xz.

       -b
	       benchmark file(s)

       -i#
	       iteration loops [1-9](default : 3), benchmark mode only

BUGS
       Report bugs at: https://github.com/inikep/lizard/issues

AUTHOR
       Yann Collet

lizard				  2015-03-21			     lizard(1)

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

home | help