linux手册翻译——pthread_setname_np(3)

pthread_setname_np, pthread_getname_np ：设置/获取线程的名称

#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);

编译和链接需要参数 ： -pthread

默认情况下，所有使用 pthread_create() 创建的线程都继承程序名称。 pthread_setname_np() 函数可用于为线程设置唯一名称，这对于调试多线程应用程序非常有用。 线程名称是一个有意义的 C 语言字符串，包括终止空字节 ('\0')在内，其长度限制为 16 个字符。 thread 参数指定要更改名称的线程； name 指定新名称。
pthread_getname_np() 函数可用于获取线程的名称。 thread 参数指定线程。 缓冲区name用于存放返回的线程名称； len 指定缓冲区的可用字节数。 区长度至少应为 16 个字符。 输出缓冲区中返回的线程名称将以空 ('\0')终止。

成功时，这些函数返回 0； 出错时，它们返回一个非零错误号。

pthread_setname_np() 函数可能会失败并出现以下错误：
ERANGE name 指定的字符串长度超过了允许的限制。

pthread_setname_np() 函数可能会失败并出现以下错误：
ERANGE name 和 len 指定的缓冲区太小，无法容纳线程名称。

如果这些函数中的任何一个无法打开 /proc/self/task/[tid]/comm，则调用可能会失败并出现 open(2) 中描述的错误之一。(见NOTES)

从实现上讲，pthread_setname_np()将线程的名称写入到了/proc FS的comm文件:/proc/self/task/[tid]/comm.
pthread_getname_np()则是从相同的位置获取线程名