Return to backup.1 CVS log

Up to [Research Unix] / researchv10dc / man / adm / man1

Annotation of researchv10dc/man/adm/man1/backup.1, revision 1.1

1.1     ! root        1: .TH BACKUP 1
        !             2: .CT 1 sa_mortals 
        !             3: .SH NAME
        !             4: backup \- backup and recover files
        !             5: .SH SYNOPSIS
        !             6: .B "backup recover"
        !             7: [
        !             8: .I option ...
        !             9: ]
        !            10: .I file ...
        !            11: .PP
        !            12: .B "backup grep"
        !            13: [
        !            14: .I option ...
        !            15: ]
        !            16: .I pattern ...
        !            17: .PP
        !            18: .B "backup fetch"
        !            19: [
        !            20: .I option ...
        !            21: ]
        !            22: [
        !            23: .I file ...
        !            24: ]
        !            25: .PP
        !            26: .B "backup stats"
        !            27: [
        !            28: .I option ...
        !            29: ]
        !            30: .PP
        !            31: .B "backup backup"
        !            32: [
        !            33: .I file ...
        !            34: ]
        !            35: .PP
        !            36: .B "backup munge"
        !            37: .PP
        !            38: .B "backup mount"
        !            39: [
        !            40: .I option ...
        !            41: ]
        !            42: .I mountpt
        !            43: .SH DESCRIPTION
        !            44: The
        !            45: .I backup
        !            46: programs save and restore archival copies of files in an optical disk
        !            47: store on a central system (see
        !            48: .IR backup (5)).
        !            49: Backup occurs automatically daily (see
        !            50: .IR backup (8))
        !            51: and upon specific request via
        !            52: .IR "backup backup" .
        !            53: .I "Backup grep"
        !            54: shows backup copy names for specific files, and
        !            55: .I "backup fetch"
        !            56: restores data from specific backup copies.
        !            57: .I "Backup recover"
        !            58: is a combination of these two;
        !            59: it fetches the most recent copy.
        !            60: All the
        !            61: .I backup
        !            62: programs describe their options when presented
        !            63: with a bad option such as
        !            64: .BR -? .
        !            65: .PP
        !            66: .I "Backup recover"
        !            67: retrieves
        !            68: .I files
        !            69: by name.
        !            70: The names should be full pathnames rooted at
        !            71: .BR /n/ ;
        !            72: if not,
        !            73: .I backup
        !            74: tries to guess names that begin with
        !            75: .BR /n/ .
        !            76: Directories should be recovered before their contents.
        !            77: Regular files that are linked together will stay linked if they
        !            78: are recovered together.
        !            79: The options for
        !            80: .I recover
        !            81: are:
        !            82: .TP
        !            83: .BI -o " dir"
        !            84: The argument is restored as an entry in the directory
        !            85: .IR dir .
        !            86: .PD 0
        !            87: .TP
        !            88: .B -v
        !            89: Verbose (enforced).
        !            90: .TP
        !            91: .B -F
        !            92: Restore directories as files containing a null-terminated list of element names.
        !            93: .TP
        !            94: .B -r
        !            95: Recursively recover any subdirectories.
        !            96: .TP
        !            97: .B -d
        !            98: Create any missing intermediate directories.
        !            99: .TP
        !           100: .BI -D old = new
        !           101: Replace the prefix
        !           102: .I old
        !           103: of the original filename with
        !           104: .I new
        !           105: to form the new output filename.
        !           106: .TP
        !           107: .B -m
        !           108: The names are backup copy names, as determined from
        !           109: .I backup grep,
        !           110: not original filenames.
        !           111: .TP
        !           112: .BI -fdevice
        !           113: Use
        !           114: .I device
        !           115: rather than
        !           116: .B /dev/worm0
        !           117: for the WORM.
        !           118: .I Device
        !           119: may be on another machine:
        !           120: .IB machine ! device\fR.
        !           121: An initial
        !           122: .B w
        !           123: implies a WORM device; a
        !           124: .B j
        !           125: implies a jukebox.
        !           126: A numeric 
        !           127: .I device
        !           128: means
        !           129: .BI /dev/worm device\fR.
        !           130: .TP
        !           131: .B -e
        !           132: Cause the
        !           133: .I worm fetch
        !           134: server on the backup system to terminate gracefully.
        !           135: .TP
        !           136: .B -i
        !           137: Append
        !           138: .BI . n
        !           139: to the output name for each file where
        !           140: .I n
        !           141: is an increasing integer.
        !           142: This is useful for recovering multiple copies of the same file.
        !           143: .PD
        !           144: .PP
        !           145: A diagnostic like
        !           146: .B "need disk backup2a"
        !           147: means you need to mount the
        !           148: A side of the cartridge labeled
        !           149: .BR backup2 .
        !           150: .PP
        !           151: .I "Backup grep"
        !           152: searches for names of backed up files that match the strings
        !           153: .IR patterns .
        !           154: If the pattern is a literal (no
        !           155: .BR -e )
        !           156: that looks like a filename, 
        !           157: it reports the filename catenated with
        !           158: .B //
        !           159: and the time
        !           160: of the most recent backup copy.
        !           161: If the pattern is a literal that looks like the output under option
        !           162: .BR -d , 
        !           163: it reports the name of the corresponding backup copy.
        !           164: The options are:
        !           165: .TP
        !           166: .B -d
        !           167: Print file change times 
        !           168: .RB ( ctime ,
        !           169: see
        !           170: .IR stat (2))
        !           171: as integers rather than as dates.
        !           172: .PD 0
        !           173: .TP
        !           174: .B -e
        !           175: Interpret
        !           176: .I patterns
        !           177: as regular expressions
        !           178: given in the notation of
        !           179: .IR regexp (3).
        !           180: Warning:
        !           181: this option can execute extremely slowly;
        !           182: it is almost always better to use
        !           183: .IR gre (1)
        !           184: on
        !           185: .F /usr/backup/filenames
        !           186: on the backup machine; see
        !           187: .IR backup (5).
        !           188: .TP
        !           189: .B -a
        !           190: Print all names in the database.
        !           191: .TP
        !           192: .B -V
        !           193: Treat
        !           194: .I pattern
        !           195: as a literal filename
        !           196: and list all versions of the file.
        !           197: .TP
        !           198: .BI -< n
        !           199: Only list entries with a date less than or equal to
        !           200: .IR n .
        !           201: If
        !           202: .I n
        !           203: is not a simple integer date, it is interpreted as by
        !           204: .IR timec (3).
        !           205: .TP
        !           206: .BI -> n
        !           207: Only list entries with a date greater than or equal to
        !           208: .IR n .
        !           209: .TP
        !           210: .B -D
        !           211: Print the most recent entry for every file name starting with
        !           212: .I pattern,
        !           213: taking into account any cutoff date, but turning off option
        !           214: .BR -e .
        !           215: .PD
        !           216: .PP
        !           217: .I Backup fetch
        !           218: takes from its arguments or from standard input
        !           219: backup copy names as reported by
        !           220: .I backup grep
        !           221: (such as
        !           222: .BR v2345/987 )
        !           223: and restores the corresponding files.
        !           224: It accepts the same options as
        !           225: .I backup recover
        !           226: except 
        !           227: .BR -m ;
        !           228: .B -v
        !           229: is really optional.
        !           230: Irrelevant prefixes are stripped from backup copy names.
        !           231: Thus the output of the
        !           232: .I "backup grep"
        !           233: command can be used directly.
        !           234: .PP
        !           235: .I "Backup stats"
        !           236: provides statistics about the files backed up.
        !           237: By default, it looks for all systems and all users and gives a grand total.
        !           238: The options are
        !           239: .nr xx \w'\f5-u \fIusers '
        !           240: .TP \n(xxu
        !           241: .B -i
        !           242: Give information per system or user 
        !           243: rather than a total.
        !           244: .TP
        !           245: .BI -s " systems
        !           246: .br
        !           247: .ns
        !           248: .TP
        !           249: .BI -u " users
        !           250: With option
        !           251: .BR -i ,
        !           252: restrict the total to the systems or users named in
        !           253: comma-separated lists.
        !           254: The name
        !           255: .L *
        !           256: expands to all systems or all users.
        !           257: .TP
        !           258: .B -d
        !           259: Print average number of files and bytes for the last 1 day,
        !           260: 7 days and 30 days.
        !           261: .PP
        !           262: .I "Backup backup"
        !           263: backs up files.
        !           264: If no file names are given,
        !           265: they are taken from standard input.
        !           266: File names are interpreted as in
        !           267: .IR "backup recover" .
        !           268: The files are safely on the backup system when the command exits but
        !           269: will normally take a day to get into the backup database.
        !           270: .PP
        !           271: .I "Backup munge"
        !           272: causes the backup system to process any received files.
        !           273: When this terminates (assuming no errors), the files have been
        !           274: put onto backup media and have been absorbed into the database.
        !           275: .PP
        !           276: .I "Backup mount"
        !           277: is an experimental way to access backed up files.
        !           278: The specified part of the backup files
        !           279: (set by
        !           280: .BI -D root
        !           281: or
        !           282: .B /
        !           283: by default) is mounted at
        !           284: .IR mountpt .
        !           285: There is one option
        !           286: .TP \n(xxu
        !           287: .BI -d " date
        !           288: Make the mounted hierarchy reflect the state at 
        !           289: the given date.
        !           290: The mounting can be reversed with
        !           291: .IR umount ;
        !           292: see
        !           293: .IR mount (8).
        !           294: .SH EXAMPLES
        !           295: .TP
        !           296: .L
        !           297: backup stats -i -s '*'
        !           298: Get totals for all systems.
        !           299: .TP
        !           300: .L
        !           301: backup fetch `backup grep -d \e`backup grep -d /n/bowell/etc/passwd\e``
        !           302: What 
        !           303: .I backup recover
        !           304: does for you.
        !           305: .TP
        !           306: .L
        !           307: backup recover /n/coma/usr/rob/fortunes
        !           308: .br
        !           309: .ns
        !           310: .TP
        !           311: .L
        !           312: cd /n/coma/usr/rob; backup recover fortunes
        !           313: Two ways to get the latest available copy of
        !           314: .BR /n/coma/usr/rob/fortunes .
        !           315: .TP
        !           316: .L
        !           317: backup grep -V /n/coma/usr/rob/fortunes
        !           318: List all available copies of
        !           319: .B /n/coma/usr/rob/fortunes
        !           320: with their dates.
        !           321: .TP
        !           322: .L
        !           323: backup recover -m -o /tmp /n/wild/usr/backup/v/v919/678
        !           324: .br
        !           325: .ns
        !           326: .TP
        !           327: .L
        !           328: backup recover -m -o /tmp v919/678
        !           329: Two ways to recover a specific backup copy and place the result in
        !           330: .BR /tmp .
        !           331: .B /n/wild/usr/backup/v/v919/678
        !           332: is the name of the backup copy; the file will be restored to
        !           333: its home machine, not to
        !           334: .BR wild .
        !           335: .TP
        !           336: .L
        !           337: backup grep -V /n/coma/usr/rob/fortunes | backup fetch -i -o .
        !           338: Recover all the versions of the fortunes file into
        !           339: .BR fortunes.1 ,
        !           340: .BR fortunes.2 ,
        !           341: \&... in the current directory.
        !           342: .PD
        !           343: .SH FILES
        !           344: .F /usr/lib/backup
        !           345: \h'.5i'home of all datafiles and executables (on client machines)
        !           346: .SH "SEE ALSO"
        !           347: .IR worm (8),
        !           348: .IR backup (5), 
        !           349: .IR backup (8)
        !           350: .SH BUGS
        !           351: Recovery via symbolic links may not work; use the non-linked pathname.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.