allbery@uunet.UU.NET (Brandon S. Allbery - comp.sources.misc) (07/28/89)
Posting-number: Volume 7, Issue 104
Submitted-by: dhesi@bsu-cs.bsu.edu (Rahul Dhesi)
Archive-name: zooman.cat/part01
The zoo archiver version 2.01 appeared in comp.sources.unix in early
1989. Here is an enhanced user manual for it written by Bill
Davidsen. The previous posting contained the nroff/troff-suitable
manual. This posting and the next contain the formatted manual in two
parts. Because this manual was over 64000 bytes, and because it
contains quite a few tabs and backspaces, I am posting it in my shar-
compatible "rap" format.
#! /bin/sh
# This is a rap archive. Feed it to "unrap" for extraction with
# some protection against malicious archives or feed to /bin/sh
# for extraction without any such protection. If /bin/sh is used
# to extract the archive, it will try to invoke "brik" to verify
# CRC values. If "brik" is not available, extraction will
# still work but CRC values will not be verified. If "unrap"
# is used, it will check CRC values itself and "brik" is not needed.
#
# If this archive arrived in multiple parts, concatenate all in order
# without editing, and feed to sh. E.g., "cat part[12345] | sh"
#
# This archive includes the files listed below.
#
# uguide.prn
#
#RAP archive follows.
#VERSION 0 0
hardtab=' ' # Must be hard tab within quotes
bksp='' # Must be backspace within quotes
#BEGIN
#FMARK
# uguide.prn
echo Extracting 'uguide.prn', should be 61113 characters
sed -e 's/^X//' -e "s/@t/$hardtab/g" -e '/^#EOPART/,/#BOPART/d' \
-e "s/@h/$bksp/g" -e 's/@a/@/g' > uguide.prn << \#EOF
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X@t@t@t The _@hz_@ho_@ho Archiver
X
X@t@t@t User's Guide
X
X@t@t@t Bill Davidsen
X
X
X@t@t@trev 1.19, modified 11/9/88
X
X
X
X
X
X
X
X@tCopyright (c) 1988 by Bill Davidsen, all rights@treserved.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X This document may be distributed@tunmodified by anyone for
X
X any purpose. Copies of this guide may be freely@tduplicated
X
X and distributed in any form but may not be sold at a profit.
X
X
X T@hT@hT@hTr@hr@hr@hra@ha@ha@had@hd@hd@hde@he@he@hem@hm@hm@hma@ha@ha@har@hr@hr@hrk@hk@hk@hks@hs@hs@hs
X
X
X MS-DOS is a trademark of@tMicrosoft, UNIX@tis a trademark of
X
X AT&T, and ARC is@ta trademark of System Enhancement
X
X Associates. VMS and VAX are trademarks of Digital Equipment
X
X Corp.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X@t 1. I@hI@hI@hIn@hn@hn@hnt@ht@ht@htr@hr@hr@hro@ho@ho@hod@hd@hd@hdu@hu@hu@huc@hc@hc@hct@ht@ht@hti@hi@hi@hio@ho@ho@hon@hn@hn@hn
X
X
X@t 1.1 W@hW@hW@hWh@hh@hh@hha@ha@ha@hat@ht@ht@ht'@h'@h'@h's@hs@hs@hs a@ha@ha@han@hn@hn@hn a@ha@ha@har@hr@hr@hrc@hc@hc@hch@hh@hh@hhi@hi@hi@hiv@hv@hv@hve@he@he@her@hr@hr@hr,@h,@h,@h, a@ha@ha@han@hn@hn@hnd@hd@hd@hd w@hw@hw@hwh@hh@hh@hhy@hy@hy@hy d@hd@hd@hdo@ho@ho@ho I@hI@hI@hI@tw@hw@hw@hwa@ha@ha@han@hn@hn@hnt@ht@ht@ht o@ho@ho@hon@hn@hn@hne@he@he@he?@h?@h?@h?
X
X
X@t An archive program is@tone which performs two functions; to
X
X@t compress the data for@ta file,@tsuch as@tMS-DOSTM SQ, or@tUNIXTM
X
X@t compress, and@tto allow storage of a number of@tfiles in a
X
X@t single file, such as MS-DOS LBR or UNIX tar or cpio.
X
X
X@t Because many files have been stored as a single file they
X
X@t can be easily@tmoved or backed@tup to another disk or tape.
X
X@t The compressed files take less space on disk than the
X
X@t originals, and access@tto other files may be faster since the
X
X@t directory will be less cluttered.
X
X
X@t 1.2 W@hW@hW@hWh@hh@hh@hha@ha@ha@hat@ht@ht@ht'@h'@h'@h's@hs@hs@hs z@hz@hz@hzo@ho@ho@hoo@ho@ho@ho?@h?@h?@h?
X
X
X@t _@hz_@ho_@ho is an archive program written by Rahul Dhesi, which
X
X@t offers all of@tthese benefits,@tand which also offers your
X
X@t choice of a _@hn_@ho_@hv_@hi_@hc_@he or@tan _@he_@hx_@hp_@he_@hr_@ht user interface. Additional
X
X@t support programs are available for MS-DOS, UNIX, and several
X
X@t other@tsystems.
X
X
X@t 1.3 H@hH@hH@hHo@ho@ho@how@hw@hw@hw t@ht@ht@hto@ho@ho@ho u@hu@hu@hus@hs@hs@hse@he@he@he t@ht@ht@hth@hh@hh@hhi@hi@hi@his@hs@hs@hs g@hg@hg@hgu@hu@hu@hui@hi@hi@hid@hd@hd@hde@he@he@he
X
X
X@t The User's Guide is not intended to replace the manual. The
X
X@t manual is concise and@tcomplete, but not in many cases@teasy
X
X@t to use and understand. The User's Guide is intended to be
X
X@t easy to use and understand, with examples allowing a new
X
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t@tPage 1
X@t@t@t@t Introduction
X
X
X
X
X
X
X
X
X
X
X
X user to learn the use of _@hz_@ho_@ho without instruction.
X
X
X This guide@tis organized by@tfunction. If you want to add a
X
X file to an@tarchive, for instance, you go to the "add file"
X
X section and read about how@tto do it. The simplest case is
X
X presented first, followed by discussion of@toptions@tand
X
X related topics.
X
X
X _@hz_@ho_@ho provides the following@tcapabilities: a@ha@ha@had@hd@hd@hdd@hd@hd@hd files@tto an
X
X archive, e@he@he@hex@hx@hx@hxt@ht@ht@htr@hr@hr@hra@ha@ha@hac@hc@hc@hct@ht@ht@ht files from an archive, l@hl@hl@hli@hi@hi@his@hs@hs@hst@ht@ht@ht the files in an
X
X archive, d@hd@hd@hde@he@he@hel@hl@hl@hle@he@he@het@ht@ht@hte@he@he@he files from@tan existing archive, and r@hr@hr@hre@he@he@hep@hp@hp@hpl@hl@hl@hla@ha@ha@hac@hc@hc@hce@he@he@he
X
X old files with a newer version. All of these basic@tfunctions
X
X are available with@toptions. Details on how to use@teach of
X
X these follows.
X
X
X
X 2.@t U@hU@hU@hUs@hs@hs@hsi@hi@hi@hin@hn@hn@hng@hg@hg@hg _@hz_@ho_@ho
X
X
X _@hz_@ho_@ho has two sets of commands, the _@hn_@ho_@hv_@hi_@hc_@he commands and _@he_@hx_@hp_@he_@hr_@ht
X
X commands. The _@hn_@ho_@hv_@hi_@hc_@he commands are easy to learn and use, and
X
X allow you to do the common@tarchiver commands. The _@he_@hx_@hp_@he_@hr_@ht
X
X commands are somewhat more@tcomplex@tto use,@tand provide
X
X access to all of the capabilities of _@hz_@ho_@ho, particularly those
X
X which are not available in@tmost other archivers. Note that
X
X you can get a reminder of the novice commands just@tby typing
X
X the _@hz_@ho_@ho command with no arguments,@tor the expert commands by
X
X typing "zoo h".
X
X
X
X
X
X page 2@t@t For zoo 2.01 rev 1.19@t- 11/9/88
X@t@t@t Introduction
X
X
X
X
X
X
X
X
X
X
X
X@t 2.1 F@hF@hF@hFi@hi@hi@hil@hl@hl@hle@he@he@hen@hn@hn@hna@ha@ha@ham@hm@hm@hme@he@he@hes@hs@hs@hs
X
X
X@t 2.1.1@t _@hT_@hh_@he__@hn_@ha_@hm_@he__@ho_@hf__@ht_@hh_@he__@ha_@hr_@hc_@hh_@hi_@hv_@he__@hf_@hi_@hl_@he Since _@hz_@ho_@ho is going to
X
X@t take a number@tof files and place them@tin one archive file,
X
X@t there@tthe name of the@tarchive@tfile must be specified.@t_@hz_@ho_@ho
X
X@t archives are usually named something.zoo, just as ARCTM
X
X@t files@tare named something.arc, etc. However, the archives
X
X@t may have other names,@tdepending on the operating system. If
X
X@t the archive name specified by@tthe user contains at least one
X
X@t dot (.) the suffix zoo will not be added.
X
X
X@t When you provide the name of an archive on the command line,
X
X@t if the name does not contain a dot the extension ".zoo" will
X
X@t be added. This means that if you use the name@t"docs" the
X
X@t actual archive will be named "docs.zoo", while if you@tuse
X
X@t the name "my.doc" that will be the actual filename. Using
X
X@t names@twhich don't end@tin .zoo@tmay cause you confusion, and
X
X@t should be done only when you will still be able to identify
X
X@t the file as a@t_@hz_@ho_@ho archive.
X
X
X@t 2.1.2@t _@hT_@hh_@he__@hn_@ha_@hm_@he_@hs__@ho_@hf__@hf_@hi_@hl_@he_@hs__@hi_@hn__@ht_@hh_@he__@ha_@hr_@hc_@hh_@hi_@hv_@he The@tnames of files
X
X@t in an@tarchive@tare limited only by the@toperating system.
X
X@t Under@tMS-DOS the names are eight characters for the name,
X
X@t followed by a@tdot, followed by three characters for the
X
X@t extension. Under VMSTM the name and extension may each be
X
X@t up to@t32 characters long, and@tunder UNIX the names may be as
X
X@t long as the system allows (always at least 14@tcharacters)
X
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t@tPage 3
X@t@t@t@t Introduction
X
X
X
X
X
X
X
X
X
X
X
X and may be@tany legal name.@tOther operating@tsystems@tmay have
X
X other rules for filenames.@tIn general files with names
X
X consisting@tof not more than 8 characters, a dot, and not
X
X more than three characters@tare supported by most common
X
X operating systems.
X
X
X 2.1.3 _@hT_@hr_@he_@ha_@ht_@hm_@he_@hn_@ht__@ho_@hf__@hw_@hi_@hl_@hd_@hc_@ha_@hr_@hd_@hs If you are familiar@twith the
X
X way the UNIX operating system expands wildcard names, you
X
X understand@thow zoo@ttreats wildcards. For MS-DOS users the
X
X action is most similar to the DIR command,@trather than the
X
X COPY usage. If you type "a*" it means "all names beginning
X
X with a" even if they have an extension. Also, the construct
X
X "*a" will match all filenames ending in "a", such as "data"
X
X or@t"left.pa". For a complete discussion see the manual.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X page 4@t@t For zoo 2.01 rev 1.19@t- 11/9/88
X@t@t@t Introduction
X
X
X
X
X
X
X
X
X
X
X
X@t 3. C@hC@hC@hCo@ho@ho@hom@hm@hm@hmm@hm@hm@hmo@ho@ho@hon@hn@hn@hn z@hz@hz@hzo@ho@ho@hoo@ho@ho@ho o@ho@ho@hop@hp@hp@hpe@he@he@her@hr@hr@hra@ha@ha@hat@ht@ht@hti@hi@hi@hio@ho@ho@hon@hn@hn@hns@hs@hs@hs
X
X
X@t 3.1 A@hA@hA@hAd@hd@hd@hdd@hd@hd@hdi@hi@hi@hin@hn@hn@hng@hg@hg@hg d@hd@hd@hda@ha@ha@hat@ht@ht@hta@ha@ha@ha t@ht@ht@hto@ho@ho@ho a@ha@ha@han@hn@hn@hn a@ha@ha@har@hr@hr@hrc@hc@hc@hch@hh@hh@hhi@hi@hi@hiv@hv@hv@hve@he@he@he
X
X
X@t When you add a file to an archive, a copy of the file@tis
X
X@t placed in the@tarchive@tin a compressed@tformat.@tThe original
X
X@t file is left unchanged for other use.@tThe simplest way to
X
X@t add data to an archive is with the novice command:
X
X@t zoo -add@tzoofile@tmyfile
X
X
X@t Which@tcompresses the file _@hm_@hy_@hf_@hi_@hl_@he and adds it to _@hz_@ho_@ho_@hf_@hi_@hl_@he._@hz_@ho_@ho.
X
X@t You can have several files named on the command line,@teither
X
X@t explicitly or@twith wildcards.
X
X
X@t Add files examples:
X@t zoo -add@tzoofile@tmyfile.dat myfile.doc
X
X@t zoo a zoofile myfile.*
X
X@t Note that if there is@talready@ta file in the archive having
X
X@t the same name@tas a file you are adding, it will be replaced
X
X@t by the new file. If you want to prevent this,@tthere is an
X
X@t expert option@t'n' which says only add@tfiles which are@tnot in
X
X@t the archive already.
X
X
X@t For example the two command sequence:
X@t zoo a arch myfile.src
X@t zoo an arch myfile.dat myfile.src myfile.doc
X
X@t Note that the@tfile "myfile.src" was added to the archive
X
X@t with the first command, and therefore@twill not be added by
X
X@t the second.
X
X
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t@tPage 5
X@t@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X 3.1.1 _@hU_@hp_@hd_@ha_@ht_@hi_@hn_@hg__@hf_@hi_@hl_@he_@hs__@hi_@hn__@ha_@hn__@ha_@hr_@hc_@hh_@hi_@hv_@he There@tmay be times when
X
X you want to be sure the archive contains the latest versions
X
X of@tall the@tfiles, without adding any new files. This may be
X
X done with the '-freshen' novice command, or the option, 'u',
X
X controls this in the expert mode.
X
X
X You may enter the command as either:
X@t zoo au arch myfiles.*
X - or -
X@t zoo -freshen arch myfiles.*
X
X
X where any file which had been changed would be replaced with
X
X the newer version,@twhile any files@twhich were not in the
X
X archive would be ignored.
X
X
X 3.1.2 _@hA_@hd_@hd_@hi_@hn_@hg__@ho_@hn_@hl_@hy__@hn_@he_@hw__@hf_@hi_@hl_@he_@hs__@ht_@ho__@ha_@hn__@ha_@hr_@hc_@hh_@hi_@hv_@he@t If you@twant to
X
X add some new files@tto an archive, but don't want to change
X
X the existing files@tin the archive,@teven if@tthey are not the
X
X latest version, you can specify leaving the existing files
X
X unchanged by use of the 'n' option@tin expert mode.
X
X
X In@texpert mode only:
X@t zoo an arch myfiles.*
X
X will do just that.@tIf a file is in@tthe archive it is not
X
X changed, but if it's not in the archive it@twill be@tadded.
X
X
X 3.1.3 _@hB_@hr_@hi_@hn_@hg_@hi_@hn_@hg__@ha_@hn__@ha_@hr_@hc_@hh_@hi_@hv_@he__@hu_@hp__@ht_@ho__@hd_@ha_@ht_@he When keeping the
X
X parts of a@tpackage@tin a zoo archive, one of the common
X
X operations@tis to move all newly created files into@tthe
X
X archive, and to update the@tfiles which are@tin the archive
X
X
X
X page 6@t@t For zoo 2.01 rev 1.19@t- 11/9/88
X@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X@t but have been@tmodified since they were saved.
X
X
X@t The easiest way is with the novice command:
X@t zoo -update arch@tmyfiles.*
X@t and can also be done with the@texpert command:
X@t zoo aun arch myfiles.*
X
X@t Note the difference between '-freshen' and '-update'.@tThe
X
X@t freshen command does not add new files to the@tarchive, it
X
X@t just insures that the@tfile already in@tthe archive are@tthe
X
X@t latest versions. The '-update' command makes sure that the
X
X@t archive contains all of the files you@tneed.
X
X
X@t The reason for not using update in all cases is that you may
X
X@t have a lot of@tfiles with unrelated names in a@tdirectory, and
X
X@t want to save only a few. The freshen command allows you to
X
X@t specify all the files@tin the directory, and have _@hz_@ho_@ho select
X
X@t those@twhich should be@tsaved.
X
X
X@t To do@tthis you can type:
X@t zoo -freshen arch *
X
X@t 3.1.4@t _@hM_@ho_@hv_@hi_@hn_@hg__@hf_@hi_@hl_@he_@hs__@hi_@hn_@ht_@ho__@ha_@hn__@ha_@hr_@hc_@hh_@hi_@hv_@he Since one common@treason
X
X@t for using an archive is to save space, frequently you@twill
X
X@t want to put files into a archive, and@tthen delete the
X
X@t original, full size, files.
X
X
X@t The novice command to@tdo this@tis:
X@t zoo -move arch file1 file2
X@t or using the the 'M' option to the 'a' expert@tcommand:
X@t zoo aM arch file1 file2
X
X@t In either case the original files will not be@tdeleted@tuntil
X
X@t _@ha_@hl_@hl files have been added to the archive and the archive has
X
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t@tPage 7
X@t@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X been closed.
X
X
X 3.2 L@hL@hL@hLi@hi@hi@his@hs@hs@hst@ht@ht@hti@hi@hi@hin@hn@hn@hng@hg@hg@hg t@ht@ht@hth@hh@hh@hhe@he@he@he a@ha@ha@har@hr@hr@hrc@hc@hc@hch@hh@hh@hhi@hi@hi@hiv@hv@hv@hve@he@he@he c@hc@hc@hco@ho@ho@hon@hn@hn@hnt@ht@ht@hte@he@he@hen@hn@hn@hnt@ht@ht@hts@hs@hs@hs
X
X
X A _@hz_@ho_@ho archive may be listed, giving the contents of the
X
X archive with various detail and options. A@tcomplete list of
X
X options is@tfound in the User's Manual.
X
X
X 3.2.1 _@hG_@he_@ht_@ht_@hi_@hn_@hg__@ha__@hd_@he_@hf_@ha_@hu_@hl_@ht__@hl_@hi_@hs_@ht_@hi_@hn_@hg
X
X
X The common@tlisting@tis done@tby:
X@t zoo -list arch
X
X Which might produce a listing like:
X
X@t Archive FIZsim.zoo:
X@t Length CF@tSize Now Date@t Time
X@t -------- ---@t-------- --------- --------
X@t 3849 43%@t 2211 3 Feb 88 21:55:56 69e7 fiz.1
X@t 6864 48%@t 3563 3 Feb 88 21:52:16 d14e fiz.c
X@t -------- ---@t-------- --------- --------
X@t 10713 46%@t 5774 2 files
X
X Let's look@tat the listing.@tThe first line is the name of the
X
X archive, followed by the line giving the headers for all of
X
X the columns. The first column contains the@toriginal length
X
X of@tthe file before@tcompression, the second@tthe percent of
X
X compression, and the third@tthe size of the@tfile in@tthe
X
X archive. Remember that the@tchecksum, date,@tand the@tfilename
X
X are there,@ttoo.
X
X
X Column four is the@tdate when the file was last modified, and
X
X five is the time. The sixth column@tcontains the checksum,
X
X discussed in the concepts section.@tFinally@tthe name of the
X
X file is displayed,@teither as just a filename or as@ta
X
X
X page 8@t@t For zoo 2.01 rev 1.19@t- 11/9/88
X@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X@t complete name@tif a subdirectory was specified@twhen the file
X
X@t was saved.
X
X
X@t The totals line gives@tthe total of all file sizes, useful
X
X@t when you check to see@tif you have room to unpack, the
X
X@t average percent compression, and the compressed file size.
X
X@t At the end of@tthe totals is the number of files displayed.
X
X@t Remember that@tthe file count is files@tdisplayed, and may not
X
X@t include all of the files in the archive (see the concepts
X
X@t section on deleted files and generations).
X
X
X@t 3.2.2@t _@hl_@hi_@hs_@ht__@hf_@hi_@hl_@he_@hs_@h,__@he_@hx_@hp_@he_@hr_@ht__@hc_@ho_@hm_@hm_@ha_@hn_@hd The expert@tform of@tthe
X
X@t list command allows a@tshort form of the listing, having no
X
X@t checksum information displayed. It is@totherwise identical to
X
X@t the the display produced by the -list@tcommand. If the@t'f'
X
X@t option is used, only the filenames are displayed, with
X
X@t several filenames on a line. If you use the 'q' (quiet)
X
X@t option, all of the headings and totals are deleted as@twell.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t@tPage 9
X@t@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X Using an archive with a number of files, we see this.
X
X@t Archive FIZbig.zoo:
X@t Length CF@tSize Now Date@t Time
X@t -------- ---@t-------- --------- --------
X@t 455 4%@t 438 17 Aug 88 14:12:36@t addbfcrc.o
X@t 1280 24%@t 970 17 Aug 88 14:12:52@t addfname.o
X@t 1069 16%@t 900 17 Aug 88 14:13:02@t basename.o
X@t 3509 26%@t 2611 17 Aug 88 14:13:28@t comment.o
X@t 814 0%@t 814 17 Aug 88 14:13:34@t crcdefs.o
X@t 3655 26%@t 2717 17 Aug 88 14:22:02@t fiz.o
X@t 792 13%@t 688 17 Aug 88 14:13:44@t getfile.o
X@t 2465 20%@t 1972 17 Aug 88 14:14:02@t lzc.o
X@t 2543 18%@t 2082 17 Aug 88 14:14:22@t lzd.o
X@t -------- ---@t-------- --------- --------
X@t 16582 20%@t 13192 9 files
X
X
X By@tusing the 'f' option we@tget:
X
X@t Archive FIZbig.zoo:
X@t addbfcrc.o@t addfname.o@t basename.o@t comment.o@t crcdefs.o
X@t fiz.o@t@t getfile.o@t lzc.o@t@t lzd.o
X
X
X
X If@twe add the 'q' option to delete@tthe summary:
X
X@t addbfcrc.o@t addfname.o@t basename.o@t comment.o@t crcdefs.o
X@t fiz.o@t@t getfile.o@t lzc.o@t@t lzd.o
X
X You may also want to read the section on advanced listing,
X
X which includes a section on keeping track of several
X
X archive, including@thow to build a rudimentary database of
X
X which files are in@twhich archives.
X
X
X 3.3 E@hE@hE@hEx@hx@hx@hxt@ht@ht@htr@hr@hr@hra@ha@ha@hac@hc@hc@hct@ht@ht@hti@hi@hi@hin@hn@hn@hng@hg@hg@hg f@hf@hf@hfi@hi@hi@hil@hl@hl@hle@he@he@hes@hs@hs@hs f@hf@hf@hfr@hr@hr@hro@ho@ho@hom@hm@hm@hm@ty@hy@hy@hyo@ho@ho@hou@hu@hu@hur@hr@hr@hr a@ha@ha@har@hr@hr@hrc@hc@hc@hch@hh@hh@hhi@hi@hi@hiv@hv@hv@hve@he@he@he
X
X
X 3.3.1 _@hU_@hn_@hp_@ha_@hc_@hk_@hi_@hn_@hg__@ha_@hn__@he_@hn_@ht_@hi_@hr_@he__@ha_@hr_@hc_@hh_@hi_@hv_@he@t If you@twant to@textract
X
X all of the@tfiles in an archive to their original size and
X
X date, you can use the novice '-extract' command, or the
X
X expert
X
X
X
X page 10@t@t For zoo 2.01 rev 1.19@t- 11/9/88
X@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X@t Novice and expert unpack archive:
X@t zoo -extract arch
X
X@t zoo x arch
X
X@t In both cases@tall files will be extracted.
X
X
X@t 3.3.2@t _@hU_@hn_@hp_@ha_@hc_@hk_@hi_@hn_@hg__@hs_@he_@hl_@he_@hc_@ht_@he_@hd__@hf_@hi_@hl_@he_@hs__@hf_@hr_@ho_@hm__@ha_@hn__@ha_@hr_@hc_@hh_@hi_@hv_@he If you wish
X
X@t to extract a single file from@tan archive, you@tsimply add the
X
X@t file name to the command line@tafter the archive name.@tThe
X
X@t effect is identical.
X
X
X@t Extract individual file or files
X@t zoo -extract arch myfile.3
X
X@t zoo x arch myfile.3
X
X@t zoo x arch myfile.3 myfile.4
X
X@t zoo x arch *.bas
X
X@t The first two@texamples do the@tsame thing, using the novice
X
X@t and expert commands respectively. In the third example
X
X@t several of files are being extracted at the same time. The
X
X@t use of wildcards is also permitted, as shown in the fourth
X
X@t example. this@twill extract all BASIC files from the archive.
X
X@t The example is for MS-DOS, UNIX and other users should see
X
X@t the discussion of wildcards and the manual for additional
X
X@t discussion of@tthis.
X
X
X@t 3.4 D@hD@hD@hDe@he@he@hel@hl@hl@hle@he@he@het@ht@ht@hti@hi@hi@hin@hn@hn@hng@hg@hg@hg@tf@hf@hf@hfi@hi@hi@hil@hl@hl@hle@he@he@hes@hs@hs@hs
X
X
X@t When a file is "deleted" from@tan archive, it is marked as no
X
X@t longer wanted. If you@tare using the novice commands the file
X
X@t will be physically removed from the archive after the@tdelete
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t Page 11
X@t@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X command has been executed,@tand a copy of the archive with
X
X the file marked deleted but still physically in the archive
X
X will be called something.bak. If your archive were@tcalled
X
X docs.zoo, the backup would@tbe called docs.bak. The@texpert
X
X commands allow you@tto leave deleted files in the archive,
X
X until you explicitly remove them with the pack command.
X
X Files are deleted from an archive using the "-delete" novice
X
X command or@tthe "D"@texpert command.
X
X
X Consider the archive below:
X
X@t Archive FIZ.zoo:
X@t Length CF@tSize Now Date@t Time
X@t -------- ---@t-------- --------- --------
X@t 3849 43%@t 2211 3 Feb 88 21:55:56@t fiz.1
X@t 6864 48%@t 3563 3 Feb 88 21:52:16@t fiz.c
X@t 3849 43%@t 2211 6 Sep 88 09:33:54@t t1/fiz.1
X@t -------- ---@t-------- --------- --------
X@t 14562 45%@t 7985 3 files
X
X If@tyou delete a file and list using the novice command:
X
X@t zoo -delete FIZ fiz.c
X@t zoo l@tFIZ
X
X@t Archive FIZ.zoo:
X@t Length CF@tSize Now Date@t Time
X@t -------- ---@t-------- --------- --------
X@t 3849 43%@t 2211 3 Feb 88 21:55:56@t fiz.1
X@t 3849 43%@t 2211 6 Sep 88 09:33:54@t t1/fiz.1
X@t -------- ---@t-------- --------- --------
X@t 7698 43%@t 4422 2 files
X
X
X
X
X
X
X
X
X
X
X
X
X
X page 12@t@t For zoo 2.01 rev 1.19@t- 11/9/88
X@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X@t While@tif I use the expert commands:
X
X@t zoo D FIZ fiz.c
X@t zoo l FIZ
X
X@t Archive FIZ.zoo:
X@t Length@t CF Size Now Date@t Time
X@t --------@t --- -------- --------- --------
X@t@t 3849@t 43%@t 2211@t3 Feb 88 21:55:56 fiz.1
X@t@t 3849@t 43%@t 2211@t6 Sep 88 09:33:54 t1/fiz.1
X@t --------@t --- -------- --------- --------
X@t@t 7698@t 43%@t 4422@t 2 files
X@t ------------
X@t There is@t1 deleted file.
X
X@t In addition to the explicit delete command, files are
X
X@t deleted when overwritten with@tvarious@tforms of the add,
X
X@t freshen, and update commands.
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t Page 13
X@t@t@t@t zoo commands
X
X
X
X
X
X
X
X
X
X
X
X 4.@t O@hO@hO@hOt@ht@ht@hth@hh@hh@hhe@he@he@her@hr@hr@hr c@hc@hc@hco@ho@ho@hon@hn@hn@hnc@hc@hc@hce@he@he@hep@hp@hp@hpt@ht@ht@hts@hs@hs@hs
X
X
X 4.1 P@hP@hP@hPa@ha@ha@hac@hc@hc@hck@hk@hk@hki@hi@hi@hin@hn@hn@hng@hg@hg@hg t@ht@ht@hth@hh@hh@hhe@he@he@he a@ha@ha@har@hr@hr@hrc@hc@hc@hch@hh@hh@hhi@hi@hi@hiv@hv@hv@hve@he@he@he a@ha@ha@han@hn@hn@hnd@hd@hd@hd d@hd@hd@hde@he@he@hel@hl@hl@hle@he@he@het@ht@ht@hte@he@he@hed@hd@hd@hd f@hf@hf@hfi@hi@hi@hil@hl@hl@hle@he@he@hes@hs@hs@hs
X
X
X When a file in an archive is replaced by a@tnewer version of
X
X the file, or another file by the same name, the old version
X
X is@tmarked "deleted," but is still in the archive.
X
X
X You can see deleted files by:
X@t zoo ld arch
X
X which will@tlist the contents of arch.zoo including@tdeleted
X
X files. _@hz_@ho_@ho@thas a number of@tcommands and option which allow
X
X you to extract deleted files. The better way to access old
X
X versions is to use@t"generations," discussed in the@tfollowing
X
X section.
X
X
X The deleted files make the@tarchive@tlarger,@tand therefore
X
X should be removed when you@tare sure you no@tlonger need them.
X
X Since packing the archive takes time, you may want@tto
X
X perform all of the@tadd and@tdelete commands@ton an archive,
X
X then pack it.
X
X
X When using@tthe novice commands the@tarchive@tis packed after
X
X every operation which produces deleted files. The old
X
X archive with the deleted files is saved as@tfile.bak. The
X
X backup name is formed by deleting the last@t(rightmost)
X
X portion of@tthe name and adding .bak. This means that
X
X "myfile.zoo" would@thave a backup called "myfile.bak", and
X
X "my.test.file" would have a backup@tnames "my.test.bak".
X
X
X page 14@t@t For zoo 2.01 rev 1.19@t- 11/9/88
X@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t Obviously systems which only allow one '.' in@ta name don't
X
X@t have all of the forms.
X
X
X@t While@tthe novice commands pack the file automatically, the
X
X@t expert commands allow@tyou to control when you@twill pack the
X
X@t archive. This@tis done@tby the 'P' command, or the 'P' option
X
X@t to most other@tcommands which may delete files.
X
X
X@t Example - add@tfiles and pack:
X@t zoo aP arch file1 file2
X
X@t Example - delete files and pack:
X@t zoo dP arch part1.old
X
X@t Example - update archive and pack:
X@t zoo aunP@tarch mystuff.*
X@t or, since the@tnovice commands@tpack every time
X@t zoo -update arch@tmystuff.*
X
X@t 4.2 G@hG@hG@hGe@he@he@hen@hn@hn@hne@he@he@her@hr@hr@hra@ha@ha@hat@ht@ht@hti@hi@hi@hio@ho@ho@hon@hn@hn@hns@hs@hs@hs
X
X
X@t There@tare times when you might want to save an old version
X
X@t of a file, even though you are working with a@tnewer version.
X
X@t This allows you to "fall back" if you@tfind a problem.@tRather
X
X@t than using the term 'version,' _@hz_@ho_@ho uses the VMS term
X
X@t 'generations.' Normally only one generation of a file@tis
X
X@t saved@tin an archive.
X
X
X@t To allow generations to be used with an archive, first they
X
X@t must be enabled for the archive. This@tis usually done@twhen
X
X@t the archive is created, by adding the@toption '+' to the 'a'
X
X@t command. To determine@thow many generations are to be saved,
X
X@t the "generation limit" must be set. If you want to save just
X
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t Page 15
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X the version of a file previous to the current version, you
X
X can set the limit to one. If you want the last four
X
X versions, the generation limit should be four, etc.
X
X
X The limit may be set using@tone of two methods, or both if
X
X needed. The first is to set the limit on the entire archive.
X
X For instance, if you set the archive limit@tto three, the
X
X current version and two most recent versions of each file
X
X will be saved.
X
X
X Create the@tfile with generations enabled:
X@t zoo a+ arch file1 file2
X
X Set the limit for the archive to three:
X@t zoo glA=3 arch
X
X Now every time you@tsave a file, up@tto two previous@tversions
X
X will be saved. If there are already three versions@tsaved,
X
X the oldest@tversion@twill be@tdeleted. Look at the listing of@ta
X
X archive which has multiple@tversions saved.
X
X
X Sample of an archive with generations:
X
X@t Archive FIZ.zoo:
X@t Length CF@tSize Now Date@t Time
X@t -------- ---@t-------- --------- --------
X@t 3849 43%@t 2211 3 Feb 88 21:55:56@t fiz.1;1
X@t@t29 0%@t 29 2 Sep 88 17:31:16@t xxx;2
X@t@t29 0%@t 29 2 Sep 88 17:32:06@t xxx;3
X@t@t29 0%@t 29 2 Sep 88 17:32:42@t xxx;4
X@t -------- ---@t-------- --------- --------
X@t 3936 42%@t 2298 4 files
X@t ------------
X@t There@tis 1 deleted file.
X
X Note that there are three different version of the@tfile
X
X "xxx" in the archive. Also@tnote that there@tis one deleted
X
X
X
X page 16@t@t For zoo 2.01 rev 1.19@t- 11/9/88
X@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X@t file.@tThis happens to@tbe the first version of@t"xxx" which
X
X@t was deleted when version four@twas added.
X
X
X@t Now, what if you want@tgenerations on just one@tfile, or
X
X@t different limits on some files? In that case you can set a
X
X@t limit@ton any file or group of@tfiles which will override the
X
X@t limit@tset on the archive. You@tmay also display the limit
X
X@t using@tthe 'g'@toption for list.
X
X
X@t Here's an example based on the previous archive. What@tyou
X
X@t see is the list with generation information, the command to
X
X@t change it, adding a new file,@tand the@tlisting@tafter the file
X
X@t has been added.
X
X
X@t Add the next file
X@t zoo a FIZ fiz.1
X@t@t Zoo: fiz.1@t-- (43%) added
X
X@t Reset@tthe generation limit for that file
X@t zoo gl=1@tFIZ fiz.1
X@t@t Zoo: fiz.1;1@t -- adjusted to@t1
X@t zoo Ldg FIZ
X
X@t@t Archive FIZ.zoo:
X@t@t Length CF Size Now Date Time
X@t@t -------- --- -------- --------- --------
X@t@t@t 29 0%@t29 2 Sep 88 17:32:42@t 0g D@txxx;1
X@t@t@t 29 0%@t29 2 Sep 88 17:47:14@t 0g@txxx;2
X@t@t@t 29 0%@t29 2 Sep 88 17:47:22@t 0g@txxx;3
X@t@t@t 29 0%@t29 2 Sep 88 17:47:30@t 0g@txxx;4
X@t@t@t3849 43% 2211 3 Feb 88 21:55:56@t 1g@tfiz.1;1
X@t@t -------- --- -------- --------- --------
X@t@t@t3965 41% 2327 5 files
X@t@t ------------
X@t@t D: deleted file.
X@t@t Archive generation limit is@t3.
X
X@t Looking at the listing, note that the@tgeneration information
X
X@t says the archive limit is three. Since the limit on the file
X
X
X@t rev 1.19 - 11/9/88@t For zoo 2.01@t@t Page 17
X@t@t@t Advanced features and commands
X
X
X
X
X
X
X
X
X
X
X
X "xxx" is zero, the@tarchive@tdefault@tis used. Since the limit
X
X on@tfile "fiz.1" is@tone, there should be only one version of
X
X the file kept. Let's test this.
X
#EOPART
Rahul Dhesi <dhesi@bsu-cs.bsu.edu>
UUCP: ...!{iuvax,pur-ee}!bsu-cs!dhesi