Section 3: library functions
pthread_sigqueue – queue a signal and data to a thread Synopsis #include <pthread.h> #include <signal.h> int pthread_sigqueue(pthread_t thread, int sig, const union sigval value); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_sigqueue(): _GNU_SOURCE Description The pthread_sigqueue() function performs a similar task to sigqueue(3), but, rather than sending a signal…
pthread_sigmask – examine and change mask of blocked signals Synopsis #include <signal.h> int pthread_sigmask(int how, const sigset_t *set, sigset_t *oldset); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_sigmask(): _POSIX_C_SOURCE >= 199506L || _XOPEN_SOURCE >= 500 Description The pthread_sigmask() function is just like sigprocmask(2), with the difference that its use in multithreaded programs is…
pthread_setschedprio – set scheduling priority of a thread Synopsis #include <pthread.h> int pthread_setschedprio(pthread_t thread, int prio); Compile and link with – pthread. Description The pthread_setschedprio() function sets the scheduling priority of the thread thread to the value specified in prio. (By contrast pthread_setschedparam(3) changes both the scheduling policy and priority of a thread.) Return Value…
pthread_setschedparam, pthread_getschedparam – set/get scheduling policy and parameters of a thread Synopsis #include <pthread.h> int pthread_setschedparam(pthread_t thread, int policy, const struct sched_param *param); int pthread_getschedparam(pthread_t thread, int *policy, struct sched_param *param); Compile and link with – pthread. Description The pthread_setschedparam() function sets the scheduling policy and parameters of the thread thread. policy specifies the new…
pthread_setname_np, pthread_getname_np – set/get the name of a thread Synopsis #define _GNU_SOURCE /* See feature_test_macros(7) */ #include <pthread.h> int pthread_setname_np(pthread_t thread, const char *name); int pthread_getname_np(pthread_t thread, char *name, size_t len); Compile and link with -pthread. Description By default, all the threads created using pthread_create() inherit the program name. The pthread_setname_np() function can be used…
pthread_setconcurrency, pthread_getconcurrency – set/get the concurrency level Synopsis #include <pthread.h> int pthread_setconcurrency(int new_level); int pthread_getconcurrency(void); Compile and link with – pthread. Description The pthread_setconcurrency() function informs the implementation of the application’s desired concurrency level, specified in new_level. The implementation takes this only as a hint: POSIX.1 does not specify the level of concurrency that should…
pthread_setcancelstate, pthread_setcanceltype – set cancelability state and type Synopsis #include <pthread.h> int pthread_setcancelstate(int state, int *oldstate); int pthread_setcanceltype(int type, int *oldtype); Compile and link with – pthread. Description The pthread_setcancelstate() sets the cancelability state of the calling thread to the value given in state. The previous cancelability state of the thread is returned in the…
pthread_setcancelstate, pthread_setcanceltype – set cancelability state and type Synopsis #include <pthread.h> int pthread_setcancelstate(int state, int *oldstate); int pthread_setcanceltype(int type, int *oldtype); Compile and link with – pthread. Description The pthread_setcancelstate() sets the cancelability state of the calling thread to the value given in state. The previous cancelability state of the thread is returned in the…
pthread_getattr_default_np, pthread_setattr_default_np, – get or set default thread-creation attributes Synopsis #define _GNU_SOURCE /* See feature_test_macros(7) */ #include <pthread.h> int pthread_getattr_default_np(pthread_attr_t *attr); int pthread_setattr_default_np(pthread_attr_t *attr); Compile and link with – pthread. Description The pthread_setattr_default_np() function sets the default attributes used for creation of a new thread—that is, the attributes that are used when pthread_create(3) is called…
pthread_setaffinity_np, pthread_getaffinity_np – set/get CPU affinity of a thread Synopsis #define _GNU_SOURCE /* See feature_test_macros(7) */ #include <pthread.h> int pthread_setaffinity_np(pthread_t thread, size_t cpusetsize, const cpu_set_t *cpuset); int pthread_getaffinity_np(pthread_t thread, size_t cpusetsize, cpu_set_t *cpuset); Compile and link with – pthread. Description The pthread_setaffinity_np() function sets the CPU affinity mask of the thread thread to the CPU…
pthread_self – obtain ID of the calling thread Synopsis #include <pthread.h> pthread_t pthread_self(void); Compile and link with – pthread. Description The pthread_self() function returns the ID of the calling thread. This is the same value that is returned in *thread in the pthread_create(3) call that created this thread. Return Value This function always succeeds, returning…
pthread_rwlockattr_setkind_np, pthread_rwlockattr_getkind_np – set/get the read-write lock kind of the thread read-write lock attribute object Synopsis #include <pthread.h> int pthread_rwlockattr_setkind_np(pthread_rwlockattr_t *attr, int pref); int pthread_rwlockattr_getkind_np(const pthread_rwlockattr_t *attr, int *pref); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_rwlockattr_setkind_np(), pthread_rwlockattr_getkind_np(): _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200809L Description The pthread_rwlockattr_setkind_np() function sets the…
pthread_rwlockattr_setkind_np, pthread_rwlockattr_getkind_np – set/get the read-write lock kind of the thread read-write lock attribute object Synopsis #include <pthread.h> int pthread_rwlockattr_setkind_np(pthread_rwlockattr_t *attr, int pref); int pthread_rwlockattr_getkind_np(const pthread_rwlockattr_t *attr, int *pref); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_rwlockattr_setkind_np(), pthread_rwlockattr_getkind_np(): _XOPEN_SOURCE >= 500 || _POSIX_C_SOURCE >= 200809L Description The pthread_rwlockattr_setkind_np() function sets the…
pthread_mutexattr_getrobust, pthread_mutexattr_setrobust – get and set the robustness attribute of a mutex attributes object Synopsis #include <pthread.h> int pthread_mutexattr_getrobust(const pthread_mutexattr_t *attr, int *robustness); int pthread_mutexattr_setrobust(const pthread_mutexattr_t *attr, int robustness); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_mutexattr_getrobust(), pthread_mutexattr_setrobust(): _POSIX_C_SOURCE >= 200809L Description The pthread_mutexattr_getrobust() function places the value of…
pthread_mutexattr_getrobust, pthread_mutexattr_setrobust – get and set the robustness attribute of a mutex attributes object Synopsis #include <pthread.h> int pthread_mutexattr_getrobust(const pthread_mutexattr_t *attr, int *robustness); int pthread_mutexattr_setrobust(const pthread_mutexattr_t *attr, int robustness); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_mutexattr_getrobust(), pthread_mutexattr_setrobust(): _POSIX_C_SOURCE >= 200809L Description The pthread_mutexattr_getrobust() function places the value of…
pthread_mutexattr_getpshared, pthread_mutexattr_setpshared – get/set process-shared mutex attribute Synopsis #include <pthread.h> int pthread_mutexattr_getpshared(const pthread_mutexattr_t *attr, int *pshared); int pthread_mutexattr_setpshared(pthread_mutexattr_t *attr, int pshared); Compile and link with -pthread. Description These functions get and set the process-shared attribute in a mutex attributes object. This attribute must be appropriately set to ensure correct, efficient operation of a mutex created…
pthread_mutexattr_getrobust, pthread_mutexattr_setrobust – get and set the robustness attribute of a mutex attributes object Synopsis #include <pthread.h> int pthread_mutexattr_getrobust(const pthread_mutexattr_t *attr, int *robustness); int pthread_mutexattr_setrobust(const pthread_mutexattr_t *attr, int robustness); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_mutexattr_getrobust(), pthread_mutexattr_setrobust(): _POSIX_C_SOURCE >= 200809L Description The pthread_mutexattr_getrobust() function places the value of…
pthread_mutexattr_getrobust, pthread_mutexattr_setrobust – get and set the robustness attribute of a mutex attributes object Synopsis #include <pthread.h> int pthread_mutexattr_getrobust(const pthread_mutexattr_t *attr, int *robustness); int pthread_mutexattr_setrobust(const pthread_mutexattr_t *attr, int robustness); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_mutexattr_getrobust(), pthread_mutexattr_setrobust(): _POSIX_C_SOURCE >= 200809L Description The pthread_mutexattr_getrobust() function places the value of…
pthread_mutexattr_getpshared, pthread_mutexattr_setpshared – get/set process-shared mutex attribute Synopsis #include <pthread.h> int pthread_mutexattr_getpshared(const pthread_mutexattr_t *attr, int *pshared); int pthread_mutexattr_setpshared(pthread_mutexattr_t *attr, int pshared); Compile and link with -pthread. Description These functions get and set the process-shared attribute in a mutex attributes object. This attribute must be appropriately set to ensure correct, efficient operation of a mutex created…
pthread_mutex_consistent – make a robust mutex consistent Synopsis #include <pthread.h> int pthread_mutex_consistent(pthread_mutex_t *mutex); Compile and link with -pthread. Feature Test Macro Requirements for glibc (see feature_test_macros(7)): pthread_mutex_consistent(): _POSIX_C_SOURCE >= 200809L Description This function makes a robust mutex consistent if it is in an inconsistent state. A mutex can be left in an inconsistent state if…