Return to unzip.doc CVS log

Up to [MW Coherent from dump] / coherent / b / bin / unzip

Annotation of coherent/b/bin/unzip/unzip.doc, revision 1.1

1.1     ! root        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, Bill Davidsen, Arjan de Vet, James Dugal, Jim
        !           220:      Dumser,  Mark  Edwards, David Feinleib, Mike Freeman, Hunter
        !           221:      Goatley, Robert Heath, Dave  Heiland,  Larry  Jones,  Kjetil
        !           222:      J(o)rgenson,  Bob Kemp, J. Kercheval, Alvin Koh, Bo Kullmar,
        !           223: 
        !           224: Info-ZIP          Last change: 22 Aug 92 (v5.0)                 4
        !           225: 
        !           226: UNZIP(1)                 USER COMMANDS                   UNZIP(1)
        !           227: 
        !           228:      Johnny Lee, Warner Losh, Fulvio Marino,  Gene  McManus,  Joe
        !           229:      Meadows,  Mike  O'Carroll,  Humberto  Ortiz-Zuazaga, Piet W.
        !           230:      Plomp, Antonio Querubin Jr., Steve Salisbury, Georg  Sassen,
        !           231:      Jon  Saxton,  Hugh Schmidt, Martin Schulz, Charles Scripter,
        !           232:      Chris Seaman, Richard Seay, Alex Sergejew,  Cliff  Stanford,
        !           233:      Onno  van der Linden, Jim Van Zandt, Antoine Verheijen, Paul
        !           234:      Wells.
        !           235: 
        !           236: VERSIONS
        !           237:      v1.2  15 Mar 89  Samuel H. Smith
        !           238:      v2.0   9 Sep 89  Samuel H. Smith
        !           239:      v2.x  fall 1989  many Usenet contributors
        !           240:      v3.0   1 May 90  Info-ZIP (DPK, consolidator)
        !           241:      v3.1  15 Aug 90  Info-ZIP (DPK, consolidator)
        !           242:      v4.0   1 Dec 90  Info-ZIP (GRR, maintainer)
        !           243:      v4.1  12 May 91  Info-ZIP
        !           244:      v4.2  20 Mar 92  Info-ZIP (zip-bugs subgroup; GRR, maint.)
        !           245:      v5.0  21 Aug 92  Info-ZIP (zip-bugs subgroup; GRR, maint.)
        !           246: 
        !           247: Info-ZIP          Last change: 22 Aug 92 (v5.0)                 5
        !           248: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.