dg_request_notification(2)     DG/UX R4.11MU05    dg_request_notification(2)


NAME
       dg_request_notification - request notification of a process state
       change

SYNOPSIS
       #include <sys/dg_notification.h>

       int  dg_request_notification (process_id, state_change)
       int                    process_id;
       dg_notification_enum_t state_change;

   where:
       process_id     The identifier of the process whose state change the
                      caller wishes to be notified of.

       state_change   The state to be notified of.

DESCRIPTION
       The dg_request_notification system call is used to request a process
       state notification message.  The notification is asynchronous.  When
       process_id experiences the specified state_change a SIGDGNOTIFY
       signal is sent to the calling process.  The calling process can use
       dg_receive_notification() to receive the notification message.

       Currently, the only state the calling process can request
       notification for is process termination.

ACCESS CONTROL
       There are no checks for access control.

RETURN VALUE
       0         Completed successfully.

       -1        An error occurred.  errno is set to indicate the error.

DIAGNOSTICS
       Errno may be set to one of the following error codes:

       EINVAL  The process_id or state_change is not valid.

       ENOMEM  Insufficient system resources to register the notification
               request.

       ESRCH   The process process_id does not exist.

SEE ALSO
       dg_receive_notification(2).


Licensed material--property of copyright holder(s)