home *** CD-ROM | disk | FTP | other *** search
/ BURKS 2 / BURKS_AUG97.ISO / BURKS / SOFTWARE / SOURCES / UNZIP52.ZIP / zipinfo.doc (.txt) < prev   
Text File  |  1996-04-29  |  23KB  |  485 lines
  1.  
  2. ZIPINFO(1L)       MISC. REFERENCE MANUAL PAGES        ZIPINFO(1L)
  3.  
  4. NAME
  5.      zipinfo - list detailed information about a ZIP archive
  6.  
  7. SYNOPSIS
  8.      zipinfo     [-12smlvhMtTz]     file[.zip]      [file(s) ...]
  9.      [-x xfile(s) ...]
  10.  
  11.      unzip    -Z    [-12smlvhMtTz]    file[.zip]    [file(s) ...]
  12.      [-x xfile(s) ...]
  13.  
  14. DESCRIPTION
  15.      zipinfo lists technical information about  files  in  a  ZIP
  16.      archive, most commonly found on MS-DOS systems.  Such infor-
  17.      mation includes file access permissions, encryption  status,
  18.      type  of  compression,  version and operating system or file
  19.      system of compressing program, and the  like.   The  default
  20.      behavior  (with  no  options) is to list single-line entries
  21.      for each file in the archive, with header and trailer  lines
  22.      providing  summary  information for the entire archive.  The
  23.      format is a cross between Unix ``ls -l''  and  ``unzip  -v''
  24.      output.   See DETAILED DESCRIPTION below.  Note that zipinfo
  25.      is the same program as unzip (under Unix, a link to it);  on
  26.      some systems, however, zipinfo support may have been omitted
  27.      when unzip was compiled.
  28.  
  29. ARGUMENTS
  30.      file[.zip]
  31.           Path of the ZIP archive(s).  If the file  specification
  32.           is  a  wildcard,  each matching file is processed in an
  33.           order determined by the operating system (or file  sys-
  34.           tem).   Only  the  filename can be a wildcard; the path
  35.           itself cannot.  Wildcard  expressions  are  similar  to
  36.           Unix egrep(1) (regular) expressions and may contain:
  37.  
  38.           *    matches a sequence of 0 or more characters
  39.  
  40.           ?    matches exactly 1 character
  41.  
  42.           [...]
  43.                matches any  single  character  found  inside  the
  44.                brackets;  ranges  are  specified  by  a beginning
  45.                character, a hyphen, and an ending character.   If
  46.                an  exclamation point or a caret (`!' or `^') fol-
  47.                lows the left bracket, then the range  of  charac-
  48.                ters within the brackets is complemented (that is,
  49.                anything except the characters inside the brackets
  50.                is considered a match).
  51.  
  52.           (Be sure to quote any character that might otherwise be
  53.           interpreted  or  modified by the operating system, par-
  54.           ticularly under Unix  and  VMS.)   If  no  matches  are
  55.           found,  the  specification  is  assumed to be a literal
  56.  
  57. Info-ZIP          Last change: 30 Apr 96 (v2.1)                 1
  58.  
  59. ZIPINFO(1L)       MISC. REFERENCE MANUAL PAGES        ZIPINFO(1L)
  60.  
  61.           filename; and if that also fails, the  suffix  .zip  is
  62.           appended.  Note that self-extracting ZIP files are sup-
  63.           ported; just specify the .exe suffix  (if  any)  expli-
  64.           citly.
  65.  
  66.      [file(s)]
  67.           An optional list of archive members  to  be  processed.
  68.           Regular  expressions  (wildcards)  may be used to match
  69.           multiple members; see above.  Again, be sure  to  quote
  70.           expressions  that  would otherwise be expanded or modi-
  71.           fied by the operating system.
  72.  
  73.      [-x xfile(s)]
  74.           An optional list of archive members to be excluded from
  75.           processing.
  76.  
  77. OPTIONS
  78.      -1   list  filenames  only,  one  per  line.   This   option
  79.           excludes all others; headers, trailers and zipfile com-
  80.           ments are never printed.  It is  intended  for  use  in
  81.           Unix shell scripts.
  82.  
  83.      -2   list filenames only, one per line,  but  allow  headers
  84.           (-h), trailers (-t) and zipfile comments (-z), as well.
  85.           This option may be useful in  cases  where  the  stored
  86.           filenames are particularly long.
  87.  
  88.      -s   list zipfile info in short Unix ``ls -l'' format.  This
  89.           is the default behavior; see below.
  90.  
  91.      -m   list zipfile info in  medium  Unix  ``ls  -l''  format.
  92.           Identical to the -s output, except that the compression
  93.           factor, expressed as a percentage, is also listed.
  94.  
  95.      -l   list zipfile info in long Unix ``ls  -l''  format.   As
  96.           with  -m  except that the compressed size (in bytes) is
  97.           printed instead of the compression ratio.
  98.  
  99.      -v   list zipfile information in verbose, multi-page format.
  100.  
  101.      -h   list header line.  The archive name,  actual  size  (in
  102.           bytes) and total number of files is printed.
  103.  
  104.      -M   pipe all output through an internal  pager  similar  to
  105.           the  Unixmore(1) command.  At the end of a screenful of
  106.           output, zipinfo pauses with a ``--More--'' prompt;  the
  107.           next  screenful  may  be  viewed  by pressing the Enter
  108.           (Return) key or the space bar.   zipinfo  can  be  ter-
  109.           minated by pressing the ``q'' key and, on some systems,
  110.           the Enter/Return key.  Unlike Unix more(1), there is no
  111.           forward-searching or editing capability.  Also, zipinfo
  112.           doesn't notice if long lines wrap at the  edge  of  the
  113.  
  114. Info-ZIP          Last change: 30 Apr 96 (v2.1)                 2
  115.  
  116. ZIPINFO(1L)       MISC. REFERENCE MANUAL PAGES        ZIPINFO(1L)
  117.  
  118.           screen, effectively resulting in the printing of two or
  119.           more lines and  the  likelihood  that  some  text  will
  120.           scroll  off  the top of the screen before being viewed.
  121.           On some systems the number of available  lines  on  the
  122.           screen  is  not detected, in which case zipinfo assumes
  123.           the height is 24 lines.
  124.  
  125.      -t   list totals for files listed or  for  all  files.   The
  126.           number   of   files   listed,  their  uncompressed  and
  127.           compressed total sizes, and their  overall  compression
  128.           factor is printed; or, if only the totals line is being
  129.           printed, the values for the entire archive  are  given.
  130.           Note  that  the total compressed (data) size will never
  131.           match  the  actual  zipfile  size,  since  the   latter
  132.           includes  all  of the internal zipfile headers in addi-
  133.           tion to the compressed data.
  134.  
  135.      -T   print the file dates and times in  a  sortable  decimal
  136.           format  (yymmdd.hhmmss).   The default date format is a
  137.           more standard, human-readable version with  abbreviated
  138.           month names (see examples below).
  139.  
  140.      -z   include the archive comment (if any) in the listing.
  141.  
  142. DETAILED DESCRIPTION
  143.      zipinfo has a number of  modes,  and  its  behavior  can  be
  144.      rather  difficult  to fathom if one isn't familiar with Unix
  145.      ls(1) (or even if one is).  The default behavior is to  list
  146.      files in the following format:
  147.  
  148. -rw-rws---  1.9 unx    2802 t- defX 11-Aug-91 13:48 perms.2660
  149.  
  150.      The last three fields are the modification date and time  of
  151.      the  file,  and  its  name.   The  case  of  the filename is
  152.      respected; thus files that come from MS-DOS PKZIP are always
  153.      capitalized.  If the file was zipped with a stored directory
  154.      name, that is also displayed as part of the filename.
  155.  
  156.      The second and third  fields  indicate  that  the  file  was
  157.      zipped  under  Unix with version 1.9 of zip.  Since it comes
  158.      from Unix, the file permissions at the beginning of the line
  159.      are  printed  in  Unix  format.   The uncompressed file-size
  160.      (2802 in this example) is the fourth field.
  161.  
  162.      The fifth field consists of two characters, either of  which
  163.      may  take  on  several  values.   The first character may be
  164.      either `t' or `b', indicating that zip believes the file  to
  165.      be  text  or  binary,  respectively;  but  if  the  file  is
  166.      encrypted, zipinfo notes this fact by capitalizing the char-
  167.      acter  (`T'  or `B').  The second character may also take on
  168.      four values, depending on whether there is an extended local
  169.      header  and/or  an  ``extra field'' associated with the file
  170.  
  171. Info-ZIP          Last change: 30 Apr 96 (v2.1)                 3
  172.  
  173. ZIPINFO(1L)       MISC. REFERENCE MANUAL PAGES        ZIPINFO(1L)
  174.  
  175.      (fully explained  in  PKWare's  APPNOTE.TXT,  but  basically
  176.      analogous  to  pragmas in ANSI C--i.e., they provide a stan-
  177.      dard  way  to  include  non-standard  information   in   the
  178.