zoo.man

汇编源代码大全

     zoo gl[Aq]{+-=}number archive files ..
     zoo gc[q]{+-=}number archive files ..
     zoo gA[q]- archive
     zoo gA[q]+ archive

     The first form, gl, adjusts the generation limit of selected
     files by the specified value.  If the form =n is used, where
     n is a decimal number, this sets the generation limit to the
     specified value.  If + or - are used in placed of = the
     effect is to increment or decrement the generation limit by
     the specified value.  For example, the command

          zoo gl=5 xyz :


     sets the generation limit of each file in the archive
     xyz.zoo to a value of 5.  The command

          zoo gl-3 xyz :


     decrements the generation limit of each file in the archive
     to 3 less than it currently is.

     If the A modifier is used, the archive-wide generation limit
     is adjusted instead.

     The number of generations of a file maintained in an archive
     is limited by the file generation limit, or the archive gen-
     eration limit, whichever is lower.  As a special case, a
     generation limit of 0 stands for no limit.  Thus the default
     file generation limit of 0 and archive generation limit of 3
     limits the number of generations of each file in a newly-
     created archive to three.

     The generation limit specified should be in the range 0
     through 15;  any higher numbers are interpreted modulo 16.

     The second form of the command, using gc, adjusts the gen-
     eration count of selected files.  Each file has a generation
     count of 1 when it is first added to an archive.  Each time
     a file by the same name is added again to an archive, it
     receives a generation count that is one higher than the
     highest generation count of the archived copy of the file.
     The permissible range of generation counts is 1 through
     65535.  If repeated manipulations of an archive result in
     files having very high generation counts, they may be set
     back to lower numbers with the gc command.  The syntax of
     the command is analogous to the syntax of the gl command,
     except that the A modifier is not applicable to the gc com-
     mand.

     The third form, gA-, disables generations in an archive.
     Generations are off when an archive is first created, but
     may be enabled with the fourth form of the command, gA+.
     When generations are disabled in an archive, zoo will not
     display generation numbers in archive listings or maintain
     multiple generations.  Generations can be re-enabled at any
     time, though manipulation of an archive with repeated inter-
     spersed gA- and gA+ commands may result in an archive whose
     behavior is not easily understandable.

     Archived files are listed with the command:

     zoo {lLvV}[aAcCdfgmqvV@/1+-] archive[.zoo] [file] ...

     l    Information presented includes the date and time of
          each file, its original and current (compressed) sizes,
          and the percentage size decrease due to compression
          (labelled CF or compression factor).  If a file was
          added to the archive in a different timezone, the
          difference between timezones is shown in hours as a
          signed number.  As an example, if the difference is
          listed as +3, this means that the file was added to the
          archive in a timezone that is 3 hours west of the
          current timezone.  The file time listed is, however,
          always the original timestamp of the archived file, as
          observed by the user who archived the file, expressed
          as that user's local time.  (Timezone information is
          stored and displayed only if the underlying operating
          system knows about timezones.)

          If no filename is supplied all files are listed except
          deleted files.

          Zoo selects which generation(s) of a file to list
          according to the following algorithm.

          If no filename is supplied, only the latest generation
          of each file is listed.  If any filenames are
          specified, and a generation is specified for an argu-
          ment, only the requested generation is listed.  If a
          filename is specified ending with the generation char-
          acter (`:' or `;'), all generations of that file are
          listed.  Thus a filename argument of the form zoo.c
          will cause only the latest generation of zoo.c to be
          listed;  an argument of the form zoo.c:4 will cause
          generation 4 of zoo.c to be listed;  and an argument of
          the form zoo.c: or zoo.c:* will cause all generations
          of zoo.c to be listed.

     L    This is similar to the l command except that all sup-
          plied arguments must be archives and all non-deleted
          generations of all files in each archive appear in the
          listing.

          On **IX systems, on which the shell expands arguments,
          if multiple archives are to be listed, the L command
          must be used.  On other systems (VAX/VMS, AmigaDOS,
          MSDOS) on which wildcard expansion is done internally
          by zoo, wildcards may be used in the archive name, and
          a multiple archive listing obtained, using the l com-
          mand.

     v    This causes any comment attached to the archive to be
          listed in addition to the other information.

     V    This causes any comment attached to the archive and
          also any comment attached to each file to be listed.

          Both the V and v command characters can also be used as
          modifiers to the l and L commands.

     In addition to the general modifiers described later, the
     following modifiers can be applied to the archive list com-
     mands.

     a    This gives a single-line format containing both each
          filename and the name of the archive, sorted by archive
          name.  It is especially useful with the L command,
          since the result can be further sorted on any field to
          give a master listing of the entire contents of a set
          of archives.

     A    This causes any comment attached to the archive to be
          listed.

     g    This modifier causes file generation information to be
          listed about the archive.  For each file listed, the
          user-specified generation limit, if any, is listed.
          For example, `3g' for a file means that the user wants
          no more than three generations of the file to be kept.
          In archives created by older versions of zoo, the list-
          ing will show `-g', meaning that no generation informa-
          tion is kept and multiple generations of the file are
          not being maintained.

          In addition to the generation information for each
          file, the archive-wide generation limit, if any, is
          shown at the end of the listing.  If generations have
          been disabled by the user, this is so indicated, for
          example:

               Archive generation limit is 3 (generations off).

          For more information about generations see the descrip-
          tion of the g command.

     m    This modifier is currently applicable to **IX systems
          only.  It causes the mode bits (file protection code)
          of each file to be listed as a three-digit octal
          number.  Currently zoo preserves only the lowest nine
          mode bits.  Their meanings are as described in the **IX
          documentation for the chmod(1) command.

     C    This modifier causes the stored cyclic redundancy code
          (CRC) for each archived file to be shown as a four-
          digit hexadecimal number.

     1    This forces one filename to be listed per line.  It is
          most useful in combination with the f modifier.

     /    This forces any directory name to be always listed,
          even in fast columnized listings that do not normally
          include any directory names.

     +,-  The - modifier causes trailing generation numbers to be
          omitted from filenames.  The + modifier causes the
          trailing generation numbers to be shown, which is also
          the default if neither - nor + is specified.

     Files may be deleted and undeleted from an archive with the
     following commands:

     zoo {DU}[Pq1] archive file ...

     The D command deletes the specified files and the U command
     undeletes the specified files.  The 1 modifier (the digit
     one, not the letter ell) forces deletion or undeletion of at
     most one file.  If multiple instances of the same file exist
     in an archive, use of the 1 modifier may allow selective
     extraction of one of these.

     Comments may be added to an archive with the command:

     zoo c[A] archive

     Without the modifier A, this behaves identically to the
     -comment command.  With the modifier A, the command serves
     to add or update the comment attached to the archive as a
     whole.  This comment may be listed with the lA, LA, v, and V
     commands.  Applying the cA command to an archive that was
     created with an older version of zoo will result in an error
     message requesting that the user first pack the archive with
     the P command.  This reorganizes the archive and creates
     space for the archive comment.

     The timestamp of an archive may be adjusted with the com-
     mand:

     zoo T[q] archive

     Zoo normally attempts to maintain the timestamp of an
     archive to reflect the age of the newest file stored in it.
     Should the timestamp ever be incorrect it can be fixed with
     the T command.

     An archive may be packed with the command:

     zoo P[EPq] archive

     If the backup copy of the archive already exists, zoo will
     refuse to pack the archive unless the P modifier is also
     given.  The E modifier causes zoo not to save a backup copy
     of the original archive after packing.  A unique temporary
     file in the current directory is used to initially hold the
     packed archive.  This file will be left behind if packing is
     interrupted or if for some reason this file cannot be
     renamed to the name of the original archive when packing is
     complete.

     Packing removes any garbage data appended to an archive
     because of Xmodem file transfer and also recovers any wasted
     space remaining in an archive that has been frequently
     updated or in which comments were replaced.  Packing also
     updates the format of any archive that was created by an
     older version of zoo so that newer features (e.g. archive-
     wide generation limit, archive comment) become fully avail-
     able.

     Zoo can act as a pure compression or uncompression filter,
     reading from standard input and writing to standard output.
     This is achieved with the command:

     zoo f{cu}[h

     where c specifies compression, u specifies uncompression,
     and h used in addition requests the high-performance
     compression be used.  A CRC value is used to check the
     integrity of the data.  The compressed data stream has no
     internal archive structure and contains multiple files only
     if the input data stream was already structured, as might be
     obtained, for example, from tar or cpio.

      Modem transfers can be speeded up with these commands:

               zoo fc < file | sz ... rz | zoo fu > file


     General modifiers

     The following modifiers are applicable to several commands:

     c    Applied to the a and u commands, this causes the user
          to be prompted for a comment for each file added to the
          archive.  If the file being added has replaced, or is a
          newer generation of, a file already in the archive, any
          comment attached to that file is shown to the user and
          becomes attached to the newly-added file unless the
          user changes it.  Possible user responses are as
          described for the -comment command.  Applied to the
          archive list command l, the c modifier causes the list-
          ing of any comments attached to archived files.

      .   In conjunction with / or // this modifier causes any