BACKUP(1M) BACKUP(1M)
NAME
backup - backup files and directories now, later, or recurring
SYNOPSIS
/usr/sysadm/privbin/backup -f device -n [ options ]
/usr/sysadm/privbin/backup -f device -l time [ options ]
/usr/sysadm/privbin/backup -f device -d time [ options ]
/usr/sysadm/privbin/backup -f device -w day:time [ options ]
DESCRIPTION
backup is a privileged command that performs a backup of the entire
system or of a selected list of files. The backup can be performed now,
once at a later date, or recurring either daily or weekly.
backup uses cpio(1) to write its output. device would typically be a
tape device, but can also be a file for backing up to disk.
-n is used to specify that a backup occur now, -l is for backups which
are occur once at a later date, -d is for daily backups, and -w is for
weekly backups. Backups that occur once at a later date are scheduled
using at(1), and recurring backups are scheduled using cron(1).
After scheduling a later or recurring backup, backup prints to its output
a string which uniquely identifies this backup to the system. This
string can be used to unschedule the backup using unschedBackup(1M).
backup can be run by ordinary users without going through runpriv(1M).
Ordinary users cannot do full system backups, and backups made by
ordinary users will not be able to back up files that the user does not
have permission to read.
When doing a full system backup, backup does not back up nfs mounted
files. When backing up a selected list of files, backup does back up nfs
mounted files.
OPTIONS
-f device Specifies where the backup is to be written. Typically this
would be a tape device such as /dev/tape or
user@remotehost:/dev/tape, but can also be a file for backup to
disk.
-n Specifies that the backup is to occur now.
-l time Specifies that the backup is to occur at time. time is in
seconds since midnight Jan 1, 1970.
-d time Specifies that the backup is to occur daily. time is the
number of seconds after midnight to start the backup.
-w day:time
Specifies that the backup is to occur weekly. day is the
number of days after after Sunday to start the backup, and time
Page 1
BACKUP(1M) BACKUP(1M)
is the number of seconds after midnight to start the backup.
-i indentifier
identifier is to be associated with this backup. identifier is
displayed in the BackupAndRestoreManager(1M) along with the
icon for this backup.
-v Output of the backup is to be verbose. Specifying -v to backup
causes v to be included as an option to cpio(1).
-m email-address
For later and recurring backups, send a backup report to
email-address. If -v was specified, this will include a list
of the files which were backed up. If this option is not
specified, the user that scheduled the backup will receive mail
from cron.
-s source source is a file containing a list of files to be backed up,
one per line. These can either be full paths, or can be
relative to the root specified with the -r option. If the -s
option is not specified, this will be a full system backup.
-r root Specify that the backup should be relative to root. This has
no effect unless the paths in source are relative, and never
has an effect on full backups.
FILES
/var/sysadm/backups/* File lists for later and recurring backups
scheduled by root.
$HOME/.saBackupLists/* File lists for later and recurring backups
scheduled by non-root users.
$HOME/.saBackupSched/* Information about later backups for the
BackupAndRestoreManager(1M). This duplicates
information stored by at(1) which is not
readable by non-root users and difficult to
parse. Information about recurring backups is
retrieved using crontab(1).
SEE ALSO
cpio(1), cpio(1), cron(1), at(1), crontab(1), sysmgr(1M),
BackupAndRestoreManager(1M), restore(1M), unschedBackup(1M).
Page 2