programs

一套客户/服务器模式的备份系统代码,跨平台,支持linux,AIX, IRIX, FreeBSD, Digital Unix (OSF1), Solaris and HP-UX.

                     files in a filesystem of the named type are not
                     saved, nonetheless such filesystems are traversed
                     to search for filesystems of other types probably
                     mounted underneath. The slash means, that such
                     filesystems are not even entered or traversed. If
                     the - or + prefix is used, no space is allowed
                     between option -f and it's argument, e.g. -f-nfs

   -G              To request a new cartridge. If the current writing
                     position is already at the beginning of a new or
                     reused tape, nothing happens

   -h <backuphosts> The names of the hosts, where a backup server side
                     lives. The list can be separated by commas and/or
                     whitespace. If whitespace is present, quotes are
                     necessary. The hosts are tested for service
                     availability. If a backup server is not ready,
                     the next one is tried. If all are busy, the program
                     waits for a minute and tries again

   -I <idx-prefix> The first part of the filename, the names of the
                     stored files and directories are written to. The
                     current total backup number is appended (that
                     increments each start of a full backup). If these
                     files undergo processing, .z is appended

   -i <info-prog>  The command to save startup information. A minimum
                     information to recover from a hard crash is piped
                     into this program (at stdin). If the command
                     comprises of several words, it must be put into
                     quotes. Not to be mixed up with option -b

   -k <file>       Use the contents of the given file as encryption
                     key for authenticating to the server

   {+-}L           Process the filename list files (+L) or not (-L)
                     (See: -I)

   -l <logfile>    Write loggings into the given logfile. A dash -
                     means: no logging, only write to stderr

   -M <svrmsg-conf> The configuration to output messages from the server,
                     that normally are sent only via mail to a maintainer.
                     The first word consisting of the letters b r v and c
                     tells, whether to output messages during backup,
                     restore, verify and copy-tape, respecively. The next
                     words must name the service name or port number of
                     the single stream servers, related to the option -P .
                     For each multi stream service configured with -P or
                     in the configuration file, the respective single
                     stream service must be given here

   -N <num-idxes>  The number of filename list files, that is stored
                     over time. A new list is begun at each start of
                     a full backup (except -a is supplied)

   -O <maxidxage>  The maximum age of the filename list files (== index
                     files) in days, that is stored. See also option
                     -N . A floating point number is allowed here

   -P <portnos>    The port numbers, that are tried to connect at the
                     servers. They must be supplied positionally according
                     to the configured or (with the -h option) given
                     backup servers. The list may be separated by whitespace
                     and/or commas. If whitespace is present, quotes are
                     necessary

   -S <cartsets>   The cartridge sets to use, where <cartsets> is a
                     number of a valid cartridge set on the appropriate
                     server side. Default is 1. These must be supplied
                     positionally according to the configured or (with
                     the -h option) given backup servers. The list may
                     be separated by whitespace and/or commas. If
                     whitespace is present, quotes are necessary

   -s <noproc>     A list of filename patterns, that no processing is
                     attempted on, what can save time significantly.
                     The list should always be enclosed in quotes

   -V <var-dir>    The directory, where varying files are put

   -v              be verbose

   -W <id>         Identify as <id> to the server. This is needed when
                     connecting a multi-stream server to distinguish
                     between the clients. Default is the official
                     hostname of the client. If the client should fake
                     to be a different one than it is in fact, this
                     option must be used. This flag can also be useful
                     e.g. to explicitly store the serverside
                     var-directory, that is crucial for restore and
                     should be saved seperately after all other backup
                     clients are done
 
   -X <excl-file>  The name of a file, that may exist in any directory
                     containing a list of filename patterns, one per
                     line. All files and directories in that directory
                     matching one of the patterns are exluded from
                     backup (See: -D and -F)

   {+-}x           Write CRC32 checksums for each file to tape (+x) or
                     don't do this (-x). This option is ignored, if
                     built-in compression is selected, cause then CRC32
                     checksumming is already performed

   -z <z> <uz>    The commands to use for process and unprocess. If
                    a command comprises of several words, it must be
                    put in quotes

   -Z <level>     If built-in compression should be used, the level
                    can be supplied here. If commands to process and
                    unprocess are also supplied with option -z, then
                    data is first processed by the process command,
                    then by built-in compression. During uncompress
                    it works the other way round


  A table of corresponding command line options and configuration
  file entries, (subsets) accepted by full_backup, incr_backup,
  restore, verify:

   Option       Client configuration file parameter name

    +B -B       ProcessBackupedFiles

    -b          InitProgram

    -C          RootDirectory

    -D          DirsToSkip

    -E          UseCTime

    -e          ExitProgram

    -F          FilesToSkip

    -f          FilesystemTypes

    -h          BackupHosts

    -I          IndexFilePart

    -i          StartupInfoProgram

    -k          EncryptionKeyFile

    -l          LoggingFile

    +L -L       ProcessLogfiles

    -M          PrintServerMessages

    -N          NumIndexesToStore (*_backup), NumIndexesToScan (afrestore)

    -O          DaysToStoreIndexes (*_backup), DaysToScanIndexes (afrestore)

    -P          BackupPorts

    -S          CartridgeSets

    -s          DoNotProcess

    -V          VarDirectory

    -W          ClientIdentifier

    -X          ExcludeListFile

    -x          WriteChecksums

    -z          ProcessCmd UnprocessCmd

    -Z          BuiltinCompressLevel

  Signals

  When receiving SIGHUP or a single SIGINT (i.e. keyboard Ctrl-C)
  this program tries to process all pending writes to the server
  before terminating. That is, if the server is currently not
  ready to process requests, this program will wait until the
  server is done or terminates unexpectedly, what will break the
  connection to all clients. Any connection breakdown will cause
  a SIGPIPE and thus make a client terminate prematurely. If this
  program should not wait for the server to terminate properly,
  but shut down as soon as a consistent status of the client's
  local persistent data can be achieved, SIGQUIT (== Ctrl-\\) or
  SIGABRT must be sent (once) or SIGINT (== Ctrl-C) 3 times within
  2 seconds. Pressing Ctrl-C the second time a respective hint is
  written to the user. The same can be achieved by sending SIGTERM,
  which is the default using the kill(1) command. This signal is
  typically sent to all processes, when a Unix-system goes down in
  a controlled manner without crashing or fast halt. When SIGINT
  is received and standard input of this program is not a TTY, the
  immediate shutdown without waiting for the server is attempted
  as well. A shutdown like this can be expected to finish quite
  surely within one second.


 $BASEDIR/client/bin/incr_backup

  Run an incremental backup. Usage: See full_backup above.
  Additional options:
                              [ -EH ] [ -Q <backup-level> ]

  This program reads the client-side configuration file and runs
  an incremental backup, i.e. all files and directories are saved,
  whose modification time is later than the moment the previous
  backup (full or incremental) has started. The options and their
  meanings are exactly the same as for full_backup, except for the
  -a option, see below. The total backup counter is not increased.

   -a              Differential mode. The timestamp storing the
                     time of the last backup is not modified

   -E              Use not only the modification time comparing
                     the timestamps to select filesystem entries
                     for backup, but also the inode change
                     time (ctime)

   -H              If this flag is set, all backups with a lower level
                     since the last full backup are removed from the
                     indexes and the respective tapes freed, if there
                     is no other backup data on them. In differential
                     mode (-a) a previous differential backup is also
                     removed and the tapes freed, if possible

   -Q <level>      The backup level. All files modified since the
                     most recent backup with a level equal or
                     higher are saved. The higher this number, the
                     more files are redundantly saved again.
                     <level> can be an arbitrary number from 0
                     up to 2147483646 (== MAXINT - 1). Default: 0.
                     A full backup has an implicit backup level of
                     2147483647 (== MAXINT)


 $BASEDIR/client/bin/afrestore

  The restore utility. The Usage:

       afrestore [ -nltvmi ] [ -<past-backup-no> ] [ -C <root-directory> ] \
               [ -h <backuphosts> ] [ -P <backup-ports> ] \
               [ -c <configuration-file> ] [ -W <identity> ] \
               [ -A "<after-date>" ] [ -B "<before-date>" ] \
               [ -T <tapes> ] [ -I <indexfile-part> ] \
               [ -V <var-directory> ] [ -k <encryption-key-file> ] \
               [ -z <process-cmd> <unprocess-cmd> ] \
               [ -Z <built-in-compress-level> ] [ -F <format> ] \
               [ { -N <num-indexfiles> | -O <indexfile-age-days> } ] \
               [ -M <server-message-config> ] \
               [ -p ] <path-pattern> [ [ -p ] <path-patterns> [ ... ] ]
       afrestore -a [ -nlvm ] [ -<past-backup-no> ] [ -C <root-directory> ] \
               [ -h <backuphosts> ] [ -P <backup-ports> ] \
               [ -c <configuration-file> ] [ -W <identity> ] \
               [ -I <indexfile-part> ] [ -V <var-directory> ] \
               [ -k <encryption-key-file> ] \
               [ -z <process-cmd> <unprocess-cmd> ] \
               [ -Z <built-in-compress-level> ] [ -F <format> ] \
               [ -M <server-message-config> ]
       afrestore -{ef} [ -evm ] [ -C <root-directory> ] [ -h <backuphosts> ] \
               [ -P <backup-ports> ] [ -V <var-directory> ] \
               [ -z <process-cmd> <unprocess-cmd> ] \