xio_notify(3)                       CLIX                       xio_notify(3)



  NAME

    xio_notify - Notifies a process of an asynchronous request completion

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int xio_notify(
      unsigned long mask ,
      int signal, ,
      int var[2] ,
      int val0 ,
      int val1 );

  PARAMETERS

    mask     Specifies the event flag numbers of the requests for which the
             process requires notification.

    signal   Represents a signal.

    var      Specifies an array of two integers.

    val0     Specifies an integer stored in the first var array member.

    val1     Specifies an integer stored in the second var array member.

  DESCRIPTION

    The xio_notify() function provides a mechanism to detect completion of an
    asynchronous request with signal or memory location update.  Either or
    both of these methods of notification is available.

    The mask parameter corresponds to the event flag numbers of the
    asynchronous requests for which the process requires notification.

    The appropriate signal is sent to the process upon completion of any of
    the specified asynchronous requests.  The signal must be chosen in
    accordance with defined system signals, and the signal-catching handler
    must be established with standard signal management functions (see
    sigset() or signal()).

    The var parameter is an array of two integers; xio_notify() updates these
    locations with the values contained in val0 and val1.  The var must be
    aligned on a longword boundary.  If var is 0, this feature is disabled.




  2/94 - Intergraph Corporation                                              1

  xio_notify(3)                       CLIX                       xio_notify(3)



  NOTES

    Only one xio_notify() request (specifying either a signal notification, a
    memory location update, or both) may be active.  If a subsequent
    xio_notify() call is made, the previous call is no longer in effect.

  CAUTIONS

    After notification, the process must call either xio_readef(),
    xio_waitfr(), xio_wflor(), or xio_wfland before the xiosb structures for
    the completed asynchronous requests are valid.

  RETURN VALUES

    Upon successful completion, a value of 0 is returned.  Otherwise,
    XIO_FAILURE is returned.

  ERRORS

    The xio_notify() function fails if the following is true:

    XIO_FAILURE   Either mask is 0, signal is not a valid signal number, or
                  var is invalid.

  RELATED INFORMATION

    Functions:  xio_readef(3), xio_waitfr(3), xio_allocef(3), signal(2),
    sigset(2), intro(3)


























  2                                              Intergraph Corporation - 2/94