.\" $HeadURL$ $LastChangedRevision$
.\"
.TH BACKUP 8 "3 January 2002"
.SH NAME
backup \- Make a Tape Backup in a Home Environment
.br
.ne 5
.SH SYNOPSIS
.B backup
[ 
.B \-d
.I level
|
.B \-v
] [
.B \-n
|
.B \-y
|
.B \-p
] [
.B \-f
.I configfile
] [
.I backupid
] [
.I tapeid
]
.br
.B "mkfad -V"
.br
.ne 5
.SH DESCRIPTION
.I Backup
makes tape backups according to a config file. That is, the source to 
backup, the method to use to make the backup and the method used to 
verify the data are all controlled by a config file; it is not possible
to specify on the command line a backup to be done that has not already
been specified in the configuration file. For more details on the configuration
file see 
.I backup.conf\fR(5).
.I Backup
runs extensive tape checks before starting the backup. It logs everything.
.PP
Two command line arguments may be supplied, although if either is missing
they will be prompted for. The first is the backup id - this refers to a
small set of backups to be done in one batch. The contents of this batch
are specified in the configuaration file. The second is the tape identification
string. Currently this is not used, although it is logged.
.br
.ne 5
.SH OPTIONS
.\"  This indents everything after the next line by 25 some-things.
.TP 25
.B \-V
Print the version number and exit.
.TP
.B \-d \fIlevel\fB
Sets debug to the specified level.
.TP
.B \-v
This is equivalent to \fB\-d 3\fR.
.TP
.B \-n
No backup is done, it is only simulated. No data is written to the tape.
.TP
.B \-y
The backup is not simulated. This is the default.
.TP
.B \-p
The user is prompted at all tape-write operations.
.TP
.B \-f \fIconfigfile\fB
Specifies an alternate configuration file to use.
.br
.ne 5
.SH FILES
.TP 25
.B \*[backup_etc_prefix]/backup.conf
default backup configuration file.
.br
.ne 5
.SH ENVIRONMENT VARIABLES
None.
.br
.ne 5
.SH DIAGNOSTICS
No diagnostic messages are so cryptic that they need to be explained here.
.br
.ne 5
.SH CAVEATS
.I Backup
does not support pre- and post-backup tasks (such as shutting down 
databases, splitting mirrored volumes etc. But see CAVEATS below.
.PP
Beware that log files can be enormous.
.br
.ne 5
.SH SEE ALSO
dailybackup(8), backup.conf(5)
.br
.ne 5
.SH AUTHOR
ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>
.br
.ne 5
.SH COPYRIGHT & DISTRIBUTION POLICY
Copyright (C) 1997-2002 ADE_APP_TOKEN_AUTHOR_NAME
.PP
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
.PP
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
.PP
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.