Backup(1)

NAME
     Backup - backup the specified file or directory

SYNOPSIS
     Backup [ -h hostname ] [ -i ] [ -t tapedevice ]
          [ directory_name | file_name ]

DESCRIPTION
     The Backup command archives the named file or directory (the current
     directory if none is specified) to the local or remote tape device.  It
     can be used to make a full system backup by specifying the directory name
     as /.

     In case of a full backup, this command makes a list of the files in the
     disk volume header and saves this information in a file which is then
     stored on tape.  This file is used during crash recovery to restore a
     damaged volume header.  Information about mounted filesystems and logical
     volumes is also copied to the backup.  The current date is saved in the
     file /etc/lastbackup.

     Full system backups can be used with the system recovery mechanism from
     the PROM maintenance mode (the miniroot is booted with mode 3 in the
     normal way, but recovery is started, instead of installation).  See your
     Owner's Manual for more information on this procedure.

     The options and arguments to Backup are:

     -h hostname     If a tape drive attached to a remote host is used for
                     backup, specify the name of the remote host with the -h
                     hostname option.  For remote backup to successfully work,
                     you should have a TCP/IP network connection to the remote
                     host and guest login privileges on that host.

     -i              If a backup of all files modified since the date
                     specified in the /etc/lastbackup file is desired, specify
                     the -i option.  This option is valid only when doing a
                     complete backup.

     -t tapedevice   If the local or remote tape device is pointed to by a
                     device file other than /dev/tape, specify the device with
                     the -t tapedevice option.

     directory_name  Create a backup of the directory directory_name.  For
                     this case, when files are restored, they will be restored
                     in the root directory, with the leading directory_name
                     stripped off.

     file_name       Create a backup of the file file_name.

     The Backup command uses cpio(1) to perform the backup function.  Older
     versions used bru(1), or tar(1).  The Restore(1) command will handle any
     of the 3 types of backups.
FILES
     /tmp/volhdrlist     contains the list of the root volume header files
     /etc/lastbackup     contains the date of last full backup for incremental
                         backups; the modification time of this file is used

NOTE
     Backup constructs a list of file names with find to pipe to cpio.
     Filenames with embedded white space will work this way, with the
     exception of filenames with embedded newlines, since each filename in the
     list is terminated by a newline.  This may sometimes produce confusing
     error messages.

     The exit status is 0 on success (including the case where no files are
     backed up, but no errors with the tape drive or command occur).

SEE ALSO
     List_tape(1), Restore(1), cpio(1).