Open System Services System Calls Reference Manual (G06.25+, H06.03+)

spt_interrupt(2) OSS System Calls Reference Manual
NAME
spt_interrupt - Interrupts all threads awaiting input or output
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_interrupt(
const short filenum,
const spt_error_t errorSPT);
PARAMETERS
filenum Specifies the Guardian file number for thev file whose awaiting I/O is to be inter-
rupted.
errorSPT Specifies SPT error returned to waiting file.
DESCRIPTION
Interrupts all threads awaiting IO on file number. Note the I/O is not cancelled by this function.
Interrupted threads will return from the spt_awaitio() function with a return value of error_SPT.
Additionally, the error parameter passed to the spt_awaitio() function will be set as shown in
the PARAMETERS section.
RETURN VALUES
SPT_SUCCESS
The file number awaiting I/O (if any) was interrupted.
SPT_ERROR Either the value specified for error_SPT is invalid or the value for filenum is less
than 0 (zero) or is not registered.
ERRORS
-1 - SPT_ERROR
40 - SPT_TIMEOUT
[EINTR] - SPT_INTERRUPTED
STANDARDS CONFORMANCE
This function is an extension to the XPG4 Version 2 specification. Interfaces documented on this
reference page conform to the following industry standards:
• IEEE Std 1003.1c-1995, POSIX System Application Program Interface
The use of the header file spthread.h is an HP exception to the POSIX standard.
7−112 Hewlett-Packard Company 527186-003