PTHREAD(3)						   BSD 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 library.

     The NetBSD implementation is based on 1:1 thread model, therefore each pthread has a kernel thread, called a light-weight process (LWP).

     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.

FUNCTIONS

     The following functions comprise the core of the pthread library:

	   Function			 Description
	   pthread_attr(3)		 thread attribute operations
	   pthread_barrier_destroy(3)	 destroy a barrier
	   pthread_barrier_init(3)	 create a barrier
	   pthread_barrier_wait(3)	 wait for a barrier
	   pthread_barrierattr(3)	 barrier attribute operations
	   pthread_cancel(3)		 cancel the execution of a thread
	   pthread_cleanup_push(3)	 add or remove cleanup functions
	   pthread_cond_broadcast(3)	 unblock one or more threads
	   pthread_cond_destroy(3)	 destroy a condition variable
	   pthread_cond_init(3) 	 create a condition variable
	   pthread_cond_wait(3) 	 wait for a condition variable
	   pthread_condattr(3)		 condition attribute operations
	   pthread_create(3)		 create a new thread
	   pthread_detach(3)		 detach a thread
	   pthread_equal(3)		 compare thread identifiers
	   pthread_exit(3)		 terminate the calling thread
	   pthread_getspecific(3)	 get a thread-specific data value
	   pthread_join(3)		 wait for thread termination
	   pthread_key_create(3)	 thread-specific data key creation
	   pthread_key_delete(3)	 delete a thread-specific data key
	   pthread_kill(3)		 send a signal to a specific thread
	   pthread_mutex_destroy(3)	 free a mutex
	   pthread_mutex_init(3)	 create a mutex
	   pthread_mutex_lock(3)	 acquire a lock on a mutex
	   pthread_mutex_unlock(3)	 unlock a mutex
	   pthread_mutexattr(3) 	 mutex attribute operations
	   pthread_once(3)		 dynamic package initialization
	   pthread_rwlock_destroy(3)	 destroy a read/write lock
	   pthread_rwlock_init(3)	 initialize a read/write lock
	   pthread_rwlock_rdlock(3)	 acquire a read/write lock for reading
	   pthread_rwlock_unlock(3)	 release a read/write lock
	   pthread_rwlock_wrlock(3)	 acquire a read/write lock for writing
	   pthread_rwlockattr(3)	 read/write lock attribute operations
	   pthread_schedparam(3)	 thread scheduling manipulation
	   pthread_self(3)		 get the ID of the calling thread
	   pthread_setspecific(3)	 get a thread-specific data value
	   pthread_sigmask(3)		 manipulate a thread's signal mask
	   pthread_spin_destroy(3)	 destroy a spin lock
	   pthread_spin_init(3) 	 initialize a spin lock
	   pthread_spin_lock(3) 	 acquire a spin lock
	   pthread_spin_unlock(3)	 release a spin lock
	   pthread_testcancel(3)	 set cancelability state

ENVIRONMENT

     The following environment variables affect the behavior of the 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_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

     David R. Butenhof, Programming with POSIX(R) Threads, Addison-Wesley, 1997.

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

BSD
								   May 16, 2010 							       BSD