gpib_clear(3)                       CLIX                       gpib_clear(3)



  NAME

    gpib_clear - Clears a General Purpose Interface Bus (GPIB) channel or
    device

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int gpib_clear(
      int channel ,
      char *ldev ,
      int lcnt );

  PARAMETERS

    channel   An integer representing a GPIB channel

    ldev      A pointer to an array of primary addresses for the device

    lcnt      The number of addresses in the array ldev

  DESCRIPTION

    The gpib_clear() function allows a user to clear the entire General
    Purpose Interface Bus (GPIB) channel or selected devices on channel.  An
    entire channel is cleared by setting lcnt to 0.  If specific devices are
    to be cleared, ldev points to an array GPIB primary addresses for the
    device and lcnt equals the number of addresses in the array.

    To clear channel, the driver puts the system controller in an active state
    and issues the GPIB message Device Clear (DCL).

    To clear specific devices, the driver puts the system controller in an
    active state and sends the following GPIB messages:

    UNL   Unlisten

    LAG   Listen Address Group

    SDC   Selected Device Clear

  RETURN VALUES

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




  2/94 - Intergraph Corporation                                              1

  gpib_clear(3)                       CLIX                       gpib_clear(3)



  ERRORS

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

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

    [GPIB_OUT_OF_RANGE]
           The specified channel is beyond the maximum allowed.

    [GPIB_NOT_OPEN]
           The specified channel is not open.

    [GPIB_NOT_OWNER]
           The specified channel is currently open by another process.

    [GPIB_DEVICE_INVALID]
           One or more of the specified primary addresses are incorrect.

    [BAD_DATA_BUFFER_ADDRESS]
           The primary address pointer ldev is invalid.

    [BAD_DATA_BUFFER_SIZE]
           The device count lcnt is incorrect.

  RELATED INFORMATION

    Functions:  gpib_open(3), gpib_reset(3), gpib_cmd(3), gpib_cancel(3)

    Files:  xgpib(7)























  2                                              Intergraph Corporation - 2/94