posix多线程有感--线程高级编程(线程属性函数总结)
pthread_attr_t 的缺省属性值 属性 | 值 | 结果 |
scope | PTHREAD_SCOPE_PROCESS | 新线程与进程中的其他线程发生竞争。 |
detachstate | PTHREAD_CREATE_JOINABLE | 线程退出后，保留完成状态和线程 ID。 |
stackaddr | NULL | 新线程具有系统分配的栈地址。 |
stacksize | 1M | 新线程具有系统定义的栈大小。 |
priority | 0 | 新线程的优先级为0。 |
inheritsched | PTHREAD_EXPLICIT_SCHED | 新线程不继承父线程调度优先级。 |
schedpolicy | SCHED_OTHER | 新线程对同步对象争用使用 Solaris 定义的固定优先级。线程将一直运行，直到被抢占或者直到线程阻塞或停止为止。 |
guardsize | PAGESIZE（4M） | 新线程具有系统定义的栈溢出保护区大小 |
1、初始化一个线程对象的属性int pthread_attr_init(pthread_attr_t *attr);
返回值：若是成功返回0,否则返回错误的编号
形 参： attr 指向一个线程属性的指针
说 明：Posix线程中的线程属性pthread_attr_t主要包括scope属性、detach属性、堆栈地址、堆栈大小、优先级。
pthread_attr_init实现时为属性对象分配了动态内存空间。
2、销毁一个线程属性对象
int pthread_attr_destroy(pthread_attr_t *attr);
返回值：若是成功返回0,否则返回错误的编号 形 参：attr 指向一个线程属性的指针 说 明：经pthread_attr_destroy去除初始化之后的pthread_attr_t结构被pthread_create函数调用，将会导致其返回错误。 3、获取线程间的CPU亲缘性int pthread_attr_getaffinity_np(pthread_attr_t *attr, size_t cpusetsize, cpu_set_t *cpuset);
返回值：若是成功返回0,否则返回错误的编号 形 参：attr 指向一个线程属性的指针 说 明：获取线程的CPU亲缘属性 4、设置线程的CPU亲缘性int pthread_attr_setaffinity_np(pthread_attr_t *attr, size_t cpusetsize, const cpu_set_t *cpuset);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
cpusetsize 指向CPU组的缓冲区大小
cpuset 指向CPU组的指针
说 明：通过指定cupset来设置线程的CPU亲缘性
5、获取线程分离状态属性
int pthread_attr_getdetachstate(pthread_attr_t *attr, int *detachstate);
返回值：若是成功返回0,否则返回错误的编号
形 参： attr 指向一个线程属性的指针
detachstate 保存返回的分离状态属性
说 明：获取线程分离状态属性
6、修改线程分离状态属性
int pthread_attr_setdetachstate(pthread_attr_t *attr, int detachstate);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
detachstat 有两个取值
PTHREAD_CREATE_DETACHED(分离)
PTHREAD_CREATE_JOINABLE（非分离）
说 明：所有的Pthreads系统都支持detachstate属性，该属性的值可以是PTHREAD_CREATE_DETACHED(分离)或PTHREAD_CREATE_JOINABLE（非分离）。默认的，线程被创建为非分离，即意味着由pthread_create创建的该线程ID能被用来与线程连接并获得它的返回值，或取消它。
7、获取线程的栈溢出保护区大小
int pthread_attr_getguardsize(pthread_attr_t *attr, size_t *guardsize);
返回值：若是成功返回0,否则返回错误的编号
形 参： attr 指向一个线程属性的指针
guardsize 返回获取的栈保护区大小
说 明：获取线程的栈保护区大小。 出于以下两个原因，为应用程序提供了 guardsize 属性：
溢出保护可能会导致系统资源浪费。如果应用程序创建大量线程，并且已知这些线程永远不会溢出其栈，则可以关闭溢出保护区。通过关闭溢出保护区，可以节省系统资源。
线程在栈上分配大型数据结构时，可能需要较大的溢出保护区来检测栈溢出。
guardsize 参数提供了对栈指针溢出的保护。如果创建线程的栈时使用了保护功能，则实现会在栈的溢出端分配额外内存。此额外内存的作用与缓冲区一样，可以防止栈指针的栈溢出。如果应用程序溢出到此缓冲区中，这个错误可能会导致 SIGSEGV 信号被发送给该线程。
8、设置线程的栈溢出保护区大小int pthread_attr_setguardsize(pthread_attr_t *attr, size_t guardsize);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
guardsize 线程的栈保护区大小
说 明：参数提供了对栈指针溢出的保护。如果 guardsize 为零，则不会为使用 attr 创建的线程提供溢出保护区。如果 guardsize 大于零，则会为每个使用attr 创建的线程提供大小至少为 guardsize 字节的溢出保护区。缺省情况下，线程具有实现定义的非零溢出保护区。将 guardsize 的值向上舍入为可配置的系统变量 PAGESIZE 的倍数。请参见 sys/mman.h 中的PAGESIZE。9、获取线程的作用域int pthread_attr_getscope(pthread_attr_t *attr, int *scope);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
scope 返回线程的作用域
说 明：指定了作用域也就指定了线程与谁竞争资源
10、设置线程的作用域
int pthread_attr_setscope(pthread_attr_t *attr, int scope);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
guardsize 线程的作用域，可以取如下值
PTHREAD_SCOPE_SYSTEM 与系统中所有进程中线程竞争
PTHREAD_SCOPE_PROCESS 与当前进程中的其他线程竞争
说 明：指定了作用域也就指定了线程与谁竞争资源
11、获取线程的堆栈信息（栈地址和栈大小）
int pthread_attr_getstack(pthread_attr_t *attr, void **stackaddr, size_t *stacksize);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
stackaddr 返回获取的栈地址
stacksize 返回获取的栈大小
说 明：获取线程的堆栈地址和大小
12、设置线程的堆栈信息（栈地址和栈大小）
int pthread_attr_setstack(pthread_attr_t *attr, void *stackaddr, size_t stacksize);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
stackaddr 线程的堆栈地址（低位地址）：应该是可移植的，对齐页边距的可以用posix_memalign来进行获取。如果将 stackaddr 设置为非空值，而不是缺省的 NULL，则系统将在该地址初始化栈，假设大小为 stacksize。
stacksize 线程的堆栈大小：应该是页大小的整数倍
说 明：设置堆栈区，将导致pthread_attr_setguardsize失效。
13、获取线程堆栈地址
int pthread_attr_getstackaddr(pthread_attr_t *attr, void **stackaddr);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
stackaddr 返回获取的栈地址
说 明：函数已过时，一般用pthread_attr_getstack来代替
14、设置线程堆栈地址
int pthread_attr_setstackaddr(pthread_attr_t *attr, void *stackaddr);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
stackaddr 设置线程堆栈地址
说 明：函数已过时，一般用pthread_attr_setstack来代替。15、获取线程堆栈大小int pthread_attr_getstacksize(pthread_attr_t *attr, size_t *stacksize);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
stacksize 返回线程的堆栈大小
说 明：获取线程堆栈大小。设置堆栈大小不是可移植的。Pthreads定义PTHREAD_STACK_MIN标志，指定每个线程要求的最小栈大小，包含#include <limits.h>后可以通过打印其值查看。命令：#ulimit -s或者#ulimit -a其中stack size项表示堆栈大小。#ulimit -s value用来重新设置stack大小。默认为8M，最小16384字节。注意：通常，线程栈是从页边界开始的。任何指定的大小都被向上舍入到下一个页边界。不具备访问权限的页将被附加到栈的溢出端。大多数栈溢出都会导致将 SIGSEGV 信号发送到违例线程。将直接使用调用方分配的线程栈，而不进行修改。指定栈时，还应用 PTHREAD_CREATE_JOINABLE 创建线程。在该线程的 pthread_join调用返回之前，不会释放该栈。在该线程终止之前，不会释放该线程的栈。一般情况下，不需要为线程分配栈空间。系统会为每个线程的栈分配 1 MB（对于 32 位系统）或 2 MB（对于 64 位系统）的虚拟内存，而不保留任何交换空间。系统将使用 mmap() 的 MAP_NORESERVE 选项来进行分配。极少数情况下需要指定栈和/或栈大小。甚至专家也很难了解是否指定了正确的大小。16、设置线程堆栈大小int pthread_attr_setstacksize(pthread_attr_t *attr, size_t stacksize);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
stacksize 线程的堆栈大小（以字节为单位）：应该是页大小的整数倍。（以字节为单位）。stacksize不应小于系统定义的最小栈大小。stacksize包含新线程使用的栈的字节数。如果 stacksize为零，则使用缺省大小。在大多数情况下，零值最适合。
说 明：设置线程堆栈大小。
17、获取线程的调度策略
int pthread_attr_getschedpolicy(pthread_attr_t *attr, int *policy);
返回值：若是成功返回0,否则返回错误的编号
形 参： attr 指向一个线程属性的指针
policy 返回线程的调度策略
说 明：获取线程的调度策略
18、设置线程的调度策略
int pthread_attr_setschedpolicy(pthread_attr_t *attr, int policy);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
policy 线程的调度策略，有如下三种：
SCHED_FIFO 先入先出策略
SCHED_RR 轮转调度，类似于 FIFO，但加上了时间轮片算法
SCHED_OTHER 系统默认策略。是不支持优先级使用的,而SCHED_FIFO和SCHED_RR支持优先级的使用,他们分别为1和99,数值越大优先级越高.
注意：此处的SCHED_FIFO是允许被高优先级抢占的，也就是有高优先级的必须先运行。SCHED_RR是设置一个时间片。当有SCHED_FIFO或SCHED_RR策赂的线程在一个条件变量上等持或等持加锁同一个互斥量时，它们将以优先级顺序被唤醒。即，如果一个低优先级的SCHED_FIFO线程和一个高优先级的SCHED_FIFO线程都在等待锁相同的互斥量，则当互斥量被解锁时，高优先级线程将总是被首先解除阻塞。
说 明：设置线程的调度策略
19、设置线程的调度参数
int pthread_attr_setschedparam(pthread_attr_t *attr, const struct sched_param *param);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
param 返回获取的调度参数，该结构仅有一个从参数，如下
struct sched_param
{
int sched_priority; /* Scheduling priority */
};
说 明：设置线程的调度参数
20、获取线程的调度参数
int pthread_attr_getschedparam(pthread_attr_t *attr, struct sched_param *param);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
param 要设置的调度参数
说 明：获取线程的调度参数
21、获取线程是否继承调度属性
int pthread_attr_getinheritsched(pthread_attr_t *attr, int *inheritsched);
返回值：若是成功返回0,否则返回错误的编号
形 参：attr 指向一个线程属性的指针
guardsize 获取线程是否继承调度属性
PTHREAD_INHERIT_SCHED：调度属性将继承于正创建的线程，attr中的设置将被忽略
PTHREAD_EXPLICIT_SCHED 调度属性将被设置为attr中指定的属性值
说 明：获取线程是否继承调度属性注意：当在属性对象中设置调度策略或优先级时，必须同时设置inheritsched属性（即继承属性设置为：PTHREAD_EXPLICIT_SCHED）。
