NAME
hpib_abort() — stop activity on specified HP-IB bus (OBSOLETED AT 10.30)
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
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.
