Provided by:
manpages-nl_20051127-4_all
NAAM
sigaction, sigprocmask, sigpending, sigsuspend - POSIX signaal behan‐
delings functies
OVERZICHT
#include <signal.h>
int sigaction(int signum, const struct sigaction *act, struct sigaction
*oudeact);
int sigprocmask(int hoe, const sigset_t *set, sigset_t *oudeset);
int sigpending(sigset_t *set);
int sigsuspend(const sigset_t *masker);
BESCHRIJVING
De sigaction systeem aanroep wordt gebruikt om de genomen actie door
een proces bij het ontvangst van een signaal te veranderen.
signum bepaald het signaal en kan elk geldig signaal zijn behalve
SIGKILL {vermoord} en SIGSTOP {stop}.
Als act on-gelijk nul is wordt de nieuwe actie voor het signaal signum
geïnstalleerd van act. Als oudeact niet-null is, dan wordt de vorige
actie bewaard in oudeact.
De sigaction structuur is bepaald als
struct sigaction {
void (*sa_handler)(int);
void (*sa_sigaction)(int, siginfo_t *, void *);
sigset_t sa_mask;
int sa_flags;
void (*sa_restorer)(void);
}
Het sa_restorer element is verouderd en zou niet gebruikt moeten wor‐
den. POSIX geeft geen sa_restorer element op.
sa_handler Geeft de actie die verbonden zal worden met signum op, en
mag SIG_DFL {signaal standaard} zijn voor de standaard actie, SIG_IGN
{signaal negeer} om het signaal te negeren, of een pointer naar een
signaal behandelaar functie.
sa_mask Geeft een masker van signalen die geblokkeerd zouden moeten
worden tijdens de uitvoering van de signaal behandelaar. In toevoeging
daarop zal het signaal dat de behandelaar af liet gaan geblokkeerd wor‐
den, tenzij de SA_NODEFER {*niet uitstellen} of SA_NOMASK {*geen
masker} vlaggen worden gebruikt.
sa_flags Geeft een aantal vlaggen op die het gedrag van het signaal
behandelings proces aanpassen. Het wordt gevormd door de bitsgewijze OF
{incl.} van nul of meer van het volgende:
SA_NOCLDSTOP
{*geen kind stop} Als signum , SIGCHLD is, ontvang geen
bericht wanneer kind processen stoppen (dat is, wanneer
kind processen 1 van SIGSTOP, SIGTSTP, SIGTTIN of SIGTTOU
ontvangen).
SA_ONESHOT {1 keer} of SA_RESETHAND {herzet behandelaar}
Herstel de signaal actie naar de standaard toestand zodra
de signaal behandelaar aangeroepen is geweest. (Dit is
het standaard gedrag van de signal(2) systeem aanroep.)
SA_RESTART
{*herstart} Geef gedrag overeenkomend met BSD signaal-
regels door bepaalde systeem aanroepen herstartbaar te
maken door signalen heen.
SA_NOMASK {*geen masker} or SA_NODEFER {*geen uitstel}
Voorkom niet dat het signaal ontvangen wordt binnen in
zijn eigen signaal behandelaar.
SA_SIGINFO
{*signaal informatie} De signaal behandelaar neemt 3
argumenten, niet 1. In dit geval zou sa_sigaction gezet
moeten zijn inplaats van sa_handler. (Het sa_sigaction
veld werd toegevoegd in Linux 2.1.86.)
De siginfo_t grootheid van sa_sigaction is een "struct" met de volgende
elementen
siginfo_t {
int si_signo; /* Signaal nummer */
int si_errno; /* Een errno waarde */
int si_code; /* Signaal code */
pid_t si_pid; /* Zendende proces ID */
uid_t si_uid; /* Echte gebruiker ID van het zendende proces */
int si_status; /* Teruggeef waarde, of signaal */
clock_t si_utime; /* Gebruiker tijd verbruikt */
clock_t si_stime; /* Systeem tijd verbruikt */
sigval_t si_value; /* Signaal waarde */
int si_int; /* POSIX.1b signaal */
void * si_ptr; /* POSIX.1b signaal */
void * si_addr; /* Geheugen plaats die de fout veroorzaakte */
int si_band; /* "Band" gebeurtenis */
int si_fd; /* Bestandsindicator */
}
si_signo, si_errno en si_code zijn bepaald voor alle signalen.
kill(2), POSIX.1b signalen en SIGCHLD vullen si_pid en si_uid in.
SIGCHLD vult ook: si_status, si_utime en si_stime in. si_int en si_ptr
worden opgegeven door de zender van het POSIX.1b signaal. SIGILL
{*ziek}, SIGFPE {*drijvende komma uitzondering}, SIGSEGV {*seg v} en
SIGBUS {*bus} vullen si_addr in met het adres van de fout. SIGPOLL
{*onderzoek} vult si_band en si_fd in.
si_code geeft aan waarom dit signaal gezonden werd. Het is een waarde,
geen bitmasker. De waardes die mogelijk zijn voor elk signaal zijn
hieronder gegeven in deze tabel:
+---------------------------------------------------------------+
| si_code |
+-----------------------------+---------------------------------+
|Waarde | Signaal herkomst |
+-----------------------------+---------------------------------+
|SI_USER {*gebruiker} | vermoord, "sigsend" of "raise" |
+-----------------------------+---------------------------------+
|SI_KERNEL {*kernel} | De kernel |
+-----------------------------+---------------------------------+
|SI_QUEUE {*rij} | "sigqueue" |
+-----------------------------+---------------------------------+
|SI_TIMER {*uurwerk} | uurwerk liep af |
+-----------------------------+---------------------------------+
|SI_MESGQ {*?} | "mesgq" toestand veranderd |
+-----------------------------+---------------------------------+
|SI_ASYNCIO {*ongelijktijdig} | "AIO" afgemaakt |
+-----------------------------+---------------------------------+
|SI_SIGIO {*in/uit} | in de wachtrij geplaatst SIGIO |
+-----------------------------+---------------------------------+
+----------------------------------------------------------+
| SIGILL {signaal ziek} |
+-----------------------------+----------------------------+
|ILL_ILLOPC {*ziek opcode} | onwettige opcode |
+-----------------------------+----------------------------+
|ILL_ILLOPN {*ziek operand} | onwettige operand |
+-----------------------------+----------------------------+
|ILL_ILLADR {*ziek adres} | onwettige adresseer "mode" |
+-----------------------------+----------------------------+
|ILL_ILLTRP {*ziek val} | onwettige valkuil {"trap"} |
+-----------------------------+----------------------------+
|ILL_PRVOPC {*prive opcode} | geprivilegieerde opcode |
+-----------------------------+----------------------------+
|ILL_PRVREG {*prive register} | geprivilegieerd register |
+-----------------------------+----------------------------+
|ILL_COPROC {*help processor} | hulpprocessor fout |
+-----------------------------+----------------------------+
|ILL_BADSTK {*slechte stapel} | inwendige stapel fout |
+-----------------------------+----------------------------+
+---------------------------------------------------------------------+
| SIGFPE {signaal drijvende komma uitzondering} |
+--------------------------------+------------------------------------+
|FPE_INTDIV {*heel delen} | geheel getal delen door nul |
+--------------------------------+------------------------------------+
|FPE_INTOVF {*heel overloop} | geheel getal overloop |
+--------------------------------+------------------------------------+
|FPE_FLTDIV {*dr.kma. delen} | drijvende komma deel door nul |
+--------------------------------+------------------------------------+
|FPE_FLTOVF {*dr.kma. overloop} | drijvende komma overloop |
+--------------------------------+------------------------------------+
|FPE_FLTUND {*dr.kma. onderloop} | drijvende komma onderloop |
+--------------------------------+------------------------------------+
|FPE_FLTRES {*dr.kma. resultaat} | drijvende komma onprecies antwoord |
+--------------------------------+------------------------------------+
|FPE_FLTINV {*dr.kma. ongeldig} | drijvende komma ongeldige operatie |
+--------------------------------+------------------------------------+
|FPE_FLTSUB {*dr.kma. subscript} | index {"subscript"} buiten bereik |
+--------------------------------+------------------------------------+
+------------------------------------------------------------------------+
| SIGSEGV {signaal segment ?} |
+---------------------------------+--------------------------------------+
|SEGV_DIRECTORIEERR {*kaart fout} | adres niet verbonden met object |
+---------------------------------+--------------------------------------+
|SEGV_ACCERR {*toegang fout} | ongeld. toestemm. voor "mapped" obj. |
+---------------------------------+--------------------------------------+
+------------------------------------------------------------+
| SIGBUS {signaal bus} |
+----------------------------+-------------------------------+
|BUS_ADRALN {*adres oplijn} | ongeldige adres oplijning |
+----------------------------+-------------------------------+
|BUS_ADRERR {*adres fout} | niet bestaand materieel adres |
+----------------------------+-------------------------------+
|BUS_OBJERR {*voorwerp fout} | object eigen "hardware" fout |
+----------------------------+-------------------------------+
+------------------------------------------------+
| SIGTRAP {signaal val(kuil)} |
+-----------+------------------------------------+
|TRAP_BRKPT | {*breekpunt} proces breekpunt |
+-----------+------------------------------------+
|TRAP_TRACE | {*volg} proces volg {"trace"} punt |
+-----------+------------------------------------+
+----------------------------------------------------------------------+
| SIGCHLD {signaal kind} |
+----------------------------+-----------------------------------------+
|CLD_EXITED {*eindigde} | kind is beëindigd |
+----------------------------+-----------------------------------------+
|CLD_KILLED {*vermoord} | kind werd vermoord |
+----------------------------+-----------------------------------------+
|CLD_DUMPED {*gedumpt} | kind eindigde abnormaal |
+----------------------------+-----------------------------------------+
|CLD_TRAPPED {*gevangen} | gevolgd {"traced"} kind viel in valkuil |
+----------------------------+-----------------------------------------+
|CLD_STOPPED {*gestopt} | kind is gestopt |
+----------------------------+-----------------------------------------+
|CLD_CONTINUED {*doorgegaan} | gestopt kind is doorgegaan |
+----------------------------+-----------------------------------------+
+------------------------------------------------------------+
| SIGPOLL {signaal onderzoek} |
+-----------------------+------------------------------------+
|POLL_IN {*in} | gegevens invoer beschikbaar |
+-----------------------+------------------------------------+
|POLL_OUT {*uit} | uitvoer buffers beschikbaar |
+-----------------------+------------------------------------+
|POLL_MSG {*bericht} | invoer bericht beschikbaar |
+-----------------------+------------------------------------+
|POLL_ERR {*fout} | in/uit fout |
+-----------------------+------------------------------------+
|POLL_PRI {*prioriteit} | hoge prioriteit invoer beschikbaar |
+-----------------------+------------------------------------+
|POLL_HUP {*hangop} | apparaat los gemaakt |
+-----------------------+------------------------------------+
De sigprocmask aanroep wordt gebruikt om de lijst van momenteel geblok‐
keerde signalen te veranderen. Het gedrag van de aanroep is afhankelijk
van de waarde van hoe, als volgt.
SIG_BLOCK
{*blokkeer} De set van geblokkeerde signalen is de
vereniging van de huidige set en het set argument.
SIG_UNBLOCK
{*niet-blokkeer} De signalen in set worden verwijderd uit
de huidige set geblokkeerde signalen. Het is wettig om te
proberen een signaal te on-blokkeren dat niet geblokkeerd
wordt.
SIG_SETMASK
{*zet masker} De set van geblokkeerde signalen wordt
gezet naar het argument set.
Als oudeset niet-null is dan wordt de vorige waarde van het signaal
masker bewaard in oudeset.
De sigpending aanroep laat het beoordelen van wachtende {eng: pending}
signalen toe (degenen die opgekomen zijn terwijl zo geblokkeerd waren).
Het signaal masker van wachtende signalen wordt bewaard in set.
De sigsuspend aanroep vervangt tijdelijk het signaal masker voor het
proces met dat gegeven door masker en schort dan het proces op totdat
een signaal ontvangen wordt.
sigaction, sigprocmask, sigpending en sigsuspend geven 0 bij slagen en
-1 bij fout.
FOUTEN
EINVAL {ongeldig} Een ongeldig signaal werd opgegeven. Dit zal ook
voortgebracht worden als een poging wordt gedaan om de actie
voor SIGKILL of SIGSTOP, te veranderen, die niet gevangen kunnen
worden.
EFAULT {fout} act, oldact, set of oldset wijzen naar geheugen dat niet
een geldig onderdeel van de proces adresruimte is.
EINTR {onderbroken} Systeem aanroep werd onderbroken.
OPMERKINGEN
Het is niet mogelijk om SIGKILL of SIGSTOP te blokkeren met de sigproc‐
mask aanroep. Pogingen om dat te doen zullen stilzwijgend genegeerd
worden.
Volgens POSIX is het gedrag van een proces ongedefinieerd als het een
SIGFPE, SIGILL of SIGSEGV negeert dat niet voortgebracht werd door de
kill() of de raise() functies. Heel getal delen door nul heeft
ongedefinieerd gevolg. Op sommige architecturen zal het een SIGFPE
signaal veroorzaken. (Ook het delen van het meest negatieve hele getal
door -1 kan een SIGFPE veroorzaken.) Negeren van dit signaal zou tot
een eindeloze lus kunnen leiden.
POSIX (B.3.3.1.3) status niet toe de actie voor SIGCHLD naar SIG_IGN te
zetten. De BSD en SYSV gedragingen verschillen, wat zorgt dat BSD
zachtgoed {software ;)}, dat de actie voor SIGCHLD naar SIG_IGN zet
faalt op Linux.
De POSIX bepaling bepaald alleen SA_NOCLDSTOP. Gebruik van andere
sa_flags {*vlaggen} is niet-draagbaar.
De SA_RESETHAND vlag is overdraagbaar met de SVr4 vlag met dezelfde
naam.
De SA_NODEFER vlag is overeenkomstig met de SVr4 vlag met dezelfde naam
onder kernels 1.3.9 en nieuwer. Op oudere kernels liet de Linux-verw‐
erkelijking het ontvangen van elk signaal toe, niet alleen degenen die
we installeren (elke sa_mask zetting dus te niet doende)
De SA_RESETHAND en SA_NODEFER namen voor SVr4 overdraagbaarheid zijn
alleen aanwezig in bibliotheek versie 3.0.9 en hoger.
De SA_SIGINFO vlag wordt opgegeven door POSIX.1b. Ondersteuning ervoor
werd toegevoegd in Linux 2.2.
sigaction kan aangeroepen worden met een tweede argument nul om de
huidige signaalbehandelaar te ondervragen. Het kan ook gebruikt worden
om te testen of een gegeven signaal geldig is voor de huidige machine,
door het aan te roepen met ’nul’ tweede en derde argumenten.
Zie sigsetops(3) voor details over manipuleren van signaal sets.
POSIX, SVr4. SVr4 beschrijft de EINTR toestand niet.
ZIE
kill(1) {vermoord}, kill(2) {vermoord}, killpg(2) {vermoord proces
groep}, pause(2){pauze}," raise(3) {opkomen}, siginterrupt(3) {signaal
onderbreking}, signal(2) {signaal}, signal(7) {signaal}, sigsetops(3)
{signaal zet operatie}, sigvec(2) {bsd signaal}
VERTALING
Dit is een handleiding uit manpages-dev 1.29. Alles wat tussen
‘{’..‘}’ staat is aanvullende vertaling, en hoort niet bij de originele
handleiding. Email naar <manpages-nl@nl.linux.org>.
$Id: sigaction.2,v 1.1.1.1 2004/03/21 21:02:25 cor Exp $