> 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/man9/signal.9.md). # signal.9 `signal` — 内核信号函数 ## 名称 `signal`, `SIGADDSET`, `SIGDELSET`, `SETEMPTYSET`, `SIGFILLSET`, `SIGISMEMBER`, `SIGISEMPTY`, `SIGNOTEMPTY`, `SIGSETEQ`, `SIGSETNEQ`, `SIGSETOR`, `SIGSETAND`, `SIGSETNAND`, `SIGSETCANTMASK`, `SIG_STOPSIGMASK`, `SIG_CONTSIGMASK`, `SIGPENDING`, `cursig`, `execsigs`, `issignal`, `killproc`, `pgsigio`, `postsig`, `sigexit`, `siginit`, `signotify`, `trapsignal` ## 概要 `#include ` `#include ` `#include ` `Ft void Fn SIGADDSET sigset_t set int signo Ft void Fn SIGDELSET sigset_t set int signo Ft void Fn SIGEMPTYSET sigset_t set Ft void Fn SIGFILLSET sigset_t set Ft int Fn SIGISMEMBER sigset_t set int signo Ft int Fn SIGISEMPTY sigset_t set Ft int Fn SIGNOTEMPTY sigset_t set Ft int Fn SIGSETEQ sigset_t set1 sigset_t set2 Ft int Fn SIGSETNEQ sigset_t set1 sigset_t set2 Ft void Fn SIGSETOR sigset_t set1 sigset_t set2 Ft void Fn SIGSETAND sigset_t set1 sigset_t set2 Ft void Fn SIGSETNAND sigset_t set1 sigset_t set2 Ft void Fn SIG_CANTMASK sigset_t set Ft void Fn SIG_STOPSIGMASK sigset_t set Ft void Fn SIG_CONTSIGMASK sigset_t set Ft int Fn SIGPENDING struct proc *p Ft int Fn cursig struct thread *td Ft void Fn execsigs struct proc *p Ft int Fn issignal struct thread *td Ft void Fn killproc struct proc *p char *why Ft void Fn pgsigio struct sigio **sigiop int sig int checkctty Ft void Fn postsig int sig Ft void Fn sigexit struct thread *td int signum Ft void Fn siginit struct proc *p Ft void Fn signotify struct thread *td Ft void Fn trapsignal struct thread *td int sig u_long code` ## 描述 `SIGADDSET` 宏将 `signo` 添加到 `set` 中。不确保 `signo` 是有效的信号编号。 `SIGDELSET` 宏从 `set` 中删除 `signo`。不确保 `signo` 是有效的信号编号。 `SIGEMPTYSET` 宏清除 `set` 中的所有信号。 `SIGFILLSET` 宏设置 `set` 中的所有信号。 `SIGISMEMBER` 宏确定 `signo` 是否在 `set` 中设置。 `SIGISEMPTY` 宏确定 `set` 是否未设置任何信号。 `SIGNOTEMPTY` 宏确定 `set` 是否设置了任何信号。 `SIGSETEQ` 宏确定两个信号集是否相等；即两者中设置了相同的信号。 `SIGSETNEQ` 宏确定两个信号集是否不同；即如果一个信号集中设置的信号在另一个信号集中未设置。 `SIGSETOR` 宏将 `set2` 中设置的信号或运算到 `set1` 中。 `SIGSETAND` 宏将 `set2` 中设置的信号与运算到 `set1` 中。 `SIGSETNAND` 宏将 `set2` 中设置的信号与非运算到 `set1` 中。 `SIG_CANTMASK` 宏从 `set` 中清除 `SIGKILL` 和 `SIGSTOP` 信号。这两个信号不能被阻塞或捕获，在操作信号的代码中使用 `SIG_CANTMASK` 来确保此策略得到执行。 `SIG_STOPSIGMASK` 宏从 `set` 中清除 `SIGSTOP`、`SIGTSTP`、`SIGTTIN` 和 `SIGTTOU` 信号。当进程等待子进程退出或执行 exec 时，以及进程在被挂起后继续时，使用 `SIG_STOPSIGMASK` 清除停止信号。 `SIG_CONTSIGMASK` 宏从 `set` 中清除 `SIGCONT` 信号。当进程被停止时调用 `SIG_CONTSIGMASK`。 `SIGPENDING` 宏确定给定进程是否有任何未屏蔽的挂起信号。如果进程有挂起信号且进程当前正在被跟踪，即使该信号被屏蔽，`SIGPENDING` 也将返回 true。 `cursig` 函数返回应该传递给进程 `td->td_proc` 的信号编号。如果没有挂起的信号，则返回零。 `execsigs` 函数重置进程的信号集和信号栈，为 execve(2) 做准备。在调用 `execsigs` 之前必须持有 `p` 的进程锁。 `issignal` 函数确定进程 `td->td_proc` 是否有任何应该被捕获的挂起信号，或导致此进程终止或中断其当前系统调用的挂起信号。如果进程 `td->td_proc` 当前正在被跟踪，被忽略的信号将被处理，并且进程始终被停止。停止信号由 `issignal` 立即处理并清除，除非进程是孤儿进程组的成员且停止信号源自 TTY。可能会获取和释放 `td->td_proc` 的进程自旋锁。在调用 `issignal` 之前必须锁定 `sigacts` 结构 `td->td_proc->p_sigacts`，并且可能在调用期间释放并重新获取。在调用 `issignal` 之前必须获取 `td->td_proc` 的进程锁，并且可能在调用期间释放并重新获取。系统进程和 init 不采取默认信号操作。 `killproc` 函数向 `p` 传递 `SIGKILL`。`why` 被记录为进程被杀死的原因。 `pgsigio` 函数向进程或进程组 `sigiop->sio_pgid` 发送信号 `sig`。如果 `checkctty` 为非零，则信号仅传递给进程组中具有控制终端的进程。如果 `sigiop->sio_pgid` 用于进程（> 0），则获取和释放 `sigiop->sio_proc` 的锁。如果 `sigiop->sio_pgid` 用于进程组（< 0），则获取和释放 `sigiop->sio_pgrp` 的进程组锁。获取和释放 `sigio_lock` 锁。 `postsig` 函数处理信号 `sig` 的实际传递。在内核被通知应传递信号（通过调用 `signotify`，这会设置标志 `PS_NEEDSIGCHK`）后，从 `ast` 调用 `postsig`。在调用 `postsig` 之前必须持有拥有 `curthread` 的进程的进程锁，且当前进程不能为 0。在调用 `postsig` 之前必须持有当前进程的 `p_sigacts` 字段的锁，并且可能释放并重新获取。 `sigexit` 函数使拥有 `td` 的进程以信号编号 `sig` 的返回值退出。如果需要，进程将转储核心。在调用 `sigexit` 之前必须持有拥有 `td` 的进程的进程锁。 `siginit` 函数在系统初始化期间被调用，使每个具有默认属性 `SA_IGNORE` 的信号（除 `SIGCONT` 外）被 `p` 忽略。获取和释放 `p` 的进程锁，以及 sigacts 结构 `p->p_sigacts` 的锁。`siginit` 曾经被调用的唯一进程是 `proc0`。 `signotify` 函数标记有未屏蔽的挂起信号应该由 `ast` 处理。在调用 `signotify` 之前必须持有进程 `td->td_proc` 的进程锁，并且获取和释放线程锁。 `trapsignal` 函数向进程 `td->td_proc` 发送作为陷阱结果的信号。如果进程未被跟踪且信号可以立即传递，`trapsignal` 将直接传递；否则，`trapsignal` 将调用 [psignal(9)](/man/man9/psignal.9.md) 来传递信号。获取和释放 `td->td_proc` 的进程锁。获取和释放 `td->td_proc` 的 `p_sigacts` 字段的锁。 ## 返回值 `SIGISMEMBER`、`SIGISEMPTY`、`SIGNOTEMPTY`、`SIGSETEQ`、`SIGSETNEQ` 和 `SIGPENDING` 宏在检查的条件为真时都返回非零（true）；否则返回零（false）。 `cursig` 函数返回有效信号编号或零。 `issignal` 返回有效信号编号或零。 ## 参见 pgsignal(9), [psignal(9)](/man/man9/psignal.9.md) ## 作者 本手册页由 Chad David 编写。 --- # 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/man9/signal.9.md?ask=&goal= ``` `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.