> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/pthread/pthread_np.3.md).

# pthread\_np.3

`pthread_np` — FreeBSD 对 POSIX 线程函数的扩展

## 名称

`pthread_np`

## 库

libpthread

## 概要

```c
#include <pthread_np.h>
```

## 描述

本手册页记录了对 POSIX 线程函数的扩展。这些扩展不一定能移植到其他操作系统。

POSIX 线程函数在本节中按以下分组进行汇总：

* 线程例程
* 属性对象例程
* mutex 例程

### 线程例程

```c
int
pthread_getaffinity_np(pthread_t td, size_t cpusetsize,
    cpuset_t *cpusetp);
```

获取指定线程的 CPU 亲和性。

```c
int
pthread_get_name_np(pthread_t thread, char *name, size_t len);
```

获取指定线程的名称。

```c
int
pthread_getname_np(pthread_t thread, char *name, size_t len);
```

获取指定线程的名称。

```c
int
pthread_getthreadid_np(void);
```

获取调用线程的整数 ID。

```c
int
pthread_main_np(void);
```

标识初始线程。

```c
int
pthread_multi_np(void);
```

将线程的调度模式设置为多线程。

```c
int
pthread_peekjoin_np(pthread_t thread, void **value_ptr);
```

查看指定线程的退出状态。

```c
int
pthread_resume_all_np(void);
```

恢复所有被挂起的线程。

```c
int
pthread_setaffinity_np(pthread_t td, size_t cpusetsize,
    const cpuset_t *cpusetp);
```

设置指定线程的 CPU 亲和性。

```c
int
pthread_set_name_np(pthread_t thread, char *name);
```

设置指定线程的名称。

```c
int
pthread_setname_np(pthread_t thread, char *name);
```

设置指定线程的名称。

```c
void
pthread_signals_block_np(void);
```

快速阻塞所有异步信号。

```c
int
pthread_single_np(void);
```

将线程的调度模式设置为单线程。

```c
int
pthread_suspend_np(pthread_t tid);
```

挂起指定的线程。

```c
int
pthread_suspend_all_np(void);
```

挂起所有活动线程。

```c
int
pthread_timedjoin_np(pthread_t thread, void **value_ptr,
    const struct timespec *abstime);
```

`pthread_join` 的带超时变体。

### 属性对象例程

```c
int
pthread_attr_get_np(pthread_t pid, pthread_attr_t *dst);
```

获取已存在线程的属性。

```c
int
pthread_attr_getaffinity_np(const pthread_attr_t *pattr,
    size_t cpusetsize, cpuset_t *cpusetp);
```

从线程属性对象获取 CPU 亲和性掩码。

```c
int
pthread_attr_setaffinity_np(pthread_attr_t *pattr,
    size_t cpusetsize, const cpuset_t *cpusetp);
```

为线程属性对象设置 CPU 亲和性掩码。

```c
int
pthread_attr_setcreatesuspend_np(pthread_attr_t *attr);
```

允许创建已挂起的线程。

### mutex 例程

```c
int
pthread_mutexattr_getkind_np(pthread_mutexattr_t attr);
```

已弃用，请改用 pthread\_mutexattr\_gettype(3)。

```c
int
pthread_mutexattr_setkind_np(pthread_mutexattr_t *attr);
```

已弃用，请改用 pthread\_mutexattr\_settype(3)。

## 参见

libthr(3), [pthread(3)](/man/pthread/pthread.3.md), [pthread\_affinity\_np(3)](/man/pthread/pthread_affinity_np.3.md), [pthread\_attr\_affinity\_np(3)](/man/pthread/pthread_attr_affinity_np.3.md), [pthread\_attr\_get\_np(3)](/man/pthread/pthread_attr_get_np.3.md), [pthread\_attr\_setcreatesuspend\_np(3)](/man/pthread/pthread_attr_setcreatesuspend_np.3.md), [pthread\_getthreadid\_np(3)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man3/pthread_getthreadid_np.3.md), [pthread\_join(3)](https://github.com/FreeBSD-Ask/freebsd-man-sc/blob/main/man3/pthread_join.3.md), [pthread\_main\_np(3)](/man/pthread/pthread_main_np.3.md), [pthread\_multi\_np(3)](/man/pthread/pthread_multi_np.3.md), [pthread\_mutexattr\_getkind\_np(3)](/man/pthread/pthread_mutexattr_getkind_np.3.md), [pthread\_resume\_all\_np(3)](/man/pthread/pthread_resume_all_np.3.md), [pthread\_resume\_np(3)](/man/pthread/pthread_resume_np.3.md), [pthread\_set\_name\_np(3)](/man/pthread/pthread_set_name_np.3.md), [pthread\_signals\_block\_np(3)](/man/pthread/pthread_signals_block_np.3.md), [pthread\_suspend\_all\_np(3)](/man/pthread/pthread_suspend_all_np.3.md), [pthread\_suspend\_np(3)](/man/pthread/pthread_suspend_np.3.md), pthread\_switch\_add\_np(3)

## 标准

所有这些函数都是对 POSIX 线程的不可移植扩展。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/pthread/pthread_np.3.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.