.\" 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_DELETEDUMP 8" .TH BACKUP_DELETEDUMP 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_deletedump \- Deletes one or more dump records from the Backup Database .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBbackup deletedump\fR [\fB\-dumpid\fR\ <\fIdump\ id\fR>+] [\fB\-from\fR\ <\fIdate\ time\fR>+] [\fB\-to\fR\ <\fIdate\ time\fR>+] [\fB\-portoffset\fR\ <\fI\s-1TC\s0\ port\ offset\fR>] [\fB\-groupid\fR\ <\fIgroup\ \s-1ID\s0\fR>] [\fB\-dbonly\fR] [\fB\-force\fR] [\fB\-dryrun\fR | \fB\-n\fR] [\fB\-localauth\fR] [\fB\-cell\fR\ <\fIcell\ name\fR>] [\fB\-help\fR] .PP \&\fBbackup dele\fR [\fB\-d\fR\ <\fIdump\ id\fR>+] [\fB\-fr\fR\ <\fIdate\ time\fR>+] [\-t <\fIdate time\fR>+] [\fB\-p\fR\ <\fI\s-1TC\s0\ port\ offset\fR>] [\fB\-g\fR\ <\fIgroup\ \s-1ID\s0\fR>] [\fB\-db\fR] [\fB\-fo\fR] [\fB\-l\fR] [\fB\-dryrun\fR | \fB\-n\fR] [\fB\-c\fR\ <\fIcell\ name\fR>] [\fB\-h\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" The \fBbackup deletedump\fR command deletes one or more dump records from the Backup Database. Either use the \fB\-dumpid\fR argument to specify the dump \s-1ID\s0 number of one or more dumps, or use the \fB\-from\fR and \fB\-to\fR arguments to delete the records for all regular dumps created during the time period bracketed by the specified values. .PP Use this command to remove dump records that are incorrect (possibly because a dump operation was interrupted or failed), or that correspond to dumps that are expired or otherwise no longer needed. .SH "CAUTIONS" .IX Header "CAUTIONS" The only way to remove the dump record for an appended dump is to remove the record for its initial dump, and doing so removes the records for all of the initial dump's associated appended dumps. .PP The only way to remove the record for a Backup Database dump (created with the \fBbackup savedb\fR command) is to specify its dump \s-1ID\s0 number with the \&\fB\-dumpid\fR argument. Using the \fB\-from\fR and \fB\-to\fR arguments never removes database dump records. .PP Removing records of a dump makes it impossible to restore data from the corresponding tapes or from any dump that refers to the deleted dump as its parent, directly or indirectly. That is, restore operations must begin with the full dump and continue with each incremental dump in order. If the records for a specific dump are removed, it is not possible to restore data from later incremental dumps unless the deleted records are restored by running the \fBbackup scantape\fR command with the \fB\-dbadd\fR flag. .PP If a dump set contains any dumps that were created outside the time range specified by the \fB\-from\fR and \fB\-to\fR arguments, the command does not delete any of the records associated with the dump set, even if some of them represent dumps created during the time range. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-dumpid\fR <\fIdump id\fR>+" 4 .IX Item "-dumpid +" Specifies the dump \s-1ID\s0 of each dump record to delete. The corresponding dumps must be initial dumps; it is not possible to delete appended dump records directly, but only by deleting the record of their associated initial dump. Using this argument is the only way to delete records of Backup Database dumps (created with the \fBbackup savedb\fR command). .Sp Provide either this argument or the \fB\-to\fR (and optionally \fB\-from\fR) argument. .IP "\fB\-from\fR <\fIdate time\fR>+" 4 .IX Item "-from +" Specifies the beginning of a range of dates; the record for any dump created during the indicated period of time is deleted. .Sp Omit this argument to indicate the default of midnight (00:00 hours) on 1 January 1970 (\s-1UNIX\s0 time zero), or provide a date value in the format \&\fImm/dd/yyyy\fR [\fIhh:MM\fR]. The month (\fImm\fR), day (\fIdd\fR), and year (\fIyyyy\fR) are required. The hour and minutes (\fIhh:MM\fR) are optional, but if provided must be in 24\-hour format (for example, the value \f(CW\*(C`14:36\*(C'\fR represents 2:36 p.m.). If omitted, the time defaults to midnight (00:00 hours). .Sp The \fB\-to\fR argument must be provided along with this one. .IP "\fB\-to\fR <\fIdate time\fR>+" 4 .IX Item "-to +" Specifies the end of a range of dates; the record of any dump created during the range is deleted from the Backup Database. .Sp Provide either the value \f(CW\*(C`NOW\*(C'\fR to indicate the current date and time, or a date value in the same format as for the \fB\-from\fR argument. Valid values for the year (\fIyyyy\fR) range from \f(CW1970\fR to \f(CW2037\fR; higher values are not valid because the latest possible date in the standard \s-1UNIX\s0 representation is in February 2038. The command interpreter automatically reduces any later date to the maximum value. .Sp If the time portion (\fIhh:MM\fR) is omitted, it defaults to 59 seconds after midnight (00:00:59 hours). Similarly, the \fBbackup\fR command interpreter automatically adds 59 seconds to any time value provided. In both cases, adding 59 seconds compensates for how the Backup Database and \fBbackup dumpinfo\fR command represent dump creation times in hours and minutes only. For example, the Database records a creation timestamp of \f(CW\*(C`20:55\*(C'\fR for any dump operation that begins between 20:55:00 and 20:55:59. Automatically adding 59 seconds to a time thus includes the records for all dumps created during that minute. .Sp Provide either this argument, or the \fB\-dumpid\fR argument. This argument is required if the \fB\-from\fR argument is provided. .Sp \&\fBCaution:\fR Specifying the value \f(CW\*(C`NOW\*(C'\fR for this argument when the \&\fB\-from\fR argument is omitted deletes all dump records from the Backup Database (except for Backup Database dump records created with the \&\fBbackup savedb\fR command). .IP "\fB\-groupid\fR <\fIgroup id\fR>" 4 .IX Item "-groupid " Delete all dumps associated with the given group \s-1ID.\s0 If \fB\-from\fR and \fB\-to\fR are also given, then we only delete dumps that are both a part of this group \s-1ID,\s0 and fall within the time range specified by \fB\-from\fR and \fB\-to\fR. .IP "\fB\-dbonly\fR" 4 .IX Item "-dbonly" If this option is specified, only delete the dump from the budb; do not contact the Tape Coordinator at all. .IP "\fB\-force\fR" 4 .IX Item "-force" By default, we attempt to delete the specified dumps from the Tape Coordinator before deleting the dumps from the budb. If the Tape Coordinator operation fails, then we do not delete the dumps from the budb. If the \fB\-force\fR option is given, we will delete the specified dumps from the budb, even if deleting the dumps on the Tape Coordinator fails. .IP "\fB\-portoffset\fR <\fI\s-1TC\s0 port offset\fR>" 4 .IX Item "-portoffset " Specifies the port offset number of the Tape Coordinator to contact for this operation. .IP "\fB\-dryrun\fR | \fB\-n\fR" 4 .IX Item "-dryrun | -n" Prints out information about what actions would be taken to run this command, but do not actually perform those actions. .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" At the conclusion of processing, the output lists the dump IDs of all dump records deleted in the following format: .PP .Vb 4 \& The following dumps were deleted: \& dump ID 1 \& dump ID 2 \& etc. .Ve .SH "EXAMPLES" .IX Header "EXAMPLES" The following command deletes the dump record with dump \s-1ID 653777462,\s0 and for any appended dumps associated with it: .PP .Vb 3 \& % backup deletedump \-dumpid 653777462 \& The following dumps were deleted: \& 653777462 .Ve .PP The following command deletes the Backup Database record of all dumps created between midnight on 1 January 1997 and 23:59:59 hours on 31 December 1997: .PP .Vb 8 \& % backup deletedump \-from 01/01/1997 \-to 12/31/1997 \& The following dumps were deleted: \& 598324045 \& 598346873 \& ... \& ... \& 653777523 \& 653779648 .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" \&\fBbackup\fR\|(8), \&\fBbackup_dumpinfo\fR\|(8), \&\fBbackup_scantape\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.