home *** CD-ROM | disk | FTP | other *** search
/ PDA Software Library / pdasoftwarelib.iso / PSION / UTILS / S3UZIP15 / UNZIP.DOC < prev    next >
Encoding:
Text File  |  1992-08-22  |  9.6 KB  |  252 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.  
  45. [DP: The following switches are not supported in the EPOC version]
  46.  
  47.      -s  [OS/2,  MS-DOS]  allow  spaces   in   filenames   (e.g.,
  48.          ``EA DATA. SF'')
  49.      -U  leave filenames uppercase if created under MS-DOS,  VMS,
  50.          etc.
  51.      -V  retain (VMS) file version numbers
  52.      -X  [VMS]  restore  owner/protection   info   (may   require
  53.          privileges)
  54.  
  55. DESCRIPTION
  56.      UnZip will list, test, or extract from a ZIP  archive,  com-
  57.      monly  found on MSDOS systems.  Archive member extraction is
  58.      implied by the absence of the -c,  -p,  -t,  -l,  -v  or  -z
  59.  
  60. Info-ZIP          Last change: 22 Aug 92 (v5.0)                 1
  61.  
  62. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  63.  
  64.      options.    All  archive  members  are  processed  unless  a
  65.      filespec is provided to specify  a  subset  of  the  archive
  66.      members.   The  filespec  is similar to an egrep expression,
  67.      and may contain:
  68.  
  69.      *      matches a sequence of 0 or more characters
  70.      ?      matches exactly 1 character
  71.      \nnn   matches the character having octal code nnn
  72.      [...]  matches any single character found inside the  brack-
  73.             ets; ranges are specified by a beginning character, a
  74.             hyphen, and an ending character.  If  an  exclamation
  75.             point  or  a  carat  (`!'  or  `^')  follows the left
  76.             bracket, then the range of characters matched is com-
  77.             plemented  with  respect  to  the ASCII character set
  78.             (that is, anything except the characters  inside  the
  79.             brackets is considered a match).
  80.  
  81. ENVIRONMENT OPTIONS
  82.      UnZip's default behavior may be modified via options  placed
  83.      in  an  environment  variable.   This  can  be done with any
  84.      option, but it is probably most useful with the -q,  -o,  or
  85.      -n modifiers:  in order to make UnZip quieter by default, or
  86.      to make it always overwrite or never overwrite files  as  it
  87.      extracts them.  For example, to make UnZip act as quietly as
  88.      possible, only reporting errors, one would use  one  of  the
  89.      following commands:
  90.  
  91.            setenv UNZIP -qq           Unix C shell
  92.  
  93.            UNZIP=-qq; export UNZIP    Unix Bourne shell
  94.  
  95.            set UNZIP=-qq              OS/2 or MS-DOS
  96.  
  97.            define UNZIP_OPTS "-qq"    VMS (quotes for LOWERCASE)
  98.  
  99.      Environment options are, in effect, considered  to  be  just
  100.      like  any  other  command-line options, except that they are
  101.      effectively the first options on the command line.  To over-
  102.      ride  an  environment option, one may use the ``minus opera-
  103.      tor'' to remove it.  For instance, to override  one  of  the
  104.      quiet-flags in the example above, use the command
  105.  
  106.            unzip --q[other options] zipfile
  107.  
  108.      The first hyphen is the normal  switch  character,  and  the
  109.      second  is  a  minus sign, acting on the q option.  Thus the
  110.      effect here is to cancel a single quantum of quietness.   To
  111.      cancel both quiet flags, two (or more) minuses may be used:
  112.  
  113.            unzip -x--q zipfile
  114.  
  115. Info-ZIP          Last change: 22 Aug 92 (v5.0)                 2
  116.  
  117. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  118.  
  119.      or
  120.  
  121.            unzip ---qx zipfile
  122.  
  123.      (the two are equivalent).  This may seem awkward or  confus-
  124.      ing,  but it is reasonably intuitive:  just ignore the first
  125.      hyphen and go from there.  It is also  consistent  with  the
  126.      behavior of Unix nice(1).
  127.  
  128. EXAMPLES
  129.      To  use  UnZip  to  extract  all  members  of  the   archive
  130.      letters.zip, creating any directories as necessary:
  131.  
  132.            unzip letters
  133.  
  134.      To extract all members of letters.zip to the current  direc-
  135.      tory:
  136.  
  137.            unzip -j letters
  138.  
  139.      To test letters.zip, printing only a summary  message  indi-
  140.      cating whether the archive is OK or not:
  141.  
  142.            unzip -tq letters
  143.  
  144.      To extract to standard output  all  members  of  letters.zip
  145.      whose  names  end  in ``.tex'', converting to the local end-
  146.      of-line convention and piping the output into more(1):
  147.  
  148.            unzip -ca letters \*.tex | more
  149.  
  150.      (The backslash before the asterisk is only required  if  the
  151.      shell  expands  wildcards,  as  in Unix; double quotes could
  152.      have been used instead, as in the source example below.)  To
  153.      extract  the  binary  file paper1.dvi to standard output and
  154.      pipe it to a printing program:
  155.  
  156.            unzip -p articles paper1.dvi | dvips
  157.  
  158.      To extract all FORTRAN and C source  files--*.f,  *.c,  *.h,
  159.      Makefile  (the  double quotes are necessary only in Unix and
  160.      only if globbing is turned on):
  161.  
  162.            unzip source.zip "*.[fch]" Makefile
  163.  
  164.      To extract only newer versions of the files already  in  the
  165.      current  directory,  without  querying (NOTE:  be careful of
  166.      unzipping in one timezone a zipfile created in  another--ZIP
  167.      archives  contain  no  timezone information, and a ``newer''
  168.      file from an eastern timezone may, in fact, be older):
  169.  
  170. Info-ZIP          Last change: 22 Aug 92 (v5.0)                 3
  171.  
  172. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  173.  
  174.            unzip -fo sources
  175.  
  176.      To extract newer  versions  of  the  files  already  in  the
  177.      current  directory and to create any files not already there
  178.      (same caveat as previous example):
  179.  
  180.            unzip -uo sources
  181.  
  182.      In the last five examples, assume that UNZIP  or  UNZIP_OPTS
  183.      is set to -q.  To do a singly quiet listing:
  184.  
  185.            unzip -l file
  186.  
  187.      To do a doubly quiet listing:
  188.  
  189.            unzip -ql file
  190.  
  191.      To do a standard listing:
  192.  
  193.            unzip --ql file
  194.  
  195.      or
  196.  
  197.            unzip -l-q file
  198.  
  199.      or
  200.  
  201.            unzip -l--q file
  202.  
  203.      (extra minuses don't hurt).
  204.  
  205. TIPS
  206.      The current maintainer, being a lazy  sort,  finds  it  very
  207.      useful to define an alias ``tt'' for ``unzip -tq''.  One may
  208.      then simply type ``tt zipfile'' to test the  archive,  some-
  209.      thing  which  one  ought  make  a habit of doing.  With luck
  210.      UnZip will report ``No  errors  detected  in  zipfile.zip,''
  211.      after which one may breathe a sigh of relief.
  212.  
  213. SEE ALSO
  214.      funzip(1),  zip(1),  zipcloak(1),  zipinfo(1),   zipnote(1),
  215.      zipsplit(1)
  216.  
  217. AUTHORS
  218.      Samuel H. Smith, Carl Mascott, David P. Kirschbaum, Greg  R.
  219.      Roelofs,  Mark  Adler,  Kai  Uwe  Rommel, Igor Mandrichenko,
  220.      Johnny Lee, Jean-loup Gailly; Glenn  Andrews,  Joel  Aycock,
  221.      Allan  Bjorklund,  James  Birdsall,  Wim Bonner, John Cowan,
  222.      Frank da Cruz, Bill Davidsen, Arjan de Vet, James Dugal, Jim
  223.      Dumser,  Mark  Edwards, David Feinleib, Mike Freeman, Hunter
  224.      Goatley, Robert Heath, Dave  Heiland,  Larry  Jones,  Kjetil
  225.      J(o)rgenson,  Bob Kemp, J. Kercheval, Alvin Koh, Bo Kullmar,
  226.  
  227. Info-ZIP          Last change: 22 Aug 92 (v5.0)                 4
  228.  
  229. UNZIP(1)                 USER COMMANDS                   UNZIP(1)
  230.  
  231.      Johnny Lee, Warner Losh, Fulvio Marino,  Gene  McManus,  Joe
  232.      Meadows,  Mike  O'Carroll,  Humberto  Ortiz-Zuazaga, Piet W.
  233.      Plomp, Antonio Querubin Jr., Steve Salisbury, Georg  Sassen,
  234.      Jon  Saxton,  Hugh Schmidt, Martin Schulz, Charles Scripter,
  235.      Chris Seaman, Richard Seay, Alex Sergejew,  Cliff  Stanford,
  236.      Onno  van der Linden, Jim Van Zandt, Antoine Verheijen, Paul
  237.      Wells.
  238.  
  239. VERSIONS
  240.      v1.2  15 Mar 89  Samuel H. Smith
  241.      v2.0   9 Sep 89  Samuel H. Smith
  242.      v2.x  fall 1989  many Usenet contributors
  243.      v3.0   1 May 90  Info-ZIP (DPK, consolidator)
  244.      v3.1  15 Aug 90  Info-ZIP (DPK, consolidator)
  245.      v4.0   1 Dec 90  Info-ZIP (GRR, maintainer)
  246.      v4.1  12 May 91  Info-ZIP
  247.      v4.2  20 Mar 92  Info-ZIP (zip-bugs subgroup; GRR, maint.)
  248.      v5.0  21 Aug 92  Info-ZIP (zip-bugs subgroup; GRR, maint.)
  249.  
  250. Info-ZIP          Last change: 22 Aug 92 (v5.0)                 5
  251.  
  252.