.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "BACKUP_DUMPINFO 8" .TH BACKUP_DUMPINFO 8 "2023-12-24" "OpenAFS" "AFS Command Reference" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" backup_dumpinfo \- Displays a dump record from the Backup Database .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBbackup dumpinfo\fR [\fB\-ndumps\fR\ <\fInumber\ of\ dumps\fR>] [\fB\-id\fR\ <\fIdump\ id\fR>] [\fB\-verbose\fR] [\fB\-localauth\fR] [\fB\-cell\fR\ <\fIcell\ name\fR>] [\fB\-help\fR] .PP \&\fBbackup dumpi\fR [\fB\-n\fR\ <\fIno.\ of\ dumps\fR>] [\-i <\fIdump id\fR>] [\fB\-v\fR] [\fB\-l\fR] [\fB\-c\fR\ <\fIcell\ name\fR>] [\fB\-h\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" The \fBbackup dumpinfo\fR command formats and displays the Backup Database record for the specified dumps. To specify how many of the most recent dumps to display, starting with the newest one and going back in time, use the \fB\-ndumps\fR argument. To display more detailed information about a single dump, use the \fB\-id\fR argument. To display the records for the 10 most recent dumps, omit both the \fB\-ndumps\fR and \fB\-id\fR arguments. .PP The \fB\-verbose\fR flag produces very detailed information that is useful mostly for debugging purposes. It can be combined only with the \fB\-id\fR argument. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-ndumps\fR <\fInumber of dumps\fR>" 4 .IX Item "-ndumps " Displays the Backup Database record for each of the specified number of dumps that were most recently performed. If the database contains fewer dumps than are requested, the output includes the records for all existing dumps. Do not combine this argument with the \fB\-id\fR or \fB\-verbose\fR options; omit all options to display the records for the last 10 dumps. .IP "\fB\-id\fR <\fIdump id\fR>" 4 .IX Item "-id " Specifies the dump \s-1ID\s0 number of a single dump for which to display the Backup Database record. Precede the \fIdump id\fR value with the \fB\-id\fR switch; otherwise, the command interpreter interprets it as the value of the \fB\-ndumps\fR argument. Combine this argument with the \fB\-verbose\fR flag, but not with the \fB\-ndumps\fR argument; omit all options to display the records for the last 10 dumps. .IP "\fB\-verbose\fR" 4 .IX Item "-verbose" Provides more detailed information about the dump specified with the \&\fB\-id\fR argument, which must be provided along with it. Do not combine this flag with the \fB\-ndumps\fR argument. .IP "\fB\-localauth\fR" 4 .IX Item "-localauth" Constructs a server ticket using a key from the local \&\fI/etc/openafs/server/KeyFile\fR file. The \fBbackup\fR command interpreter presents it to the Backup Server, Volume Server and \s-1VL\s0 Server during mutual authentication. Do not combine this flag with the \fB\-cell\fR argument. For more details, see \fBbackup\fR\|(8). .IP "\fB\-cell\fR <\fIcell name\fR>" 4 .IX Item "-cell " Names the cell in which to run the command. Do not combine this argument with the \fB\-localauth\fR flag. For more details, see \fBbackup\fR\|(8). .IP "\fB\-help\fR" 4 .IX Item "-help" Prints the online help for this command. All other valid options are ignored. .SH "OUTPUT" .IX Header "OUTPUT" If the \fB\-ndumps\fR argument is provided, the output presents the following information in table form, with a separate line for each dump: .IP "dumpid" 4 .IX Item "dumpid" The dump \s-1ID\s0 number. .IP "parentid" 4 .IX Item "parentid" The dump \s-1ID\s0 number of the dump's parent dump. A value of \f(CW0\fR (zero) identifies a full dump. .IP "lv" 4 .IX Item "lv" The depth in the dump hierarchy of the dump level used to create the dump. A value of \f(CW0\fR (zero) identifies a full dump, in which case the value in the \f(CW\*(C`parentid\*(C'\fR field is also \f(CW0\fR. A value of \f(CW1\fR or greater indicates an incremental dump made at the corresponding level in the dump hierarchy. .IP "created" 4 .IX Item "created" The date and time at which the Backup System started the dump operation that created the dump. .IP "nt" 4 .IX Item "nt" The number of tapes that contain the data in the dump. A value of \f(CW0\fR (zero) indicates that the dump operation was terminated or failed. Use the \&\fBbackup deletedump\fR command to remove such entries. .IP "nvols" 4 .IX Item "nvols" The number of volumes from which the dump includes data. If a volume spans tapes, it is counted twice. A value of \f(CW0\fR (zero) indicates that the dump operation was terminated or failed; the value in the \f(CW\*(C`nt\*(C'\fR field is also \&\f(CW0\fR in this case. .IP "dump name" 4 .IX Item "dump name" The dump name in the form .Sp .Vb 1 \& . () .Ve .Sp where is the name of the volume set, and is the last element in the dump level pathname at which the volume set was dumped. .Sp The , if displayed, is the dump \s-1ID\s0 of the initial dump in the dump set to which this dump belongs. If there is no value in parentheses, the dump is the initial dump in a dump set that has no appended dumps. .PP If the \fB\-id\fR argument is provided alone, the first line of output begins with the string \f(CW\*(C`Dump\*(C'\fR and reports information for the entire dump in the following fields: .IP "id" 4 .IX Item "id" The dump \s-1ID\s0 number. .IP "level" 4 .IX Item "level" The depth in the dump hierarchy of the dump level used to create the dump. A value of \f(CW0\fR (zero) identifies a full dump. A value of \f(CW1\fR (one) or greater indicates an incremental dump made at the specified level in the dump hierarchy. .IP "volumes" 4 .IX Item "volumes" The number of volumes for which the dump includes data. .IP "created" 4 .IX Item "created" The date and time at which the dump operation began. .PP If an \s-1XBSA\s0 server was the backup medium for the dump (rather than a tape device or backup data file), the following line appears next: .PP .Vb 1 \& Backup Service: : Server: .Ve .PP where is the name of the XBSA-compliant program and is the name of the machine on which the program runs. .PP Next the output includes an entry for each tape that houses volume data from the dump. Following the string \f(CW\*(C`Tape\*(C'\fR, the first two lines of each entry report information about that tape in the following fields: .IP "name" 4 .IX Item "name" The tape's permanent name if it has one, or its \s-1AFS\s0 tape name otherwise, and its tape \s-1ID\s0 number in parentheses. .IP "nVolumes" 4 .IX Item "nVolumes" The number of volumes for which this tape includes dump data. .IP "created" 4 .IX Item "created" The date and time at which the Tape Coordinator began writing data to this tape. .PP Following another blank line, the tape-specific information concludes with a table that includes a line for each volume dump on the tape. The information appears in columns with the following headings: .IP "Pos" 4 .IX Item "Pos" The relative position of each volume in this tape or file. On a tape, the counter begins at position 2 (the tape label occupies position 1), and increments by one for each volume. For volumes in a backup data file, the position numbers start with 1 and do not usually increment only by one, because each is the ordinal of the 16 \s-1KB\s0 offset in the file at which the volume's data begins. The difference between the position numbers therefore indicates how many 16 \s-1KB\s0 blocks each volume's data occupies. For example, if the second volume is at position 5 and the third volume in the list is at position 9, that means that the dump of the second volume occupies 64 \s-1KB\s0 (four 16\-KB blocks) of space in the file. .IP "Clone time" 4 .IX Item "Clone time" For a backup or read-only volume, the time at which it was cloned from its read/write source. For a Read/Write volume, it is the same as the dump creation date reported on the first line of the output. .IP "Nbytes" 4 .IX Item "Nbytes" The number of bytes of data in the dump of the volume. .IP "Volume" 4 .IX Item "Volume" The volume name, complete with \f(CW\*(C`.backup\*(C'\fR or \f(CW\*(C`.readonly\*(C'\fR extension if appropriate. .PP If both the \fB\-id\fR and \fB\-verbose\fR options are provided, the output is divided into several sections: .IP "\(bu" 4 The first section, headed by the underlined string \f(CW\*(C`Dump\*(C'\fR, includes information about the entire dump. The fields labeled \f(CW\*(C`id\*(C'\fR, \f(CW\*(C`level\*(C'\fR, \&\f(CW\*(C`created\*(C'\fR, and \f(CW\*(C`nVolumes\*(C'\fR report the same values (though in a different order) as appear on the first line of output when the \fB\-id\fR argument is provided by itself. Other fields of potential interest to the backup operator are: .RS 4 .IP "Group id" 4 .IX Item "Group id" The dump's \fIgroup \s-1ID\s0 number\fR, which is recorded in the dump's Backup Database record if the \f(CW\*(C`GROUPID\*(C'\fR instruction appears in the Tape Coordinator's \fI/var/lib/openafs/backup/CFG_\fItcid\fI\fR file when the dump is created. .IP "maxTapes" 4 .IX Item "maxTapes" The number of tapes that contain the dump set to which this dump belongs. .IP "Start Tape Seq" 4 .IX Item "Start Tape Seq" The ordinal of the tape on which this dump begins in the set of tapes that contain the dump set. .RE .RS 4 .RE .IP "\(bu" 4 For each tape that contains data from this dump, there follows a section headed by the underlined string \f(CW\*(C`Tape\*(C'\fR. The fields labeled \f(CW\*(C`name\*(C'\fR, \&\f(CW\*(C`written\*(C'\fR, and \f(CW\*(C`nVolumes\*(C'\fR report the same values (though in a different order) as appear on the second and third lines of output when the \fB\-id\fR argument is provided by itself. Other fields of potential interest to the backup operator are: .RS 4 .IP "expires" 4 .IX Item "expires" The date and time when this tape can be recycled, because all dumps it contains have expired. .IP "nMBytes Data and nBytes Data" 4 .IX Item "nMBytes Data and nBytes Data" Summed together, these fields represent the total amount of dumped data actually from volumes (as opposed to labels, filemarks, and other markers). .IP "KBytes Tape Used" 4 .IX Item "KBytes Tape Used" The number of kilobytes of tape (or disk space, for a backup data file) used to store the dump data. It is generally larger than the sum of the values in the \f(CW\*(C`nMBytes Data\*(C'\fR and \f(CW\*(C`nBytes Data\*(C'\fR fields, because it includes the space required for the label, file marks and other markers, and because the Backup System writes data at 16 \s-1KB\s0 offsets, even if the data in a given block doesn't fill the entire 16 \s-1KB.\s0 .RE .RS 4 .RE .IP "\(bu" 4 For each volume on a given tape, there follows a section headed by the underlined string \f(CW\*(C`Volume\*(C'\fR. The fields labeled \f(CW\*(C`name\*(C'\fR, \f(CW\*(C`position\*(C'\fR, \&\f(CW\*(C`clone\*(C'\fR, and \f(CW\*(C`nBytes\*(C'\fR report the same values (though in a different order) as appear in the table that lists the volumes in each tape when the \&\fB\-id\fR argument is provided by itself. Other fields of potential interest to the backup operator are: .RS 4 .IP "id" 4 .IX Item "id" The volume \s-1ID.\s0 .IP "tape" 4 .IX Item "tape" The name of the tape containing this volume data. .RE .RS 4 .RE .SH "EXAMPLES" .IX Header "EXAMPLES" The following example displays information about the last five dumps: .PP .Vb 7 \& % backup dumpinfo \-ndumps 5 \& dumpid parentid lv created nt nvols dump name \& 924424000 0 0 04/18/1999 04:26 1 22 usr.sun (924424000) \& 924685000 924424000 1 04/21/1999 04:56 1 62 usr.wed (924424000) \& 924773000 924424000 1 04/22/1999 05:23 1 46 usr.thu (924424000) \& 924860000 924424000 1 04/23/1999 05:33 1 58 usr.fri (924424000) \& 925033000 0 0 04/25/1999 05:36 2 73 sys.week .Ve .PP The following example displays a more detailed record for a single dump. .PP .Vb 6 \& % backup dumpinfo \-id 922097346 \& Dump: id 922097346, level 0, volumes 1, created Mon Mar 22 05:09:06 1999 \& Tape: name monday.user.backup (922097346) \& nVolumes 1, created 03/22/1999 05:09 \& Pos Clone time Nbytes Volume \& 1 03/22/1999 04:43 27787914 user.pat.backup .Ve .PP The following example displays even more detailed information about the dump displayed in the previous example (dump \s-1ID 922097346\s0). This example includes only one exemplar of each type of section (\f(CW\*(C`Dump\*(C'\fR, \f(CW\*(C`Tape\*(C'\fR, and \&\f(CW\*(C`Volume\*(C'\fR): .PP .Vb 10 \& % backup dumpinfo \-id 922097346 \-verbose \& Dump \& \-\-\-\- \& id = 922097346 \& Initial id = 0 \& Appended id = 922099568 \& parent = 0 \& level = 0 \& flags = 0x0 \& volumeSet = user \& dump path = /monday1 \& name = user.monday1 \& created = Mon Mar 22 05:09:06 1999 \& nVolumes = 1 \& id = 0 \& tapeServer = \& format= user.monday1.%d \& maxTapes = 1 \& Start Tape Seq = 1 \& name = pat \& instance = \& cell = \& Tape \& \-\-\-\- \& tape name = monday.user.backup \& AFS tape name = user.monday1.1 \& flags = 0x20 \& written = Mon Mar 22 05:09:06 1999 \& expires = NEVER \& kBytes Tape Used = 121 \& nMBytes Data = 0 \& nBytes Data = 19092 \& nFiles = 0 \& nVolumes = 1 \& seq = 1 \& tapeid = 0 \& useCount = 1 \& dump = 922097346 \& Volume \& \-\-\-\-\-\- \& name = user.pat.backup \& flags = 0x18 \& id = 536871640 \& server = \& partition = 0 \& nFrags = 1 \& position = 2 \& clone = Mon Mar 22 04:43:06 1999 \& startByte = 0 \& nBytes = 19092 \& seq = 0 \& dump = 922097346 \& tape = user.monday1.1 .Ve .SH "PRIVILEGE REQUIRED" .IX Header "PRIVILEGE REQUIRED" The issuer must be listed in the \fI/etc/openafs/server/UserList\fR file on every machine where the Backup Server is running, or must be logged onto a server machine as the local superuser \f(CW\*(C`root\*(C'\fR if the \fB\-localauth\fR flag is included. .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBbutc\fR\|(5), \&\fBbackup\fR\|(8), \&\fBbackup_deletedump\fR\|(8) .SH "COPYRIGHT" .IX Header "COPYRIGHT" \&\s-1IBM\s0 Corporation 2000. All Rights Reserved. .PP This documentation is covered by the \s-1IBM\s0 Public License Version 1.0. It was converted from \s-1HTML\s0 to \s-1POD\s0 by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.