Manpages

Semantics of file descriptor passing
As with other file descriptors, signalfd file descriptors can be passed to another process via a UNIX domain socket (see unix(7)). In the receiving process, a read(2) from the received file descriptor will return information about signals queued to that process.

Sémantique de execve(2)
Comme tout descripteur de fichier, un descripteur de fichier signalfd reste ouvert au travers d’un execve(2), à moins qu’il ait été marqué comme « close-on-exec » (consultez fcntl(2)). Tout signal qui était disponible en lecture avant un execve(2) reste disponible pour le nouveau programme. (C’est analogue à la sémantique traditionnelle des signaux, pour laquelle un signal bloqué qui est en attente reste en attente au travers d’un execve(2))

epoll(7) semantics
If a process adds (via epoll_ctl(2)) a signalfd file descriptor to an epoll(7) instance, then epoll_wait(2) returns events only for signals sent to that process. In particular, if the process then uses fork(2) to create a child process, then the child will be able to read(2) signals that are sent to it using the signalfd file descriptor, but epoll_wait(2) will not indicate that the signalfd file descriptor is ready. In this scenario, a possible workaround is that after the fork(2), the child process can close the signalfd file descriptor that it inherited from the parent process and then create another signalfd file descriptor and add it to the epoll instance. Alternatively, the parent and the child could delay creating their (separate) signalfd file descriptors and adding them to the epoll instance until after the call to fork(2).

VALEUR RENVOYÉE

S’il réussit, signalfd() renvoie un descripteur de fichier signalfd ; il s’agit soit d’un nouveau descripteur de fichier (si fd valait -1), ou fd si fd était un descripteur de fichier signalfd valable. En cas d’erreur, il renvoie -1 et errno contient le code d’erreur.

ERREURS

VERSIONS

signalfd() est disponible sous Linux depuis le noyau 2.6.22. La glibc le gère depuis la version 2.8. L’appel système signalfd4() (voir NOTES) est disponible sous Linux depuis le noyau 2.6.27.

CONFORMITÉ

signalfd() et signalfd4() sont spécifiques à Linux.

NOTES

A process can create multiple signalfd file descriptors. This makes it possible to accept different signals on different file descriptors. (This may be useful if monitoring the file descriptors using select(2), poll(2), or epoll(7): the arrival of different signals will make different file descriptors ready.) If a signal appears in the mask of more than one of the file descriptors, then occurrences of that signal can be read (once) from any one of the file descriptors.

Attempts to include SIGKILL and SIGSTOP in mask are silently ignored.

The signal mask employed by a signalfd file descriptor can be viewed via the entry for the corresponding file descriptor in the process’s /proc/[pid]/fdinfo directory. See proc(5) for further details.

Limitations
The signalfd mechanism can’t be used to receive signals that are synchronously generated, such as the SIGSEGV signal that results from accessing an invalid memory address or the SIGFPE signal that results from an arithmetic error. Such signals can be caught only via signal handler.

As described above, in normal usage one blocks the signals that will be accepted via signalfd(). If spawning a child process to execute a helper program (that does not need the signalfd file descriptor), then, after the call to fork(2), you will normally want to unblock those signals before calling execve(2), so that the helper program can see any signals that it expects to see. Be aware, however, that this won’t be possible in the case of a helper program spawned behind the scenes by any library function that the program may call. In such cases, one must fall back to using a traditional signal handler that writes to a file descriptor monitored by select(2), poll(2), or epoll(7).

différences entre bibliothèque C et noyau
L’appel système Linux sous-jacent nécessite un paramètre supplémentaire, size_t sizemask, qui spécifie la taille du paramètre mask. La fonction enveloppe signalfd() de la glibc n’a pas ce paramètre, puisqu’elle fournit ce paramètre à l’appel système sous-jacent.

Il y a deux appels système sous-jacent : signalfd() et signalfd4(), qui est plus récent. Le premier appel système n’implémente pas de paramètre flags. Le dernier appel système implémente les valeurs de flags décrites ci-dessous. À partir de la glibc 2.9, la fonction enveloppe signalfd() utilisera signalfd4() quand il est disponible.

BOGUES

Dans les noyaux antérieurs à 2.6.25, les champs ssi_ptr et ssi_int n’étaient pas renseignés avec les données accompagnant un signal envoyé par sigqueue(3).

EXEMPLES

Le programme ci-dessous accèpte les signaux SIGINT et SIGQUIT en utilisant un descripteur de fichier signalfd. Le programme se termine après avoir accepté le signal SIGQUIT. La session shell suivante montre l’utilisation du programme :

$ ./signalfd_demo
^C # Contrôle-C génère un SIGINT
Got SIGINT
^C

Got SIGINT
^\                    # Contrôle-\ génère un SIGQUIT
Got SIGQUIT
$

Source du programme

#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);

    /* Bloquer les signaux pour qu’il ne soit plus géré
       par les gestionnaires par défaut */

    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("Got SIGINT\n");
        } else if (fdsi.ssi_signo == SIGQUIT) {
            printf("Got SIGQUIT\n");
            exit(EXIT_SUCCESS);
        } else {
            printf("Read unexpected signal\n");
        }
    }
}

VOIR AUSSI

eventfd(2), poll(2), read(2), select(2), sigaction(2), sigprocmask(2), sigwaitinfo(2), timerfd_create(2), sigsetops(3), sigwait(3), epoll(7), signal(7)

COLOPHON

Cette page fait partie de la publication 5.07 du projet man-pages Linux. Une description du projet et des instructions pour signaler des anomalies et la dernière version de cette page, peuvent être trouvées à l’adresse https://www.kernel.org/doc/man-pages/.

TRADUCTION

La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>;, Stéphan Rafin <stephan.rafin [AT] laposte.net>, Thierry Vignaud <tvignaud [AT] mandriva.com>, François Micaux, Alain Portal <aportal [AT] univ-montp2.fr>, Jean-Philippe Guérard <fevrier [AT] tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon [AT] wanadoo.fr>, Julien Cristau <jcristau [AT] debian.org>, Thomas Huriaux <thomas.huriaux [AT] gmail.com>, Nicolas François <nicolas.francois [AT] centraliens.net>, Florentin Duneau <fduneau [AT] gmail.com>, Simon Paillard <simon.paillard [AT] resel.fr>, Denis Barbier <barbier [AT] debian.org>, David Prévot <david [AT] tilapin.org>, Cédric Boutillier <cedric.boutillier [AT] gmail.com> et Frédéric Hantrais <fhantrais [AT] gmail.com>

Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n’y a aucune RESPONSABILITÉ LÉGALE.

Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à <debian-l10n-french [AT] lists.org>.