Section: AFS Command Reference (8)
Updated: OpenAFS


backup deletedump - Deletes one or more dump records from the Backup Database 


backup deletedump << [-dumpid <dump id+] >>> << [-from <date time+] >>>
    << [-to <date time+] >>> [-localauth] << [-cell <cell name] >>>

backup dele << [-d <dump id+] >>> << [-f <date time+] >>>
    [-t <date time>+] [-l] << [-c <cell name] >>> [-h] 


The backup deletedump command deletes one or more dump records from theBackup Database. Either use the -dumpid argument to specify the dump IDnumber of one or more dumps, or use the -from and -to arguments todelete the records for all regular dumps created during the time periodbracketed by the specified values.

Use this command to remove dump records that are incorrect (possiblybecause a dump operation was interrupted or failed), or that correspond todumps that are expired or otherwise no longer needed. 


The only way to remove the dump record for an appended dump is to removethe record for its initial dump, and doing so removes the records for allof the initial dump's associated appended dumps.

The only way to remove the record for a Backup Database dump (created withthe backup savedb command) is to specify its dump ID number with the-dumpid argument. Using the -from and -to arguments never removesdatabase dump records.

Removing records of a dump makes it impossible to restore data from thecorresponding tapes or from any dump that refers to the deleted dump asits parent, directly or indirectly. That is, restore operations must beginwith the full dump and continue with each incremental dump in order. Ifthe records for a specific dump are removed, it is not possible to restoredata from later incremental dumps unless the deleted records are restoredby running the backup scantape command with the -dbadd flag.

If a dump set contains any dumps that were created outside the time rangespecified by the -from and -to arguments, the command does notdelete any of the records associated with the dump set, even if some ofthem represent dumps created during the time range. 


-dumpid <dump id>+
Specifies the dump ID of each dump record to delete. The correspondingdumps must be initial dumps; it is not possible to delete appended dumprecords directly, but only by deleting the record of their associatedinitial dump. Using this argument is the only way to delete records ofBackup Database dumps (created with the backup savedb command).

Provide either this argument or the -to (and optionally -from)argument.

-from <date time>+
Specifies the beginning of a range of dates; the record for any dumpcreated during the indicated period of time is deleted.

Omit this argument to indicate the default of midnight (00:00 hours) on 1January 1970 (UNIX time zero), or provide a date value in the formatmm/dd/yyyy [hh:MM]. The month (mm), day (dd), and year(yyyy) are required. The hour and minutes (hh:MM) are optional, butif provided must be in 24-hour format (for example, the value 14:36represents 2:36 p.m.). If omitted, the time defaults to midnight (00:00hours).

The -to argument must be provided along with this one.

-to <date time>+
Specifies the end of a range of dates; the record of any dump createdduring the range is deleted from the Backup Database.

Provide either the value NOW to indicate the current date and time, ora date value in the same format as for the -from argument. Valid valuesfor the year (yyyy) range from 1970 to 2037; higher values arenot valid because the latest possible date in the standard UNIXrepresentation is in February 2038. The command interpreter automaticallyreduces any later date to the maximum value.

If the time portion (hh:MM) is omitted, it defaults to 59 seconds aftermidnight (00:00:59 hours). Similarly, the backup command interpreterautomatically adds 59 seconds to any time value provided. In both cases,adding 59 seconds compensates for how the Backup Database and backupdumpinfo command represent dump creation times in hours and minutesonly. For example, the Database records a creation timestamp of 20:55for any dump operation that begins between 20:55:00 and 20:55:59.Automatically adding 59 seconds to a time thus includes the records forall dumps created during that minute.

Provide either this argument, or the -dumpid argument. This argumentis required if the -from argument is provided.

Caution: Specifying the value NOW for this argument when the-from argument is omitted deletes all dump records from the BackupDatabase (except for Backup Database dump records created with thebackup savedb command).

Constructs a server ticket using a key from the local/usr/afs/etc/KeyFile file. The backup command interpreter presentsit to the Backup Server, Volume Server and VL Server during mutualauthentication. Do not combine this flag with the -cell argument. Formore details, see the backup(8) manpage.
-cell <cell name>
Names the cell in which to run the command. Do not combine this argumentwith the -localauth flag. For more details, see the backup(8) manpage.
Prints the online help for this command. All other valid options areignored.


At the conclusion of processing, the output lists the dump IDs of all dumprecords deleted in the following format:

   The following dumps were deleted:        dump ID 1        dump ID 2        etc.


The following command deletes the dump record with dump ID 653777462, andfor any appended dumps associated with it:

   % backup deletedump -dumpid 653777462   The following dumps were deleted:        653777462
The following command deletes the Backup Database record of all dumpscreated between midnight on 1 January 1997 and 23:59:59 hours on 31December 1997:

   % backup deletedump -from 01/01/1997 -to 12/31/1997   The following dumps were deleted:        598324045        598346873           ...           ...        653777523        653779648


The issuer must be listed in the /usr/afs/etc/UserList file on everymachine where the Backup Server is running, or must be logged onto aserver machine as the local superuser root if the -localauth flag isincluded. 


the backup(8) manpage,the backup_dumpinfo(8) manpage,the backup_scantape(8) manpage 


IBM Corporation 2000. <> All Rights Reserved.

This documentation is covered by the IBM Public License Version 1.0. It wasconverted from HTML to POD by software written by Chas Williams and RussAllbery, based on work by Alf Wachsmann and Elizabeth Cassell.




This document was created byman2html,using the manual pages.