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)