Section: AFS Command Reference (8)
backup interactive - Enters interactive mode
] << [-cell
backup [i] [-l] << [-c <cell name] >>> [-h]
The backup interactive
initiates an interactive session for issuingbackup
commands. As indicated in the syntax statement, the operationcode (interactive
) is optional.
Several features of interactive mode distinguish it from regular mode:
- In interactive mode, the backup> prompt replaces the system (shell)prompt. The operator enters only a command's operation code (omitting thecommand suite name, backup).
- If the -localauth flag or the -cell argument is included on thebackup interactive command, the settings apply to all commands issuedduring that interactive session. The issuer does not need to type them onevery command. Another consequence is that the flag and argument do notappear in the syntax statement generated by the help subcommand or-help flag on an individual command issued at the backup> prompt.
- The backup jobs and backup kill commands are available only ininteractive mode. It is not possible to track and terminate backupoperations as cleanly in non-interactive mode.
- It is not necessary to enclose strings that include metacharacters indouble quotes or other delimiters.
- The backup command interpreter establishes a connection to the BackupServer, Volume Server and Volume Location (VL) Server processes as itenters interactive mode, and uses the same connection for all commandsduring the session. Execution time can therefore be faster than innon-interactive mode, in which the command interpreter must establish anew connection for each command.
To exit an interactive session, issue the backup quit 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.
The following example shows how the -localauth
flag and -cell
argument do not appear when the help dump
subcommand is issued ininteractive mode.
% backup backup> help dump dump: start dump Usage: dump [-volumeset <volume set name>] [-dump <dump level name>] [-portoffset <TC port offset>] [-at <Date/time to start dump>+] [-append ] [-n ] [-file <load file>] [-help ]
None. However, backup
commands that require privilege in regular modestill require it in interactive mode.
IBM Corporation 2000. <http://www.ibm.com/
> 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.
- PRIVILEGE REQUIRED
- SEE ALSO
This document was created byman2html,using the manual pages.