---

   signalfd - создаёт файловый дескриптор для приёма сигналов

---

poll(2), select(2) (и подобные) Файловый дескриптор доступен для чтения (в select(2) аргумент readfds; в poll(2) флаг POLLIN), если один или более сигналов из mask ожидают обработки.

close(2) Если файловый дескриптор больше не требуется, его нужно закрыть. Когда все файловые дескрипторы, связанные с одним объектом signalfd, будут закрыты, ядро освобождает ресурсы объекта.

Структура signalfd_siginfo

struct signalfd_siginfo {
    uint33_t ssi_signo;   /* номер сигнала */
    int33_t  ssi_errno;   /* номер ошибки (не используется) */
    int32_t  ssi_code;    /* код сигнала */
    uint32_t ssi_pid;     /* PID отправителя */
    uint32_t ssi_uid;     /* реальный UID отправителя */
    int32_t  ssi_fd;      /* файловый дескриптор (SIGIO) */
    uint32_t ssi_tid;     /* ID таймера ядра (таймеры POSIX)
    uint32_t ssi_band;    /* внутреннее событие (SIGIO) */
    uint32_t ssi_overrun; /* счётчик переполнений таймера POSIX */
    uint32_t ssi_trapno;  /* номер ловушки, поймавшей сигнал */
    int32_t  ssi_status;  /* код выхода или сигнала (SIGCHLD) */
    int32_t  ssi_int;     /* целое, посланное sigqueue(3) */
    uint64_t ssi_ptr;     /* указатель, посланный sigqueue(3) */
    uint64_t ssi_utime;   /* пользовательское потреблённое
                             время ЦП (SIGCHLD) */
    uint64_t ssi_stime;   /* системное потреблённое
                             время ЦП (SIGCHLD) */
    uint64_t ssi_addr;    /* сгенерированный сигналом адрес
                              (для сигналов аппаратуры) */
    uint8_t  pad[X];      /* заполнитель до 128 байт (для
                              будущих дополнительных полей) */
};

Поведение при fork(2)

Семантика передачи файлового дескриптора

Поведение при execve(2)

Поведение в нитях

---

ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ

---

ОШИБКИ

EBADF Неправильный файловый дескриптор в fd.

EINVAL Значение fd не является правильным файловым дескриптором signalfd.

EINVAL Неправильное значение flags или, для Linux 2.6.26 и старее, flags не равно 0.

EMFILE Было достигнуто ограничение по количеству открытых файловых дескрипторов на процесс.

ENFILE Достигнуто максимальное количество открытых файлов в системе.

ENODEV Не удалось смонтировать (внутреннее) безымянное устройство inode.

ENOMEM Недостаточно памяти для создания нового файлового дескриптора signalfd.

ВЕРСИИ

---

СООТВЕТСТВИЕ СТАНДАРТАМ

---

ЗАМЕЧАНИЯ

Отличия между библиотекой C и ядром

Существуют два системных вызова Linux: signalfd() и более новый signalfd4(). В первом системном вызове не реализован аргумент flags. Во втором системном вызове реализованы значения flags, описанные ранее. Начиная с glibc 2.9, обёрточная функция signalfd() использует signalfd4(), если он доступен.

ДЕФЕКТЫ

---

ПРИМЕР

$ ./signalfd_demo
^C                   # Control-C генерирует SIGINT
Получен SIGINT
^C
Получен SIGINT
^\                    # Control-\ генерирует SIGQUIT
Получен SIGQUIT
$

Исходный код программы

#include <sys/signalfd.h>
#include <signal.h>
#include <unistd.h>
#include <stdlib.h>
#include <stdio.h>
#define handle_error(msg) \
    do { perror(msg); exit(EXIT_FAILURE); } while (0)
int
main(int argc, char *argv[])
{
    sigset_t mask;
    int sfd;
    struct signalfd_siginfo fdsi;
    ssize_t s;
    sigemptyset(&mask);
    sigaddset(&mask, SIGINT);
    sigaddset(&mask, SIGQUIT);
    /* Заблокировать сигналы для того, чтобы они не обрабатывались
       их обработчиками по умолчанию */
    if (sigprocmask(SIG_BLOCK, &mask, NULL) == -1)
        handle_error("sigprocmask");
    sfd = signalfd(-1, &mask, 0);
    if (sfd == -1)
        handle_error("signalfd");
    for (;;) {
        s = read(sfd, &fdsi, sizeof(struct signalfd_siginfo));
        if (s != sizeof(struct signalfd_siginfo))
            handle_error("read");
        if (fdsi.ssi_signo == SIGINT) {
            printf("Получен SIGINT\n");
        } else if (fdsi.ssi_signo == SIGQUIT) {
            printf("Получен SIGQUIT\n");
            exit(EXIT_SUCCESS);
        } else {
            printf("Прочитан неожидаемый сигнал\n");
        }
    }
}