Open System Services System Calls Reference Manual (G06.29+, H06.08+, J06.03+)

spt_awaitio(2) OSS System Calls Reference Manual
NAME
spt_awaitio - Awaits a tagged I/O file
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
#include <spthread.h>
spt_error_t spt_awaitio(
const short filenum,
const long tag,
const long timelimit,
long *count_transferred,
long *error,
void *userdata);
PARAMETERS
filenum Specifies Guardian file number being waited on
tag Specifies tag being waited on
timelimit Specifies how many hundredths of a second to wait for a completed I/O:
-1 means wait forever
0 means immediate return
count_transferred
Specifies transfer count of completed I/O; set by callback when SPT_SUCCESS
is returned.
error Specifies Guardian error number for I/O; set by callback when SPT_SUCCESS
is returned or as described in ERRORS
userdata Specifies address of user data area; the referenced data may be modified by a
callback
DESCRIPTION
Awaits a tagged I/O on file number to complete, timeout, or be interrupted (see the
spt_interrupt(2) reference page under RETURN VALUES). The function never cancels I/O.
I/O completes only if SPT_SUCCESS is returned. Multiple threads should not await the same
tagged I/O on any given file number.
RETURN VALUES
SPT_SUCCESS
File number was waited on.
SPT_ERROR An error occurred. See ERRORS.
SPT_TIMEDOUT
Time limit has expired. See ERRORS.
SPT_INTERRUPTED
Wait was interrupted. See ERRORS.
7−136 Hewlett-Packard Company 527186-023