> 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/compat-43/sigvec.2.md).

# sigvec.2

`sigvec` — 软件信号设施

## 名称

`sigvec`

## 库

Lb libc

## 概要

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

```c
struct sigvec {
	void     (*sv_handler)();
	int      sv_mask;
	int      sv_flags;
};
```

```c
int
sigvec(int sig, struct sigvec *vec, struct sigvec *ovec)
```

## 描述

**此接口由 sigaction(2) 取代。**

系统定义了一组可传递给进程的信号。信号传递类似于硬件中断的发生：信号被阻止再次发生，保存当前进程上下文，并构建新的上下文。进程可以指定一个*处理程序*来接收信号，或指定信号被*屏蔽*或*忽略*。进程还可以指定信号发生时系统采取的默认动作。通常，信号处理程序在进程的当前栈上执行。可以按每个处理程序更改此设置，使信号在特殊的*信号栈*上处理。

所有信号具有相同的*优先级*。信号例程执行时，导致其调用的信号被*屏蔽*，但其他信号仍可能发生。全局*信号掩码*定义了当前阻止传递给进程的信号集。进程的信号掩码从其父进程初始化（通常为 0）。可以通过 sigblock(2) 或 [sigsetmask(2)](/man/compat-43/sigsetmask.2.md) 调用更改，也可以在信号传递给进程时更改。

当进程出现信号条件时，该信号被添加到进程的待处理信号集中。如果该信号当前未被进程*屏蔽*，则将其传递给进程。信号传递时，保存进程的当前状态，计算新的信号掩码（如下所述），并调用信号处理程序。处理程序的调用方式使得如果信号处理例程正常返回，进程将在信号传递之前的上下文中恢复执行。如果进程希望在不同的上下文中恢复，则必须自行安排恢复先前的上下文。

当信号传递给进程时，在进程信号处理程序执行期间（或直到调用 sigblock(2) 或 [sigsetmask(2)](/man/compat-43/sigsetmask.2.md)）安装新的信号掩码。此掩码由当前信号掩码、添加要传递的信号、以及与要调用的处理程序关联的信号掩码进行*或*运算形成。

`sigvec` 函数为特定信号分配处理程序。如果 `vec` 非零，它指定传递指定信号时使用的处理程序例程和掩码。此外，如果 `sv_flags` 中设置了 `SV_ONSTACK` 位，系统将在由 sigaltstack(2) 指定的*信号栈*上向进程传递信号。如果 `ovec` 非零，信号之前的处理信息将返回给用户。

以下是所有信号的列表，名称与头文件 `<signal.h>` 中的定义一致：

| **名称**      | **默认动作** | **描述**                       |
| ----------- | -------- | ---------------------------- |
| `SIGHUP`    | 终止进程     | 终端线路挂起                       |
| `SIGINT`    | 终止进程     | 中断程序                         |
| `SIGQUIT`   | 创建核心映像   | 退出程序                         |
| `SIGILL`    | 创建核心映像   | 非法指令                         |
| `SIGTRAP`   | 创建核心映像   | 跟踪陷阱                         |
| `SIGABRT`   | 创建核心映像   | abort(3)（原为 `SIGIOT`）        |
| `SIGEMT`    | 创建核心映像   | 仿真指令执行                       |
| `SIGFPE`    | 创建核心映像   | 浮点异常                         |
| `SIGKILL`   | 终止进程     | 终止程序                         |
| `SIGBUS`    | 创建核心映像   | 总线错误                         |
| `SIGSEGV`   | 创建核心映像   | 段违规                          |
| `SIGSYS`    | 创建核心映像   | 调用不存在的系统调用                   |
| `SIGPIPE`   | 终止进程     | 向无读取者的管道写入                   |
| `SIGALRM`   | 终止进程     | 实时定时器超时                      |
| `SIGTERM`   | 终止进程     | 软件终止信号                       |
| `SIGURG`    | 丢弃信号     | 套接字上出现紧急条件                   |
| `SIGSTOP`   | 停止进程     | 停止（无法捕获或忽略）                  |
| `SIGTSTP`   | 停止进程     | 来自键盘的停止信号                    |
| `SIGCONT`   | 丢弃信号     | 停止后继续                        |
| `SIGCHLD`   | 丢弃信号     | 子进程状态改变                      |
| `SIGTTIN`   | 停止进程     | 后台尝试从控制终端读取                  |
| `SIGTTOU`   | 停止进程     | 后台尝试向控制终端写入                  |
| `SIGIO`     | 丢弃信号     | 可能在描述符上进行 I/O（参见 fcntl(2)）   |
| `SIGXCPU`   | 终止进程     | 超过 CPU 时间限制（参见 setrlimit(2)） |
| `SIGXFSZ`   | 终止进程     | 超过文件大小限制（参见 setrlimit(2)）    |
| `SIGVTALRM` | 终止进程     | 虚拟时间闹钟（参见 setitimer(2)）      |
| `SIGPROF`   | 终止进程     | 概要分析定时器闹钟（参见 setitimer(2)）   |
| `SIGWINCH`  | 丢弃信号     | 窗口大小改变                       |
| `SIGINFO`   | 丢弃信号     | 来自键盘的状态请求                    |
| `SIGUSR1`   | 终止进程     | 用户定义信号 1                     |
| `SIGUSR2`   | 终止进程     | 用户定义信号 2                     |

信号处理程序安装后，将保持安装状态，直到再次调用 `sigvec` 或执行 execve(2)。可以通过将 `sv_handler` 设置为 `SIG_DFL` 来重置特定信号的默认动作。默认动作包括：终止进程（可能伴随核心转储）、无动作、停止进程或继续进程。各信号的默认动作参见上方的信号列表。如果 `sv_handler` 为 `SIG_IGN`，信号的当前和待处理实例将被忽略并丢弃。

如果在以下列出的系统调用期间捕获到信号，调用通常会重启。通过在 `sv_flags` 中设置 `SV_INTERRUPT` 位，可以强制调用以 `EINTR` 错误提前终止。受影响的系统调用包括：在通信通道或慢速设备（如终端，但不包括普通文件）上的 read(2)、write(2)、sendto(2)、recvfrom(2)、sendmsg(2) 和 recvmsg(2)，以及 wait(2) 或 ioctl(2) 期间。但是，已经提交的调用不会重启，而是返回部分成功（例如，较短的读取计数）。

在 fork(2) 或 vfork(2) 之后，所有信号、信号掩码、信号栈以及重启/中断标志都由子进程继承。

execve(2) 系统调用恢复所有被捕获信号的默认动作，并将所有信号重置为在用户栈上捕获。被忽略的信号保持忽略状态；信号掩码保持不变；中断系统调用的信号继续如此。

## 注释

`vec` 中指定的掩码不允许屏蔽 `SIGKILL` 或 `SIGSTOP`。系统会静默处理此事。

`SV_INTERRUPT` 标志在 4.2BSD 中不可用，因此如果需要向后兼容则不应使用。

## 返回值

成功完成时，`sigvec` 函数返回值 0；否则返回值 -1，并设置全局变量 `errno` 以指示错误。

## 实例

在 VAX-11 上，处理程序例程可以声明为：

```c
void handler(sig, code, scp)
int sig, code;
struct sigcontext *scp;
```

其中 `sig` 是信号编号，硬件故障和陷阱按如下定义映射到信号编号。`code` 参数是下方给出的常量，或者对于兼容模式故障，是硬件提供的代码（兼容模式故障通过在 psl 中设置 `PSL_CM` 来与其他 `SIGILL` 陷阱区分）。`scp` 参数是指向 `sigcontext` 结构（定义在 `<signal.h>` 中）的指针，用于恢复信号之前的上下文。

## 错误

`sigvec` 函数将失败且不安装新的信号处理程序，如果发生以下情况之一：

**\[`EFAULT`]** `vec` 或 `ovec` 指向不属于进程地址空间有效部分的内存。

**\[`EINVAL`]** `sig` 参数不是有效的信号编号。

**\[`EINVAL`]** 试图忽略或为 `SIGKILL` 或 `SIGSTOP` 提供处理程序。

## 参见

[kill(1)](/man/man1/kill.1.md), kill(2), ptrace(2), sigaction(2), sigaltstack(2), sigblock(2), [sigpause(2)](/man/compat-43/sigpause.2.md), sigprocmask(2), [sigsetmask(2)](/man/compat-43/sigsetmask.2.md), sigsuspend(2), setjmp(3), siginterrupt(3), signal(3), sigsetops(3), [tty(4)](/man/man4/tty.4.md)

## 历史

`sigvec` 系统调用首次出现于 4.2BSD。在 4.3BSD 中被重新实现为 sigaction(2) 的包装。

## 缺陷

本手册页仍然令人困惑。


---

# 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/compat-43/sigvec.2.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.