> 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_create.3.md).

# pthread\_create.3

`pthread_create` — 创建新线程

## 名称

`pthread_create`

## 库

libpthread

## 概要

```c
#include <pthread.h>

int
pthread_create(pthread_t *restrict thread,
    const pthread_attr_t *restrict attr,
    void *(*start_routine)(void *), void *restrict arg);
```

## 描述

`pthread_create` 函数用于在一个进程中创建一个新线程，其属性由 `attr` 指定。如果 `attr` 为 `NULL`，则使用默认属性。如果 `attr` 指定的属性随后被修改，已创建线程的属性不受影响。成功完成后，`pthread_create` 会将所创建线程的 ID 存入 `thread` 所指定的位置。

新线程创建后即开始执行 `start_routine`，并以 `arg` 作为其唯一参数。如果 `start_routine` 返回，其效果等同于以 `start_routine` 的返回值作为退出状态隐式调用 `pthread_exit`。注意，最初调用 `main` 的线程与此不同：当它从 `main` 返回时，其效果等同于以 `main` 的返回值作为退出状态隐式调用 `exit`。

新线程的信号状态初始化如下：

* 信号掩码从创建线程继承。
* 新线程的待处理信号集为空。

## 返回值

如果成功，`pthread_create` 函数将返回零；否则将返回一个错误号以指示错误。

## 错误

`pthread_create` 函数可能返回以下任何错误：

**`[ENOMEM]`** 系统缺乏必要的资源来创建另一个线程。

**`[EAGAIN]`** 将超出系统对单个进程中线程总数的限制 `[PTHREAD_THREADS_MAX]`。

**`[EAGAIN]`** 将超出 `RACCT_NTHR` 限制；参见 racct(2)。

**`[EPERM]`** 调用者没有权限设置调度参数或调度策略。

**`[EINVAL]`** 由 `attr` 指定的值无效。

**`[EDEADLK]`** 由 `attr` 指定的 CPU 集合将导致该线程无法在任何 CPU 上运行。

**`[EFAULT]`** 由 `attr` 指定的栈基址无效，或内核无法将所需的初始数据放入栈中。

## 参见

cpuset\_setaffinity(2), fork(2), racct(2), thr\_new(2), [pthread\_attr(3)](/man/pthread/pthread_attr.3.md), [pthread\_cancel(3)](/man/pthread/pthread_cancel.3.md), [pthread\_cleanup\_pop(3)](/man/pthread/pthread_cleanup_pop.3.md), [pthread\_cleanup\_push(3)](/man/pthread/pthread_cleanup_push.3.md), [pthread\_exit(3)](/man/pthread/pthread_exit.3.md), [pthread\_join(3)](/man/pthread/pthread_join.3.md)

## 标准

`pthread_create` 函数符合 ISO/IEC 9945-1:1996 ("POSIX.1") 规范。


---

# 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_create.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.