posix多线程有感--API
一.头文件
#include <pthread.h>
二.编译选项
-lpthread
三.结构体
pthread_t pthread_attr_t pthread_barrier_t pthread_barrierattr_t pthread_cond_t pthread_condattr_t pthread_key_t pthread_mutex_t pthread_mutexattr_t pthread_once_t pthread_rwlock_t pthread_rwlockattr_t pthread_spinlock_t
四.API函数
pthread_create() - thread creation //创建线程 int pthread_create(pthread_t *restrict thread,const pthread_attr_t *restrict attr,void *(*start_routine)(void*), void *restrict arg); pthread_detach() - detach a thread //解绑线程(子线程退出可以回收资源) int pthread_detach(pthread_t thread); pthread_join() - wait for thread termination //等待子进程结束 int pthread_join(pthread_t thread, void **value_ptr); pthread_exit() - thread termination //线程退出 void pthread_exit(void *value_ptr); pthread_self() - get calling thread's ID //获取线程自身id pthread_t pthread_self(void); pthread_kill() - send a signal to a thread //发送结束信号给线程 int pthread_kill(pthread_t thread, int sig); pthread_equal() - compare thread IDs //比较线程id int pthread_equal(pthread_t t1, pthread_t t2); pthread_cancel() - cancel execution of a thread //取消线程 int pthread_cancel(pthread_t thread); pthread_cleanup_pop(), pthread_cleanup_push - establish cancelation handlers void pthread_cleanup_pop(int execute); void pthread_cleanup_push(void (*routine)(void*), void *arg); pthread_getcpuclockid() - access a thread CPU-time clock (ADVANCED REALTIME THREADS) int pthread_getcpuclockid(pthread_t thread_id, clockid_t *clock_id); pthread_once() - dynamic package initialization int pthread_once(pthread_once_t *once_control,void (*init_routine)(void)); pthread_atfork() - register fork handlers int pthread_atfork(void (*prepare)(void), void (*parent)(void),void (*child)(void)); pthread_getconcurrency() - get level of concurrency int pthread_getconcurrency(void); pthread_setconcurrency() - set level of concurrency int pthread_setconcurrency(int new_level); pthread_getschedparam() - dynamic thread scheduling parameters access (REALTIME THREADS) int pthread_getschedparam(pthread_t thread, int *restrict policy,struct sched_param *restrict param); pthread_setschedparam() - dynamic thread scheduling parameters access (REALTIME THREADS) int pthread_setschedparam(pthread_t thread, int policy,const struct sched_param *param); pthread_getspecific() - thread-specific data management void *pthread_getspecific(pthread_key_t key); pthread_setspecific() - thread-specific data management int pthread_setspecific(pthread_key_t key, const void *value); pthread_key_create() - thread-specific data key creation int pthread_key_create(pthread_key_t *key, void (*destructor)(void*)); pthread_key_delete() - thread-specific data key deletion int pthread_key_delete(pthread_key_t key); pthread_setcancelstate() - set cancelability state int pthread_setcancelstate(int state, int *oldstate); pthread_setcanceltype() - set cancelability state int pthread_setcanceltype(int type, int *oldtype); pthread_testcancel() - set cancelability state void pthread_testcancel(void); pthread_setschedprio() - dynamic thread scheduling parameters access (REALTIME THREADS) int pthread_setschedprio(pthread_t thread, int prio); pthread_sigmask() - examine and change blocked signals int pthread_sigmask(int how, const sigset_t *restrict set,sigset_t *restrict oset); sigprocmask() - examine and change blocked signals int sigprocmask(int how, const sigset_t *restrict set,sigset_t *restrict oset); pthread_attr_init() - initialize threads attributes object int pthread_attr_init(pthread_attr_t *attr); pthread_attr_destroy() - destroy threads attributes object int pthread_attr_destroy(pthread_attr_t *attr); pthread_attr_getinheritsched() - get inheritsched attribute (REALTIME THREADS) int pthread_attr_getinheritsched(const pthread_attr_t *restrict attr,int *restrict inheritsched); pthread_attr_setinheritsched() - set inheritsched attribute (REALTIME THREADS) int pthread_attr_setinheritsched(pthread_attr_t *attr,int inheritsched); pthread_attr_getschedparam() - get schedparam attribute int pthread_attr_getschedparam(const pthread_attr_t *restrict attr,struct sched_param *restrict param); pthread_attr_setschedparam() - set schedparam attribute int pthread_attr_setschedparam(pthread_attr_t *restrict attr,const struct sched_param *restrict param); pthread_attr_getschedpolicy() - get schedpolicy attribute (REALTIME THREADS) int pthread_attr_getschedpolicy(const pthread_attr_t *restrict attr,int *restrict policy); pthread_attr_setschedpolicy() - set schedpolicy attribute (REALTIME THREADS) int pthread_attr_setschedpolicy(pthread_attr_t *attr, int policy); pthread_attr_getscope() - get contentionscope attribute (REALTIME THREADS) int pthread_attr_getscope(const pthread_attr_t *restrict attr,int *restrict contentionscope); pthread_attr_setscope() - set contentionscope attribute (REALTIME THREADS) int pthread_attr_setscope(pthread_attr_t *attr, int contentionscope); pthread_attr_getstackaddr() - get stackaddr attribute int pthread_attr_getstackaddr(const pthread_attr_t *restrict attr,void **restrict stackaddr); pthread_attr_setstackaddr() - set stackaddr attribute int pthread_attr_setstackaddr(pthread_attr_t *attr, void *stackaddr); pthread_attr_getstack() - set stack attributes int pthread_attr_getstack(const pthread_attr_t *restrict attr,void **restrict stackaddr, size_t *restrict stacksize); pthread_attr_setstack() - set stack attribute int pthread_attr_setstack(pthread_attr_t *attr, void *stackaddr,size_t stacksize); pthread_attr_getdetachstate() - get detachstate attribute int pthread_attr_getdetachstate(const pthread_attr_t *attr,int *detachstate); pthread_attr_setdetachstate() - set detachstate attribute int pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate); pthread_attr_getguardsize() - get thread guardsize attribute int pthread_attr_getguardsize(const pthread_attr_t *restrict attr,size_t *restrict guardsize); pthread_attr_setguardsize() - set thread guardsize attribute int pthread_attr_setguardsize(pthread_attr_t *attr,size_t guardsize); pthread_attr_setstacksize() - set stacksize attribute int pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize); pthread_attr_getstacksize() - get stacksize attribute int pthread_attr_getstacksize(const pthread_attr_t *restrict attr,size_t *restrict stacksize); pthread_barrier_init() - initialize a barrier object (ADVANCED REALTIME THREADS) int pthread_barrier_init(pthread_barrier_t *restrict barrier,const pthread_barrierattr_t *restrict attr, unsigned count); pthread_barrier_destroy() - destroy a barrier object (ADVANCED REALTIME THREADS) int pthread_barrier_destroy(pthread_barrier_t *barrier); pthread_barrier_wait() - synchronize at a barrier (ADVANCED REALTIME THREADS) int pthread_barrier_wait(pthread_barrier_t *barrier); pthread_barrierattr_init() - initialize barrier attributes object (ADVANCED REALTIME THREADS) int pthread_barrierattr_init(pthread_barrierattr_t *attr); pthread_barrierattr_destroy() - destroy barrier attributes object (ADVANCED REALTIME THREADS) int pthread_barrierattr_destroy(pthread_barrierattr_t *attr) pthread_barrierattr_getpshared(), pthread_barrierattr_setpshared - get and set process-shared attribute of barrier attributes object (ADVANCED REALTIME THREADS) int pthread_barrierattr_getpshared(const pthread_barrierattr_t *restrict attr, int *restrict pshared); pthread_barrierattr_setpshared() - set process-shared attribute of barrier attributes object (ADVANCED REALTIME THREADS) int pthread_barrierattr_setpshared(pthread_barrierattr_t *attr,int pshared); pthread_condattr_init() - initialize condition variable attributes object int pthread_condattr_init(pthread_condattr_t *attr); pthread_condattr_destroy() - destroy condition variable attributes object int pthread_condattr_destroy(pthread_condattr_t *attr); pthread_condattr_getclock() - get the clock selection condition variable attribute (ADVANCED REALTIME) int pthread_condattr_getclock(const pthread_condattr_t *restrict attr,clockid_t *restrict clock_id); pthread_condattr_setclock() - set the clock selection condition variable attribute int pthread_condattr_setclock(pthread_condattr_t *attr,clockid_t clock_id); pthread_condattr_getpshared() - get the process-shared condition variable attributes int pthread_condattr_getpshared(const pthread_condattr_t *restrict attr,int *restrict pshared); pthread_condattr_setpshared() - set the process-shared condition variable attributes int pthread_condattr_setpshared(pthread_condattr_t *attr,int pshared); pthread_cond_init() - initialize condition variables int pthread_cond_init(pthread_cond_t *restrict cond,const pthread_condattr_t *restrict attr); pthread_cond_destroy() - destroy condition variables int pthread_cond_destroy(pthread_cond_t *cond); pthread_cond_broadcast() - broadcast a condition int pthread_cond_broadcast(pthread_cond_t *cond); pthread_cond_signal() - signal a condition int pthread_cond_signal(pthread_cond_t *cond); pthread_cond_timedwait() - wait on a condition int pthread_cond_timedwait(pthread_cond_t *restrict cond,pthread_mutex_t *restrict mutex,const struct timespec *restrict abstime); pthread_cond_wait() - wait on a condition int pthread_cond_wait(pthread_cond_t *restrict cond,pthread_mutex_t *restrict mutex); pthread_mutexattr_init() - initialize mutex attributes object int pthread_mutexattr_init(pthread_mutexattr_t *attr); pthread_mutexattr_destroy() - destroy mutex attributes object int pthread_mutexattr_destroy(pthread_mutexattr_t *attr); pthread_mutexattr_getprioceiling() - get prioceiling attribute of mutex attributes object (REALTIME THREADS) int pthread_mutexattr_getprioceiling(const pthread_mutexattr_t *restrict attr, int *restrict prioceiling); pthread_mutexattr_setprioceiling() - set prioceiling attribute of mutex attributes object (REALTIME THREADS) int pthread_mutexattr_setprioceiling(pthread_mutexattr_t *attr,int prioceiling); pthread_mutexattr_getprotocol() - get and set protocol attribute of mutex attributes object (REALTIME THREADS) int pthread_mutexattr_getprotocol(const pthread_mutexattr_t *restrict attr, int *restrict protocol); pthread_mutexattr_setprotocol() - set protocol attribute of mutex attributes object (REALTIME THREADS) int pthread_mutexattr_setprotocol(pthread_mutexattr_t *attr,int protocol); pthread_mutexattr_getpshared() - get process-shared attribute int pthread_mutexattr_getpshared(const pthread_mutexattr_t *restrict attr, int *restrict pshared); pthread_mutexattr_setpshared() - set process-shared attribute int pthread_mutexattr_setpshared(pthread_mutexattr_t *attr,int pshared); pthread_mutexattr_gettype() - get a mutex type attribute int pthread_mutexattr_gettype(const pthread_mutexattr_t *restrict attr,int *restrict type); pthread_mutexattr_settype() - set a mutex type attribute int pthread_mutexattr_settype(pthread_mutexattr_t *attr, int type); pthread_mutex_init() - initialize a mutex int pthread_mutex_init(pthread_mutex_t *restrict mutex,const pthread_mutexattr_t *restrict attr); pthread_mutex_destroy() - destroy a mutex int pthread_mutex_destroy(pthread_mutex_t *mutex); pthread_mutex_getprioceiling() - get the priority ceiling of a mutex (REALTIME THREADS) int pthread_mutex_getprioceiling(const pthread_mutex_t *restrict mutex,int *restrict prioceiling); pthread_mutex_setprioceiling() - change the priority ceiling of a mutex (REALTIME THREADS) int pthread_mutex_setprioceiling(pthread_mutex_t *restrict mutex,int prioceiling, int *restrict old_ceiling); pthread_mutex_lock() - lock a mutex int pthread_mutex_lock(pthread_mutex_t *mutex); pthread_mutex_trylock() - lock a mutex int pthread_mutex_trylock(pthread_mutex_t *mutex); pthread_mutex_timedlock() - lock a mutex (ADVANCED REALTIME) int pthread_mutex_timedlock(pthread_mutex_t *restrict mutex,const struct timespec *restrict abs_timeout); pthread_mutex_unlock() - unlock a mutex int pthread_mutex_unlock(pthread_mutex_t *mutex); pthread_rwlockattr_init() - initialize read-write lock attributes object int pthread_rwlockattr_init(pthread_rwlockattr_t *attr); pthread_rwlockattr_destroy() - destroy read-write lock attributes object int pthread_rwlockattr_destroy(pthread_rwlockattr_t *attr); pthread_rwlockattr_getpshared() - get process-shared attribute of read-write lock attributes object int pthread_rwlockattr_getpshared(const pthread_rwlockattr_t *restrict attr, int *restrict pshared); pthread_rwlockattr_setpshared() - set process-shared attribute of read-write lock attributes object int pthread_rwlockattr_setpshared(pthread_rwlockattr_t *attr,int pshared); pthread_rwlock_init() - initialize a read-write lock object int pthread_rwlock_init(pthread_rwlock_t *restrict rwlock,const pthread_rwlockattr_t *restrict attr); pthread_rwlock_destroy() - destroy a read-write lock object int pthread_rwlock_destroy(pthread_rwlock_t *rwlock); pthread_rwlock_rdlock() - lock a read-write lock object for reading int pthread_rwlock_rdlock(pthread_rwlock_t *rwlock); pthread_rwlock_wrlock() - lock a read-write lock object for writing int pthread_rwlock_rdlock(pthread_rwlock_t *rwlock); pthread_rwlock_tryrdlock() - lock a read-write lock object for reading int pthread_rwlock_tryrdlock(pthread_rwlock_t *rwlock); pthread_rwlock_trywrlock() - lock a read-write lock object for writing int pthread_rwlock_tryrdlock(pthread_rwlock_t *rwlock); pthread_rwlock_timedrdlock() - lock a read-write lock for reading int pthread_rwlock_timedrdlock(pthread_rwlock_t *restrict rwlock,const struct timespec *restrict abs_timeout); pthread_rwlock_timedwrlock() - lock a read-write lock for writing int pthread_rwlock_timedwrlock(pthread_rwlock_t *restrict rwlock,const struct timespec *restrict abs_timeout); pthread_rwlock_unlock() - unlock a read-write lock object int pthread_rwlock_unlock(pthread_rwlock_t *rwlock); pthread_spin_init() - initialize a spin lock object (ADVANCED REALTIME THREADS) int pthread_spin_init(pthread_spinlock_t *lock, int pshared); pthread_spin_destroy() - destroy a spin lock object (ADVANCED REALTIME THREADS) int pthread_spin_destroy(pthread_spinlock_t *lock); pthread_spin_lock() - lock a spin lock object (ADVANCED REALTIME THREADS) int pthread_spin_lock(pthread_spinlock_t *lock); pthread_spin_trylock() - lock a spin lock object (ADVANCED REALTIME THREADS) int pthread_spin_trylock(pthread_spinlock_t *lock); pthread_spin_unlock() - unlock a spin lock object (ADVANCED REALTIME THREADS) int pthread_spin_unlock(pthread_spinlock_t *lock);
