aux_modem(3)                        CLIX                        aux_modem(3)



  NAME

    aux_modem, aux_modem_nw - Gets a modem change from a serial port

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xio.h>

    #include <sys/xio/xerr.h>

    int aux_modem(
      int );

    int aux_modem_nw(
      int port ,
      struct xiosb *xiosb ,
      int efn );

  PARAMETERS

    port    An integer representing a port

    efn     The event number associated with the request

    xiosb   A pointer to an xiosb structure

  DESCRIPTION

    The aux_modem() function waits for a change of modem state on the
    specified port.  The port must have been opened by aux_open().

    To get and set modem characteristics, refer to aux().

    The aux_modem_nw function is the asynchronous version of aux_modem(),
    providing the same capability without waiting for completion of the
    request.  The efn parameter is the event flag number associated with the
    request.  The xiosb parameter is a pointer to the xiosb structure updated
    on completion of the request (see intro(3)).

  RETURN VALUES

    Upon successful completion of the synchronous request, a value of 0 is
    returned.  Otherwise, one of the following failure codes is returned.

    If the asynchronous request is accepted by the XIO system, a value of 0
    will be returned by the request.  Otherwise, XIO_FAILURE will be returned.
    Upon completion of an accepted request, the status member of the xiosb



  2/94 - Intergraph Corporation                                              1

  aux_modem(3)                        CLIX                        aux_modem(3)



    structure will be set to either 0 if successful, or to one of the above
    failure codes if unsuccessful.

  ERRORS

    The aux_modem() and aux_modem_nw() functions will fail if one of the
    following is true:

    [XIO_FAILURE]
           The system does not contain the driver needed to support this
           request or efn is invalid.

    [AUX_PORT_NOT_OPEN]
           The specified port is not open by the calling process.

  RELATED INFORMATION

    Functions:  aux_open(3), intro(3)

    Files:  xaux(7), aux(7)


































  2                                              Intergraph Corporation - 2/94