gpib_trigger(3)                     CLIX                     gpib_trigger(3)



  NAME

    gpib_trigger - Triggers a General Purpose Interface Bus (GPIB) device

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

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

  PARAMETERS

    channel   An integer representing a GPIB channel

    ldev      A pointer to an array of GPIB primary addresses

    lcnt      An integer representing the number of devices to be triggered

  DESCRIPTION

    The gpib_trigger() function performs a trigger operation on a General
    Purpose Interface Bus (GPIB) device.  The ldev parameter points to an
    array of GPIB primary addresses and lcnt specifies the number of devices
    to be triggered on the GPIB channel.

    The system controller transmits the following messages to conduct a GPIB
    trigger:

    UNL   Unlisten

    LAG   Listen Address Group

    GET   Group Execute Trigger

  RETURN VALUES

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

  ERRORS

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

    [XIO_FAILURE]



  2/94 - Intergraph Corporation                                              1

  gpib_trigger(3)                     CLIX                     gpib_trigger(3)



           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]
           The specified primary address is incorrect.

    [BAD_DATA_BUFFER_ADDRESS]
           The ldev parameter points to an invalid memory address.

    [BAD_DATA_BUFFER_SIZE]
           The size of the primary address array specified by lcnt is too big.

  RELATED INFORMATION

    Functions:  gpib_open(3), gpib_cmd(3)

    Files:  xgpib(7)




























  2                                              Intergraph Corporation - 2/94