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