NAME

pthread - POSIX Threads Library

LIBRARY

POSIX Thread Library (libpthread, -lpthread)

SYNOPSIS

cc [flags] files -lpthread [libraries]

DESCRIPTION

The pthread library provides an implementation of the standard POSIX threads framework.

Note that the system private thread interfaces upon which the pthread library is built are subject to change without notice. In order to remain compatible with future NetBSD releases, programs must be linked against the dynamic version of the thread library. Statically linked programs using the POSIX threads framework may not work when run on a future version of the system.

ENVIRONMENT

PTHREAD_CONCURRENCY
The current version of the system does not inspect this variable. It is reserved for use by the pthread library.

PTHREAD_DIAGASSERT
Possible values are any combinations of:

A
Report errors to application by error return, but do not abort.
a
Abort on errors, creating a core dump for further debugging.
E
Do not log errors to stdout.
e
Log errors to stdout.
L
Do not log errors via syslogd(8).
l
Log errors via syslogd(8).

If not set in the environment, the pthread library behaves as if AEL has been specified.

PTHREAD_RRTIME
The current version of the system does not inspect this variable. It is reserved for use by the pthread library.

PTHREAD_STACKSIZE
Integer value giving the stack size in kilobytes. This allows to set a smaller stack size than the default stack size. The default stack size is the current limit on the stack size as set with the shell's command to change limits (limit for csh(1), or ulimit for sh(1)).

SEE ALSO

pthread_attr(3), pthread_barrier_destroy(3), pthread_barrier_init(3), pthread_barrier_wait(3), pthread_barrierattr(3), pthread_cancel(3), pthread_cleanup_push(3), pthread_cond_broadcast(3), pthread_cond_destroy(3), pthread_cond_init(3), pthread_cond_wait(3), pthread_condattr(3), pthread_create(3), pthread_detach(3), pthread_equal(3), pthread_exit(3), pthread_getspecific(3), pthread_join(3), pthread_key_create(3), pthread_key_delete(3), pthread_kill(3), pthread_mutex_destroy(3), pthread_mutex_init(3), pthread_mutex_lock(3), pthread_mutex_unlock(3), pthread_mutexattr(3), pthread_once(3), pthread_rwlock_destroy(3), pthread_rwlock_init(3), pthread_rwlock_rdlock(3), pthread_rwlock_unlock(3), pthread_rwlock_wrlock(3), pthread_rwlockattr(3), pthread_schedparam(3), pthread_self(3), pthread_setspecific(3), pthread_sigmask(3), pthread_spin_destroy(3), pthread_spin_init(3), pthread_spin_lock(3), pthread_spin_unlock(3), pthread_testcancel(3)

STANDARDS

The pthread library conforms to IEEE Std 1003.1-2001 (``POSIX.1'') .

CAVEATS

Due to limitations in the current pthread implementation, makecontext(3) and sigaltstack(2) should not be used in programs which link against the pthread library (whether threads are used or not).