NAME
hpib_ren_ctl() — control the Remote Enable line on HP-IB (OBSOLETED AT 10.30)
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.