Pthread API总结

Pthread API

函数名	说明
pthread_atfork	fork前后的处理函数，一般不建议多线程下进行fork，见http://blog.csdn.net/anxuegang/article/details/66584722
pthread_attr_getguardsize pthread_attr_setguardsize	堆栈保护区大小
PTHREAD_CREATE_DETACHED PTHREAD_CREATE_JOINABLE pthread_attr_getdetachstate pthread_attr_setdetachstate	设置线程属性，是可分离的，还是可合并的
PTHREAD_INHERIT_SCHED PTHREAD_EXPLICIT_SCHED pthread_attr_getinheritsched pthread_attr_setinheritsched	是继承父线程的调度属性，还是显式使用attr中提供的调度属性
SCHED_FIFO, SCHED_RR SCHED_OTHER，SCHED_SPORADIC pthread_attr_getschedpolicy pthread_attr_setschedpolicy pthread_attr_getschedparam pthread_attr_setschedparam pthread_getschedparam pthread_setschedparam	设置调度策略，round-robin，fifo等不同策略，具体在sched_setscheduler中可以找到各个策略含义，struct sched_param结构参看http://www.oschina.net/question/565065_86198
PTHREAD_SCOPE_SYSTEM PTHREAD_SCOPE_PROCESS pthread_attr_setscope pthread_attr_getscope	调度时线程抢占资源范围，系统范围和进程内范围
PTHREAD_STACK_MIN pthread_attr_getstack pthread_attr_setstack pthread_attr_getstackaddr pthread_attr_setstackaddr pthread_attr_getstacksize pthread_attr_setstacksize	设置线程的堆栈地址和堆栈大小
pthread_barrier_wait	一个计数器同步栅栏，只有指定数字的wait到达后，才开始后续动作
PTHREAD_PROCESS_PRIVATE PTHREAD_PROCESS_SHARED pthread_barrierattr_getpshared pthread_barrierattr_setpshared pthread_condattr_getpshared pthread_condattr_setpshared pthread_mutexattr_getpshared pthread_mutexattr_setpshared pthread_rwlockattr_getpshared pthread_rwlockattr_setpshared	进程间共享
pthread_cancel	终止线程
pthread_cleanup_pop pthread_cleanup_push	添加或清理handler，按照栈的顺序LIFO执行，弹出时可以指定是否执行
pthread_cond_broadcast pthread_cond_signal pthread_cond_timedwait pthread_cond_wait	condition是在某个条件达到时执行，可以理解为某个变量成为某个值的时候，无需循环poll
pthread_condattr_getclock pthread_condattr_setclock	在使用pthread_cond_timedwait时，可以自己指定一个clock ID来做超时服务，默认使用system clock
pthread_detach	分离线程，当该线程结束时，资源会被回收
pthread_equal pthread_self	判断是否相同的两个线程，相同返回非0
pthread_exit	线程退出，注意main的效果；main()中调用pthread_exit，如果不调用，那么main退出时，它所创建的线程也会退出。如果结束时调用，那么main会block住，直到它所支持的线程全部完事。
pthread_getconcurrency pthread_setconcurrency	设置并发数量，只是hint，不强制，在某些系统上并没有实现。默认情况下系统只是保证进程中有线程会被调度，从而使进程不断进行，这可能会保护系统资源，但是不一定是一个很有效率的并行（大概是说某些重要进程需要更高的并行度）
pthread_getcpuclockid	返回线程所使用的clock ID
pthread_key_create pthread_key_delete pthread_getspecific pthread_setspecific	线程可以共用key，但是绑定的value是线程独有的，不能在destructor函数中调用pthread_setspecific
pthread_kill	向线程发送信号，如果是0，则做错误检测，并不真正发送信号
pthread_mutex_lock pthread_mutex_unlock pthread_mutex_timedlock pthread_mutex_trylock	互斥锁
pthread_mutex_getprioceiling pthread_mutex_setprioceiling pthread_mutexattr_getprioceiling pthread_mutexattr_setprioceiling	设置互斥锁的属性，优先级顶；set的时候会对mutex加锁
PTHREAD_PRIO_NONE PTHREAD_PRIO_INHERIT PTHREAD_PRIO_PROTECT pthread_mutexattr_getprotocol pthread_mutexattr_setprotocol	设置protocol，和优先级相关
PTHREAD_MUTEX_NORMAL(锁2次死锁，解锁别的线程锁定或者解锁2次，未定义行为) PTHREAD_MUTEX_ERRORCHECK（上述行为都会返回错误，有错误检测性能会下降） PTHREAD_MUTEX_RECURSIVE（可以锁多次，解锁别的线程锁定或者解锁2次，返回错误） PTHREAD_MUTEX_DEFAULT（锁2次，解锁别的线程锁定或者解锁2次，全是未定义行为） pthread_mutexattr_gettype pthread_mutexattr_settype	设置互斥锁类型
pthread_once	对于同一个pthread_once_t变量，只有一个线程能够调用对应函数
pthread_rwlock_rdlock pthread_rwlock_timedrdlock pthread_rwlock_timedwrlock pthread_rwlock_tryrdlock pthread_rwlock_trywrlock pthread_rwlock_unlock pthread_rwlock_wrlock	读写锁
PTHREAD_CANCEL_ENABLE PTHREAD_CANCEL_DISABLE pthread_setcancelstate PTHREAD_CANCEL_DEFERRED PTHREAD_CANCEL_ASYNCHRONOUS pthread_setcanceltype pthread_testcancel	设置线程是否可以cancel；设置是否延迟cancel
SIG_BLOCK SIG_SETMASK SIG_UNBLOCK pthread_sigmask sigprocmask	设置信号屏蔽;下面这个是单线程进程中使用
pthread_spin_lock pthread_spin_trylock pthread_spin_unlock	自旋锁

注1 sporadic 不定时的，这种策略是有一个时间预算，当预算耗尽，就会降低优先级，然后隔一段指定时间补充预算

参考

[1] https://computing.llnl.gov/tutorials/pthreads/#AppendixA