xref: /csrg-svn/lib/libc/gen/sigsetops.3 (revision 48352)
1*48352Scael.\" Copyright (c) 1983, 1991 The Regents of the University of California.
244873Skarels.\" All rights reserved.
344873Skarels.\"
444873Skarels.\" %sccs.include.redist.man%
544873Skarels.\"
6*48352Scael.\"     @(#)sigsetops.3	6.2 (Berkeley) 04/19/91
744873Skarels.\"
8*48352Scael.Dd
9*48352Scael.Dt SIGSETOPS 3
10*48352Scael.Os
11*48352Scael.Sh NAME
12*48352Scael.Nm sigsetops ,
13*48352Scael.Nm sigemptyset ,
14*48352Scael.Nm sigfillset ,
15*48352Scael.Nm sigaddset ,
16*48352Scael.Nm sigdelset ,
17*48352Scael.Nm sigismember
18*48352Scael.Nd manipulate signal masks
19*48352Scael.Sh SYNOPSIS
20*48352Scael.Fd #include <signal.h>
21*48352Scael.Fn sigemptyset "sigset_t *set"
22*48352Scael.Fn sigfillset "sigset_t *set"
23*48352Scael.Fn sigaddset "sigset_t *set" "int signo"
24*48352Scael.Fn sigdelset "sigset_t *set" "int signo"
25*48352Scael.Fn sigismember "sigset_t *set" "int signo"
26*48352Scael.Sh DESCRIPTION
2744873SkarelsThese functions manipulate signal mask stored in a
28*48352Scael.Fa sigset_t .
2944873SkarelsThey are provided as macros, but actual functions are available
3044873Skarelsif their names are undefined (with #undef
31*48352Scael.Em name ) .
32*48352Scael.Pp
3344873SkarelsThe
34*48352Scael.Fn sigemptyset
3544873Skarelsfunction initializes a signal set to be empty.
3644873SkarelsThe
37*48352Scael.Fn sigfillset
3844873Skarelsfunction initializes a signal set to contain all of the known signals.
3944873SkarelsOne of these routines must be used to initialize a signal set
4044873Skarelsbefore its use by the other functions.
41*48352Scael.Pp
4244873SkarelsThe
43*48352Scael.Fn sigaddset
4444873Skarelsfunction adds a specified signal
45*48352Scael.Fa signo
4644873Skarelsto a signal set.
4744873SkarelsThe
48*48352Scael.Fn sigdelset
4944873Skarelsfunction deletes a specified signal
50*48352Scael.Fa signo
5144873Skarelsfrom a signal set.
52*48352Scael.Pp
5344873SkarelsThe
54*48352Scael.Fn sigismember
5544873Skarelsfunction tests whether a specified signal
56*48352Scael.Fa signo
5744873Skarelsis contained in a signal set.
58*48352Scael.Sh RETURN VALUES
5944873SkarelsThe
60*48352Scael.Fn sigismember
6144873Skarelsfunction returnes 1
6244873Skarelsif the signal is a member of the set,
6344873Skarelsa 0 otherwise.
6444873SkarelsThe other functions return 0 upon success.
6544873SkarelsA \-1 return value
66*48352Scaelindicates an error occurred and the global variable
67*48352Scael.Va errno
6844873Skarelsis set to indicated the reason.
6944873SkarelsThe current implementation does not detect any errors.
70*48352Scael.Sh ERRORS
7144873SkarelsThese functions could fail if one of the following occurs:
72*48352Scael.Bl -tag -width [EINVAL]
73*48352Scael.It Bq Er EINVAL
74*48352Scael.Fa signo
7544873Skarelshas an invalid value.
76*48352Scael.El
77*48352Scael.Sh SEE ALSO
78*48352Scael.Xr kill 2 ,
79*48352Scael.Xr sigaction 2 ,
80*48352Scael.Xr sigsetops 2 ,
81*48352Scael.Xr sigsuspend 2
82*48352Scael.Sh STANDARDS
83*48352ScaelThe
84*48352ScaelThese functions are defined by
85*48352Scael.St -p1003.1-88 .
86*48352Scael.Sh HISTORY
87*48352ScaelThese functions are
88*48352Scael.Ud .
89