aux_open(3)                         CLIX                         aux_open(3)



  NAME

    aux_open - Opens a serial port

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int aux_open(
      int port );

  PARAMETERS

    port   An integer representing a serial port

  DESCRIPTION

    The aux_open() function opens the specified serial port if it is not
    currently opened by either this call or by the standard open() call.

    The aux_open() function will default the modem characteristics of the port
    to the standard open() state.  The modem characteristics may be changed
    after a successful aux_open() by opening the corresponding /dev/tty??
    device, and issuing the appropriate ioctl().

  RETURN VALUES

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

  ERRORS

    The aux_open() function will fail if one of the following is true:

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

    [AUX_PORT_IN_USE]
           The specified port is already in use.

  RELATED INFORMATION

    Functions:  aux_close(3), open(2), ioctl(2)

    Files:  xaux(7), aux(7)




  2/94 - Intergraph Corporation                                              1