view release on metacpan or  search on metacpan

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

              verbosely,  adding  to the basic -l info the compression method,
              compressed size, compression ratio and 32-bit CRC.  In  contrast
              to  most  of the competing utilities, unzip removes the 12 addi-
              tional header bytes of encrypted  entries  from  the  compressed
              size  numbers.  Therefore, compressed size and compression ratio
              figures are independent of the  entry's  encryption  status  and
              show the correct compression performance.  (The complete size of
              the encrypted compressed data  stream  for  zipfile  entries  is
              reported  by the more verbose zipinfo(1L) reports, see the sepa-
              rate manual.)  When no zipfile is specified (that is,  the  com-
              plete  command  is  simply ``unzip -v''), a diagnostic screen is
              printed.  In addition to the normal header with release date and
              version,  unzip  lists  the  home Info-ZIP ftp site and where to
              find a list of other ftp and non-ftp sites; the target operating
              system  for  which  it  was  compiled, as well as (possibly) the
              hardware on which it was  compiled,  the  compiler  and  version
              used,  and the compilation date; any special compilation options
              that might affect the program's operation (see  also  DECRYPTION
              below);  and  any  options  stored in environment variables that
              might do the same (see ENVIRONMENT OPTIONS below).  As  a  modi-
              fier  it  works  in conjunction with other options (e.g., -t) to
              produce more verbose or debugging output; this is not yet  fully
              implemented but will be in future releases.

       -z     display only the archive comment.

MODIFIERS
       -a     convert  text files.  Ordinarily all files are extracted exactly
              as they are stored (as ``binary'' files).  The -a option  causes
              files  identified by zip as text files (those with the `t' label
              in zipinfo  listings,  rather  than  `b')  to  be  automatically
              extracted  as such, converting line endings, end-of-file charac-
              ters and the character set itself as necessary.   (For  example,
              Unix  files  use line feeds (LFs) for end-of-line (EOL) and have
              no end-of-file (EOF) marker; Macintoshes  use  carriage  returns
              (CRs) for EOLs; and most PC operating systems use CR+LF for EOLs
              and control-Z for EOF.  In  addition,  IBM  mainframes  and  the
              Michigan  Terminal System use EBCDIC rather than the more common
              ASCII character set, and NT supports Unicode.)  Note that  zip's
              identification  of  text  files  is  by  no  means perfect; some
              ``text'' files may actually be binary  and  vice  versa.   unzip
              therefore  prints  ``[text]''  or ``[binary]'' as a visual check
              for each file it extracts when using the  -a  option.   The  -aa
              option  forces  all files to be extracted as text, regardless of
              the supposed file type.  On VMS, see also -S.

       -b     [general] treat all files as binary (no text conversions).  This
              is a shortcut for ---a.

       -b     [Tandem]  force  the creation files with filecode type 180 ('C')
              when extracting Zip entries marked as "text". (On Tandem, -a  is
              enabled by default, see above).

       -b     [VMS]  auto-convert binary files (see -a above) to fixed-length,
              512-byte record format.  Doubling the option  (-bb)  forces  all
              files  to  be extracted in this format. When extracting to stan-
              dard output (-c or -p option in effect), the default  conversion
              of  text record delimiters is disabled for binary (-b) resp. all
              (-bb) files.

       -B     [when compiled with UNIXBACKUP defined] save a  backup  copy  of
              each  overwritten  file. The backup file is gets the name of the
              target file with a tilde and optionally a unique sequence number
              (up to 5 digits) appended.  The sequence number is applied when-
              ever another file with the  original  name  plus  tilde  already
              exists.   When used together with the "overwrite all" option -o,
              numbered backup files are  never  created.  In  this  case,  all
              backup  files  are  named  as the original file with an appended
              tilde, existing backup files are deleted without  notice.   This
              feature  works  similarly to the default behavior of emacs(1) in
              many locations.

              Example: the old copy of ``foo'' is renamed to ``foo~''.

              Warning: Users should be aware that the -B option does not  pre-
              vent  loss  of existing data under all circumstances.  For exam-
              ple, when unzip  is  run  in  overwrite-all  mode,  an  existing
              ``foo~'' file is deleted before unzip attempts to rename ``foo''
              to ``foo~''.  When this rename attempt fails (because of a  file
              locks,  insufficient  privileges,  or  ...),  the  extraction of
              ``foo~'' gets cancelled, but the  old  backup  file  is  already
              lost.   A  similar scenario takes place when the sequence number
              range for numbered backup files gets exhausted (99999, or  65535
              for  16-bit  systems).   In  this case, the backup file with the
              maximum sequence number is  deleted  and  replaced  by  the  new
              backup version without notice.

       -C     use  case-insensitive  matching  for  the  selection  of archive
              entries from the command-line list  of  extract  selection  pat-
              terns.  unzip's philosophy is ``you get what you ask for'' (this
              is also responsible for  the  -L/-U  change;  see  the  relevant
              options below).  Because some file systems are fully case-sensi-
              tive (notably those under the Unix operating system) and because
              both  ZIP  archives  and  unzip itself are portable across plat-
              forms, unzip's default behavior is to match  both  wildcard  and
              literal filenames case-sensitively.  That is, specifying ``make-
              file'' on the command line will only match ``makefile''  in  the
              archive,  not  ``Makefile''  or  ``MAKEFILE'' (and similarly for
              wildcard specifications).  Since this does not correspond to the
              behavior of many other operating/file systems (for example, OS/2
              HPFS, which preserves mixed case but is not  sensitive  to  it),
              the  -C  option  may be used to force all filename matches to be
              case-insensitive.  In the example above, all three  files  would
              then  match  ``makefile''  (or  ``make*'',  or similar).  The -C
              option affects file specs in both the normal file list  and  the
              excluded-file list (xlist).

              Please  note  that  the -C option does neither affect the search
              for the zipfile(s) nor the matching of archive entries to exist-
              ing files on the extraction path.  On a case-sensitive file sys-
              tem, unzip will never try  to  overwrite  a  file  ``FOO''  when
              extracting an entry ``foo''!

       -D     skip  restoration  of timestamps for extracted items.  Normally,
              unzip tries to restore all meta-information for extracted  items
              that  are supplied in the Zip archive (and do not require privi-
              leges or impose a security risk).  By specifying  -D,  unzip  is
              told  to  suppress  restoration  of  timestamps  for directories
              explicitly created from Zip archive entries.  This  option  only
              applies to ports that support setting timestamps for directories
              (currently ATheOS, BeOS, MacOS,  OS/2,  Unix,  VMS,  Win32,  for
              other unzip ports, -D has no effect).  The duplicated option -DD
              forces suppression of timestamp restoration  for  all  extracted
              entries (files and directories).  This option results in setting
              the timestamps for all extracted entries to the current time.

              On VMS, the default setting for this option is  -D  for  consis-
              tency   with  the  behaviour  of  BACKUP:  file  timestamps  are
              restored, timestamps of extracted directories are  left  at  the
              current  time.   To  enable restoration of directory timestamps,
              the negated option --D should be specified.  On VMS, the  option
              -D  disables timestamp restoration for all extracted Zip archive
              items.  (Here, a single -D on the command line combines with the
              default -D to do what an explicit -DD does on other systems.)

       -E     [MacOS  only]  display  contents  of  MacOS  extra  field during
              restore operation.

       -F     [Acorn only] suppress removal of  NFS  filetype  extension  from
              stored filenames.

       -F     [non-Acorn  systems supporting long filenames with embedded com-
              mas, and only if compiled with ACORN_FTYPE_NFS  defined]  trans-
              late  filetype information from ACORN RISC OS extra field blocks
              into a NFS filetype extension and append it to the names of  the
              extracted  files.   (When the stored filename appears to already