pthread(3) - NetBSD Manual Pages

PTHREAD(3)              NetBSD Library Functions Manual             PTHREAD(3)


NAME

     pthread -- POSIX Threads Library


LIBRARY

     POSIX Threads Library (libpthread, -lpthread)


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

NetBSD 5.0.1                    April 16, 2009                    NetBSD 5.0.1