.TH BACKUP 1 .CT 1 sa_mortals .SH NAME backup \- backup and recover files .SH SYNOPSIS .B "backup recover" [ .I option ... ] .I file ... .PP .B "backup grep" [ .I option ... ] .I pattern ... .PP .B "backup fetch" [ .I option ... ] [ .I file ... ] .PP .B "backup stats" [ .I option ... ] .PP .B "backup backup" [ .I file ... ] .PP .B "backup munge" .PP .B "backup mount" [ .I option ... ] .I mountpt .SH DESCRIPTION The .I backup programs save and restore archival copies of files in an optical disk store on a central system (see .IR backup (5)). Backup occurs automatically daily (see .IR backup (8)) and upon specific request via .IR "backup backup" . .I "Backup grep" shows backup copy names for specific files, and .I "backup fetch" restores data from specific backup copies. .I "Backup recover" is a combination of these two; it fetches the most recent copy. All the .I backup programs describe their options when presented with a bad option such as .BR -? . .PP .I "Backup recover" retrieves .I files by name. The names should be full pathnames rooted at .BR /n/ ; if not, .I backup tries to guess names that begin with .BR /n/ . Directories should be recovered before their contents. Regular files that are linked together will stay linked if they are recovered together. The options for .I recover are: .TP .BI -o " dir" The argument is restored as an entry in the directory .IR dir . .PD 0 .TP .B -v Verbose (enforced). .TP .B -F Restore directories as files containing a null-terminated list of element names. .TP .B -r Recursively recover any subdirectories. .TP .B -d Create any missing intermediate directories. .TP .BI -D old = new Replace the prefix .I old of the original filename with .I new to form the new output filename. .TP .B -m The names are backup copy names, as determined from .I backup grep, not original filenames. .TP .BI -fdevice Use .I device rather than .B /dev/worm0 for the WORM. .I Device may be on another machine: .IB machine ! device\fR. An initial .B w implies a WORM device; a .B j implies a jukebox. A numeric .I device means .BI /dev/worm device\fR. .TP .B -e Cause the .I worm fetch server on the backup system to terminate gracefully. .TP .B -i Append .BI . n to the output name for each file where .I n is an increasing integer. This is useful for recovering multiple copies of the same file. .PD .PP A diagnostic like .B "need disk backup2a" means you need to mount the A side of the cartridge labeled .BR backup2 . .PP .I "Backup grep" searches for names of backed up files that match the strings .IR patterns . If the pattern is a literal (no .BR -e ) that looks like a filename, it reports the filename catenated with .B // and the time of the most recent backup copy. If the pattern is a literal that looks like the output under option .BR -d , it reports the name of the corresponding backup copy. The options are: .TP .B -d Print file change times .RB ( ctime , see .IR stat (2)) as integers rather than as dates. .PD 0 .TP .B -e Interpret .I patterns as regular expressions given in the notation of .IR regexp (3). Warning: this option can execute extremely slowly; it is almost always better to use .IR gre (1) on .F /usr/backup/filenames on the backup machine; see .IR backup (5). .TP .B -a Print all names in the database. .TP .B -V Treat .I pattern as a literal filename and list all versions of the file. .TP .BI -< n Only list entries with a date less than or equal to .IR n . If .I n is not a simple integer date, it is interpreted as by .IR timec (3). .TP .BI -> n Only list entries with a date greater than or equal to .IR n . .TP .B -D Print the most recent entry for every file name starting with .I pattern, taking into account any cutoff date, but turning off option .BR -e . .PD .PP .I Backup fetch takes from its arguments or from standard input backup copy names as reported by .I backup grep (such as .BR v2345/987 ) and restores the corresponding files. It accepts the same options as .I backup recover except .BR -m ; .B -v is really optional. Irrelevant prefixes are stripped from backup copy names. Thus the output of the .I "backup grep" command can be used directly. .PP .I "Backup stats" provides statistics about the files backed up. By default, it looks for all systems and all users and gives a grand total. The options are .nr xx \w'\f5-u \fIusers ' .TP \n(xxu .B -i Give information per system or user rather than a total. .TP .BI -s " systems .br .ns .TP .BI -u " users With option .BR -i , restrict the total to the systems or users named in comma-separated lists. The name .L * expands to all systems or all users. .TP .B -d Print average number of files and bytes for the last 1 day, 7 days and 30 days. .PP .I "Backup backup" backs up files. If no file names are given, they are taken from standard input. File names are interpreted as in .IR "backup recover" . The files are safely on the backup system when the command exits but will normally take a day to get into the backup database. .PP .I "Backup munge" causes the backup system to process any received files. When this terminates (assuming no errors), the files have been put onto backup media and have been absorbed into the database. .PP .I "Backup mount" is an experimental way to access backed up files. The specified part of the backup files (set by .BI -D root or .B / by default) is mounted at .IR mountpt . There is one option .TP \n(xxu .BI -d " date Make the mounted hierarchy reflect the state at the given date. The mounting can be reversed with .IR umount ; see .IR mount (8). .SH EXAMPLES .TP .L backup stats -i -s '*' Get totals for all systems. .TP .L backup fetch `backup grep -d \e`backup grep -d /n/bowell/etc/passwd\e`` What .I backup recover does for you. .TP .L backup recover /n/coma/usr/rob/fortunes .br .ns .TP .L cd /n/coma/usr/rob; backup recover fortunes Two ways to get the latest available copy of .BR /n/coma/usr/rob/fortunes . .TP .L backup grep -V /n/coma/usr/rob/fortunes List all available copies of .B /n/coma/usr/rob/fortunes with their dates. .TP .L backup recover -m -o /tmp /n/wild/usr/backup/v/v919/678 .br .ns .TP .L backup recover -m -o /tmp v919/678 Two ways to recover a specific backup copy and place the result in .BR /tmp . .B /n/wild/usr/backup/v/v919/678 is the name of the backup copy; the file will be restored to its home machine, not to .BR wild . .TP .L backup grep -V /n/coma/usr/rob/fortunes | backup fetch -i -o . Recover all the versions of the fortunes file into .BR fortunes.1 , .BR fortunes.2 , \&... in the current directory. .PD .SH FILES .F /usr/lib/backup \h'.5i'home of all datafiles and executables (on client machines) .SH "SEE ALSO" .IR worm (8), .IR backup (5), .IR backup (8) .SH BUGS Recovery via symbolic links may not work; use the non-linked pathname.