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



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


NAME
       dgrequestnotification - request notification of a process state
       change

SYNOPSIS
       #include <sys/dgnotification.h>

       int  dgrequestnotification (processid, statechange)
       int                    processid;
       dgnotificationenumt statechange;

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

       statechange   The state to be notified of.

DESCRIPTION
       The dgrequestnotification system call is used to request a process
       state notification message.  The notification is asynchronous.  When
       processid experiences the specified statechange a SIGDGNOTIFY
       signal is sent to the calling process.  The calling process can use
       dgreceivenotification() 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 processid or statechange is not valid.

       ENOMEM  Insufficient system resources to register the notification
               request.

       ESRCH   The process processid does not exist.

SEE ALSO
       dgreceivenotification(2).


Licensed material--property of copyright holder(s)
Museum
