Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ bkoper(1a) — NEWS-os 5.0.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

bkreg(1M)

bkstatus(1M)

getvol(1M)

mailx(1)



bkoper(1M)       SYSTEM ADMINISTRATION COMMANDS        bkoper(1M)



NAME
     bkoper - interact with backup operations  to  service  media
     insertion prompts

SYNOPSIS
     bkoper [-u users]

DESCRIPTION
     Backup operations may require an operator  to  insert  media
     into  volumes  and  to  confirm  proper  volume labels.  The
     bkoper command provides a  mailx-like  interface  for  these
     operator  interactions.   It  begins  by  printing a list of
     headers.  Each header describes a backup operation requiring
     interaction,  the  device  requiring attention including the
     media type and label of the volume to be inserted (see EXAM-
     PLE).   The  system displays prompts and the operator issues
     commands to resolve the backup operation.  Typing a carriage
     return  invokes the current header.  If no headers have been
     serviced, the current header is  the  first  header  on  the
     list.   If  a  header  has  been  selected and serviced, the
     current header is the next one following.  bkoper  may  only
     be executed by a user with superuser privilege.  By default,
     the operator may interact only with backup  operations  that
     were started by the same user id.  If the -u users option is
     given, the operator interacts only  with  backup  operations
     started by the specified user(s).

  Commands
     !shell-command
               Escapes to the shell.  The remainder of  the  line
               after  the ! is sent to the UNIX system shell (sh)
               to be interpreted as a command.

     =         Prints the current backup operation number.

     ?         Prints this summary of commands.

     [p|t] [n] Both the p and t options operate in the same  way.
               Either option will interact with the backup opera-
               tion described by the n'th header.  n defaults  to
               the current header number.

     h         Prints the list of backup operations.

     q         Quits from bkoper.

DIAGNOSTICS
     The exit codes for bkoper are the following:

     0 = successful completion of the task
     1 = one or more parameters to bkoper are invalid.
     2 = an error has occurred which caused bkoper to fail to



                                                                1





bkoper(1M)       SYSTEM ADMINISTRATION COMMANDS        bkoper(1M)



           complete all portions of its task.

EXAMPLE
     A sample header is shown  below.   Items  appearing  in  the
     header  are  listed  in the following order:  header number,
     job-id, tag, originating device, destination group, destina-
     tion  device, destination volume labels.  [See bkreg(1M) for
     descriptions of items.]
            1. back-111 usrsun /dev/dsk/c1d0s1  disk /dev/dsk/c2d1s9 usrsave
            2. back-112 fs2daily /dev/dsk/c1d0s8 ctape /dev/ctape/c4d0s2 -
Backup headers are numbered on the basis of arrival;  the  oldest
header has the lowest number.  If the destination device does not
have a volume label, a dash is displayed in the header.

SEE ALSO
     bkreg(1M), bkstatus(1M), getvol(1M), mailx(1).







































                                                                2



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026