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

put_awaitio(2) OSS System Calls Reference Manual
NAME
put_awaitio - Awaits a tagged I/O file
LIBRARY
32-bit H-series and J-series OSS processes: /G/system/zdllnnn/zputdll
64-bit H-series and J-series OSS processes: /G/system/zdllnnn/yputdll
SYNOPSIS
#include <pthread.h>
put_error_t put_awaitio(
const short filenum,
const long tag,
const long timelimit,
long *count_transfe rred,
int *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
PUT_SUCCESS is returned.
error Specifies Guardian error number for I/O; set by callback when PUT_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
put_interrupt(2) reference page under RETURN VALUES). The function never cancels I/O.
I/O completes only if PUT_SUCCESS is returned. Multiple threads should not await the same
tagged I/O on any given file number.
To use this function on systems running J06.10 or later RVUs or H06.21 or later RVUs, you must
perform all of the following tasks:
• Include the pthread.h header file in the application.
• Compile the application using the _PUT_MODEL_ feature test macro or equivalent
compiler command option.
• Link the application to the zputdll library.
On systems running H06.24 or later H-series RVUs or J06.13 or later J-series RVUs, you can use
this function with 32-bit or 64-bit applications.
To use this function in a 32-bit application on systems running H06.24 or later RVUs or J06.13 or
later RVUs, perform the same tasks (described above) used to enable the function on systems
running H06.21/J06.10 or later RVUs.
5−186 Hewlett-Packard Company 527186-023