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

System Functions (n - p) put_interruptTag(2)
NAME
put_interruptTag - Interrupts 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>
put_error_t put_interruptTag(
const short filenum,
const long tag,
const put_error_t error_PUT);
PARAMETERS
filenum Specifies the Guardian file number for the file whose awaiting I/O is to be inter-
rupted.
tag Specifies tag whose awaiting I/O is to be interrupted.
error_PUT Specifies PUT error returned to awaiting IO.
DESCRIPTION
Interrupts the thread awaiting the tagged I/O on file number. Note that the I/O is not cancelled by
this function. Interrupted threads will return from the put_awaitio() function with a return value
of error_PUT. Additionally, the error parameter passed to put_awaitio() will be set as shown in
the ERRORS section.
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−223