HP-UX

NAME

itimeout − set time limit for I/O operations

SYNOPSIS

 #include <sicl.h>
 int itimeout (id, val);
 INST id;
 long val;

DESCRIPTION

Itimeout specifies in val the number of milliseconds to wait for an I/O operation to complete before aborting the operation.  If an operation is aborted due to a timeout, the operation will return an error indicating that the operation timed out.  If val is 0, timeouts are disabled. 
 
Note that no guarantee is given on the accuracy of the timeout value. Some systems may only give 1/60th or 1/50th of a second resolution and some systems may only give 1 second resolution.  Also, the resolution available may change based on O.S. specific mechanisms.  The only guarantee is that the timeout will last as least as long as the value specified (in other words, if the timeout value is rounded, it is rounded up).
 
Not all routines are affected by timeouts.  Some routines (such as routines that simply set or return session parameters) never touch the interface hardware and, therefore, will never timeout.
 

RETURN VALUE

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

ERRORS

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

­[I_ERR_BADID] The INST id is invalid. 
 

SEE ALSO

igeterrno(3), igeterrstr(3), igettimeout(3)
 

AUTHOR

itimeout was developed by HP. 

Hewlett-Packard Company  —  May 05, 1994