NAME
hpib_eoi_ctl() — control EOI mode for HP-IB file (OBSOLETED AT 10.30)
SYNOPSIS
#include <dvio.h>
int hpib_eoi_ctl(int eid, int flag);
DESCRIPTION
hpib_eoi_ctl()
enables you to turn
EOI
mode on or off.
eid
is an entity identifier of an open
HP-IB
raw device file
obtained from an
open(),
dup(),
fcntl(),
or
creat()
call.
flag
is an integer which, if non-zero, enables
EOI
mode, and otherwise disables it.
EOI
mode causes the last byte of all subsequent write operations
to be written out with the
EOI
line asserted, signifying the end of the data transmission.
By default,
EOI
mode is disabled when the device file is opened.
Entity identifiers for the same device file obtained by separate
open()
requests have their own
EOI
modes associated with them.
Entity identifiers for the same device file obtained by
dup()
or inherited by a
fork()
request share the same
EOI
mode.
In the latter case, if one process enables
EOI
mode, then
EOI
mode is in effect for all such entity identifiers.
RETURN VALUE
hpib_eoi_ctl()
returns a 0 (zero) if successful, or -1 if an error was encountered.
ERRORS
hpib_eoi_ctl()
fails under any of 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
device file.
DEPENDENCIES
EOI
mode is enabled when the device file is first opened.
AUTHOR
hpib_eoi_ctl()
was developed by HP.