HPIB_REN_CTL(3I) — HP-UX
NAME
hpib_ren_ctl − control the Remote Enable line on HP-IB
SYNOPSIS
int hpib_ren_ctl (eid, flag);
int eid, 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(2), dup(2), fcntl(2), or creat(2) call. Flag is an integer which, if non-zero, enables the REN line, and otherwise disables it.
Hpib_ren_ctl, in conjunction with hpib_send_cmnd(3I), enables you 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 may enable/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 the Hewlett-Packard Company.
Hewlett-Packard Company — May 11, 2021