home *** CD-ROM | disk | FTP | other *** search
/ Byte OS/2 Programmer's Cookbook / OS2TOOLS.ISO / bin / unzip.doc < prev    next >
Text File  |  1992-08-21  |  9KB  |  249 lines
  1.  
  2. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  3.  
  4. NAME
  5.      unzip - list/test/extract from a ZIP archive file
  6.  
  7. SYNOPSIS
  8.      unzip [ -cflptuvxz[ajnoqUV] ] file[.zip] [filespec ...]
  9.  
  10. ARGUMENTS
  11.      file[.zip]  Path of the ZIP archive.  The suffix ``.zip'' is
  12.                  applied  if  the  file specified does not exist.
  13.                  Note that self-extracting  ZIP  files  are  sup-
  14.                  ported;  just  specify the ``.exe'' suffix your-
  15.                  self.
  16.  
  17.      [filespec]  An optional list of archive members to  be  pro-
  18.                  cessed.  Expressions may be used to match multi-
  19.                  ple members; be sure to quote  expressions  that
  20.                  contain  characters interpreted by the operating
  21.                  system.  See  DESCRIPTION   (below)   for   more
  22.                  details.
  23.  
  24. OPTIONS
  25.      -c  extract files to stdout/screen (``CRT'')
  26.      -f  freshen existing files (replace if newer); create none
  27.      -l  list archive files (short format)
  28.      -p  extract files to pipe; no informational messages
  29.      -t  test archive files
  30.      -u  update existing files; create new ones if needed
  31.      -v  list archive files (verbose format)
  32.      -x  extract files in archive (default)
  33.      -z  display only the archive comment
  34.  
  35. MODIFIERS
  36.      -a  convert to MS-DOS textfile format (CR  LF),  Mac  format
  37.          (CR),  Unix/VMS  format  (LF),  OR from ASCII to EBCDIC,
  38.          depending on your system (only use for TEXT files!)
  39.      -j  junk paths (don't recreate  archive's  directory  struc-
  40.          ture)
  41.      -n  never overwrite existing files; don't prompt
  42.      -o  OK to overwrite files without prompting
  43.      -q  perform operations quietly (-qq => even quieter)
  44.      -s  [OS/2,  MS-DOS]  allow  spaces   in   filenames   (e.g.,
  45.          ``EA DATA. SF'')
  46.      -U  leave filenames uppercase if created under MS-DOS,  VMS,
  47.          etc.
  48.      -V  retain (VMS) file version numbers
  49.      -X  [VMS]  restore  owner/protection   info   (may   require
  50.          privileges)
  51.  
  52. DESCRIPTION
  53.      UnZip will list, test, or extract from a ZIP  archive,  com-
  54.      monly  found on MSDOS systems.  Archive member extraction is
  55.      implied by the absence of the -c,  -p,  -t,  -l,  -v  or  -z
  56.  
  57. Info-ZIP          Last change: 22 Aug 92 (v5.0)                 1
  58.  
  59. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  60.  
  61.      options.    All  archive  members  are  processed  unless  a
  62.      filespec is provided to specify  a  subset  of  the  archive
  63.      members.   The  filespec  is similar to an egrep expression,
  64.      and may contain:
  65.  
  66.      *      matches a sequence of 0 or more characters
  67.      ?      matches exactly 1 character
  68.      \nnn   matches the character having octal code nnn
  69.      [...]  matches any single character found inside the  brack-
  70.             ets; ranges are specified by a beginning character, a
  71.             hyphen, and an ending character.  If  an  exclamation
  72.             point  or  a  carat  (`!'  or  `^')  follows the left
  73.             bracket, then the range of characters matched is com-
  74.             plemented  with  respect  to  the ASCII character set
  75.             (that is, anything except the characters  inside  the
  76.             brackets is considered a match).
  77.  
  78. ENVIRONMENT OPTIONS
  79.      UnZip's default behavior may be modified via options  placed
  80.      in  an  environment  variable.   This  can  be done with any
  81.      option, but it is probably most useful with the -q,  -o,  or
  82.      -n modifiers:  in order to make UnZip quieter by default, or
  83.      to make it always overwrite or never overwrite files  as  it
  84.      extracts them.  For example, to make UnZip act as quietly as
  85.      possible, only reporting errors, one would use  one  of  the
  86.      following commands:
  87.  
  88.            setenv UNZIP -qq           Unix C shell
  89.  
  90.            UNZIP=-qq; export UNZIP    Unix Bourne shell
  91.  
  92.            set UNZIP=-qq              OS/2 or MS-DOS
  93.  
  94.            define UNZIP_OPTS "-qq"    VMS (quotes for LOWERCASE)
  95.  
  96.      Environment options are, in effect, considered  to  be  just
  97.      like  any  other  command-line options, except that they are
  98.      effectively the first options on the command line.  To over-
  99.      ride  an  environment option, one may use the ``minus opera-
  100.      tor'' to remove it.  For instance, to override  one  of  the
  101.      quiet-flags in the example above, use the command
  102.  
  103.            unzip --q[other options] zipfile
  104.  
  105.      The first hyphen is the normal  switch  character,  and  the
  106.      second  is  a  minus sign, acting on the q option.  Thus the
  107.      effect here is to cancel a single quantum of quietness.   To
  108.      cancel both quiet flags, two (or more) minuses may be used:
  109.  
  110.            unzip -x--q zipfile
  111.  
  112. Info-ZIP          Last change: 22 Aug 92 (v5.0)                 2
  113.  
  114. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  115.  
  116.      or
  117.  
  118.            unzip ---qx zipfile
  119.  
  120.      (the two are equivalent).  This may seem awkward or  confus-
  121.      ing,  but it is reasonably intuitive:  just ignore the first
  122.      hyphen and go from there.  It is also  consistent  with  the
  123.      behavior of Unix nice(1).
  124.  
  125. EXAMPLES
  126.      To  use  UnZip  to  extract  all  members  of  the   archive
  127.      letters.zip, creating any directories as necessary:
  128.  
  129.            unzip letters
  130.  
  131.      To extract all members of letters.zip to the current  direc-
  132.      tory:
  133.  
  134.            unzip -j letters
  135.  
  136.      To test letters.zip, printing only a summary  message  indi-
  137.      cating whether the archive is OK or not:
  138.  
  139.            unzip -tq letters
  140.  
  141.      To extract to standard output  all  members  of  letters.zip
  142.      whose  names  end  in ``.tex'', converting to the local end-
  143.      of-line convention and piping the output into more(1):
  144.  
  145.            unzip -ca letters \*.tex | more
  146.  
  147.      (The backslash before the asterisk is only required  if  the
  148.      shell  expands  wildcards,  as  in Unix; double quotes could
  149.      have been used instead, as in the source example below.)  To
  150.      extract  the  binary  file paper1.dvi to standard output and
  151.      pipe it to a printing program:
  152.  
  153.            unzip -p articles paper1.dvi | dvips
  154.  
  155.      To extract all FORTRAN and C source  files--*.f,  *.c,  *.h,
  156.      Makefile  (the  double quotes are necessary only in Unix and
  157.      only if globbing is turned on):
  158.  
  159.            unzip source.zip "*.[fch]" Makefile
  160.  
  161.      To extract only newer versions of the files already  in  the
  162.      current  directory,  without  querying (NOTE:  be careful of
  163.      unzipping in one timezone a zipfile created in  another--ZIP
  164.      archives  contain  no  timezone information, and a ``newer''
  165.      file from an eastern timezone may, in fact, be older):
  166.  
  167. Info-ZIP          Last change: 22 Aug 92 (v5.0)                 3
  168.  
  169. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  170.  
  171.            unzip -fo sources
  172.  
  173.      To extract newer  versions  of  the  files  already  in  the
  174.      current  directory and to create any files not already there
  175.      (same caveat as previous example):
  176.  
  177.            unzip -uo sources
  178.  
  179.      In the last five examples, assume that UNZIP  or  UNZIP_OPTS
  180.      is set to -q.  To do a singly quiet listing:
  181.  
  182.            unzip -l file
  183.  
  184.      To do a doubly quiet listing:
  185.  
  186.            unzip -ql file
  187.  
  188.      To do a standard listing:
  189.  
  190.            unzip --ql file
  191.  
  192.      or
  193.  
  194.            unzip -l-q file
  195.  
  196.      or
  197.  
  198.            unzip -l--q file
  199.  
  200.      (extra minuses don't hurt).
  201.  
  202. TIPS
  203.      The current maintainer, being a lazy  sort,  finds  it  very
  204.      useful to define an alias ``tt'' for ``unzip -tq''.  One may
  205.      then simply type ``tt zipfile'' to test the  archive,  some-
  206.      thing  which  one  ought  make  a habit of doing.  With luck
  207.      UnZip will report ``No  errors  detected  in  zipfile.zip,''
  208.      after which one may breathe a sigh of relief.
  209.  
  210. SEE ALSO
  211.      funzip(1),  zip(1),  zipcloak(1),  zipinfo(1),   zipnote(1),
  212.      zipsplit(1)
  213.  
  214. AUTHORS
  215.      Samuel H. Smith, Carl Mascott, David P. Kirschbaum, Greg  R.
  216.      Roelofs,  Mark  Adler,  Kai  Uwe  Rommel, Igor Mandrichenko,
  217.      Johnny Lee, Jean-loup Gailly; Glenn  Andrews,  Joel  Aycock,
  218.      Allan  Bjorklund,  James  Birdsall,  Wim Bonner, John Cowan,
  219.      Frank da Cruz, B