NAME

       backup_deletedump - Deletes one or more dump records from the Backup Database

SYNOPSIS

       backup deletedump [-dumpid <dump id>+]
           [-from <date time>+]
           [-to <date time>+]
           [-port <TC port offset>]
           [-groupid <group ID>]
           [-dbonly] [-force] [-noexecute] [-localauth]
           [-cell <cell name>]
           [-help]

       backup dele [-d <dump id>+]
           [-fr <date time>+]
           [-t <date time>+]
           [-p <TC port offset>]
           [-g <group ID>]
           [-db] [-fo] [-n] [-l]
           [-c <cell name>]
           [-h]

DESCRIPTION

       The backup deletedump command deletes one or more dump records from the Backup Database.
       Either use the -dumpid argument to specify the dump ID number of one or more dumps, or use
       the -from and -to arguments to delete the records for all regular dumps created during the
       time period bracketed by the specified values.

       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.

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.

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

       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 backup scantape command with the -dbadd flag.

       If a dump set contains any dumps that were created outside the time range specified by the
       -from and -to 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.

OPTIONS

       -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 /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.

OUTPUT

       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.

EXAMPLES

       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

PRIVILEGE REQUIRED

       The issuer must be listed in the /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.

SEE ALSO

       backup(8), backup_dumpinfo(8), backup_scantape(8)

COPYRIGHT

       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.