> Linux Reviews > man >

signal

obs�uga sygna��w ANSI C

signal.2.man
signal.7.man

1. signal.2.man

Manpage of SIGNAL

SIGNAL

Section: Podr�cznik programisty Linuksa (2)
Updated: 2000-04-28
Index Return to Main Contents

NAZWA

signal - obs�uga sygna��w ANSI C

SK�ADNIA

#include <signal.h>

typedef void (*sighandler_t)(int);

sighandler_t signal(int signum, sighandler_t handler);

OPIS

Funkcja systemowa signal() instaluje now� obs�ug� sygna�u dla sygna�u o numerze signum. Obs�uga sygna�u ustawiana jest na sighandler, kt�ry mo�e by� funkcj� podan� przez u�ytkownika lub SIG_IGN albo SIG_DFL.

Po przys�aniu sygna�u o numerze signum dzieje si�, co nast�puje. Je�li obs�uga odpowiedniego sygna�u zosta�a ustawiona na SIG_IGN, to sygna� jest ignorowany. Je�li obs�uga zosta�a ustawiona na SIG_DFL, to podejmowana jest domy�lna akcja skojarzona z sygna�em (patrz signal(7)). Ostatecznie, Je�li jako obs�uga sygna�u zosta�a ustawiona function sighandler, to najpierw albo obs�uga sygna�u jest inicjowana na SIG_DFL albo odbywa si� zale�ne od implementacji blokowanie sygna�u, a nast�pnie wywo�ywana jest funkcja sighandler z argumentem signum.

U�ywanie funkcji obs�ugi sygna�u jest nazywane "przechwytywaniem sygna�u". Sygna�y SIGKILL i SIGSTOP nie mog� by� ani przechwycone, ani zignorowane.

WARTO�� ZWRACANA

Funkcja signal() zwraca poprzedni� warto�� obs�ugi sygna�u, lub SIG_ERR w przypadku b��du.

PRZENO�NO��

Oryginalne uniksowe signal() zainicjalizowa�oby obs�ug� sygna�u na SIG_DFL i to samo robi System V (oraz j�dro Linuksa i libc4,5). Z drugiej strony, BSD nie inicjalizuje obs�ugi sygna�u, ale blokuje nowopojawiaj�ce si� egzemplarze tego sygna�u podczas wywo�ywania funkcji obs�ugi. Biblioteka glibc2 na�laduje zachowanie BSD.

Je�li w systemie opartym o libc5 zostanie w��czone <bsd/signal.h> zamiast <signal.h>, to signal zostanie przedefiniowane jako __bsd_signal i b�dzie mia�o semantyk� BSD. Nie jest to zalecane.

Je�li w systemie opartym o glibc2 zdefiniowane zostanie makro testowania cechy, takie jak _XOPEN_SOURCE lub zostanie u�yta osobna funkcja sysv_signal, otrzyma si� zachowanie klasyczne. Nie jest to zalecane.

Pr�ba zmiany semantyki tej funkcji za pomoc� przedefiniowywania i w��czania plik�w nag��wkowych nie jest dobrym pomys�em. Lepiej w og�le unika� funkcji signal i pos�ugiwa� si� zamiast niej sigaction(2).

UWAGI

Zgodnie ze standardem POSIX, zachowanie procesu po zignorowaniu sygna�u SIGFPE, SIGILL lub SIGSEGV, kt�ry nie by� wygenerowany przez funkcj� kill(2) ani raise(3), jest niezdefiniowane. Dzielenie przez zero liczby ca�kowitej nie ma okre�lonego wyniku. Na niekt�rych architekturach generuje to sygna� SIGFPE. (R�wnie� dzielenie najmniejszej liczby ujemnej przez -1 mo�e spowodowa� wygenerowanie SIGFPE.) Ignorowanie tego sygna�u mo�e doprowadzi� do p�tli niesko�czonej.

Zgodnie ze standardem POSIX (3.3.1.3) nie jest okre�lone, co sie stanie gdy SIGCHLD zostanie ustawiony na SIG_IGN. W tym miejscu zachowanie BSD i SYSV r�ni si�, powoduj�c nie dzia�anie na Linuksie oprogramowania BSD, kt�re ustawia akcj� dla SIGCHLD na SIG_IGN.

U�ycie sighandler_t jest rozszerzeniem GNU. R�ne wersje libc predefiniuj� ten typ; libc4 i libc5 definiuj� SignalHandler, glibc definiuje sig_t, a gdy zdefiniowane jest _GNU_SOURCE, r�wnie� sighandler_t.

ZGODNE Z

ANSI C

ZOBACZ TAK�E

kill(1), kill(2), killpg(2), pause(2), raise(3), sigaction(2), signal(7), sigsetops(3), sigvec(2), alarm(2)

This document was created by man2html using the manual pages.
Time: 00:25:14 GMT, November 20, 2008

2. signal.7.man

Manpage of SIGNAL

SIGNAL

Section: Podr�cznik programisty Linuksa (7)
Updated: 2002-06-13
Index Return to Main Contents

NAZWA

signal - lista dost�pnych sygna��w

OPIS

Linux wspiera zar�wno rzeczywiste sygna�y POSIX-owe (zwane dalej "sygna�ami standardowymi"), jak i sygna�y POSIX-owe czasu rzeczywistego.

Zachowania sygna�u

Ka�dy sygna� ma przypisane bie��ce zachowanie, kt�re okre�la reakcj� procesu na dostarczony sygna�.

Wpisy w kolumnie "Akcja" tabeli okre�laj� domy�lne zachowanie dla danego sygna�u, jako jedno z nast�puj�cych:

Term: Domy�ln� akcj� jest przerwanie procesu.
Ign: Domy�ln� akcj� jest zignorowanie sygna�u.
Core: Domy�ln� akcj� jest przerwanie procesu i zapisanie obrazu pami�ci (patrz core(5)).
Stop: Domy�ln� akcj� jest zatrzymanie procesu.
Cont: Domy�ln� akcj� jest kontynuowanie procesu, je�eli jest obecnie zatrzymany.

Proces mo�e zmieni� zachowanie si� sygna�u, u�ywaj�c sigaction(2) lub (mniej przeno�nego) signal(2). U�ywaj�c tych wywo�a� systemowych, proces mo�e wybra� jedn� z poni�szych reakcji na dostarczenie sygna�u: wykona� domy�ln� akcj�, zignorowa� sygna�, przej�� sygna� wykonuj�c akcj� obs�ugi sygna�u, czyli podan� przez programist� funkcj�, wywo�ywan� automatycznie po dostarczeniu sygna�u.

Zachowanie sygna�u jest atrybutem poszczeg�lnych proces�w: w aplikacji wielow�tkowej zachowanie danego sygna�u jest takie samo dla wszystkich w�tk�w.

Maska sygna�u i sygna�y oczekuj�ce

Sygna� mo�e by� zablokowany, co oznacza, �e nie zostanie dostarczony, dop�ki si� go nie odblokuje. Sygna� jest nazywany oczekuj�cym, je�eli zosta� ju� wygenerowany, ale nie zosta� jeszcze dostarczony.

Ka�dy w�tek procesu ma swoj� niezale�n� mask� sygna��w, okre�laj�c� zbi�r sygna��w obecnie blokowanych przez w�tek. W�tek mo�e zmienia� mask� sygna��w, u�ywaj�c pthread_sigmask(3). Tradycyjna, jednow�tkowa aplikacja mo�e do tego celu u�y� sigprocmask(2).

Sygna� mo�e by� wygenerowany (i w zwi�zku z tym oczekuj�cy) dla procesu jako ca�o�ci (np. wys�any za pomoc� kill(2)) lub dla okre�lonego w�tku (np. skierowane do w�tku s� niekt�re sygna�y, takie jak SIGSEGV lub SIGPFPE, generowane w konsekwencji u�ycia okre�lonej instrukcji j�zyka maszynowego oraz sygna�y wys�ane za pomoc� pthread_kill(2)). Sygna� skierowany do procesu mo�e by� dostarczony do kt�regokolwiek z jego w�tk�w, kt�ry nie blokuje tego sygna�u. Je�eli wi�cej ni� jeden w�tek nie blokuje sygna�u, to j�dro dostarczy sygna� do przypadkowo wybranego w�tku.

W�tek mo�e pobra� zbi�r obecnie oczekuj�cych sygna��w, u�ywaj�c sigpending(2). Zbi�r ten b�dzie zawiera� sygna�y oczekuj�ce skierowane zar�wno do ca�ego procesu, jak i do wywo�uj�cego w�tku.

Sygna�y standardowe

Linux wspiera wymienione poni�ej sygna�y standardowe. Numery niekt�rych sygna��w zale�� od architektury, co pokazano w kolumnie "Warto��". (Je�eli podano trzy warto�ci, to zazwyczaj pierwsza obowi�zuje dla architektur alpha i sparc, �rodkowa dla i386, ppc i sh, a ostatnia dla mips. Znak - oznacza, �e sygna� dla danej architektury nie wyst�puje.)

Najpierw sygna�y opisane w pierwotnym standardzie POSIX.1.

Sygna�	Warto��	Akcja	Komentarz

			lub �mier� procesu kontroluj�cego
SIGINT	2	Term	Przerwanie nakazane z klawiatury
SIGQUIT	3	Core	Wyj�cie nakazane z klawiatury
SIGILL	4	Core	Nielegalna instrukcja
SIGABRT	6	Core	Sygna� abort od abort(3)
SIGFPE	8	Core	Wyj�tek zmiennoprzecinkowy
SIGKILL	9	Term	Sygna� Kill
SIGSEGV	11	Core	Nieprawid�owa referencja pami�ciowa
SIGPIPE	13	Term	Uszkodzony potok: zapis do potoku bez odbiorc�w
SIGALRM	14	Term	Sygna� timera od alarm(2)
SIGTERM	15	Term	Sygna� zako�czenia pracy
SIGUSR1	30,10,16	Term	Sygna� 1 u�ytkownika
SIGUSR2	31,12,17	Term	Sygna� 2 u�ytkownika
SIGCHLD	20,17,18	Ign	Potomek zatrzyma� si� lub zako�czy� prac�
SIGCONT	19,18,25	Cont	Kontynuuj, je�li si� zatrzyma�
SIGSTOP	17,19,23	Stop	Zatrzymaj proces
SIGTSTP	18,20,24	Stop	Zatrzymanie napisane z tty
SIGTTIN	21,21,26	Stop	Wej�cie tty dla procesu w tle
SIGTTOU	22,22,27	Stop	Wyj�cie tty dla procesu w tle

Sygna��w SIGKILL oraz SIGSTOP nie mo�na przechwyci�, zablokowa� ani zignorowa�.

Nast�pnie sygna�y nie wyst�puj�ce w standardzie POSIX.1, ale opisane w SUSv2 lub w SUSv3 / POSIX 1003.1-2001.

Sygna�	Warto��	Akcja	Komentarz

SIGPOLL		Term	Zdarzenie odpytywalne (Sys V). Synonim SIGIO
SIGPROF	27,27,29	Term	Przeterminowanie zegara profilowego
SIGSYS	12,-,12	Core	Niew�a�ciwy argument funkcji (SVID)
SIGTRAP	5	Core	�ledzenie/pu�apka kontrolna
SIGURG	16,23,21	Ign	Pilny warunek na gnie�dzie (BSD 4.2)
SIGVTALRM	26,26,28	Term	Wirtualny zegar alarmu (BSD 4.2)
SIGXCPU	24,24,30	Core	Przekroczone ograniczenie czasu CPU (BSD 4.2)
SIGXFSZ	25,25,31	Core	Przekroczone ograniczenie rozmiaru pliku (BSD 4.2)

Do wersji 2.2 Linuksa (w��cznie) domy�lne zachowanie dla sygna��w SIGSYS, SIGXCPU, SIGXFSZ oraz (na architekturach innych ni� SPARC i MIPS) SIGBUS polega�o na przerwaniu procesu (bez zrzutu pami�ci). (W niekt�rych innych Uniksach domy�lne zachowanie dla SIGXCPU i SIGXFSZ polega na przerwaniu procesu bez zrzutu pami�ci). Linux 2.4 jest zgodny ze wymaganiami standardu POSIX 1003.1-2001 w zakresie przerywania procesu ze zrzutem pami�ci.

A teraz r�ne inne sygna�y.

Sygna�	Warto��	Akcja	Komentarz

SIGEMT	7,-,7	Term
SIGSTKFLT	-,16,-	Term	B��d stosu koprocesora (nieu�ywany)
SIGIO	23,29,22	Term	I/O teraz mo�liwe (BSD 4.2)
SIGCLD	-,-,18	Ign	Synonim SIGCHLD
SIGPWR	29,30,19	Term	B��d zasilania (System V)
SIGINFO	29,-,-		Synonim SIGPWR
SIGLOST	-,-,-	Term	Utracono blokad� pliku
SIGWINCH	28,28,20	Ign	Sygna� zmiany rozmiar�w okna (BSD 4.3, Sun)
SIGUNUSED	-,31,-	Term	Nie u�yty sygna� (wyst�pi SIGSYS)

(Sygna� 29 oznacza SIGINFO / SIGPWR na architekturze alpha, lecz SIGLOST na architekturze sparc).

SIGEMT nie jest wymieniony w POSIX 1003.1-2001, lecz pomimo to pojawia si� w wi�kszo�ci innych Uniks�w. Domy�ln� akcj� dla tego sygna�u jest zazwyczaj przerwanie procesu ze zrzutem pami�ci.

SIGPWR (nie wymieniony w POSIX 1003.1-2001) jest zazwyczaj domy�lnie ignorowany w tych Uniksach, w kt�rych wyst�puje.

SIGIO (nie wymieniony w POSIX 1003.1-2001) jest domy�lnie ignorowany w niekt�rych innych Uniksach.

Sygna�y czasu rzeczywistego

Linux wspiera sygna�y czasu rzeczywistego zdefiniowane pierwotnie w rozszerzeniu dla czasu rzeczywistego POSIX.4 (a obecnie zawarte w POSIX 1003.1-2001). Linux wspiera 32 sygna�y czasu rzeczywistego, o numerach od 32 (SIGRTMIN) do 63 (SIGRTMAX). (Programy powinny zawsze odwo�ywa� si� do sygna��w czasu rzeczywistego u�ywaj�c notacji SIGRTMIN+n, gdy� zakres numer�w sygna��w czasu rzeczywistego r�ni si� pomi�dzy Uniksami).

W odr�nieniu od sygna��w standardowych, sygna�y czasu rzeczywistego nie posiadaj� predefiniowanego znaczenia: mo�na wykorzystywa� ca�y zestaw sygna��w czasu rzeczywistego do cel�w okre�lonych w aplikacji. (Nale�y jednak zauwa�y�, �e implementacja LinuxThreads korzysta z trzech pierwszych sygna��w czasu rzeczywistego).

Domy�l� akcj� na nieobs�u�ony sygna� czasu rzeczywistego jest przerwanie procesu, kt�ry go otrzyma�.

Sygna�y czasu rzeczywistego s� rozpoznawane w nast�puj�cy spos�b:

1.: Mo�na kolejkowa� wiele egzemplarzy sygna�u czasu rzeczywistego. Dla odr�nienia, je�li w czasie gdy standardowy sygna� jest blokowany zostanie dor�czonych wiele egzemplarzy tego sygna�u, tylko jeden egzemplarzy trafia do kolejki.
2.: Je�li sygna� wys�ano korzystaj�c z sigqueue(2), mo�na wys�a� wraz z tym sygna�em warto�� towarzysz�c� (ca�kowit� lub wska�nik). Je�li proces otrzymuj�cy ustanawia funkcj� obs�ugi dla tego sygna�u za pomoc� znacznika SA_SIGACTION funkcji sigaction(2), to otrzymuje towarzysz�c� mu dan� za po�rednictwem pola si_value struktury siginfo_t przekazanej jako drugi argument funkcji obs�ugi. Ponadto, pola si_pid oraz si_uid tej struktury mog� s�u�y� do otrzymania PID oraz rzeczywistego ID u�ytkownika procesu wysy�aj�cego sygna�.
3.: Sygna�y czasu rzeczywistego s� dor�czane w zagwarantowanej kolejno�ci. Sygna�y czasu rzeczywistego jednego rodzaju s� dor�czane w takiej kolejno�ci, w jakiej zosta�y wys�ane. Je�li do procesu zostan� wys�ane r�ne sygna�y czasu rzeczywistego, b�d� one dor�czone pocz�wszy od sygna�u o najni�szym numerze. (Tzn. sygna�y o niskich numerach maj� najwy�szy priorytet).

POSIX nie okre�la, kt�re z sygna��w powinny zosta� dor�czone jako pierwsze w sytuacji, gdy obs�u�enia wymagaj� zar�wno sygna�y standardowe, jak i sygna�y czasu rzeczywistego. Linux, podobnie do innych implementacji, daje w tym przypadku pierwsze�stwo sygna�om standardowym.

Zgodnie z POSIX, implementacja powinna zezwala� na kolejkowanie do procesu co najmniej _POSIX_SIGQUEUE_MAX (32) sygna��w czasu rzeczywistego. Jednak�e, Linux zamiast okre�la� ograniczenie dla procesu, wymusza ograniczenie og�lnosystemowe liczby kolejkowanych do wszystkich proces�w sygna��w czasu rzeczywistego. Ograniczenie to mo�na zobaczy�, a tak�e (przy odpowiednich uprawnieniach) zmieni� za po�rednictwem pliku /proc/sys/kernel/rtsig-max. Podobnie, za po�rednictwem pliku /proc/sys/kernel/rtsig-nr mo�na dowiedzie� si� ile sygna��w czasu rzeczywistego jest aktualnie w kolejce. W Linuksie 2.6.8 ten interfejs /proc zosta� zast�piony limitem zasob�w RLIMIT_SIGPENDING, kt�ry okre�la limit kolejkowanych sygna��w dla poszczeg�lnych u�ytkownik�w; patrz setrlimit(2) w celu uzyskania dalszych informacji.

ZGODNE Z

POSIX.1

B��DY

SIGIO i SIGLOST maj� t� sam� warto��. Ten drugi jest zakomentowany w �r�d�ach j�dra, lecz proces tworzenia niekt�rych aplikacji wci�� zak�ada, �e sygna� 29 to SIGLOST.

ZOBACZ TAK�E

kill(1), kill(2), killpg(2), setitimer(2), setrlimit(2), sigaction(2), signal(2), sigpending(2), sigprocmask(2), sigqueue(2), sigsuspend(2), sigwaitinfo(2), raise(3), sigvec(3), sigset(3), strsignal(3), core(5), proc(5), pthreads(7)

Index

NAZWA

OPIS

Zachowania sygna�u
Maska sygna�u i sygna�y oczekuj�ce
Sygna�y standardowe
Sygna�y czasu rzeczywistego

ZGODNE Z

B��DY

ZOBACZ TAK�E

This document was created by man2html using the manual pages.
Time: 00:25:15 GMT, November 20, 2008