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



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


NAME
       dgreceivenotification - receive a notification message

SYNOPSIS
       #include <sys/dgnotification.h>

       int  dgreceivenotification (messageptr,
            flags,
            size,
            version)
       dgnotificationt * messageptr;
       unsigned int       flags;
       unsigned int       size;
       long                version;

   where:
       messageptr    A pointer to a dgnotificationt.  This is a union of
                      all the possible notification messages.  An
                      enumeration field in the message discriminates the
                      type of message.

       flags          The notification message flags.

       size           The maximum size in bytes of the notification message
                      to receive.

       version        The version of the notification message.  This should
                      be DG_NOTIFICATION_VERSION.

DESCRIPTION
       The dgreceivenotification system call is used to receive a process
       state notification message.  The message will be for any process and
       event the calling process previously requested using
       dgrequestnotification().

       If there is a pending notification message, that message is copied to
       the buffer specified in messageptr.  Only up to size bytes of the
       message will be copied.  If there are no messages and flags and
       DG_NOTIFICATION_NOWAIT is false, the caller will wait for a message.

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 version is not valid.

       EFAULT  The messageptr specifies a bad address.

       ENOMSG  No notification message is available and flags and
               DG_NOTIFICATION_NOWAIT is true.

       ESRCH   The calling process has not requested any notification
               messages.

SEE ALSO
       dgrequestnotification(2).


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