home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / UTILS / UNZ42DOC.ZIP / zipinfo.man < prev   
Text File  |  1992-03-19  |  7KB  |  199 lines
  1.  
  2.  
  3.  
  4. unzip(1)                 USER COMMANDS                   unzip(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      zipinfo - list detailed information about a ZIP archive file
  10.  
  11. SYNOPSIS
  12.      zipinfo [-1lv] file[.zip] [filespec...]
  13.  
  14. ARGUMENTS
  15.      file[.zip]  Path of the ZIP archive.  The suffix ``.zip'' is
  16.                  applied  if  the  file specified does not exist.
  17.                  Note that self-extracting  ZIP  files  are  sup-
  18.                  ported;  just  specify the ``.exe'' suffix your-
  19.                  self.
  20.  
  21.      [filespec]  An optional list of archive members to  be  pro-
  22.                  cessed.  Expressions may be used to match multi-
  23.                  ple members; be sure to quote  expressions  that
  24.                  contain   characters  interpreted  by  the  UNIX
  25.                  shell. See PATTERN  MATCHING  (below)  for  more
  26.                  details.
  27.  
  28. OPTIONS
  29.         -1  list filenames only, one per line (useful for pipes)
  30.         -l  list files in Unix "ls -l" format:  default
  31.         -v  list files in verbose, multi-page format
  32.  
  33. DESCRIPTION
  34.      ZipInfo lists technical information  about  a  ZIP  archive,
  35.      including  information  file  access permissions, encryption
  36.      status, type of compression, version and operating system of
  37.      compressing program, and the like.  The default option is to
  38.      list files in the following format:
  39.  
  40. -rw-rwl---  1.5 unx    2802 t-     538 defX 11-Aug-91 13:48 perms.2660
  41.  
  42.      The last three fields are clearly the modification date  and
  43.      time of the file, and its name.  The case of the filename is
  44.      respected; thus files which come from MS-DOS are always cap-
  45.      italized.   If  the  file was zipped with a stored directory
  46.      name, that is also displayed as part of the filename.
  47.  
  48.      The second and third  fields  indicate  that  the  file  was
  49.      zipped under Unix with version 1.5 of zip (not available, so
  50.      don't ask--this is just an example).  Since  it  comes  from
  51.      Unix,  the file permissions at the beginning of the line are
  52.      printed in Unix format.  The uncompressed file-size (2802 in
  53.      this  example) is the fourth field, and the compressed file-
  54.      size is the sixth (538).
  55.  
  56.      The fifth field consists of two characters, either of  which
  57.      may  take  on  several  values.   The first character may be
  58.      either `t' or `b', indicating that zip believes the file  to
  59.      be  text  or  binary,  respectively;  but  if  the  file  is
  60.  
  61.  
  62.  
  63.                           ZipInfo version 0.96                  1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. unzip(1)                 USER COMMANDS                   unzip(1)
  71.  
  72.  
  73.  
  74.      encrypted, ZipInfo notes this fact by capitalizing the char-
  75.      acter  (`T'  or `B').  The second character may also take on
  76.      four values, depending on whether there is an extended local
  77.      header  and/or  an  ``extra field'' associated with the file
  78.      (explained in PKWare's APPNOTE.TXT).  If neither exists, the
  79.      character  will  be  a hyphen (`-'); if there is an extended
  80.      local header but no extra field, `l'; if the  reverse,  `x';
  81.      and  if  both  exist, `X'.  Thus the file in this example is
  82.      (apparently) a text file, is not encrypted, and has  neither
  83.      an  extra field nor an extended local header associated with
  84.      it.  The example below, on the other hand, is  an  encrypted
  85.      binary file with an extra field:
  86.  
  87. RWD,R,R     0.9 vms     168 Bx     165 shrk  9-Aug-91 19:15 perms.0644
  88.  
  89.      Extra fields are used by PKWare for  authenticity  verifica-
  90.      tion  (?)  and  possibly  other purposes, and by an upcoming
  91.      release of Info-ZIP's zip for  VMS  (to  store  file  attri-
  92.      butes).   This  example  presumably  falls  into  the latter
  93.      class, then.  Note that the file attributes  are  listed  in
  94.      VMS format.  Other possibilities for the host operating sys-
  95.      tem are OS/2 with High Performance File System  (HPFS),  and
  96.      DOS  or  OS/2  with File Allocation Table (FAT) file system,
  97.      denoted as follows:
  98.  
  99. arc,hid,rdo,sys dos    4096 b-    2334 i4:2 14-Jul-91 12:58 EA DATA. SF
  100. arc,,rw,    1.0 os2    5358 Tl    1914 i4:3  4-Dec-91 11:33 longfilename.hpfs
  101.  
  102.      File attributes in both of these cases are  indicated  in  a
  103.      DOS-like  format,  where  the  file  may or may not have its
  104.      archive bit set; may be hidden or not; may be read-write  or
  105.      read-only;  and  may be a system file or not.  If the attri-
  106.      butes are too long,  the  version  number  of  the  encoding
  107.      software is omitted.  (The information is still available in
  108.      the verbose listing, however.)
  109.  
  110.      Finally, the seventh field indicates the compression  method
  111.      and  possible  sub-method used.  There are six methods known
  112.      at present:  storing (no compression), reducing,  shrinking,
  113.      imploding,  tokenizing,  and  deflating.  In addition, there
  114.      are four levels of reducing (1 through  4);  four  types  of
  115.      imploding  (4K or 8K sliding dictionary, and 2 or 3 Shannon-
  116.      Fano trees); and three levels of  deflating  (fast,  normal,
  117.      maximum  compression).  ZipInfo represents these methods and
  118.      their sub-methods as follows:  ``stor''; ``re:1,'' ``re:2,''
  119.      etc.;  ``shrk'';  ``i4:2,''  ``i8:3,''  etc.;  ``tokn''; and
  120.      ``defF,'' ``defN,'' and ``defX.''
  121.  
  122.      The verbose listing is self-explanatory.  It also lists file
  123.      comments and the zipfile comment, if any.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                           ZipInfo version 0.96                  2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. unzip(1)                 USER COMMANDS                   unzip(1)
  137.  
  138.  
  139.  
  140. PATTERN MATCHING
  141.      All archive members are listed unless a filespec is provided
  142.      to specify a subset of the archive members.  The filespec is
  143.      similar to an egrep expression, and may contain:
  144.  
  145.      *       matches a sequence of 0 or more characters
  146.      ?       matches exactly 1 character
  147.      \nnn    matches the character having octal code nnn
  148.      [...]   matches any single character found inside the brack-
  149.              ets;  ranges are specified by a beginning character,
  150.              a hyphen, and an ending character.  If a '!' follows
  151.              the  left  bracket,  then  the  range  of characters
  152.              matched is complemented with respect  to  the  ASCII
  153.              character set.
  154.  
  155. TIPS
  156.      The author finds it convenient to set up an alias ``ii'' for
  157.      ZipInfo  on systems which allow aliases, or else to set up a
  158.      batch  file  ``ii.bat''  or  to  rename  the  executable  to
  159.      ``ii.exe'' on systems such as MS-DOS which have no provision
  160.      for aliases.  The ``ii'' usage parallels the  common  ``ll''
  161.      alias  for long listings in Unix, and the similarity between
  162.      the outputs of the two commands was intentional.
  163.  
  164. AUTHOR
  165.      Greg Roelofs (also known as Cave Newt).  ZipInfo  is  partly
  166.      based  on  S. H. Smith's unzip and contains pattern-matching
  167.      code from Thom Henderson, but mostly  it  was  written  from
  168.      scratch.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                           ZipInfo version 0.96                  3
  196.  
  197.  
  198.  
  199.