NAME

hpib_address_ctl() − set the HP-IB bus address for an interface

SYNOPSIS

#include <dvio.h>

int hpib_address_ctl(int eid, int ba);

DESCRIPTION

hpib_address_ctl() sets the HP-IB bus address of the interface associated with eid to ba. eid is an entity identifier of an open HP-IB raw bus device file obtained from an open(), dup(), fcntl(), or creat() call.  ba is an integer and must be in the range of [0-30]. 

The new bus address remains in effect until a reboot, an io_reset() call, or another hpib_address_ctl() call occurs.  When a reboot() or io_reset() call occurs, the HP-IB bus address reverts to its powerup value. 

RETURN VALUE

hpib_address_ctl() returns 0 (zero) if successful or −1 if an error was encountered. 

ERRORS

hpib_address_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] a timeout occurred. 

[EINTR] the request was interrupted by a signal. 

[EINVAL] ba is not in the range of 0-30. 

AUTHOR

hpib_address_ctl() was developed by HP. 

SEE ALSO

dup(2), creat(2), fcntl(2), open(2), io_reset(3I). 

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