HP-UX

NAME

ireadstb − read the status byte for a device

SYNOPSIS

 #include <sicl.h>
 int ireadstb (id, stb);
 INST id;
 unsigned char *stb;

DESCRIPTION

Ireadstb reads the status byte from the specified device and stores the byte in stb.  This routine works on device sessions only. 
 
The mechanism used to obtain the status byte is device specific.  For example, HP-IB devices are serially polled.
 

RETURN VALUE

Ireadstb returns 0 on success, or a non-zero error code otherwise. 

ERRORS

Ireadstb fails under the following circumstances, and sets the return value to one of the following:

­[I_ERR_BADID] The INST id is invalid. 

­[I_ERR_TIMEOUT] The call timed out before the status byte could be obtained. 
 

SEE ALSO

igeterrno(3), igeterrstr(3), isetlock(3)
 

AUTHOR

ireadstb was developed by HP. 

Hewlett-Packard Company  —  September 29, 1999