home *** CD-ROM | disk | FTP | other *** search
/ ftp.sunet.se/pub/OS2/ / 2014.11.ftp.sunet.se_pub_OS2.tar / ftp.sunet.se / pub / OS2 / hobbes / os2 / util / archiver / unz552x2.exe / README < prev    next >
Text File  |  2005-02-28  |  15KB  |  289 lines
  1. This is the README file for the 28 February 2005 public release of the
  2. Info-ZIP group's portable UnZip zipfile-extraction program (and related
  3. utilities).
  4.  
  5. unzip552.zip       portable UnZip, version 5.52, source code distribution
  6. unzip552.tar.Z     same as above, but compress'd tar format
  7. unzip552.tar.gz    same as above, but gzip'd tar format
  8.  
  9. __________________________________________________________________________
  10.  
  11. BEFORE YOU ASK:  UnZip, its companion utility Zip, and related utilities
  12. and support files can be found in many places; read the file "WHERE" for
  13. further details.  To contact the authors with suggestions, bug reports,
  14. or fixes, continue reading this file (README) and, if this is part of a
  15. source distribution, the file "ZipPorts" in the proginfo directory.  Also
  16. in source distributions:  read "BUGS" for a list of known bugs, non-bugs
  17. and possible future bugs; INSTALL for instructions on how to build UnZip;
  18. and "Contents" for a commented listing of all the distributed files.
  19. __________________________________________________________________________
  20.  
  21.  
  22. GENERAL INFO
  23. ------------
  24. UnZip is an extraction utility for archives compressed in .zip format (also
  25. called "zipfiles").  Although highly compatible both with PKWARE's PKZIP
  26. and PKUNZIP utilities for MS-DOS and with Info-ZIP's own Zip program, our
  27. primary objectives have been portability and non-MSDOS functionality.
  28.  
  29. This version of UnZip has been ported to a stupendous array of hardware--
  30. from micros to supercomputers--and operating systems:  Unix (many flavors),
  31. VMS, OS/2 (including DLL version), Windows NT and Windows 95 (including DLL
  32. version), Windows CE (GUI version), Windows 3.x (including DLL version),
  33. MS-DOS, AmigaDOS, Atari TOS, Acorn RISC OS, BeOS, Macintosh (GUI version),
  34. SMS/QDOS, MVS, VM/CMS, FlexOS, Tandem NSK, Human68k (mostly), AOS/VS (partly)
  35. and TOPS-20 (partly).  UnZip features not found in PKUNZIP include source
  36. code; default extraction of directory trees (with a switch to defeat this,
  37. rather than the reverse); system-specific extended file attributes; and, of
  38. course, the ability to run under most of your favorite operating systems.
  39. Plus, it's free. :-)
  40.  
  41. For source distributions, see the main Contents file for a list of what's
  42. included, and read INSTALL for instructions on compiling (including OS-
  43. specific comments).  The individual operating systems' Contents files (for
  44. example, vms/Contents) may list important compilation info in addition to
  45. explaining what files are what, so be sure to read them.  Some of the ports
  46. have their own, special README files, so be sure to look for those, too.
  47.  
  48. See unzip.1 or unzip.txt for usage (or the corresponding UnZipSFX, ZipInfo,
  49. fUnZip and ZipGrep docs).  For VMS, unzip_def.rnh or unzip_cli.help may be
  50. compiled into unzip.hlp and installed as a normal VMS help entry; see
  51. vms/descrip.mms.
  52.  
  53.  
  54. CHANGES AND NEW FEATURES
  55. ------------------------
  56. The 5.52 maintenance release fixes a few minor problems found in the 5.51
  57. release, closes some more security holes, adds a new AtheOS port, and
  58. contains a Win32 extra-field code cleanup that was not finished earlier.
  59. The most important changes are:
  60.  
  61.    - (re)enabled unshrinking support by default, the LZW patents have expired
  62.    - fixed an extraction size bug for encrypted stored entries (12 excess bytes
  63.      were written with 5.51)
  64.    - fixed false "uncompressed size mismatch" messages when extracting
  65.      encrypted archive entries
  66.    - do not restore SUID/SGID/Tacky attribute bits on Unix (BeOS, AtheOS)
  67.      unless explicitely requested by new "-K" command line qualifier
  68.    - optional support for "-W" qualifier to modify the pattern matching syntax
  69.      (with -W: "*" stops at directory delimiter, "**" matches unlimited)
  70.    - prevent buffer overflow caused by bogus extra-long Zipfile specification
  71.    - performance enhancements for VMS port
  72.    - fixed windll interface handling of its extraction mode qualifiers
  73.      nfflag, ExtractOnlyNewer, noflag, PromptToOverwrite; added detailed
  74.      explanation of their meanings and interactions to the windll documentation
  75.  
  76. The 5.51 maintenance release adds a command-line CE port, intended for
  77. batch processing. With the integration of this port, the pUnZip port
  78. has been revised and "revitalized".
  79. The most important changes for the general public are a number of
  80. bug fixes, mostly related to security issues:
  81.  
  82.    - repair a serious bug in the textmode output conversion code for the 16-bit
  83.      ports (16-bit MSDOS, OS/2 1.x, some variants of AMIGA, possibly others)
  84.      which was introduced by the Deflate64 support of release 5.5
  85.    - fix a long standing bug in the the inflate decompression method that
  86.      prevented correct extraction in some rare cases
  87.    - fixed holes in parent dir traversal security code (e.g.: ".^C." slipped
  88.      through the previous version of the check code)
  89.    - fixed security hole: check naming consistency in local and central header
  90.    - fixed security hole: prevent extracted symlinks from redirecting file
  91.      extraction paths
  92.  
  93. The main addition in the 5.5 release is support for PKWARE's new Deflate64(tm)
  94. algorithm, which appeared first in PKZIP 4.0 (published November 2000).
  95. As usual, some other bugfixes and clean-ups have been integrated:
  96.  
  97.    - support for Deflate64 (Zip compression method #9)
  98.    - support for extracting VMS variable length record text files on
  99.      any system
  100.    - optional "cheap autorun" feature for the SFX stub
  101.    - security fixes:
  102.      * strip leading slash from stored pathspecs,
  103.      * remove "../" parent dir path components from extracted file names
  104.    - new option "-:" to allow verbatim extraction of file names containing
  105.      "../" parent dir path specs
  106.    - fixed file handle leak for the DLL code
  107.    - repaired OS2 & WinNT ACL extraction which was broken in 5.42
  108.  
  109. The 5.42 maintenance release fixes more bugs and cleans up the redistribution
  110. conditions:
  111.  
  112.    - removal of unreduce.c and amiga/timelib.c code to get rid of the last
  113.      distribution restrictions beyond the BSD-like Info-ZIP LICENSE
  114.    - new generic timelib replacement (currently used by AMIGA port)
  115.    - more reasonable mapping rules of UNIX "leading-dot" filenames to the
  116.      DOS 8.3 name convention
  117.    - repaired screensize detection in MORE paging code
  118.      (was broken for DOS/OS2/WIN32 in 5.41)
  119.  
  120. The 5.41 maintenance release adds another new port and fixes some bugs.
  121.  
  122.    - new BSD-like LICENSE
  123.    - new Novell Netware NLM port
  124.    - supports extraction of archives with more than 64k entries
  125.    - attribute handling of VMS port was broken in UnZip 5.4
  126.    - decryption support integrated in the main source distribution
  127.  
  128. The 5.4 release adds new ports, again. Other important items are changes
  129. to the listing format, new supplemental features and several bug fixes
  130. (especially concerning time-stamp handling...):
  131.  
  132.    - new IBM OS/390 port, a UNIX derivate (POSIX with EBCDIC charset)
  133.    - complete revision of the MacOS port
  134.    - changed listing formats to enlarge the file size fields for more digits
  135.    - added capability to restore directory attributes on MSDOS, OS/2, WIN32
  136.    - enabled support of symbolic links on BeOS
  137.    - Unix: optional Acorn filetype support, useful for volumes exported via NFS
  138.    - several changes/additions to the DLL API
  139.    - GUI SFX stub for Win16 (Windows 3.1) and Win32 (Windows 9x, Windows NT)
  140.    - new free GCC compiler environments supported on WIN32
  141.    - many time-zone handling bug fixes for WIN32, AMIGA, ...
  142.  
  143. The 5.32 release adds two new ports and a fix for at least one relatively
  144. serious bug:
  145.  
  146.    - new FlexOS port
  147.    - new Tandem NSK port
  148.    - new Visual BASIC support (compatibility with the Windows DLLs)
  149.    - new -T option (set zipfile timestamp) for virtually all ports
  150.    - fix for timestamps beyond 2038 (e.g., 2097; crashed under DOS/Win95/NT)
  151.    - fix for undetected "dangling" symbolic links (i.e., no pointee)
  152.    - fix for VMS indexed-file extraction problem (stored with Zip 2.0 or 2.1)
  153.    - further performance optimizations
  154.  
  155. The 5.31 release included nothing but small bug-fixes and typo corrections,
  156. with the exception of some minor performance tweaks.
  157.  
  158. The 5.3 release added still more ports and more cross-platform portability
  159. features:
  160.  
  161.    - new BeOS port
  162.    - new SMS/QDOS port
  163.    - new Windows CE graphical port
  164.    - VM/CMS port fully updated and tested
  165.    - MVS port fully updated and tested
  166.    - updated Windows DLL port, with WiZ GUI spun off to a separate package
  167.    - full Universal Time (UTC or GMT) support for trans-timezone consistency
  168.    - cross-platform support for 8-bit characters (ISO Latin-1, OEM code pages)
  169.    - support for NT security descriptors (ACLs)
  170.    - support for overwriting OS/2 directory EAs if -o option given
  171.    - updated Solaris/SVR4 package facility
  172.  
  173. What is (still!) not added is multi-part archive support (a.k.a. "diskette
  174. spanning") and a unified and more powerful DLL interface.  These are the
  175. two highest priorities for the 6.x releases.  Work on the former is almost
  176. certain to have commenced by the time you read this.  This time we mean it!
  177. You betcha. :-)
  178.  
  179. Although the DLLs are still basically a mess, the Windows DLLs (16- and 32-
  180. bit) now have some documentation and a small example application.  Note that
  181. they should now be compatible with C/C++, Visual BASIC and Delphi.  Weirder
  182. languages (FoxBase, etc.) are probably Right Out.
  183.  
  184. Finally, note that support for unshrinking has now been turned OFF by default,
  185. although the source code is still available (as with unreducing).  This was
  186. done for legal reasons, not technical ones, and no, we're not any happier
  187. about it than you are. :-(  See the COPYING file for details.
  188.  
  189.  
  190. INTERNET RESOURCES
  191. ------------------
  192.  
  193. Info-ZIP's web site is at http://www.info-zip.org/pub/infozip/
  194. and contains the most up-to-date information about coming releases,
  195. links to binaries, and common problems.
  196. (See http://www.info-zip.org/pub/infozip/FAQ.html for the latter.)
  197. Files may also be retrieved via ftp://ftp.info-zip.org/pub/infozip/ .
  198. Thanks to LEO (Munich, Germany) for hosting our primary site.
  199.  
  200.  
  201. DISTRIBUTION
  202. ------------
  203. If you have a question regarding redistribution of Info-ZIP software, either
  204. as is, as packaging for a commercial product, or as an integral part of a
  205. commercial product, please read the Frequently Asked Questions (FAQ) section
  206. of the included COPYING file.
  207.  
  208. Insofar as C compilers are rare on some platforms and the authors only have
  209. direct access to a subset of the supported systems, others may wish to pro-
  210. vide ready-to-run executables for new systems.  In general there is no prob-
  211. lem with this; we require only that such distributions include this README
  212. file, the WHERE file, the COPYING file (contains copyright/redistribution
  213. information), and the appropriate documentation files (unzip.txt and/or
  214. unzip.1 for UnZip, etc.).  If the local system provides a way to make self-
  215. extracting archives in which both the executables and text files can be
  216. stored together, that's best (in particular, use UnZipSFX if at all possible,
  217. even if it's a few kilobytes bigger than the alternatives); otherwise we
  218. suggest a bare UnZip executable and a separate zipfile containing the re-
  219. maining text and binary files.  If another archiving method is in common
  220. use on the target system (for example, Zoo or LHa), that may also be used.
  221.  
  222.  
  223. BUGS AND NEW PORTS:  CONTACTING INFO-ZIP
  224. ----------------------------------------
  225. All bug reports and patches (context diffs only, please!) should go to
  226. Zip-Bugs@lists.wku.edu, which is the e-mail address for the Info-ZIP
  227. authors.  (Note that a few rare systems require the Zip-Bugs part to be
  228. capitalized as shown; most systems work OK with lowercase "zip-bugs,"
  229. however.)  DO NOT MAIL US LARGE BINARIES--EVER.  If you need to send us
  230. a problem archive that happens to be large (> 20K), contact us first for
  231. instructions.
  232.  
  233. "Dumb questions" that aren't adequately answered in the documentation
  234. should also be directed to Zip-Bugs rather than to a global forum such
  235. as Usenet.  (Kindly make certain that your question *isn't* answered by
  236. the documentation, however--a great deal of effort has gone into making
  237. it clear and complete.)
  238.  
  239. Suggestions for new features can be discussed on Info-ZIP@lists.wku.edu,
  240. a mailing list for Info-ZIP beta testers and interested parties; you need
  241. to subscribe first, however (see below).  We make no promises to act on all
  242. suggestions or even all patches, but if it is something that is manifestly
  243. useful, sending the required patches to Zip-Bugs directly (as per the
  244. instructions in the ZipPorts file) is likely to produce a quicker response
  245. than asking us to do it--the authors are always ridiculously short on time.
  246. (Please do NOT send patches or encoded zipfiles to the Info-ZIP list.
  247. Please DO read the ZipPorts file before sending any large patch.  It would
  248. be difficult to over-emphasize this point...)
  249.  
  250. If you are considering a port, not only should you read the ZipPorts file,
  251. but also please check in with Zip-Bugs BEFORE getting started, since the
  252. code is constantly being updated behind the scenes.  (For example, VxWorks,
  253. VMOS and Netware ports were once claimed to be under construction, although
  254. we have yet to see any up-to-date patches.)  We will arrange to send you the
  255. latest sources.  The alternative is the possibility that your hard work will
  256. be tucked away in a subdirectory and mostly ignored, or completely ignored
  257. if someone else has already done the port (and you'd be surprised how often
  258. this has happened).
  259.  
  260.  
  261. BETA TESTING:  JOINING INFO-ZIP
  262. -------------------------------
  263. If you'd like to keep up to date with our UnZip (and companion Zip utility)
  264. development, join the ranks of beta testers, add your own thoughts and
  265. contributions, or simply lurk, you may join one of our mailing lists.
  266. There is an announcements-only list (Info-ZIP-announce) and a general
  267. discussion/testing list (Info-ZIP). You must be a subscriber to post, and
  268. you can subscribe via the links on our Frequently Asked Questions page:
  269.  
  270.         http://www.info-zip.org/pub/infozip/FAQ.html#lists
  271.  
  272. (Please note that as of late May 2004, the lists are unavailable pending
  273. a move to a new site; we hope to have them restored shortly.  In the
  274. interim ...)  Feel free to use our bug-reporting web page for bug reports
  275. and to ask questions not answered on the FAQ page above:
  276.  
  277.     http://www.info-zip.org/zip-bug.html
  278.  
  279. There is also a closed mailing list for internal discussions of our core
  280. development team. This list is now kept secret to prevent us from being
  281. flooded with spam messages.
  282.  
  283.  
  284. -- Greg Roelofs (sometimes known as Cave Newt), principal UnZip developer
  285.    guy, with inspiration from David Kirschbaum, was Author of this text.
  286.  
  287. -- Christian Spieler (shorthand: SPC), current UnZip maintenance coordinator,
  288.    applied the most recent changes.
  289.