|-name <AFS tape name>||
Specifies the AFS tape name to record on the label. Include this argument
or the -pname argument, but not both. If this argument is omitted, the
AFS tape name is set to <NULL>. If this argument is provided, it
must have the following format:
for the tape to be acceptable for use in a future backup dump operation. The <volume_set_name> must match the volume set name of the initial dump to be written to the tape, <dump_level_name> must match the last element of the dump level pathname at which the volume set will be dumped, and <tape_index> indicates the order of the tape in the dump set (indexing begins with 1). To disable this type of name checking, include the NAME_CHECK NO instruction in the CFG_device_name file.
For the tape to be acceptable for use in a future backup savedb operation, the value specified for the -name argument must have the following format:
where <tape_index> indicates the order of the tape in the set of tapes that house the Backup Database dump; indexing begins with 1 (one).
|-size <tape size>||
Specifies the tape capacity to record on the label. Provide an integer
value followed by a letter that indicates units, with no intervening
space. A unit value of k or K indicates kilobytes, m or M
indicates megabytes, and g or G indicates gigabytes. If the units
letter is omitted, the default is kilobytes.
If this argument is omitted the first time a tape is labeled, the Backup System records the capacity that is associated with the specified port offset in the /var/openafs/backup/tapeconfig file on the Tape Coordinator machine. The value recorded the first time then persists until the -size argument is provided on a future issuance of the command.
|-portoffset <TC port offset>||Specifies the port offset number of the Tape Coordinator handling the tape for this operation.|
|-pname <permanent tape name>||
Specifies the permanent name to record on the label. It can be up to 32
characters in length, and include any alphanumeric characters. Avoid
metacharacters that have a special meaning to the shell, to avoid having
to mark them as literal in commands issued at the shell prompt.
Include this argument or the -name argument, but not both. If this argument is provided, the AFS tape name is set to <NULL>. If this argument is omitted, any existing permanent name is retained.
|-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.|
The following command records the AFS tape name user.monthly.1 on the label of the tape in the device with port offset 3:
% backup labeltape -name user.monthly.1 -portoffset 3
The following three commands are equivalent in effect: they all record a capacity of 2 GB on the label of the tape in the device with port offset 4. They set the AFS tape name to <NULL> and leave the permanent name unchanged.
% backup labeltape -size 2g -portoffset 4 % backup labeltape -size 2048M -portoffset 4 % backup labeltape -size 2097152 -portoffset 4
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.
butc(5), backup(8), backup_readlabel(8), butc(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.