src/vfs/extfs/helpers/README.uzip

   1 Overview
   2 ========
   3
   4 uzip is a module for the extfs Virtual File System (VFS) in
   5 Midnight Commander. It allows browsing, extraction and
   6 modification of zip archives.
   7
   8 uzip was written by Oskar Liljeblad. If you find a bug, or know
   9 of an improvement, please email me at osk@hem.passagen.se.
  10
  11 License and Copyright
  12 =====================
  13
  14 uzip is released under the terms of the GNU General Public License.
  15 uzip is copyright (C) 2000-2001 by Oskar Liljeblad.
  16
  17 Requirements
  18 ============
  19
  20 Info-Zip mode:
  21   Info-ZIP unzip 5.41 (for listing and extracting files)
  22   Info-ZIP zip 2.30 (for adding and deleting files)
  23
  24 otherwise:
  25   any unzip
  26   any zip
  27
  28 History
  29 =======
  30
  31 2001-08-07  Oskar Liljeblad  <osk@hem.passagen.se>
  32
  33         * Release 1.4.0.
  34         * Fixed so that files with filenames containing *, ?, [, ]
  35         and \\ can be extracted or added to zip archives etc. These
  36         characters has to be escaped once more, because Info-ZIP zip
  37         and unzip interprets them as wildcards (despite the fact that
  38         the shell already expands wildcards).
  39
  40 2001-03-01  Oskar Liljeblad  <osk@hem.passagen.se>
  41
  42         * Release 1.3.0.
  43         * Caching of files when listing archives has been fixed. (MC
  44         would list a directory twice in some cases.)
  45         * 'strict' is now used. (This is why global variables
  46         are now initialized using 'my'.)
  47         * Some code simplifications thanks to more understanding
  48         of perl :)
  49         * Minor documentation clarifications.
  50
  51 2001-02-21  Oskar Liljeblad  <osk@hem.passagen.se>
  52
  53         * Release 1.2.0.
  54         * The 'rmdir' extfs command of uzip was modified not to fail
  55         when deleting directories that doesn't exist. (A different/
  56         better solution would be to recreate the automaticly deleted
  57         directories, but that's slower and harder to implement.)
  58         Strangely, the zip man page does not mention this delete-
  59         empty-directories behavior.
  60
  61 2000-10-31  Oskar Liljeblad  <osk@hem.passagen.se>
  62
  63         * Release 1.1.0.
  64         * mczipfs_copyin: Fixed order of arguments.
  65         * safesystem, safeticks: Improved error handling.
  66         * mczipfs_copyout: Now allows error code 11, and redirects
  67         stderr to /dev/null.
  68
  69 2000-10-29  Oskar Liljeblad  <osk@hem.passagen.se>
  70
  71         * Release 1.0.1.
  72         * Fixed bug causing files with special permission not to
  73           be listed.
  74
  75 2000-10-29  Oskar Liljeblad  <osk@hem.passagen.se>
  76
  77         * Release 1.0.0: First version.
  78
  79 Differencies between new (Perl) and old (sh/AWK) uzip
  80 =====================================================
  81
  82 The script is written purely in Perl, which (hopefully) means
  83 faster execution and cleaner code.
  84
  85 Listing is done only with either zipinfo or unzip,
  86 not both at the same time. Previously unzip would be used
  87 if the archive contained non-unix file listings (after
  88 zipinfo was run). Now there is an option to choose which
  89 one to use (zipinfo is the default and preferred). This
  90 should make listing of non-unix archives faster.
  91
  92 Files appearing before their parent directories in the listings
  93 are now cached and printed later. This fixes a bug that would
  94 cause some directories to be listed twice.
  95
  96 Temporary filenames are choosen better. That is, they are
  97 generated using tmpnam(3). Previously, hardcoded filenames
  98 (in the current directory) would be used.
  99
 100 The error messages are much better. Errors are checked for
 101 (hopefully) all functions that can fail.
 102
 103 The copyin command no longer makes a copy of the file before
 104 adding it. Instead it makes a temporary directory in which
 105 a symlink to the original file is placed. This should speed
 106 up addition considerably.
 107
 108 The run command is supported.
 109
 110 The theoretic commands "mklink" and "linkout" are supported.
 111 However, MC extfs doesn't support these so they are rather
 112 useless at the moment.
 113
 114 Known problems and Unsupported features
 115 =======================================
 116
 117 Files added to the archive get listed with a+x permissions in MC.
 118 This appears to be a problem with the MC extfs, and (probably) not uzip.
 119 (It is only temporary though. When restarting MC and reading the
 120 archive, the files will no longer be listed as executable.)
 121
 122 Extracted files do not have the same modification/access date as
 123 in the archive. The same applies for permissions and ownership.
 124 Fortunately MC extfs will set these attributes based on the file
 125 listings.
 126
 127 Interpretation of special information ("central-directory extra field")
 128 in zip archives. This is used to store information such as universal
 129 time and unix UID/GID on files.
 130
 131 It would be nice if listing archives with symbolic links was faster.
 132 Unzip has to be executed once for each link. This is because the
 133 symbolic link file must be extracted in order to get the link
 134 destination.
 135
 136 -