Manual Pages  — PTHREAD_NP

pthread_np – FreeBSD extensions to POSIX thread functions

LIBRARY SYNOPSIS DESCRIPTION Thread Routines Attribute Object Routines Mutex Routines SEE ALSO STANDARDS

POSIX Threads Library (libpthread, -lpthread)

#include <pthread_np.h>

This manual page documents extensions to the POSIX thread functions. These extensions may or may not be portable to other operating systems.

The POSIX thread functions are summarized in this section in the following groups:

• Thread Routines
• Attribute Object Routines
• Mutex Routines

int pthread_getaffinity_np(pthread_t td, size_t cpusetsize, cpuset_t *cpusetp) Get the CPU affinity of a specified thread.

int pthread_get_name_np(pthread_t thread, char *name, size_t len) Get the name of a specified thread.

int pthread_getname_np(pthread_t thread, char *name, size_t len) Get the name of a specified thread.

int pthread_getthreadid_np(void) Get the calling thread's integral ID.

int pthread_main_np(void) Identify the initial thread.

int pthread_multi_np(void) Sets the thread's scheduling mode to multi-threaded.

int pthread_peekjoin_np(pthread_t thread, void **value_ptr) Peek into the exit status of a specified thread.

int pthread_resume_all_np(void) Resume all suspended threads.

int pthread_setaffinity_np(pthread_t td, size_t cpusetsize, const cpuset_t *cpusetp) Set the CPU affinity of a specified thread.

int pthread_set_name_np(pthread_t thread, char *name) Sets the specified thread's name.

int pthread_setname_np(pthread_t thread, char *name) Sets the specified thread's name.

int pthread_single_np(void) Sets the thread's scheduling mode to single-threaded.

int pthread_suspend_np(pthread_t tid) Suspend the specified thread.

int pthread_suspend_all_np(void) Suspend all active threads.

int pthread_switch_add_np(pthread_switch_routine_t routine) Install a routine that is called every time a thread context switches.

int pthread_switch_delete_np(pthread_switch_routine_t routine) Remove a routine that is called every time a thread context switches.

int pthread_timedjoin_np(pthread_t thread, void **value_ptr, const struct timespec *abstime) A variant of pthread_join() with a timeout.

int pthread_attr_get_np(pthread_t pid, pthread_attr_t *dst) Get the attributes of an existent thread.

int pthread_attr_getaffinity_np(const pthread_attr_t *pattr, size_t cpusetsize, cpuset_t *cpusetp) Get the CPU affinity mask from the thread attribute object.

int pthread_attr_setaffinity_np(pthread_attr_t *pattr, size_t cpusetsize, const cpuset_t *cpusetp) Set the CPU affinity mask for the thread attribute object.

int pthread_attr_setcreatesuspend_np(pthread_attr_t *attr) Permit creation of suspended threads.

int pthread_mutexattr_getkind_np(pthread_mutexattr_t attr) Deprecated, use pthread_mutexattr_gettype(3) instead.

int pthread_mutexattr_setkind_np(pthread_mutexattr_t *attr) Deprecated, use pthread_mutexattr_settype(3) instead.

All of these functions are non-portable extensions to POSIX threads.