gpib_lockout(3)                     CLIX                     gpib_lockout(3)



  NAME

    gpib_lockout - Issues a local lockout to a General Purpose Interface Bus
    (GPIB) channel

  LIBRARY

    Intergraph Device Library (libix.a)

  SYNOPSIS

    #include <sys/xio/xerr.h>

    int gpib_lockout(
      int channel );

  PARAMETERS

    channel   Represents a GPIB channel.

  DESCRIPTION

    The gpib_lockout() function puts General Purpose Interface Bus (GPIB)
    devices in a local lockout mode, thereby disabling local control.  The
    value of channel specifies the GPIB target for a local lockout operation.

    The system controller is put in an active state before a local lockout
    operation is performed.  The global Local Lock Out (LLO) message is issued
    on the GPIB channel.

    If the GPIB Remote Enable (REN) condition is not active (the GPIB channel
    is not in a remote state), a device's local lockout is not in effect.
    However, once the REN condition is active, a device that was previously
    sent a LLO message proceeds to the lockout state when addressed.

  EXAMPLES

    To disable local operator control of a GPIB channel:

    if (status = gpib_lockout(channel)) {
         fprintf(stderr, "gpib_lockout: failed, %d\n", status);
         return(-1);
    }
    fprintf(stdout, "gpib_lockout: succeeded\n");


  RETURN VALUES

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




  2/94 - Intergraph Corporation                                              1

  gpib_lockout(3)                     CLIX                     gpib_lockout(3)



  ERRORS

    The gpib_lock() 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 specified channel is currently open by another process.

  RELATED INFORMATION

    Functions:  gpib_open(3), gpib_remote(3), gpib_local(3), gpib_cmd(3)

    Files:  xgpib(7)
































  2                                              Intergraph Corporation - 2/94