. use library function to parse memory string
[minix3.git] / man / man3 / sigset.3
blobf832f7119aa86dd1e50d67db18e25cd984a0acd9
1 .TH SIGSET 3
2 .SH NAME
3 sigset, sigaddset, sigdelset, sigemptyset, sigfillset, sigismember \- manipulate signal sets
4 .SH SYNOPSIS
5 .ft B
6 #include <signal.h>
8 .nf
9 int sigaddset(sigset_t *\fIset\fP, int \fIsig\fP)
10 int sigdelset(sigset_t *\fIset\fP, int \fIsig\fP)
11 int sigemptyset(sigset_t *\fIset\fP)
12 int sigfillset(sigset_t *\fIset\fP)
13 int sigismember(const sigset_t *\fIset\fP, int \fIsig\fP)
14 .fi
15 .ft P
16 .SH DESCRIPTION
17 The system calls that handle signals, such as
18 .BR sigaction (2)
19 and
20 .BR sigprocmask (2)
21 use sets of signals to keep a process from being interrupted by those
22 signals while executing a signal handler or a critical code segment.  These
23 signal sets are manipulated by the following functions:
24 .TP 5
25 .B "int sigaddset(sigset_t *\fIset\fP, int \fIsig\fP)"
26 Add signal
27 .I sig
28 to the signal set referenced by
29 .IR set .
30 .TP
31 .B "int sigdelset(sigset_t *\fIset\fP, int \fIsig\fP)"
32 Remove signal
33 .I sig
34 from the signal set referenced by
35 .IR set .
36 .TP
37 .B "int sigemptyset(sigset_t *\fIset\fP)"
38 Initialize the signal set referenced by
39 .I set
40 to an empty set.
41 .TP
42 .B "int sigfillset(sigset_t *\fIset\fP)"
43 Initialize the signal set referenced by
44 .I set
45 to an full set, i.e. all signals are in the set.
46 .TP
47 .B "int sigismember(const sigset_t *\fIset\fP, int \fIsig\fP)"
48 Return
49 .B 1
50 if the signal
51 .I sig
52 is present in the set referenced by
53 .IR set ,
54 .B 0
55 otherwise.
56 .SH "SEE ALSO"
57 .BR sigaction (2),
58 .BR sigpending (2),
59 .BR sigprocmask (2),
60 .BR sigsuspend (2).
61 .SH DIAGNOSTICS
62 All functions except
63 .B sigismember
64 return
65 .B 0
66 on success.
67 .B Sigismember
68 returns
69 .B 0
71 .B 1
72 on success.  They return
73 .B \-1
74 with error code
75 .B EINVAL
76 for an invalid signal number.  (They do not use
77 .B EFAULT
78 for a bad
79 .I set
80 address, but will simply cause a segmentation violation.)
81 .SH AUTHOR
82 Kees J. Bot (kjb@cs.vu.nl)
84 .\"
85 .\" $PchId: sigset.3,v 1.2 1996/04/11 06:39:09 philip Exp $