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

spt_wakeup(2) OSS System Calls Reference Manual
NAME
spt_wakeup - Wakes up a thread awaiting tagged I/O
LIBRARY
G-series native OSS processes: /G/system/sysnn/zsptsrl
H-series OSS processes: /G/system/zdllnnn/zsptdll
SYNOPSIS
#include <spthread.h>
extern spt_error_t spt_wakeup(
const short filenum,
const long tag,
const long count_transferred,
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 spt_awaitio() function with a
return value of SPT_SUCCESS.
RETURN VALUES
SPT_SUCCESS
One of the following conditions exists:
• tag was not -1 and waiting I/O was awakened. Note that
only one awaiting I/O was awakened.
• tag was -1 and awaiting I/O (if any) was awakened.
SPT_ERROR One of the following conditions exists:
The value specified for filenum was less than 0 (zero).
• tag was not -1 and no awaiting IO was found.
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−156 Hewlett-Packard Company 527186-003