[net.unix-wizards] Incremental Backup

walsh (04/14/83)

Manual pages for the programs we use at Harvard follow.  They are
currently running on 70s, Vaxen, and BBN C70s.  They were initially
written by Steve Dyer (now of BBN).

Bob Walsh
Harvard Science Center
(617) 495-5320

walsh (04/14/83)

MTBACKUP(8H)        UNIX Programmer's Manual         MTBACKUP(8H)

NAME
     mtbackup - incremental file system dump

SYNOPSIS
     /privbin/mtbackup [ -daily -weekly -monthly ] [ -tell ]

DESCRIPTION
     _M_t_b_a_c_k_u_p copies to magnetic tape all files on all currently
     mounted filesystems changed after a certain date.  Its
     method of doing this is by exec'ing (2) /privbin/mtb (8).

     Mtbackup's purpose in life is to run mtb with the proper
     argument.  Mtbackup, after finding out the date, will run a
     monthly backup if the time is between noon the first of a
     month and noon on the second.  Otherwise, if the time lies
     between noon Thursday and noon Friday, a weekly backup is
     performed.  If none of the above two cases holds, a daily
     backup is performed.

     A particular type of backup may be forced by using the
     appropriate switch.

     The "-tell" switch tells when the last type of the various
     kinds of backup was done.

     Please avoid forcing a particular kind of backup.  Let the
     program make the decisions.

SEE ALSO
     mtb(8H)

Printed 4/14/83                                                 1

MTB(8H)             UNIX Programmer's Manual              MTB(8H)

NAME
     mtb - incremental file system dump

SYNOPSIS
     /privbin/mtb [ -daily -weekly -monthly -semester ]

DESCRIPTION
     _M_t_b copies to magnetic tape all files on all currently
     mounted filesystems changed after a certain date.  The date
     after which all modified files are dumped is the date of the
     last more inclusive dump.  For example, files place on a
     daily dump tape are those changed since the last weekly was
     completed.

SWITCHES
     [-verbose]

     This switch causes the program to list the files as they are
     placed on the tape.

     [-from pathname]

     This switch forces mtb not to dump files who come alphabeti-
     cally before pathname.  It can be used to resume a backup if
     for some reason a tape was imporperly written, didn't com-
     plete, or if the mtb process died.  You simply restart mtb
     using the file that was to be the first file on the aborted
     tape as the argument to from.

     [-nice]

     Causes mtb to give itself a slightly better priority to do
     the job quicker.

     [-root pathname]

     Normally mtb descends the directory tree starting at "/".
     This substitutes a different tree on which to perform
     backup.

SIGNALS AND MTB
     When mtb receives a SIGTERM (15), it prints out on the con-
     sole what files it is currently dumping.

SEE ALSO
     mtbackup(8H)

Printed 4/14/83                                                 1

RETRIEVE(1H)        UNIX Programmer's Manual         RETRIEVE(1H)

NAME
     retrieve - recover files from incremental backup

SYNOPSIS
     /usr/bin/retrieve

DESCRIPTION
     _R_e_t_r_i_e_v_e extracts files from a tape written by mtb(8).  The
     format of a backup tape written by mtb is different from
     that written by dump(8), tar(1), tp(1), or standard ansi
     format.

SWITCHES
     [-verbose]

     This switch causes the program to list the files as they are
     extracted from the tape.

     [-confirm]

     Lists each file before it is extracted and asks if you
     really want to extract it.

     [-fi pathname]

     List all files on the tape whose path starts with pathname.

     [-dir pathname]

     Lists all the files with more complete directory informa-
     tion.

     [-extract] [file1 ...]

     Extracts the named files from the tape.

     [-short]

     When used with -extract, the files are not put in their ori-
     ginal paths, but in the current directory.  No subdirec-
     tories are used.  All files are put in the current direc-
     tory.

     [-tree tpath]

     Turns off the short switch.  The specified files are
     extracted to the current directory with the initial segment
     (tpath) of their full pathname removed.  For example,
     retrieve -extract -tree /fs/b/ /fs/b/dyer/misc/
     would extract the files "/fs/b/dyer/misc/*" into the current
     directory as "dyer/misc/*".  Subdirectories are used, in
     contrast to the -short switch.

Printed 4/9/83                                                  1

RETRIEVE(1H)        UNIX Programmer's Manual         RETRIEVE(1H)

SEE ALSO
     mtbackup(8)

Printed 4/9/83                                                  2