sigaction() - Unix 和 Linux 系统调用

名称

语法

int sigaction(int signum, const struct sigaction *act, struct sigaction *oldact);

描述

signum 指定信号，可以是任何有效的信号，除了 SIGKILL 和 SIGSTOP。

如果 act 非空，则从 act 安装信号 signum 的新操作。如果 oldact 非空，则将先前操作保存到 oldact 中。

sigaction 结构定义如下

struct sigaction {
    void (*sa_handler)(int);
    void (*sa_sigaction)(int, siginfo_t *, void *);
    sigset_t sa_mask;
    int sa_flags;
    void (*sa_restorer)(void);
}

在某些体系结构上，涉及联合体：不要同时为 sa_handler 和 sa_sigaction 赋值。

sa_restorer 元素已过时，不应使用。POSIX 未指定 sa_restorer 元素。

sa_handler 指定要与 signum 关联的操作，可以是 SIG_DFL（默认操作），SIG_IGN（忽略此信号），或者是指向信号处理函数的指针。此函数接收信号编号作为其唯一参数。

如果在 sa_flags 中指定了 SA_SIGINFO，则 sa_sigaction（而不是 sa_handler）指定 signum 的信号处理函数。此函数接收信号编号作为其第一个参数，指向 siginfo_t 的指针作为其第二个参数，以及指向 ucontext_t（强制转换为 void *）的指针作为其第三个参数。

sa_mask 给出一个信号掩码，这些信号应在执行信号处理程序期间被阻塞。此外，触发处理程序的信号将被阻塞，除非使用了 SA_NODEFER 标志。

sa_flags 指定一组标志，这些标志修改信号处理过程的行为。它由以下零个或多个标志的按位或组成

sa_sigaction 的 siginfo_t 参数是一个具有以下元素的结构

siginfo_t {
    int      si_signo;  /* Signal number */
    int      si_errno;  /* An errno value */
    int      si_code;   /* Signal code */
    pid_t    si_pid;    /* Sending process ID */
    uid_t    si_uid;    /* Real user ID of sending process */
    int      si_status; /* Exit value or signal */
    clock_t  si_utime;  /* User time consumed */
    clock_t  si_stime;  /* System time consumed */
    sigval_t si_value;  /* Signal value */
    int      si_int;    /* POSIX.1b signal */
    void *   si_ptr;    /* POSIX.1b signal */
    void *   si_addr;   /* Memory location which caused fault */
    int      si_band;   /* Band event */
    int      si_fd;     /* File descriptor */
}

si_signo、si_errno 和 si_code 对所有信号都已定义。（si_signo 在 Linux 上未使用。）结构的其余部分可能是一个联合体，因此只能读取对给定信号有意义的字段。POSIX.1b 信号和 SIGCHLD 将填充 si_pid 和 si_uid。SIGCHLD 还填充 si_status、si_utime 和 si_stime。si_int 和 si_ptr 由 POSIX.1b 信号的发件人指定。SIGILL、SIGFPE、SIGSEGV 和 SIGBUS 将 si_addr 填充为错误地址。SIGPOLL 填充 si_band 和 si_fd。

si_code 指示发送此信号的原因。它是一个值，而不是一个位掩码。任何信号可能出现的值在此表中列出

返回值

错误

备注

根据 POSIX，进程在忽略了未由 kill() 或 raise() 生成的 SIGFPE、SIGILL 或 SIGSEGV 信号后的行为未定义。整数除以零的结果未定义。在某些体系结构上，它会生成 SIGFPE 信号。（同样，将最负整数除以 -1 也可能生成 SIGFPE。）忽略此信号可能导致无限循环。

POSIX.1-1990 不允许将 SIGCHLD 的操作设置为 SIG_IGN。POSIX.1-2001 允许这种可能性，以便可以忽略 SIGCHLD 以防止创建僵尸进程（参见 wait(2)）。然而，忽略 SIGCHLD 的历史 BSD 和 System V 行为有所不同，因此确保终止的子进程不成为僵尸进程的唯一完全可移植的方法是捕获 SIGCHLD 信号并执行 wait(2) 或类似操作。

POSIX.1-1990 仅指定了 SA_NOCLDSTOP。POSIX.1-2001 添加了 SA_NOCLDWAIT、SA_RESETHAND、SA_NODEFER 和 SA_SIGINFO。在打算用于较旧 Unix 实现的应用程序中，使用 sa_flags 中的这些后几个值的可移植性可能较差。

Linux 2.2 中添加了对 SA_SIGINFO 的支持。

SA_RESETHAND 标志与同名的 SVr4 标志兼容。

SA_NODEFER 标志在内核 1.3.9 及更高版本下与同名的 SVr4 标志兼容。在较旧的内核上，Linux 实现允许接收任何信号，而不仅仅是我们正在安装的信号（有效地覆盖了任何 sa_mask 设置）。

sigaction() 可以使用空第二个参数调用以查询当前信号处理程序。它还可以通过使用空第二个和第三个参数调用它来检查给定信号对于当前机器是否有效。

无法阻止 SIGKILL 或 SIGSTOP（通过在 sa_mask 中指定它们）。对此类尝试会静默忽略。

有关操作信号集的详细信息，请参见 sigsetops(3)。

错误

符合标准

未公开文档

参见

• kill (1)

• kill (2)

• pause (2)

• sigaltstack (2)

• signal (2)

• sigpending (2)

• sigprocmask (2)

• sigqueue (2)

• sigsuspend (2)

• wait (2)