Content-type: text/html
Man page of pthread
pthread
Section: C Library Functions (3)
Index
Return to Main Contents
NAME
pthread, pthread_intro - Introduction to POSIX Threads (Pthreads)
DESCRIPTION
DECthreads, DIGITAL's multithreading run-time library, provides a set of
interfaces for building multithreaded programs. One of these interfaces
provides routines (with the prefix pthread_) that implement the IEEE
Std 1003.1c-1995, POSIX System Application Program Interface, also known as
POSIX Standard 1003.1c or POSIX.1c. Note that POSIX Standard 1003.1c now
supersedes the POSIX draft standard 1003.4a.
A thread is a single, sequential flow of control within a program.
Within a single thread, there is a single point of execution. Most traditional
programs consist of a single thread.
Using DECthreads, a programmer can create more than one threads within a
program. Threads execute concurrently, and, within a multithreaded
program, there are at any time multiple points of execution. The threads
in a given process execute within (and share) a single address space.
Therefore, threads read and write the same memory locations.
Synchronization elements such as mutexes and condition variables ensure
that the shared memory is accessed correctly. DECthreads provides routines
that allow you to create and use these synchronization elements. Mutexes
and condition variables are discussed in the Guide to DECthreads.
Users of previous versions of DECthreads should be aware that applications
consistent with the P1003.4a/D4 interface require significant modifications
to be upgraded to the DECthreads pthread (POSIX.1c) interface. See
the discussion in the Guide to DECthreads.
Routine names ending with the _np suffix denote that the routine is
"not portable." That is, such a routine might not be available in other
vendor implementations of POSIX 1003.1c.
Compile a multithreaded application using shared versions of libmach and
libpthread as follows:
cc -o myprog myprog.c -pthread
If you use a compiler front-end or other (not C) language environment
that does not support the -pthread compilation switch, you
must use the -D_REENTRANT compilation switch.
When linking your multithreaded application, include these switches:
-lpthread -lexc
Each C module that utilizes DECthreads exceptions must include the
pthread_exception.h header file. The Guide to DECthreads describes
the use of DECthreads exceptions.
Note that previous versions of DECthreads provided a DECthreads-specific debugging
interface. However, for this version and future versions of DECthreads, we recommend
the use of the DIGITAL UNIX Ladebug debugger for debugging DECthreads-based
multithreaded applications.
The Guide to DECthreads describes important considerations for threaded
application development, particularly for the DIGITAL UNIX operating
system.
The pthread interface routines are grouped in the following functional
categories:
General threads routines
Thread attributes object routines
Thread cancelation routines
Thread priority, concurrency, and scheduling routines
Thread-specific data routines
Mutex routines
Mutex attributes object routines
Condition variable routines
Condition variable attribute object routines
DECthreads also provides routines that implement nonportable
extensions to the POSIX 1003.1c standard. These routines are grouped
into these functional categories:
Thread execution routines
Thread attributes routines
DECthreads global mutex routines
Mutex attributes routines
Condition variable routines
DECthreads exception object routines
General Threads Routines
Declares fork handler routines to be called.
Creates a thread object and thread.
Marks a thread object for deletion.
Compares one thread identifier to another thread identifier.
Terminates the calling thread.
Causes the calling thread to wait for the termination of a specified thread and
detach it.
Delivers a signal to a specified thread.
Calls an initialization routine to be executed only once.
Obtains the identifier of the current thread.
Examines or changes the calling thread's signal mask.
Thread Attributes Object Routines
Destroys a thread attributes object.
Obtains the detachstate attribute from the specified thread attributes object.
Obtains the guardsize attribute of the specified thread attributes object.
Obtains the inherit scheduling attribute from the specified thread attributes
object.
Obtains the scheduling parameters for an attribute of the specified thread
attributes object.
Obtains the scheduling policy attribute of the specified thread attributes
object.
Obtains the contention-scope attribute of the specified thread attributes object.
Obtains the stackaddr attribute of the specified thread attributes object.
Obtains the stacksize attribute of the specified thread attributes object.
Initializes a thread attributes object.
Changes the detachstate attribute in the specified thread attributes object.
Changes the guardsize attribute of the specified thread attributes object.
Changes the inherit scheduling attribute of the specified thread attributes
object.
Changes the values of the parameters associated with the scheduling policy
attribute of the specified thread attributes object.
Changes the scheduling policy attribute of the specified thread attributes object.
Changes the stackaddr attribute in the specified thread attributes object.
Changes the stacksize attribute in the specified thread attributes object.
Thread Cancelation Routines
Allows a thread to request that it, or another thread, terminate execution.
Removes a cleanup handler routine from the top of the cleanup stack and optionally
executes it.
Establishes a cleanup handler routine to be executed when the thread exits or is
canceled.
Sets the current thread's cancelability state.
Sets the current thread's cancelability type.
Requests delivery of any pending cancelation request to the current thread.
Thread Priority, Concurrency, and Scheduling Routines
Obtains the current concurrency level parameter for the process.
Obtains the current scheduling policy and scheduling parameters of a thread.
Obtains a thread sequence number.
Changes the current concurrency level parameter for the process.
Changes the current scheduling policy and scheduling parameters of a thread.
Thread-Specific Data Routines
Obtains the thread-specific data associated with the specified key.
Generates a unique thread-specific data key.
Sets the thread-specific data value associated with the specified key for the
current thread.
Deletes a thread-specific data key.
Mutex Routines
Destroys a mutex.
Initializes a mutex with attributes specified by the attributes argument.
Locks an unlocked mutex; if locked, the caller waits for the mutex to become
available.
Attempts to lock a mutex; returns immediately if mutex is already locked.
Unlocks a locked mutex.
Mutex Attributes Object Routines
Initializes a mutex attributes object.
Destroys a mutex attributes object.
Obtains the mutex type attribute of a mutex attributes object.
Changes the mutex type attribute of a mutex attributes object.
Condition Variable Routines
Wakes all threads waiting on a condition variable.
Destroys a condition variable.
Initializes a condition variable.
Wakes at least one thread that is waiting on a condition variable.
Causes a thread to wait for a specified period of time for a condition
variable to be signaled or broadcasted.
Causes a thread to wait for a condition variable to be signaled or broadcasted.
Condition Variable Attributes Object Routines
Destroys a condition variable attributes object.
Initializes a condition variable attributes object.
Non-Portable Extensions: Thread Execution Routines
Causes a thread to delay execution.
Obtains a value representing a desired expiration time.
Obtains the thread sequence number.
Non-Portable Extensions: Thread Attributes Routines
Obtains the guardsize attribute of the specified thread attributes object.
Changes the guardsize attribute of the specified thread attributes object.
Non-Portable Extensions: DECthreads Global Mutex Routines
Locks the DECthreads global mutex if it is unlocked.
Unlocks the DECthreads lobal mutex if it is locked.
Non-Portable Extensions: Mutex Attributes Routines
Obtains the mutex type attribute of a mutex attributes object.
Changes the mutex type attribute of a mutex attributes object.
Non-Portable Extensions: Condition Variable Routines
Wakes one thread that is waiting on a condition variable (called from
interrupt level only).
Non-Portable Extensions: DECthreads Exception Object Routines
Obtains a system-defined error status from a DECthreads status exception object.
Determines whether two DECthreads exception objects are identical.
Produces a message that reports what a specified DECthreads status
exception object represents.
Imports a system-defined error status into a DECthreads address exception object.
delim off
delim off
Index
- NAME
-
- DESCRIPTION
-
- General Threads Routines
-
- Thread Attributes Object Routines
-
- Thread Cancelation Routines
-
- Thread Priority, Concurrency, and Scheduling Routines
-
- Thread-Specific Data Routines
-
- Mutex Routines
-
- Mutex Attributes Object Routines
-
- Condition Variable Routines
-
- Condition Variable Attributes Object Routines
-
- Non-Portable Extensions: Thread Execution Routines
-
- Non-Portable Extensions: Thread Attributes Routines
-
- Non-Portable Extensions: DECthreads Global Mutex Routines
-
- Non-Portable Extensions: Mutex Attributes Routines
-
- Non-Portable Extensions: Condition Variable Routines
-
- Non-Portable Extensions: DECthreads Exception Object Routines
-
This document was created by
man2html,
using the manual pages.
Time: 02:41:35 GMT, October 02, 2010