NAME

hpib_ren_ctl − control the Remote Enable line on HP-IB

SYNOPSIS

int hpib_ren_ctl (eid, flag);
int eid, flag;

HP-UX COMPATIBILITY

Level: Device I/O Library − HP-UX/EXTENDED

Origin: HP

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(3), 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. 

DIAGNOSTICS

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

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

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

the interface is not the system controller [EIO]. 

Hewlett-Packard  —  last mod. May 11, 2021