view release on metacpan or  search on metacpan

unzip-6.0/unzip.txt  view on Meta::CPAN

       VMS interprets standard Unix (or PC) return values as  other,  scarier-
       looking things, so unzip instead maps them into VMS-style status codes.
       The current mapping is as  follows:    1  (success)  for  normal  exit,
       0x7fff0001    for   warning   errors,   and   (0x7fff000?   +   16*nor-
       mal_unzip_exit_status) for all other errors, where the `?' is 2 (error)
       for unzip values 2, 9-11 and 80-82, and 4 (fatal error) for the remain-
       ing ones (3-8, 50, 51).  In addition, there is a compilation option  to
       expand  upon  this behavior:  defining RETURN_CODES results in a human-
       readable explanation of what the error status means.

BUGS
       Multi-part archives are not yet supported, except in  conjunction  with
       zip.  (All parts must be concatenated together in order, and then ``zip
       -F'' (for zip 2.x) or ``zip -FF'' (for zip 3.x) must  be  performed  on
       the  concatenated  archive  in  order to ``fix'' it.  Also, zip 3.0 and
       later can combine multi-part (split) archives into a  combined  single-
       file  archive using ``zip -s- inarchive -O outarchive''.  See the zip 3
       manual page for more information.)  This will definitely  be  corrected
       in the next major release.

       Archives  read  from  standard input are not yet supported, except with
       funzip  (and  then  only  the  first  member  of  the  archive  can  be
       extracted).

       Archives  encrypted with 8-bit passwords (e.g., passwords with accented
       European characters) may not be portable across  systems  and/or  other
       archivers.  See the discussion in DECRYPTION above.

       unzip's -M (``more'') option tries to take into account automatic wrap-
       ping of long lines. However, the code may fail to  detect  the  correct
       wrapping   locations.   First,  TAB  characters  (and  similar  control
       sequences) are not taken into account, they  are  handled  as  ordinary
       printable  characters.   Second,  depending  on  the actual system / OS
       port, unzip may not detect the true screen geometry but rather rely  on
       "commonly used" default dimensions.  The correct handling of tabs would
       require the implementation of a query for the actual tabulator setup on
       the output console.

       Dates,  times  and  permissions  of stored directories are not restored
       except under Unix. (On Windows NT and successors,  timestamps  are  now
       restored.)

       [MS-DOS]  When  extracting or testing files from an archive on a defec-
       tive floppy diskette, if the  ``Fail''  option  is  chosen  from  DOS's
       ``Abort,  Retry,  Fail?'' message, older versions of unzip may hang the
       system, requiring a reboot.  This problem appears to be fixed, but con-
       trol-C (or control-Break) can still be used to terminate unzip.

       Under DEC Ultrix, unzip would sometimes fail on long zipfiles (bad CRC,
       not always reproducible).  This was apparently due either to a hardware
       bug  (cache  memory)  or  an operating system bug (improper handling of
       page faults?).  Since Ultrix has been abandoned  in  favor  of  Digital
       Unix (OSF/1), this may not be an issue anymore.

       [Unix]  Unix  special  files  such as FIFO buffers (named pipes), block
       devices and character devices are not restored even if they are somehow
       represented  in the zipfile, nor are hard-linked files relinked.  Basi-
       cally the only file types restored by unzip are regular files, directo-
       ries and symbolic (soft) links.

       [OS/2] Extended attributes for existing directories are only updated if
       the -o (``overwrite all'') option is given.  This is  a  limitation  of
       the  operating  system;  because  directories only have a creation time
       associated with them, unzip has no way to determine whether the  stored
       attributes are newer or older than those on disk.  In practice this may
       mean a two-pass approach is required:  first unpack  the  archive  nor-
       mally  (with  or  without  freshening/updating  existing  files),  then
       overwrite just the directory entries (e.g., ``unzip -o foo */'').

       [VMS] When extracting to another directory, only the [.foo]  syntax  is
       accepted  for  the  -d  option;  the simple Unix foo syntax is silently
       ignored (as is the less common VMS foo.dir syntax).

       [VMS] When the file being extracted already exists, unzip's query  only
       allows  skipping, overwriting or renaming; there should additionally be
       a choice for creating a new version of the file.  In fact, the  ``over-
       write''  choice does create a new version; the old version is not over-
       written or deleted.

SEE ALSO
       funzip(1L),  zip(1L),  zipcloak(1L),  zipgrep(1L),  zipinfo(1L),   zip-
       note(1L), zipsplit(1L)

URL
       The Info-ZIP home page is currently at
           http://www.info-zip.org/pub/infozip/
       or
           ftp://ftp.info-zip.org/pub/infozip/ .

AUTHORS
       The  primary  Info-ZIP authors (current semi-active members of the Zip-
       Bugs workgroup) are:  Ed Gordon (Zip, general maintenance, shared code,
       Zip64,  Win32,  Unix,  Unicode);  Christian  Spieler (UnZip maintenance
       coordination, VMS, MS-DOS, Win32, shared code, general  Zip  and  UnZip
       integration  and  optimization);  Onno van der Linden (Zip); Mike White
       (Win32, Windows GUI, Windows  DLLs);  Kai  Uwe  Rommel  (OS/2,  Win32);
       Steven  M.  Schweda  (VMS, Unix, support of new features); Paul Kienitz
       (Amiga, Win32, Unicode); Chris Herborth (BeOS,  QNX,  Atari);  Jonathan
       Hudson (SMS/QDOS); Sergio Monesi (Acorn RISC OS); Harald Denker (Atari,
       MVS); John Bush (Solaris, Amiga); Hunter Goatley  (VMS,  Info-ZIP  Site
       maintenance);  Steve  Salisbury (Win32); Steve Miller (Windows CE GUI),
       Johnny Lee (MS-DOS, Win32, Zip64); and Dave Smith (Tandem NSK).

       The following people were former members of  the  Info-ZIP  development
       group  and  provided  major  contributions  to key parts of the current
       code: Greg ``Cave Newt'' Roelofs (UnZip, unshrink decompression); Jean-
       loup  Gailly  (deflate compression); Mark Adler (inflate decompression,
       fUnZip).

       The author of the original unzip code upon which Info-ZIP's  was  based
       is  Samuel H. Smith; Carl Mascott did the first Unix port; and David P.
       Kirschbaum organized and led Info-ZIP in  its  early  days  with  Keith
       Petersen  hosting the original mailing list at WSMR-SimTel20.  The full
       list of contributors to UnZip has grown quite large;  please  refer  to
       the  CONTRIBS  file  in  the UnZip source distribution for a relatively
       complete version.

VERSIONS
       v1.2   15 Mar 89   Samuel H. Smith
       v2.0    9 Sep 89   Samuel H. Smith
       v2.x   fall 1989   many Usenet contributors