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  —  HP-UX Release 9.0: August 1992