io_reset(3I)

NAME

io_reset() — reset an I/O interface (OBSOLETED AT 10.30)

SYNOPSIS

#include <dvio.h>

int io_reset(int eid);

DESCRIPTION

io_reset() resets the interface associated with the device file that was opened. It also pulses the peripheral reset line on the GPIO interface, or the IFC line on the HP-IB. eid is an entity identifier of an open HP-IB, Centronics-compatible parallel interface, or GPIO device file obtained from an open(), dup(), fcntl(), or creat() call.

io_reset() also causes an interface to go through its self-test, and returns a failure indication if the interface fails its test.

RETURN VALUE

io_reset() returns 0 (zero) if successful, or -1 if an error was encountered.

ERRORS

io_reset() fails under the following circumstances, and sets errno (see errno(2)) to the value indicated:

[EBADF]: eid does not refer to an open file.
[ENOTTY]: eid does not refer to a channel device file.
[EIO]: Interface could not be reset or failed self-test.
[EACCES]: The interface associated with this eid is locked by another process and O_NDELAY is set for this eid (see io_lock(3I)).

AUTHOR

io_reset() was developed by HP.