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