home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / man / cat1 / gunzip.0 < prev    next >
Text File  |  1993-12-07  |  19KB  |  463 lines
  1.  
  2.  
  3.  
  4. GZIP(1)                                                   GZIP(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        gzip, gunzip, zcat - compress or expand files
  9.  
  10. SSYYNNOOPPSSIISS
  11.        ggzziipp [ --aaccddffhhllLLnnNNrrttvvVV1199 ] [--SS ssuuffffiixx] [ _n_a_m_e _._._.  ]
  12.        gguunnzziipp [ --aaccffhhllLLnnNNrrttvvVV ] [--SS ssuuffffiixx] [ _n_a_m_e _._._.  ]
  13.        zzccaatt [ --ffhhLLVV ] [ _n_a_m_e _._._.  ]
  14.  
  15. DDEESSCCRRIIPPTTIIOONN
  16.        _G_z_i_p  reduces the size of the named files using Lempel-Ziv
  17.        coding (LZ77).  Whenever possible, each file  is  replaced
  18.        by one with the extension ..ggzz,, while keeping the same own-
  19.        ership modes, access and modification times.  (The default
  20.        extension  is  --ggzz for VMS, zz for MSDOS, OS/2 FAT, Windows
  21.        NT FAT and Atari.)  If no files are  specified,  or  if  a
  22.        file  name is "-", the standard input is compressed to the
  23.        standard output.  _G_z_i_p will only attempt to compress regu-
  24.        lar  files.  In particular, it will ignore symbolic links.
  25.  
  26.        If the compressed file name is too long for its file  sys-
  27.        tem,  _g_z_i_p  truncates  it.  _G_z_i_p attempts to truncate only
  28.        the parts of the file name longer than 3  characters.   (A
  29.        part  is delimited by dots.) If the name consists of small
  30.        parts only, the longest parts are truncated. For  example,
  31.        if file names are limited to 14 characters, gzip.msdos.exe
  32.        is compressed to gzi.msd.exe.gz.  Names are not  truncated
  33.        on  systems which do not have a limit on file name length.
  34.  
  35.        By default, _g_z_i_p keeps the original file name  and  times-
  36.        tamp  in  the  compressed file. These are used when decom-
  37.        pressing the file with the --NN option. This is useful  when
  38.        the  compressed  file  name was truncated or when the time
  39.        stamp was not preserved after a file transfer.
  40.  
  41.        Compressed files can be restored to  their  original  form
  42.        using  _g_z_i_p  _-_d  or  _g_u_n_z_i_p or _z_c_a_t_.  If the original name
  43.        saved in the compressed file is not suitable for its  file
  44.        system, a new name is constructed from the original one to
  45.        make it legal.
  46.  
  47.        _g_u_n_z_i_p takes a list of  files  on  its  command  line  and
  48.        replaces  each file whose name ends with .gz, -gz, .z, -z,
  49.        _z or .Z and which begins with the  correct  magic  number
  50.        with  an uncompressed file without the original extension.
  51.        _g_u_n_z_i_p also recognizes the  special  extensions  ..ttggzz  and
  52.        ..ttaazz  as  shorthands  for ..ttaarr..ggzz and ..ttaarr..ZZ respectively.
  53.        When compressing, _g_z_i_p uses the ..ttggzz extension  if  neces-
  54.        sary instead of truncating a file with a ..ttaarr extension.
  55.  
  56.        _g_u_n_z_i_p  can  currently  decompress  files created by _g_z_i_p_,
  57.        _z_i_p_, _c_o_m_p_r_e_s_s_, _c_o_m_p_r_e_s_s _-_H or _p_a_c_k_.  The detection of  the
  58.        input  format is automatic.  When using the first two for-
  59.        mats, _g_u_n_z_i_p checks a 32 bit CRC. For _p_a_c_k_, _g_u_n_z_i_p  checks
  60.        the  uncompressed length. The standard _c_o_m_p_r_e_s_s format was
  61.  
  62.  
  63.  
  64.                               local                             1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. GZIP(1)                                                   GZIP(1)
  71.  
  72.  
  73.        not designed to allow consistency checks.  However  _g_u_n_z_i_p
  74.        is  sometimes  able to detect a bad .Z file. If you get an
  75.        error when uncompressing a .Z file, do not assume that the
  76.        .Z  file is correct simply because the standard _u_n_c_o_m_p_r_e_s_s
  77.        does not complain. This generally means that the  standard
  78.        _u_n_c_o_m_p_r_e_s_s does not check its input, and happily generates
  79.        garbage output.  The SCO compress -H format (lzh  compres-
  80.        sion  method)  does not include a CRC but also allows some
  81.        consistency checks.
  82.  
  83.        Files created by _z_i_p can be uncompressed by gzip  only  if
  84.        they  have a single member compressed with the 'deflation'
  85.        method. This feature is only intended to  help  conversion
  86.        of  tar.zip  files  to  the  tar.gz format. To extract zip
  87.        files with several members, use _u_n_z_i_p instead of _g_u_n_z_i_p_.
  88.  
  89.        _z_c_a_t is identical to _g_u_n_z_i_p --cc..  (On  some  systems,  _z_c_a_t
  90.        may be installed as _g_z_c_a_t to preserve the original link to
  91.        _c_o_m_p_r_e_s_s_._)  _z_c_a_t uncompresses either a list  of  files  on
  92.        the  command  line  or  its  standard input and writes the
  93.        uncompressed data on standard output.   _z_c_a_t  will  uncom-
  94.        press  files  that  have  the correct magic number whether
  95.        they have a ..ggzz suffix or not.
  96.  
  97.        _G_z_i_p uses the Lempel-Ziv algorithm used in _z_i_p and  PKZIP.
  98.        The  amount of compression obtained depends on the size of
  99.        the input and the distribution of common substrings.  Typ-
  100.        ically,  text such as source code or English is reduced by
  101.        60-70%.  Compression is generally much  better  than  that
  102.        achieved  by LZW (as used in _c_o_m_p_r_e_s_s), Huffman coding (as
  103.        used in _p_a_c_k), or adaptive Huffman coding (_c_o_m_p_a_c_t).
  104.  
  105.        Compression is always performed, even  if  the  compressed
  106.        file  is slightly larger than the original. The worst case
  107.        expansion is a few bytes for the gzip file header, plus  5
  108.        bytes every 32K block, or an expansion ratio of 0.015% for
  109.        large files. Note that the  actual  number  of  used  disk
  110.        blocks  almost  never increases.  _g_z_i_p preserves the mode,
  111.        ownership and timestamps  of  files  when  compressing  or
  112.        decompressing.
  113.  
  114.  
  115. OOPPTTIIOONNSS
  116.        --aa ----aasscciiii
  117.               Ascii  text  mode: convert end-of-lines using local
  118.               conventions. This option is supported only on  some
  119.               non-Unix  systems. For MSDOS, CR LF is converted to
  120.               LF when compressing, and LF is converted to  CR  LF
  121.               when decompressing.
  122.  
  123.        --cc ----ssttddoouutt ----ttoo--ssttddoouutt
  124.               Write  output  on  standard  output;  keep original
  125.               files unchanged.  If there are several input files,
  126.               the  output consists of a sequence of independently
  127.  
  128.  
  129.  
  130.                               local                             2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. GZIP(1)                                                   GZIP(1)
  137.  
  138.  
  139.               compressed members. To obtain  better  compression,
  140.               concatenate  all  input  files  before  compressing
  141.               them.
  142.  
  143.        --dd ----ddeeccoommpprreessss ----uunnccoommpprreessss
  144.               Decompress.
  145.  
  146.        --ff ----ffoorrccee
  147.               Force compression or decompression even if the file
  148.               has   multiple  links  or  the  corresponding  file
  149.               already exists, or if the compressed data  is  read
  150.               from or written to a terminal. If the input data is
  151.               not in a format recognized  by  _g_z_i_p_,  and  if  the
  152.               option  --stdout is also given, copy the input data
  153.               without change to  the  standard  ouput:  let  _z_c_a_t
  154.               behave  as  _c_a_t_.   If --ff is not given, and when not
  155.               running in the background, _g_z_i_p prompts  to  verify
  156.               whether an existing file should be overwritten.
  157.  
  158.        --hh ----hheellpp
  159.               Display a help screen and quit.
  160.  
  161.        --ll ----lliisstt
  162.               For   each  compressed  file,  list  the  following
  163.               fields:
  164.  
  165.                   compressed size: size of the compressed file
  166.                   uncompressed size:  size  of  the  uncompressed
  167.               file
  168.                   ra