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

pthread_create(2) OSS System Calls Reference Manual
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 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).
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 file 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 practice of using CATCH handlers in place of pthread_cleanup_push() is not portable.
RETURN VALUES
If an error condition occurs, no thread is created, the contents of thread are undefined, and this
function returns an integer value indicating the type of error. Possible return values are:
0 Successful completion.
[EAGAIN] The system lacks the necessary resources to create another thread, or the
system-imposed limit on the total number of threads under execution by a single
user is exceeded.
[EINVAL] The value specified by the attr parameter is invalid.
RELATED INFORMATION
Functions: pthread_atfork(2), pthread_attr_destroy(2), pthread_attr_init(2),
pthread_attr_setdetachstate(2), pthread_attr_setinheritsched(2),
pthread_attr_setschedparam(2), pthread_attr_setschedpolicy(2),
pthread_attr_setstacksize(2), pthread_cancel(2), pthread_cleanup_pop(2),
pthread_cleanup_push(2), pthread_detach(2), pthread_exit(2), pthread_join(2).
STANDARDS CONFORMANCE
Interfaces documented on this reference page conform to the following industry standards:
• IEEE Std 1003.1-2004, POSIX System Application Program Interface
The use of the header file spthread.h is an HP exception to the POSIX standard.
5−104 Hewlett-Packard Company 527186-023