]>
Commit | Line | Data |
---|---|---|
c11b1abf | 1 | .\" Copyright (c) 2007 by Michael Kerrisk <mtk.manpages@gmail.com> |
c48ef83f | 2 | .\" |
5fbde956 | 3 | .\" SPDX-License-Identifier: Linux-man-pages-copyleft |
c48ef83f | 4 | .\" |
45186a5d | 5 | .TH SGETMASK 2 2021-03-22 "Linux man-pages (unreleased)" |
c48ef83f MK |
6 | .SH NAME |
7 | sgetmask, ssetmask \- manipulation of signal mask (obsolete) | |
c399eb00 AC |
8 | .SH LIBRARY |
9 | Standard C library | |
8fc3b2cf | 10 | .RI ( libc ", " \-lc ) |
c48ef83f | 11 | .SH SYNOPSIS |
511bb71b | 12 | .nf |
1cd36d9d AC |
13 | .BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" |
14 | .B #include <unistd.h> | |
15 | .PP | |
16 | .B "long syscall(SYS_sgetmask, void);" | |
17 | .BI "long syscall(SYS_ssetmask, long " newmask ); | |
511bb71b | 18 | .fi |
dbfe9c70 | 19 | .PP |
45c99e3e | 20 | .IR Note : |
1cd36d9d AC |
21 | glibc provides no wrappers for these functions, |
22 | necessitating the use of | |
23 | .BR syscall (2). | |
c48ef83f MK |
24 | .SH DESCRIPTION |
25 | These system calls are obsolete. | |
26 | .IR "Do not use them" ; | |
27 | use | |
28 | .BR sigprocmask (2) | |
29 | instead. | |
efeece04 | 30 | .PP |
c48ef83f MK |
31 | .BR sgetmask () |
32 | returns the signal mask of the calling process. | |
efeece04 | 33 | .PP |
c48ef83f | 34 | .BR ssetmask () |
0fa2491f | 35 | sets the signal mask of the calling process to the value given in |
c48ef83f MK |
36 | .IR newmask . |
37 | The previous signal mask is returned. | |
efeece04 | 38 | .PP |
c48ef83f MK |
39 | The signal masks dealt with by these two system calls |
40 | are plain bit masks (unlike the | |
41 | .I sigset_t | |
42 | used by | |
43 | .BR sigprocmask (2)); | |
0fa2491f | 44 | use |
c48ef83f | 45 | .BR sigmask (3) |
0fa2491f | 46 | to create and inspect these masks. |
c48ef83f MK |
47 | .SH RETURN VALUE |
48 | .BR sgetmask () | |
49 | always successfully returns the signal mask. | |
50 | .BR ssetmask () | |
51 | always succeeds, and returns the previous signal mask. | |
52 | .SH ERRORS | |
53 | These system calls always succeed. | |
a9adf515 MK |
54 | .SH VERSIONS |
55 | Since Linux 3.16, | |
56 | .\" f6187769dae48234f3877df3c4d99294cc2254fa | |
57 | support for these system calls is optional, | |
58 | depending on whether the kernel was built with the | |
59 | .B CONFIG_SGETMASK_SYSCALL | |
60 | option. | |
3113c7f3 | 61 | .SH STANDARDS |
8382f16d | 62 | These system calls are Linux-specific. |
c48ef83f | 63 | .SH NOTES |
c48ef83f MK |
64 | These system calls are unaware of signal numbers greater than 31 |
65 | (i.e., real-time signals). | |
efeece04 | 66 | .PP |
cb012d1d | 67 | These system calls do not exist on x86-64. |
efeece04 | 68 | .PP |
c48ef83f MK |
69 | It is not possible to block |
70 | .B SIGSTOP | |
71 | or | |
72 | .BR SIGKILL . | |
73 | .SH SEE ALSO | |
0fa2491f | 74 | .BR sigprocmask (2), |
c48ef83f | 75 | .BR signal (7) |