Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
BACKUP_JOBS(8)		     AFS Command Reference		BACKUP_JOBS(8)

NAME
       backup_jobs - Lists pending and running operations in interactive mode

SYNOPSIS
       jobs [-help]

       j [-h]

DESCRIPTION
       The backup jobs command lists the job ID	number and status of each
       backup operation	running	or pending in the current interactive session.

       This command can	be issued in interactive mode only. If the issuer of
       the backup interactive command included the -localauth flag, the	-cell
       argument, or both, those	settings apply to this command also.

       To terminate operations that appear in the output, issue	the backup
       kill command and	identify the operation to cancel with the job ID
       number from this	command's output.

       To check	the status of a	Tape Coordinator, rather than of a certain
       operation, use the backup status	command.

OPTIONS
       -help
	   Prints the online help for this command. All	other valid options
	   are ignored.

OUTPUT
       The output always includes the expiration date and time of the tokens
       that the	backup command interpreter is using during the current
       interactive session, in the following format:

	  <date>   <time>: TOKEN EXPIRATION

       If the execution	date and time specified	for a scheduled	dump operation
       is later	than <date time>, then its individual line (as described in
       the following paragraphs) appears below this line to indicate that the
       current tokens will not be available to it.

       If the issuer of	the backup command included the	-localauth flag	when
       entering	interactive mode, the line instead reads as follows:

	  :  TOKEN NEVER EXPIRES

       The entry for a scheduled dump operation	has the	following format:

	  Job <job_ID>:	 <timestamp>:  dump  <volume_set>  <dump_level>

       where

       <job_ID>
	   Is a	job identification number assigned by the Backup System.

       <timestamp>
	   Indicates the date and time the dump	operation is to	begin, in the
	   format month/date/year hours:minutes	(in 24-hour format)

       <volume_set>
	   Indicates the volume	set to dump.

       <dump_level>
	   Indicates the dump level at which to	perform	the dump operation.

       The line	for a pending or running operation of any other	type has the
       following format:

	  Job <job_ID>:	 <operation>  <status>

       where

       <job_ID>
	   Is a	job identification number assigned by the Backup System.

       <operation>
	   Identifies the operation the	Tape Coordinator is performing,	which
	   is initiated	by the indicated command:

	   Dump	(dump name)
	       Initiated by the	backup dump command. The dump name has the
	       following format:

		   <volume_set_name>.<dump_level_name>

	   Restore
	       Initiated by the	backup diskrestore, backup volrestore, or
	       backup volsetrestore command.

	   Labeltape (tape_label)
	       Initiated by the	backup labeltapen command. The tape_label is
	       the name	specified by the backup	labeltape command's -name or
	       -pname argument.

	   Scantape
	       Initiated by the	backup scantape	command.

	   SaveDb
	       Initiated by the	backup savedb command.

	   RestoreDb
	       Initiated by the	backup restoredb command.

       <status>
	   Indicates the job's current status in one of	the following
	   messages. If	no message appears, the	job is either still pending or
	   has finished.

	   number Kbytes, volume volume_name
	       For a running dump operation, indicates the number of kilobytes
	       copied to tape or a backup data file so far, and	the volume
	       currently being dumped.

	   number Kbytes, restore.volume
	       For a running restore operation,	indicates the number of
	       kilobytes copied	into AFS from a	tape or	a backup data file so
	       far.

	   [abort requested]
	       The backup kill command was issued, but the termination signal
	       has yet to reach	the Tape Coordinator.

	   [abort sent]
	       The operation is	canceled by the	backup kill command.  Once the
	       Backup System removes an	operation from the queue or stops it
	       from running, it	no longer appears at all in the	output from
	       the command.

	   [butc contact lost]
	       The backup command interpreter cannot reach the Tape
	       Coordinator. The	message	can mean either	that the Tape
	       Coordinator handling the	operation was terminated or failed
	       while the operation was running,	or that	the connection to the
	       Tape Coordinator	timed out.

	   [done]
	       The Tape	Coordinator has	finished the operation.

	   [drive wait]
	       The operation is	waiting	for the	specified tape drive to	become
	       free.

	   [operator wait]
	       The Tape	Coordinator is waiting for the backup operator to
	       insert a	tape in	the drive.

EXAMPLES
       The following example shows that	two restore operations and one dump
       operation are running (presumably on different Tape Coordinators) and
       that the	backup command interpreter's tokens expire on 22 April 1999 at
       10:45 am:

	  backup> jobs
	  Job 1: Restore, 1306 Kbytes, restore.volume
	  Job 2: Dump (user.sunday1), 34 Kbytes, volume	user.pat.backup
	  Job 3: Restore, 2498 Kbytes, restore.volume
		 04/22/1999 10:45: TOKEN EXPIRATION

PRIVILEGE REQUIRED
       None. However, queuing any operation requires privilege,	and it is
       possible	to issue this command only within the interactive session in
       which the jobs are queued.

SEE ALSO
       backup(8), backup_interactive(8), backup_kill(8), backup_quit(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.

OpenAFS				  2016-12-14			BACKUP_JOBS(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OUTPUT | EXAMPLES | PRIVILEGE REQUIRED | SEE ALSO | COPYRIGHT

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=backup_jobs&sektion=8&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help