SIGNAL(7)

NOME
signal - panoramica sui segnali

DESCRIZIONE
Linux supporta sia i segnali POSIX affidabili (d'ora in avanti "segnali standard") che i segnali real-time POSIX.

  Disposizioni dei segnali
Ciascun segnale ha una disposizione attuale, che determina come si comporta il processo quando il segnale viene recapitato. Le voci nella colonna "Azione" della tabella qui sotto specificano la disposizione predefinita di ogni segnale, come segue:

Term
    L'azione predefinita è terminare il processo.

Ign L'azione predefinita è ignorare il segnale.

Core
    L'azione predefinita è terminare il processo ed eseguire un core dump (vedere core(5)).

Stop
    L'azione predefinita è arrestare il processo.

Cont
    L'azione predefinita è far continuare il processo se esso è attualmente fermo.

Un processo può cambiare la disposizione di un segnale usando sigaction(2) o signal(2) (l'ultimo è meno portabile quando si crea un gestore di segnale; si veda signal(2) per i dettagli). Usando queste chiamate di sistema, un processo può assumere uno dei seguenti comportamenti al recapito del segnale: eseguire l'azione predefinita; ignorare il segnale; intercettare il segnale con un gestore di segnale, una funzione definita dal programmatore che è automaticamente invocata quando il segnale è recapitato (il gestore di segnale viene chiamato, in modo predefinito, nel normale stack del processo. È possibile fare in modo che il gestore di segnale usi uno stack alternativo: vedere sigaltstack(2) per una spiegazione su come farlo e quando può essere utile). La disposizione del segnale è un attributo per processo: in un'applicazione multithread, la disposizione di un particolare segnale è la stessa per tutti i thread. Un processo figlio creato tramite fork(2) eredita una copia della disposizione dei segnali del genitore. Durante un execve(2), la disposizione dei segnali gestiti viene inizializzata ai valori predefiniti; la disposizione dei segnali ignorati viene lasciata com'è.

  Inviare un segnale
Le seguenti chiamate di sistema e funzioni di libreria permettono al chiamante di inviare un segnale:

raise(3)
    Invia un segnale al thread chiamante.

kill(2)
    invia un segnale al processo specificato, a tutti i membri del processo di gruppo specificato o a tutti i processi nel sistema.

killpg(2)
    Invia un segnale a tutti i membri del processo di gruppo specificato.

pthread_kill(3)
    Invia un segnale al thread POSIX specificato nello stesso processo del chiamante.

tgkill(2)
    Invia un segnale ad un processo specificato all'interno di un processo ben preciso (è la chiamata di sistema usata per implementare pthread_kill(3)).

sigqueue(3)
    Invia un segnale real-time insieme a dati di accompagnamento al processo specificato.

  Attendere che un segnale venga intercettato
Le seguenti chiamate di sistema sospendono l'esecuzione del processo chiamante o del thread finché non viene intercettato un segnale (o finché un segnale non gestito fa terminare il processo):

pause(2)
    Sospende l'esecuzione finché non viene intercettato un segnale qualunque.

sigsuspend(2)
    Cambia temporaneamente la maschera del segnale (vedere sotto) e sospende l'esecuzione finché viene intercettato uno dei segnali senza maschera.

  Accettare in modo sincrono un segnale
Anziché intercettare un segnale in modo asincrono tramite un gestore di segnale, è possibile accettare il segnale in modo sincrono, cioé bloccare l'esecuzione finché il segnale viene consegnato: a questo punto il kernel restituirà informazioni sul segnale al chiamante. Ci sono in generale due modi per farlo:

*   sigwaitinfo(2), sigtimedwait(2), e sigwait(3) sospendono l'esecuzione finché viene consegnato uno dei segnali contenuti in un insieme specifico. Ognuna di queste chiamate restituisce informazioni sul segnale consegnato.

*   signalfd(2) restituisce un descrittore di file che può essere usato per leggere informazioni sui segnali consegnati al chiamante. Ogni read(2) da questo descrittore di file blocca il chiamante finché uno dei segnali nell'insieme specificato dalla chiamata signalfd(2) viene consegnato al chiamante stesso. Il buffer restituito da read(2) contiene una struttura che descrive il segnale.

  Maschera segnale e segnali pendenti
Un segnale può essere bloccato, cioé non verrà recapitato fino a quando non verrà sbloccato. Un segnale viene definito pendente nel periodo di tempo che passa tra quando è stato generato e quando è recapitato. Ciascun thread in un processo ha una maschera segnale indipendente, che indica l'insieme di segnali che il thread attualmente sta bloccando. Un thread può manipolare la sua maschera segnale usando pthread_sigmask(3). In un'applicazione tradizionale a thread singolo, si può usare sigprocmask(2) per manipolare la maschera segnale. Un processo figlio creato tramite fork(2) eredita una copia della maschera di segnale del processo genitore: la maschera di segnale viene preservata attraverso execve(2). Un segnale può essere generato (e quindi pendente) per un processo nel suo insieme (per esempio quando è inviato usando kill(2)) o per uno specifico thread (per esempio certi segnali, come SIGSEGV e SIGFPE, generati come conseguenza dell'esecuzione di una istruzione specifica in linguaggio macchina sono diretti al thread, come lo sono i segnali indirizzati a uno specifico thread usando pthread_kill(3)). Un segnale diretto al processo può essere recapitato a uno qualunque dei thread che attualmente non hanno il segnale bloccato. Se più di uno dei thread ha il segnale sbloccato, allora il kernel sceglie un thread arbitrario a cui recapitare il segnale. Un thread può ottenere l'insieme di segnali che attualmente ha pendenti usando sigpending(2). Questo insieme consisterà nell'unione dell'insieme dei segnali diretti ai processi pendenti e l'insieme di segnali pendenti per il thread chiamante. L'insieme di segnali pendenti di un processo figlio creato tramite fork(2) inizialmente è vuoto: l'insieme di segnali pendenti è preservato attraverso execve(2).

  Segnali standard
Linux supporta i segnali standard elencati di seguito. Molti numeri di segnale dipendono dall'architettura, come indicato nella colonna "Valore" (dove sono indicati tre valori, il primo è normalmente valido per alpha e sparc, quello in mezzo per x86, arm e la maggior parte delle altre architetture, e l'ultimo per mips (i valori per parisc non vengono mostrati; si vedano i sorgenti del kernel Linux per la numerazione dei segnali su questa architettura). A - denota che un segnale è assente sulla corrispondente architettura). Prima i segnali descritti nello standard POSIX.1-1990 originale.
Segnale | Valore | Azione | Commento
SIGHUP | 1 | Term | La linea sul terminale che ha il controllo è stata
 |  |  | agganciata o il processo che ha il controllo è morto
SIGINT | 2 | Term | Interrupt da tastiera
SIGQUIT | 3 | Core | Segnale d'uscita della tastiera
SIGILL | 4 | Core | Istruzione illegale
SIGABRT | 6 | Core | Segnale d'abbandono di abort(3)
SIGFPE | 8 | Core | Eccezione in virgola mobile
SIGKILL | 9 | Term | Termina il processo
SIGSEGV | 11 | Core | Riferimento di memoria non valido
SIGPIPE | 13 | Term | Pipe rotta: scrittura su una pipe priva di
 |  |  | lettori
SIGALRM | 14 | Term | Segnale del timer da alarm(2)
SIGTERM | 15 | Term | Segnale di termine
SIGUSR1 | 30,10,16 | Term | Segnale 1 definito dall'utente
SIGUSR2 | 31,12,17 | Term | Segnale 2 definito dall'utente
SIGCHLD | 20,17,18 | Ign | Figlio fermato o terminato
SIGCONT | 19,18,25 | Cont | Continua se fermato
SIGSTOP | 17,19,23 | Stop | Ferma il processo
SIGTSTP | 18,20,24 | Stop | Stop digitato dal terminale
SIGTTIN | 21,21,26 | Stop | Input da terminale per un processo sullo sfondo
SIGTTOU | 22,22,27 | Stop | Output da terminale per un processo sullo sfondo
I segnali SIGKILL e SIGSTOP non possono essere intercettati, bloccati o ignorati. Seguono i segnali che non sono nello standard POSIX.1-1990 ma sono descritti in SUSv2 e POSIX.1-2001.
Segnale | Valore | Azione | Commento
SIGBUS | 10,7,10 | Core | Errore sul bus (accesso errato alla memoria)
SIGPOLL |  | Term | Evento suscettibile di polling (Sys V).
 |  |  | Sinonimo di SIGIO
SIGPROF | 27,27,29 | Term | Timer del profiler scaduto
SIGSYS | 12,31,12 | Core | Argomento errato alla routine (SVr4)
SIGTRAP | 5 | Core | Trappola per trace/breakpoint
SIGURG | 16,23,21 | Ign | Condizione urgente sul socket (4.2BSD)
SIGVTALRM | 26,26,28 | Term | Allarme virtuale (4.2BSD)
SIGXCPU | 24,24,30 | Core | Superato tempo limite di CPU (4.2BSD)
SIGXFSZ | 25,25,31 | Core | Limite dimensione file superato (4.2BSD)
Fino a Linux 2.2 incluso, il comportamento predefinito per SIGSYS, SIGXCPU, SIGXFSZ, e (su architetture diverse da SPARC e MIPS) SIGBUS era terminare il processo (senza eseguire un core dump). (In alcuni altri sistemi UNIX l'azione predefinita per SIGXCPU e SIGXFSZ è terminare il processo senza eseguire un core dump.) Linux 2.4 è conforme ai requisiti di POSIX.1-2001 per questi segnali, terminando il processo con un core dump. E ora altri vari segnali.
Segnale | Valore | Azione | Commento
SIGIOT | 6 | Core | Trappola IOT. Sinonimo di SIGABRT
SIGEMT | 7,-,7 | Term
SIGSTKFLT | -,16,- | Term | Errore dello stack del coprocessore (inutilizzato)
SIGIO | 23,29,22 | Term | I/O ora possibile (4.2 BSD)
SIGCLD | -,-,18 | Ign | Sinonimo di SIGCHLD
SIGPWR | 29,30,19 | Term | Mancanza di corrente (System V)
SIGINFO | 29,-,- |  | Sinonimo di SIGPWR
SIGLOST | -,-,- | Term | Perso il lock del file (non usato)
SIGWINCH | 28,28,20 | Ign | Dimensioni finestra cambiate (4.3BSD, Sun)
SIGUNUSED | -,31,- | Core | Sinonimo di SIGSYS)
(Il segnale 29 è SIGINFO / SIGPWR su alpha ma SIGLOST su sparc.) SIGEMT non è specificato in POSIX.1-2001, tuttavia appare in molti altri sistemi UNIX, dove la sua azione predefinita è tipicamente di terminare il processo con un core dump. SIGPWR (non specificato in POSIX.1-2001) è tipicamente ignorato in via predefinita in questi altri UNIX dove appare. SIGIO (non specificato in POSIX.1-2001) è ignorato in via predefinita in molti altri sistemi UNIX. Dove definito, SIGUNUSED è sinonimo di SIGSYS sulla maggior parte delle architetture.

  Segnali Real-time
A partire dalla versione 2.2, Linux supporta i segnali real-time come originariamente definiti nelle estensioni real-time di POSIX.1b (e ora incluse in POSIX.1-2001). L'intervallo di segnali real-time supportati è definito dalle macro SIGRTMIN e SIGRTMAX. POSIX.1-2001 richiede che un'implementazione supporti almeno i segnali real-time _POSIX_RTSIG_MAX(8) .

Il kernel Linux supporta un intervallo di 33 diversi segnali real-time, numerati da 32 a 64. Comunque, l'implementazione di glibc POSIX dei thread usa internamente due (per NTPL) o tre (per LinuxThreads) segnali real-time (vedere pthreads(7)), e sistema il valore di SIGRTMIN in modo adatto (a 34 o 35). Dato che l'intervallo di segnali real-time disponibili varia a seconda dell'implementazione dei thread di glibc (e questa variazione può avvenire al run-time in accordo con kernel e glibc disponibili), e poiché l'intervallo dei segnali real-time varia tra i vari sistemi UNIX, i programmi non dovrebbero mai riferirsi ai segnali real-time usando numeri prefissati. Dovrebbero invece sempre fare riferimento ai segnali real-time usando la notazione SIGRTMIN+n, e includere controlli adatti (run-time) perché SIGRTMIN+n non ecceda SIGRTMAX.

Diversamente dai segnali standard, i segnali real-time non hanno significati predefiniti: l'intero insieme dei segnali real-time può essere usato per scopi definiti dall'applicazione.

L'azione predefinita per i segnali real-time non gestiti è di terminare il processo ricevente.

I segnali real-time si distinguono da quanto segue:

1.  Istanze multiple di segnali real-time possono essere accodate. Viceversa, se istanze multiple di un segnale predefinito sono consegnate mentre questo segnale è bloccato, allora viene accodata solo un'istanza.

2.  Se il segnale è inviato usando sigqueue(3), un valore di accompagnamento (che sia un intero o un puntatore) può essere inviato con il segnale. Se il processo ricevente stabilisce un gestore per questo segnale usando il flag SA_SIGINFO a sigaction(2) allora esso può ottenere questo dato attraverso il campo si_value della struttura siginfo_t passata come secondo argomento al gestore. Inoltre i campi si_pid e si_uid di questa struttura possono essere usati per ottenere PID e ID di un utente reale del processo che invia il segnale.

3.  I segnali real-time sono recapitati in un ordine garantito. I segnali real-time multipli dello stesso tipo sono recapitati nell'ordine in cui vengono inviati. Se segnali real-time diversi sono inviati ad un processo, essi sono consegnati partendo dal segnale con il numero più basso (cioè i segnali con i numeri bassi hanno la priorità maggiore). Al contrario, se segnali standard multipli sono in sospeso per un processo, essi verranno recapitati in un ordine non specificato.

Se sia i segnali predefinit che quelli real-time sono in attesa di un processo, POSIX non specifica quale consegnare per primo. Linux, come molte altre implementazioni, in questo caso dà priorità ai segnali predefiniti.

Conformemente a POSIX, un'implementazione deve permettere che almeno (32) segnali real-time _POSIX_SIGQUEUE_MAX vengano accodati a un processo. Tuttavia Linux fa le cose diversamente. Nei kernel fino a e incluso il 2.6.7, Linux impone un limite globale al numero di segnali real-time accodati per tutti i processi. Questo limite può essere visto e cambiato (con privilegi) attraverso il file /proc/sys/kernel/rtsig-max. Un file correlato, /proc/sys/kernel/rtsig-nr, può essere usato per trovare quanti segnali real-time sono attualmente accodati. In Linux 2.6.8, queste interfacce /proc sono sostituite dal limite di risorsa RLIMIT_SIGPENDING che specifica un limite per utente per i segnali accodati. Vedere setrlimit(2) per ulteriori dettagli. L'aggiunta di segnali real-time ha richiesto l'estensione della struttura del set di segnali (sigset_t) da 32 a 64 bit. Di conseguenza, diverse chiamate di sistema erano superate da nuove chiamate di sistema che supportavano il set di segnali più ampio. Le vecchie e le nuove chiamate di sistema sono appresso elencate:
Linux 2.0 e precedenti | Linux 2.2 e successivi
sigaction(2) | rt_sigaction(2)
sigpending(2) | rt_sigpending(2)
sigprocmask(2) | rt_sigprocmask(2)
sigreturn(2) | rt_sigreturn(2)
sigsuspend(2) | rt_sigsuspend(2)
sigtimedwait(2) | rt_sigtimedwait(2)

  Funzioni async-signal-safe

Una funzione di manipolazione dei segnali deve fare molta attenzione, poiché qualunque processo può essere interrotto in un punto arbitrario durante l'esecuzione del programma. POSIX ha il concetto di "funzione sicura". Se un segnale interrompe l'esecuzione di una funzione non sicura, e handler chiama una funzione non sicura, allora il comportamento del programma non è definito. POSIX.1-2004 (già conosciuto come POSIX.1-2001 Technical Corrigendum 2) richiede all'implementazione di garantire che le seguenti funzioni possano essere chiamate in sicurezza in un gestore di segnali:
_Exit()
_exit()
abort()
accept()
access()
aio_error()
aio_return()
aio_suspend()
alarm()
bind()
cfgetispeed()
cfgetospeed()
cfsetispeed()
cfsetospeed()
chdir()
chmod()
chown()
clock_gettime()
close()
connect()
creat()
dup()
dup2()
execle()
execve()
fchmod()
fchown()
fcntl()
fdatasync()
fork()
fpathconf()
fstat()
fsync()
ftruncate()
getegid()
geteuid()
getgid()
getgroups()
getpeername()
getpgrp()
getpid()
getppid()
getsockname()
getsockopt()
getuid()
kill()
link()
listen()
lseek()
lstat()
mkdir()
mkfifo()
open()
pathconf()
pause()
pipe()
poll()
posix_trace_event()
pselect()
raise()
read()
readlink()
recv()
recvfrom()
recvmsg()
rename()
rmdir()
select()
sem_post()
send()
sendmsg()
sendto()
setgid()
setpgid()
setsid()
setsockopt()
setuid()
shutdown()
sigaction()
sigaddset()
sigdelset()
sigemptyset()
sigfillset()
sigismember()
signal()
sigpause()
sigpending()
sigprocmask()
sigqueue()
sigset()
sigsuspend()
sleep()
sockatmark()
socket()
socketpair()
stat()
symlink()
sysconf()
tcdrain()
tcflow()
tcflush()
tcgetattr()
tcgetpgrp()
tcsendbreak()
tcsetattr()
tcsetpgrp()
time()
timer_getoverrun()
timer_gettime()
timer_settime()
times()
umask()
uname()
unlink()
utime()
wait()
waitpid()
write()

POSIX.1-2008 rimuove fpathconf(), pathconf(), e sysconf() dall'elenco precedente, e aggiunge le seguenti funzioni:

execl()
execv()
faccessat()
fchmodat()
fchownat()
fexecve()
fstatat()
futimens()
linkat()
mkdirat()
mkfifoat()
mknod()
mknodat()
openat()
readlinkat()
renameat()
symlinkat()
unlinkat()
utimensat()
utimes()

  Interruzione delle chiamate di sistema e funzioni di libreria da parte di gestori di segnale
Se viene chiamato un gestore di segnale mentre una chiamata di sistema o una funzione di libreria sono bloccate, può succedere:

*   che la chiamata venga automaticamente riavviata dopo il ritorno del gestore di segnale; o

*   che la chiamata fallisca con l'errore EINTR.

Il verificarsi di uno di questi due comportamenti dipende dall'interfaccia e dall'uso o meno del flag SA_RESTART alla creazione del gestore di segnale (vedere sigaction(2)). I dettagli variano tra i sistemi UNIX: seguono quelli per Linux. Se un gestore di segnale interrompe una chiamata bloccata verso una delle seguenti interfacce, la chiamata verrà automaticamente riavviata dopo il ritorno del gestore di segnale, se è stato usato il flag SA_RESTART, altrimenti la chiamata fallirà con l'errore EINTR: chiamate

    *   read(2), readv(2), write(2), writev(2), e ioctl(2) su dispositivi "lenti". Un dispositivo è "lento" quando le chiamate I/O possono bloccarsi per un tempo indeterminato, per esempio un terminale, una pipe o un socket Se una chiamata I/O su un dispositivo lento ha già trasferito alcuni dati al momento dell'interruzione da parte del gestore di segnale, la chiamata restituirà uno stato di successo (di solito il numero di byte trasferiti). Da notare che un disco (locale) non è un dispositivo lento, stando a quanto dice la sua definizione. Le operazioni I/O sui dischi non vengono interrotte dai segnali.

    *   open(2), se si può bloccare (per esempio nell'aprire un FIFO: vedere fifo(7)).

    *   wait(2), wait3(2), wait4(2), waitid(2), e waitpid(2).

    *   Interfacce socket: accept(2), connect(2), recv(2), recvfrom(2), recvmmsg(2), recvmsg(2), send(2), sendto(2), e sendmsg(2), a meno che venga impostato un timeout sul socket (vedere sotto).

    *   Interfacce che bloccano i file: flock(2) e le operazioni F_SETLKW e F_OFD_SETLKW di fcntl(2)

    *   Interfacce per messaggi POSIX in coda: mq_receive(3), mq_timedreceive(3), mq_send(3), e mq_timedsend(3).

    *   futex(2) FUTEX_WAIT (a partire da Linux 2.6.22; prima falliva sempre con EINTR).

    *   getrandom(2).

    *   pthread_mutex_lock(3), pthread_cond_wait(3), e con le relative API.

    *   futex(2) FUTEX_WAIT_BITSET.

    *   Interfacce semaforo POSIX: sem_wait(3) e sem_timedwait(3) (a partire da Linux 2.6.22; prima falliva sempre con EINTR).

Le seguenti interfacce non vengono mai riavviate dopo l'interruzione da parte di un gestore di segnale, senza curarsi dell'uso di SA_RESTART; falliscono sempre con l'errore EINTR quando vengono interrotte da un gestore di segnale:

    *   Interfacce socket in "input", quando è stato impostato un timeout (SO_RCVTIMEO) sul socket usando setsockopt(2): accept(2), recv(2), recvfrom(2), recvmmsg(2) (anche con un argomento imeout non NULLO) e recvmsg(2).

    *   Interfacce socket in "output", quando è stato impostato un timeout (SO_RCVTIMEO) sul socket usando setsockopt(2): connect(2), send(2), sendto(2), e sendmsg(2).

    *   Interfacce usate per aspettare segnali: pause(2), sigsuspend(2), sigtimedwait(2), e sigwaitinfo(2).

    *   Interfacce condivise per descrittori di file epoll_wait(2), epoll_pwait(2), poll(2), ppoll(2), select(2), e pselect(2).

    *   Interfacce IPV System V: msgrcv(2), msgsnd(2), semop(2), e semtimedop(2).

    *   Interfacce sleep: clock_nanosleep(2), nanosleep(2), e usleep(3).

    *   read(2) da un descrittore di file inotify(7).

    *   io_getevents(2).

La funzione sleep(3) non viene mai riavviata anche quando viene interrotta da un gestore, ma restituisce uno stato di successo: il numero di secondi rimanenti.

  Interruzione di chiamate di sistema e funzioni di libreria da parte di segnali di stop
Su Linux, anche in assenza di gestori di segnale alcune interfacce di blocco possono fallire con l'errore EINTR dopo che il processo è stato fermato da un segnale di stop, e poi riavviato tramite SIGCONT. Questo comportamento non è sanzionato da POSIX.1, e non avviene su altri sistemi. Le interfacce Linux che si comportano in questo modo sono:

    *   Interfacce socket in "input", quando è stato impostato un timeout (SO_RCVTIMEO)
         sul socket usando setsockopt(2): accept(2), recv(2), recvfrom(2), recvmmsg(2) (anche con un argomento timeout non NULL), e recvmsg(2).

    *   Interfacce socket in "output", quando è stato impostato un timeout (SO_RCVTIMEO) sul socket usando setsockopt(2): connect(2), send(2), sendto(2), e sendmsg(2), se è stato impostato un timeout in invio (SO_SNDTIMEO).

    *   epoll_wait(2), epoll_pwait(2).

    *   semop(2), semtimedop(2).

    *   sigtimedwait(2), sigwaitinfo(2).

    *   read(2) da un descrittore di file inotify(7).

    *   Linux 2.6.21 e precedenti: futex(2) FUTEX_WAIT, sem_timedwait(3), sem_wait(3).

    *   Linux 2.6.8 e precedenti: msgrcv(2), msgsnd(2).

    *   Linux 2.4 e precedenti: nanosleep(2).

CONFORME A
POSIX.1, tranne dove indicato.

VEDERE ANCHE
kill(1), getrlimit(2), kill(2), killpg(2), restart_syscall(2), rt_sigqueueinfo(2), setitimer(2), setrlimit(2), sgetmask(2), sigaction(2), sigaltstack(2), signal(2), signalfd(2), sigpending(2), sigprocmask(2), sigsuspend(2), sigwaitinfo(2), abort(3), bsd_signal(3), longjmp(3), raise(3), pthread_sigqueue(3), sigqueue(3), sigset(3), sigsetops(3), sigvec(3), sigwait(3), strsignal(3), sysv_signal(3), core(5), proc(5), nptl(7), pthreads(7), sigevent(7)

COLOPHON
Questa pagina fa parte del rilascio 4.00 del progetto Linux man-pages. Una descrizione del progetto, le istruzioni per la segnalazione degli errori, e l'ultima versione di questa pagina si trova su http://www.kernel.org/doc/man-pages/. La versione italiana fa parte del pacchetto man-pages-it v. 4.00, a cura di: ILDP "Italian Linux Documentation Project" http://www.pluto.it/ildp
Per la traduzione in italiano si può fare riferimento a http://www.pluto.it/ildp/collaborare/
Segnalare eventuali errori di traduzione a ildp@pluto.it