|-dumpid <dump id>+||
Specifies the dump ID 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 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 dump
created during the indicated period of time is deleted.
Omit this argument to indicate the default of midnight (00:00 hours) on 1 January 1970 (UNIX time zero), or provide a date value in the format mm/dd/yyyy [hh:MM]. The month (mm), day (dd), and year (yyyy) are required. The hour and minutes (hh:MM) are optional, but if provided must be in 24-hour format (for example, the value 14:36 represents 2:36 p.m.). If omitted, the time defaults to midnight (00:00 hours).
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 created
during the range is deleted from the Backup Database.
Provide either the value NOW to indicate the current date and time, or a date value in the same format as for the -from argument. Valid values for the year (yyyy) range from 1970 to 2037; higher values are not valid because the latest possible date in the standard UNIX representation is in February 2038. The command interpreter automatically reduces any later date to the maximum value.
If the time portion (hh:MM) is omitted, it defaults to 59 seconds after midnight (00:00:59 hours). Similarly, the backup command interpreter automatically adds 59 seconds to any time value provided. In both cases, adding 59 seconds compensates for how the Backup Database and backup dumpinfo command represent dump creation times in hours and minutes only. For example, the Database records a creation timestamp of 20:55 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.
Provide either this argument, or the -dumpid argument. This argument is 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 Backup Database (except for Backup Database dump records created with the backup savedb command).
|-localauth||Constructs a server ticket using a key from the local /usr/local/etc/openafs/server/KeyFile file. The backup command interpreter presents it to the Backup Server, Volume Server and VL Server during mutual authentication. Do not combine this flag with the -cell argument. For more details, see backup(8).|
|-cell <cell name>||Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see backup(8).|
|-help||Prints the online help for this command. All other valid options are ignored.|
At the conclusion of processing, the output lists the dump IDs of all dump records 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, and for 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 dumps created between midnight on 1 January 1997 and 23:59:59 hours on 31 December 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/local/etc/openafs/server/UserList file on every machine where the Backup Server is running, or must be logged onto a server machine as the local superuser root if the -localauth flag is included.
backup(8), backup_dumpinfo(8), backup_scantape(8)
IBM Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
This documentation is covered by the IBM Public License Version 1.0. It was converted from HTML to POD by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.