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

System Functions (n - p) pthread_signal_to_cancel_np(2)

To use this function in a 64-bit threaded application that uses the POSIX User Thread Model

library 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 ﬁle 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).

To use this function in a threaded application that uses the Standard POSIX Threads library on

systems running H06.21 or later RVUs or J06.10 or later RVUs, you must perform all of the fol-

lowing tasks:

• Include the spthread.h header ﬁle in the application.

• Compile the application using the _SPT_MODEL_ feature test macro or equivalent

compiler command option.

• Link the application to the zsptdll library (/G/system/zdllnnn/zsptdll).

NOTES

The address of the speciﬁed thread is saved in a per-process global variable. Therefore, any sub-

sequent call to this function by your application or any library function replaces the thread

speciﬁed in the previous call, and that thread is not canceled if one of the signals speciﬁed for it

is delivered to the process. Be careful when you call this function; if another thread calls it after

you do, the expected result of this function might not occur.

RETURN VALUES

One of the following values can be returned:

0 Successful completion.

[EINVAL] The value speciﬁed by the thread parameter is invalid.

RELATED INFORMATION

Functions: pthread_cancel(2), sigwait(2).

STANDARDS CONFORMANCE

This function is an extension to the XPG4 Version 2 speciﬁcation and to the following industry

standards:

• IEEE Std 1003.1c-1995, POSIX System Application Program Interface

527186-023 Hewlett-Packard Company 5−181