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

System Functions (n - p) put_wakeup(2)
NAME
put_wakeup - Wakes up a thread awaiting tagged I/O
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>
extern put_error_t put_wakeup(
const short filenum,
const long tag,
const long count_transfe rred,
const long error);
PARAMETERS
filenum Specifies the Guardian file number being waited on.
tag Specifies the tag that is being awaited; the value -1 indicates all tags.
count_transferred
Specifies byte transfer count of completed I/O.
error Specifies Guardian error number for IO.
DESCRIPTION
This function wakes up a thread awaiting the tagged I/O on the file with the specified Guardian
file number. The awakened thread returns from its call to the put_awaitio() function with a
return value of PUT_SUCCESS.
To use this function on systems running H06.21 or later RVUs or J06.10 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 (/G/system/zdllnnn/zputdll).
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.
To use this function in a 64-bit application on systems running H06.24 or later RVUs or J06.13 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.
• Compile the application using the -Wlp64 compiler command option.
• Link the application to the yputdll library (/G/system/zdllnnn/yputdll).
527186-023 Hewlett-Packard Company 5−295