PTHREAD(3)

NAME
pthread - POSIX Threads Library

LIBRARY
libpthread

SYNOPSIS
#include <pthread.h>

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 p1003.1-2001.

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).