csi_death(3)                        CLIX                        csi_death(3)



  NAME

    csi_death, csi_death_nw - Waits for a Command Status Interface (CSI)
    communication to fail

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    #include <sys/xio/xio.h>

    int csi_death(
      int channel ,
      int timeout ,
      int *reason );

    int csi_death_nw(
      int channel ,
      int timeout ,
      struct xiosb *xiosb ,
      int efn );

  PARAMETERS

    channel   An integer representing a command system interface channel

    timeout   The number of 1/60 second intervals to wait before aborting the
              request

    reason    An integer representing the reason a request failed

    xiosb     A pointer to the xiosb structure

    efn       The event number associated with the request

  DESCRIPTION

    The csi_death() function provides a mechanism to sense that communication
    through the Command Status Interface (CSI) port on the Image System
    Interface (ISI) board referenced by channel has failed.  The channel must
    have been opened with csi_open().

    The timeout parameter is the time limit in 1/60 second intervals to sense
    a failure.  Upon expiration, the request is aborted and an appropriate
    status is returned.  A value of 0 disables the timeout function.

    Upon completion of the synchronous request, the integer pointed to by



  2/94 - Intergraph Corporation                                              1

  csi_death(3)                        CLIX                        csi_death(3)



    reason will indicate why the failure occurred.  Possible reasons for
    failure are application specific and are copied from the DR11 status lines
    which connect directly to external hardware.  DR11 status codes 4 through
    6 are reserved as fatal status codes.  A status code of 7 indicates a
    cable problem.

    The csi_death_nw() function is the asynchronous version of csi_death,
    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
    upon completion of the request (see intro(3)).  The xfcnt member of the
    xiosb structure indicates the reason why the failure occurred.

  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
    structure will be set to either 0 if successful, or to one of the
    following failure codes if unsuccessful.

  ERRORS

    The csi_death() and csi_death_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.

    [ISI_CHANNEL_NOT_OPEN]
           The specified channel is not open for this process.

    [ISI_CANCELED]
           The request was canceled by either csi_cancel() or csi_close().

    [ISI_TIMEOUT]
           The timeout expired before a failure occurred.

  RELATED INFORMATION

    Functions:  csi_open(3), csi_close(3), csi_cancel(3), intro(3).

    Files:  xcsi(7)







  2                                              Intergraph Corporation - 2/94