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 .TP 5
  19 .B \-d
  20 # At top level, only directories are backed up
  21 .TP 5
  22 .B \-j
  23 # Do not copy junk: \fI *.Z, *.bak, a.out, core\fR, etc
  24 .TP 5
  25 .B \-m
  26 # If device full, prompt for new diskette
  27 .TP 5
  28 .B \-n
  29 # Do not backup top-level directories
  30 .TP 5
  31 .B \-o
  32 # Do not copy \fI*.o\fR files
  33 .TP 5
  34 .B \-r
  35 # Restore files
  36 .TP 5
  37 .B \-s
  38 # Do not copy \fI*.s\fR files
  39 .TP 5
  40 .B \-t
  41 # Preserve creation times
  42 .TP 5
  43 .B \-v
  44 # Verbose; list files being backed up
  45 .TP 5
  46 .B \-z
  47 # Compress the files on the backup medium
  48 .SH EXAMPLES
  49 .TP 20
  50 .B backup \-mz . /f0
  51 # Backup current directory compressed
  52 .TP 20
  53 .B backup /bin /usr/bin
  54 # Backup bin from RAM disk to hard disk
  55 .SH DESCRIPTION
  56 .PP
  57 \fIBackup\fR (recursively) backs up the contents of a given directory and its
  58 subdirectories to another part of the file system.
  59 It has two typical uses.
  60 First, some portion of the file system can be backed up onto 1 or more
  61 diskettes.
  62 When a diskette fills up, the user is prompted for a new one.
  63 The backups are in the form of mountable file systems.
  64 Second, a directory on RAM disk can be backed up onto hard disk.
  65 If the target directory is empty, the entire source directory is copied
  66 there, optionally compressed to save space.
  67 If the target directory is an old backup, only those files in the target
  68 directory that are older than similar names in the source directory are
  69 replaced.
  70 \fIBackup\fR uses times for this purpose, like \fImake\fR.
  71 Calling \fIBackup\fR as \fIRestore\fR is equivalent to using the -r option;
  72 this replaces newer files in the target directory with older files from the
  73 source directory, uncompressing them if necessary.  The target directory
  74 contents are thus returned to some previous state.
  75 .SH "SEE ALSO"
  76 .BR tar (1).