NAME

hpib_abort() − stop activity on specified HP-IB bus

SYNOPSIS

#include <dvio.h>

int hpib_abort(int eid);

DESCRIPTION

hpib_abort() terminates activity on the addressed HP-IB bus by pulsing the IFC line.  eid is an entity identifier of an open HP-IB raw bus device file obtained from an open(), dup(), fcntl(), or creat() call. 

hpib_abort() also sets the REN line and clears the ATN line.  The status of the SRQ line is not affected.  The interface must be the system controller of the bus. 

RETURN VALUE

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

ERRORS

hpib_abort() 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 specified interface is not the system controller (see DEPENDENCIES below). 

[ETIMEDOUT] a timeout occurred. 

[EACCES] The interface associated with this eid is locked by another process and O_NDELAY is set for this eid (see io_lock(3I)). 

DEPENDENCIES

Series 300/400:

The HP 98625A/B and HP 25560A HP-IB interfaces do not clear the ATN line.  EIO is returned if a timeout occurs. 

Series 800:

If the interface is not currently the system controller, hpib_abort() sets errno to [EACCES] instead of to [EIO]. 

AUTHOR

hpib_abort() was developed by HP. 

SEE ALSO

dup(2), creat(2), fcntl(2), open(2). 

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