OpenBSD manual page server

Attribute Object Routines

The functions available are as follows:

pthread_attr_init()

Initialise a threads attribute object.

pthread_attr_destroy()

Destroy a threads attribute object.

pthread_attr_getdetachstate()

Get detachstate attribute.

pthread_attr_setdetachstate()

Set detachstate attribute.

pthread_attr_getstack()

Get stackaddr and stacksize attributes.

pthread_attr_setstack()

Set stackaddr and stacksize attributes.

pthread_attr_getstackaddr()

Get stackaddr attribute.

pthread_attr_setstackaddr()

Set stackaddr attribute.

pthread_attr_getstacksize()

Get stacksize attribute.

pthread_attr_setstacksize()

Set stacksize attribute.

pthread_attr_getguardsize()

Get guardsize attribute.

pthread_attr_setguardsize()

Set guardsize attribute.

Barrier Routines

The functions available are as follows:

pthread_barrier_init()

Initialize a barrier object.

pthread_barrier_destroy()

Destroy a barrier object.

pthread_barrier_wait()

Synchronize at a barrier.

pthread_barrierattr_init()

Initialize a barrier's attribute object.

pthread_barrierattr_destroy()

Destroy a barrier's attribute object.

pthread_barrierattr_getpshared()

Get the process-shared attribute of the barrier attribute's object.

pthread_barrierattr_setpshared()

Set the process-shared attribute of the barrier attribute's object.

Cleanup Routines

The functions available are as follows:

pthread_atfork()

Register fork handlers.

pthread_cleanup_pop()

Call the first cleanup routine.

pthread_cleanup_push()

Add a cleanup function for thread exit.

Condition Variable Routines

The functions available are as follows:

pthread_cond_init()

Create a condition variable.

pthread_cond_destroy()

Destroy a condition variable.

pthread_cond_broadcast()

Unblock all threads waiting for a condition variable.

pthread_cond_signal()

Unblock a thread waiting for a condition variable.

pthread_cond_timedwait()

Wait on a condition variable until a specific point in time.

pthread_cond_wait()

Wait on a condition variable.

pthread_condattr_init()

Initialise a condition variable attribute object.

pthread_condattr_destroy()

Destroy a condition variable attribute object.

pthread_condattr_getclock()

Get clock attribute.

pthread_condattr_setclock()

Set clock attribute.

Mutex Routines

The functions available are as follows:

pthread_mutex_init()

Create a mutex.

pthread_mutex_destroy()

Free resources allocated for a mutex.

pthread_mutex_lock()

Lock a mutex.

pthread_mutex_timedlock()

Attempt to lock a mutex before a specific point in time.

pthread_mutex_trylock()

Attempt to lock a mutex without blocking.

pthread_mutex_unlock()

Unlock a mutex.

pthread_mutexattr_init()

Mutex attribute operations.

pthread_mutexattr_destroy()

Mutex attribute operations.

pthread_mutexattr_getprioceiling()

Mutex attribute operations.

pthread_mutexattr_setprioceiling()

Mutex attribute operations.

pthread_mutexattr_getprotocol()

Mutex attribute operations.

pthread_mutexattr_setprotocol()

Mutex attribute operations.

pthread_mutexattr_gettype()

Mutex attribute operations.

pthread_mutexattr_settype()

Mutex attribute operations.

Non Portable Extensions

The functions available are as follows:

pthread_main_np()

Identify the main thread.

pthread_set_name_np()

Set the name of a thread.

pthread_get_name_np()

Get the name of a thread.

pthread_stackseg_np()

Return stack size and location.

pthread_yield()

Yield control of the current thread.

Per-Thread Context Routines

The functions available are as follows:

pthread_key_create()

Thread-specific data key creation.

pthread_key_delete()

Delete a thread-specific data key.

pthread_getspecific()

Get a thread-specific data value.

pthread_setspecific()

Set a thread-specific data value.

Read/Write Lock Routines

The functions available are as follows:

pthread_rwlock_init()

Initialise a read/write lock.

pthread_rwlock_destroy()

Destroy a read/write lock.

pthread_rwlock_rdlock()

Acquire a read/write lock for reading.

pthread_rwlock_timedrdlock()

Attempt to acquire a read/write lock for reading before a specific point in time.

pthread_rwlock_tryrdlock()

Attempt to acquire a read/write lock for reading without blocking.

pthread_rwlock_wrlock()

Acquire a read/write lock for writing.

pthread_rwlock_timedwrlock()

Attempt to acquire a read/write lock for writing before a specific point in time.

pthread_rwlock_trywrlock()

Attempt to acquire a read/write lock for writing without blocking.

pthread_rwlock_unlock()

Release a read/write lock.

pthread_rwlockattr_init()

Initialise a read/write lock.

pthread_rwlockattr_destroy()

Destroy a read/write lock.

pthread_rwlockattr_getpshared()

Get the process shared attribute.

pthread_rwlockattr_setpshared()

Set the process shared attribute.

Spinlock Routines

The functions available are as follows:

pthread_spin_init()

Initialize a spinlock object.

pthread_spin_destroy()

Destroy a spinlock object.

pthread_spin_lock()

Lock a spinlock object.

pthread_spin_trylock()

Attempt to lock a spinlock without blocking.

pthread_spin_unlock()

Unlock a spinlock object.

Thread Routines

The functions available are as follows:

pthread_create()

Create a new thread.

pthread_cancel()

Cancel execution of a thread.

pthread_detach()

Detach a thread.

pthread_equal()

Compare thread IDs.

pthread_exit()

Terminate the calling thread.

pthread_getconcurrency()

Get level of concurrency.

pthread_setconcurrency()

Set level of concurrency.

pthread_join()

Wait for thread termination.

pthread_kill()

Send a signal to a specific thread.

pthread_once()

Dynamic package initialisation.

pthread_self()

Get the calling thread's ID.

pthread_setcancelstate()

Set cancelability state.

pthread_setcanceltype()

Set cancelability state.

pthread_testcancel()

Set cancelability state.

pthread_sigmask()

Examine/change a thread's signal mask.

pthread_getcpuclockid()

Get a CPU time clock for a thread.

Thread stacks

Each thread has a different stack, whether it be provided by a user attribute, or provided automatically by the system. If a thread overflows its stack, unpredictable results may occur. System-allocated stacks (including that of the initial thread) are typically allocated in such a way that a SIGSEGV signal is delivered to the process when a stack overflows.

Signals handlers are normally run on the stack of the currently executing thread. Hence, if you want to handle the SIGSEGV signal from stack overflow for a thread, you should use sigaltstack(2) in that thread.

Thread safety

The following functions are not thread-safe:

The ctermid() and tmpnam() functions are not thread-safe when passed a NULL argument. The wcrtomb(), wcsrtombs(), and wcsnrtombs() functions are not thread-safe when passed a NULL ps argument.