gpib_remote(3)                      CLIX                      gpib_remote(3)



  NAME

    gpib_remote - Puts a General Purpose Interface Bus (GPIB) channel in a
    remote state

  LIBRARY

    Intergraph XIO Library (libix.a

  SYNOPSIS

    #include <sys/xio/xerr.h>

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

  PARAMETERS

    channel   Represents a channel.

    ldev      Points to an array of device addresses.

    lcnt      Specifies the number of devices.

  DESCRIPTION

    The gpib_remote() function activates the General Purpose Interface Bus
    (GPIB) Remote Enable (REN) signal on GPIB channel.  This forces any GPIB
    device addressed to a remote state.

    The system controller asserts the GPIB REN line to initiate the
    gpib_remote() function.  The system controller's state is not changed.

  EXAMPLES

    To put GPIB devices 6, 7, and 9 in remote mode:

    lcnt = 3;
    ldev[0] = 6;
    ldev[1] = 7;
    ldev[2] = 9;
    if (status = gpib_remote(channel, ldev, lcnt)) {
         fprintf(sterr, "gpib_remote: failed, %d\n", status);
         return(-1);
    }
    fprintf(stdout, "gpib_remote: succeeded\n");


  RETURN VALUES



  2/94 - Intergraph Corporation                                              1

  gpib_remote(3)                      CLIX                      gpib_remote(3)



    Upon successful completion, a value of 0 is returned.  Otherwise, one of
    the failure codes listed in the ERRORS section is returned.

  ERRORS

    The gpib_remote() function fails 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 channel is currently open by another process.

  RELATED INFORMATION

    Functions:  gpib_open(3), gpib_lockout(3), gpib_local(3)

    Files:  gpib(7)





























  2                                              Intergraph Corporation - 2/94