man/man8/backup.8

   1 .TH BACKUP 8
   2 .SH NAME
   3 backup \- backup files
   4 .SH SYNOPSIS
   5 \fBbackup\fR [\fB\-djmnorstvz\fR] \fIdir1 dir2\fR
   6 .br
   7 .de FL
   8 .TP
   9 \\fB\\$1\\fR
  10 \\$2
  11 ..
  12 .de EX
  13 .TP 20
  14 \\fB\\$1\\fR
  15 # \\$2
  16 ..
  17 .SH OPTIONS
  18 .FL "\-d" "At top level, only directories are backed up"
  19 .FL "\-j" "Do not copy junk: \fI *.Z, *.bak, a.out, core\fR, etc"
  20 .FL "\-m" "If device full, prompt for new diskette"
  21 .FL "\-n" "Do not backup top-level directories"
  22 .FL "\-o" "Do not copy \fI*.o\fR files"
  23 .FL "\-r" "Restore files"
  24 .FL "\-s" "Do not copy \fI*.s\fR files"
  25 .FL "\-t" "Preserve creation times"
  26 .FL "\-v" "Verbose; list files being backed up"
  27 .FL "\-z" "Compress the files on the backup medium"
  28 .SH EXAMPLES
  29 .EX "backup \-mz . /f0" "Backup current directory compressed"
  30 .EX "backup /bin /usr/bin" "Backup bin from RAM disk to hard disk"
  31 .SH DESCRIPTION
  32 .PP
  33 \fIBackup\fR (recursively) backs up the contents of a given directory and its
  34 subdirectories to another part of the file system.
  35 It has two typical uses.
  36 First, some portion of the file system can be backed up onto 1 or more
  37 diskettes.
  38 When a diskette fills up, the user is prompted for a new one.
  39 The backups are in the form of mountable file systems.
  40 Second, a directory on RAM disk can be backed up onto hard disk.
  41 If the target directory is empty, the entire source directory is copied
  42 there, optionally compressed to save space.
  43 If the target directory is an old backup, only those files in the target
  44 directory that are older than similar names in the source directory are
  45 replaced.
  46 \fIBackup\fR uses times for this purpose, like \fImake\fR.
  47 Calling \fIBackup\fR as \fIRestore\fR is equivalent to using the -r option;
  48 this replaces newer files in the target directory with older files from the
  49 source directory, uncompressing them if necessary.  The target directory
  50 contents are thus returned to some previous state.
  51 .SH "SEE ALSO"
  52 .BR tar (1).