xio_waitfr(3)                       CLIX                       xio_waitfr(3)



  NAME

    xio_waitfr, xio_wfland, xio_wflor - Provides asynchronous event control

  LIBRARY

    Intergraph XIO Library (libix.a)

  SYNOPSIS

    unsigned long xio_waitfr(
      int efn );

    unsigned long xio_wfland(
      unsigned long mask );

    unsigned long xio_wflor(
      unsigned long mask; );

  PARAMETERS

    efn    Specifies an event flag.

    mask   Specifies an even flag mask.

  DESCRIPTION

    The xio_waitfr() function provides a mechanism for a process to wait for
    the bit in the event flag mask corresponding to efn to be set.  A bit set
    in the event flag mask usually corresponds to the completion of an
    asynchronous request.  If no error occurred, the event flag mask is
    returned.

    The xio_wfland() function will return control to the caller when all bits
    in the event flag mask that correspond to all set bits in mask are set.
    This provides a mechanism for a process to wait for the completion of many
    outstanding asynchronous requests.  The event flag mask is returned.

    The xio_wflor() function will return control to the caller when any of the
    bits in the event flag mask that correspond to set bits in mask are set.
    The call, in effect, waits for one of the outstanding asynchronous
    requests to complete.  The event flag mask is returned.

  RETURN VALUES

    Upon successful completion of xio_waitfr(), the event flag mask is
    returned.  Otherwise, a value of 0 is returned to indicate that efn is not
    valid.  No errors are possible for xio_wfland() and xio_wflor().

  RELATED INFORMATION




  2/94 - Intergraph Corporation                                              1

  xio_waitfr(3)                       CLIX                       xio_waitfr(3)



    Functions:  xio_allocef(3), xio_readef(3), xio_notify(3), intro(3)





















































  2                                              Intergraph Corporation - 2/94