HPUX hpib_ren_ct[3i]

 hpib_ren_ctl(3I)         Series 300, 400, 800 Only         hpib_ren_ctl(3I)





 NAME
      hpib_ren_ctl() - control the Remote Enable line on HP-IB

 SYNOPSIS
      #include <dvio.h>

      int hpib_ren_ctl(int eid, int flag);

 DESCRIPTION
      hpib_ren_ctl() enables/disables the Remote Enable (REN) line depending
      upon the value of flag.  eid is an entity identifier of an open HP-IB
      raw bus device file obtained from an open(), dup(), fcntl(), or
      creat() call.  flag is an integer which, if non-zero, enables the REN
      line, and otherwise disables it.

      hpib_ren_ctl() can be used in conjunction with hpib_send_cmnd() to
      place devices into the remote state or local state.  The REN line is
      normally enabled at all times, and is in this state at power-up.  Only
      the system controller can enable or disable the REN line.

 RETURN VALUE
      hpib_ren_ctl() returns 0 (zero) if successful, or -1 if an error was
      encountered.

 ERRORS
      hpib_ren_ctl() fails under the following circumstances, and sets errno
      (see errno(2)) to the value in square brackets:

           [EBADF]        eid does not refer to an open file.

           [ENOTTY]       eid does not refer to an HP-IB raw bus device
                          file.

           [EIO]          the interface is not the system controller.

 AUTHOR
      hpib_ren_ctl() was developed by HP.

















 Hewlett-Packard Company            - 1 -     HP-UX Release 9.0: August 1992