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.
Printable version
