admcallback(1M)                  DG/UX R4.11                 admcallback(1M)


NAME
       admcallback - manage administrative callbacks

SYNOPSIS
       admcallback -o add -a action [ -t type ] [ -r reason ] id

       admcallback -o delete [ -t type ] [ -r reason ] [ id ...  ]

       admcallback -o modify -a action [ -t type ] [ -r reason ] [ id ]

       admcallback -o call [ -t type ] -r reason [ -O options ] [ id ...  ]

       admcallback -o list [
                  -qv ] [ -t type ] [ -r reason ] [ id ...  ]

DESCRIPTION
       The admcallback command manages a table of callbacks.  Callbacks are
       commands that are performed when certain events occur in the system.

       Each callback has a id (such as dgux), type (such as printer), a
       reason (such as add), and an action (such as admlp -o add $name).

       The (id, type, reason) triple uniquely identifies callbacks.  When
       invoking callbacks, admcallback selects the callbacks with the
       indicated reason, sorts them lexicographically by type and by id
       within each type to determine the order in which the callbacks are
       performed.

   Operations
       add       Register a callback with the system.

       delete    Remove a registered callback from the system.

       modify    Change the action associated with a registered callback.

       call      Invoke the callbacks associated with a particular resource
                 type and for a particular reason.  If the type is all, then
                 all callbacks associated with the reason are called.  If
                 any callback exits with status 255, no other callbacks are
                 invoked.

       list      Display the registered callbacks.

   Options
       -a action Perform the action whenever the callbacks associated with
                 this callback's type and reason are invoked.  The action
                 must be a valid sh(1) command line, though admcallback does
                 not validate the command line.

       -t type   Deal only with callbacks of the indicated type.  The
                 default is all.

       -r reason Deal only with callbacks with the indicated reason.  The
                 default is all.

       -O options
                 Invoke the callbacks with options in the environment.  The
                 options must be valid sh(1) variable assignments of the
                 form

                     name=value


       -q        Quiet output.  No headers are displayed.

       -v        Verbose output.  Headers are displayed.  This option is
                 enabled by default.

       Each value supplied for type, reason, and id must be a sequence of
       characters from the set

           a-z A-Z 0-9 . - _ /


FILES
       Admcallback references databases and lock files stored in the
       directory /etc/sysadm/callbacks.

       Commands invoked via admcallback are logged to the file
       /var/adm/log/callback.log.

DIAGNOSTICS
   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

SEE ALSO
       sysadm(1), idl(4).

NOTES
       All callbacks delivered with DG/UX shall have an id that begins with
       "dgux".  Callbacks delivered with layered packages must not use an id
       that begins with "dgux".


Licensed material--property of copyright holder(s)