home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / archiver / gzip06st / gzip.doc < prev    next >
Text File  |  1993-07-07  |  7KB  |  161 lines
  1.  
  2. GZIP(1)                  USER COMMANDS                    GZIP(1)
  3.  
  4. NAME
  5.      gzip, gunzip, zcat - compress or expand files
  6.  
  7. SYNOPSIS
  8.      gzip [ -cdfhLrtvV19 ] [ name ... ]
  9.      gunzip [ -cfhLrtvV ] [ name ... ]
  10.      zcat [ -hLV ] [ name ... ]
  11.  
  12. DESCRIPTION
  13.      Gzip reduces the size of the named  files  using  Lempel-Ziv
  14.      coding  (LZ77).  Whenever possible, each file is replaced by
  15.      one with the extension .z, while keeping the same  ownership
  16.      modes,  access  and  modification  times.   If  no files are
  17.      specified, the standard input is compressed to the  standard
  18.      output.  If the new file name is too long, gzip truncates it
  19.      and keeps the original file name  in  the  compressed  file.
  20.      Gzip  will  only attempt to compress regular files.  In par-
  21.      ticular, it will ignore symbolic links.
  22.  
  23.      Compressed files can be  restored  to  their  original  form
  24.      using gzip -d or gunzip or zcat.
  25.  
  26.      gunzip takes a  list  of  files  on  its  command  line  and
  27.      replaces  each  file whose name ends with .z or .Z and which
  28.      begins with the correct magic number  with  an  uncompressed
  29.      file  without  the  original  extension.   gunzip is able to
  30.      extract files compressed with old versions of compress  (3.0
  31.      and  above)  and  pkzip  files which contain a single member
  32.      compressed with the  deflation  algorithm.   gunzip  chooses
  33.      automatically  the appropriate extraction algorithm, depend-
  34.      ing on the compression method.  The uncompressed  file  will
  35.      have  the  mode,  ownership and timestamps of the compressed
  36.      file.
  37.  
  38.      zcat is identical to gunzip -c. zcat uncompresses  either  a
  39.      list  of files on the command line or its standard input and
  40.      writes the uncompressed data on standard output.  zcat  will
  41.      uncompress  files that have the correct magic number whether
  42.      they have a .z suffix or not.
  43.  
  44.      Gzip uses the Lempel-Ziv algorithm used in zip and PKZIP.
  45.  
  46.      The amount of compression obtained depends on  the  size  of
  47.      the  input and the distribution of common substrings.  Typi-
  48.      cally, text such as source code or  English  is  reduced  by
  49.      60-70%.   Compression  is  generally  much  better than that
  50.      achieved by LZW (as used in compress),  Huffman  coding  (as
  51.      used in pack), or adaptive Huffman coding (compact).
  52.  
  53.      Multiple compressed files can be concatenated. In this case,
  54.      gunzip  will  extract  all members at once. If one member is
  55.      damaged,  other  members  might  still  be  recovered  after
  56.  
  57. Sun Release 4.1        Last change: local                       1
  58.  
  59. GZIP(1)                  USER COMMANDS                    GZIP(1)
  60.  
  61.      removal  of  the  damaged  member. Better compression can be
  62.      usually  obtained  if  all  members  are  decompressed  then
  63.      recompressed in a single step.
  64.  
  65. OPTIONS
  66.      -c --stdout
  67.           Write output on standard output;  keep  original  files
  68.           unchanged.   If there are several input files, the out-
  69.           put consists of a sequence of independently  compressed
  70.           members.  To obtain better compression, concatenate all
  71.           input files before compressing them.
  72.  
  73.      -d --decompress
  74.           Decompress.
  75.  
  76.      -f --force
  77.           Force compression even if the file has  multiple  links
  78.           or  the corresponding .z file already exists.  If -f is
  79.           not given, and when not running in the background, gzip
  80.           prompts to verify whether an existing .z file should be
  81.           overwritten.
  82.  
  83.      -h --help
  84.           Display a help screen.
  85.  
  86.      -L --license
  87.           Display the gzip license.
  88.  
  89.      -r --recurse
  90.           Travel the directory structure recursively. If  any  of
  91.           the file names specified on the command line are direc-
  92.           tories,  gzip  will  descend  into  the  directory  and
  93.           compress  all  the  files it finds there (or decompress
  94.           them in the case of gunzip ).
  95.  
  96.      -t --test
  97.           Test. Check the compressed file integrity.
  98.  
  99.      -v --verbose
  100.           Verbose. Display the name and percentage reduction  for
  101.           each file compressed.
  102.  
  103.      -V --version
  104.           Version. Display the  version  number  and  compilation
  105.           options.
  106.  
  107.      -# --fast --best
  108.           Regulate the speed of compression using  the  specified
  109.           digit  #,  where  -1  or  --fast  indicates the fastest
  110.           compression method (less compression) and -9 or  --best
  111.           indicates   the  slowest  compression  method  (optimal
  112.           compression).  The default compression level is -5.
  113.  
  114. Sun Release 4.1        Last change: local                       2
  115.  
  116. GZIP(1)                  USER COMMANDS                    GZIP(1)
  117.  
  118. SEE ALSO
  119.      pack(1), compact(1), compress(1), zip(1)
  120.  
  121. DIAGNOSTICS
  122.      Exit status is normally 0; if an error occurs,  exit  status
  123.      is 1.
  124.  
  125.      Usage: gzip [-cdfhLrtvV19] [file ...]
  126.              Invalid options were specified on the command line.
  127.      file: not in gzip format
  128.              The  file  specified  to   gunzip   has   not   been
  129.              compressed.
  130.      file: compressed with xx bits, can only handle yy bits
  131.              File was compressed (using LZW) by  a  program  that
  132.              could  deal  with more bits than the decompress code
  133.              on this machine.  Recompress  the  file  with  gzip,
  134.              which compresses better and uses less memory.
  135.      file: already has .z suffix -- no change
  136.              The  file  is  assumed  to  be  already  compressed.
  137.              Rename the file and try again.
  138.      file already exists; do you wish to overwrite (y or n)?
  139.              Respond "y" if  you  want  the  output  file  to  be
  140.              replaced; "n" if not.
  141.      gunzip: corrupt input
  142.              A SIGSEGV violation was detected which usually means
  143.              that the input file has been corrupted.
  144.      xx.x%
  145.              Percentage  of  the  input  saved  by   compression.
  146.              (Relevant only for -v.)
  147.      -- not a regular file or directory: ignored
  148.              When the input file is not a regular file or  direc-
  149.              tory,  (e.g.  a  symbolic link, socket, FIFO, device
  150.              file), it is left unaltered.
  151.      -- has xx other links: unchanged
  152.              The input file has links; it is left unchanged.  See
  153.              ln(1) for more information. Use the -f flag to force
  154.              compression of multiply-linked files.
  155.  
  156. BUGS
  157.      The .z extension is already used by pack(1).
  158.  
  159. Sun Release 4.1        Last change: local                       3
  160.  
  161.