| 1 |
.\" Copyright 2007, Michael Kerrisk <[email protected]> |
| 2 |
.\" Copyright, the authors of the Linux man-pages project |
| 3 |
.\" |
| 4 |
.\" SPDX-License-Identifier: Linux-man-pages-copyleft |
| 5 |
.\" |
| 6 |
.TH sgetmask 2 2026-02-08 "Linux man-pages 6.18" |
| 7 |
.SH NAME |
| 8 |
sgetmask, ssetmask \- manipulation of signal mask (obsolete) |
| 9 |
.SH LIBRARY |
| 10 |
Standard C library |
| 11 |
.RI ( libc ,\~ \-lc ) |
| 12 |
.SH SYNOPSIS |
| 13 |
.nf |
| 14 |
.BR "#include <sys/syscall.h>" " /* Definition of " SYS_* " constants */" |
| 15 |
.B #include <unistd.h> |
| 16 |
.P |
| 17 |
.B [[deprecated]] long syscall(SYS_sgetmask, void); |
| 18 |
.BI "[[deprecated]] long syscall(SYS_ssetmask, long " newmask ); |
| 19 |
.fi |
| 20 |
.SH DESCRIPTION |
| 21 |
These system calls are obsolete. |
| 22 |
.IR "Do not use them" ; |
| 23 |
use |
| 24 |
.BR sigprocmask (2) |
| 25 |
instead. |
| 26 |
.P |
| 27 |
.BR sgetmask () |
| 28 |
returns the signal mask of the calling process. |
| 29 |
.P |
| 30 |
.BR ssetmask () |
| 31 |
sets the signal mask of the calling process to the value given in |
| 32 |
.IR newmask . |
| 33 |
The previous signal mask is returned. |
| 34 |
.P |
| 35 |
The signal masks dealt with by these two system calls |
| 36 |
are plain bit masks (unlike the |
| 37 |
.I sigset_t |
| 38 |
used by |
| 39 |
.BR sigprocmask (2)); |
| 40 |
use |
| 41 |
.BR sigmask (3) |
| 42 |
to create and inspect these masks. |
| 43 |
.SH RETURN VALUE |
| 44 |
.BR sgetmask () |
| 45 |
always successfully returns the signal mask. |
| 46 |
.BR ssetmask () |
| 47 |
always succeeds, and returns the previous signal mask. |
| 48 |
.SH ERRORS |
| 49 |
These system calls always succeed. |
| 50 |
.SH STANDARDS |
| 51 |
Linux. |
| 52 |
.SH HISTORY |
| 53 |
Since Linux 3.16, |
| 54 |
.\" f6187769dae48234f3877df3c4d99294cc2254fa |
| 55 |
support for these system calls is optional, |
| 56 |
depending on whether the kernel was built with the |
| 57 |
.B CONFIG_SGETMASK_SYSCALL |
| 58 |
option. |
| 59 |
.SH NOTES |
| 60 |
These system calls are unaware of signal numbers greater than 31 |
| 61 |
(i.e., real-time signals). |
| 62 |
.P |
| 63 |
These system calls do not exist on x86-64. |
| 64 |
.P |
| 65 |
It is not possible to block |
| 66 |
.B SIGSTOP |
| 67 |
or |
| 68 |
.BR SIGKILL . |
| 69 |
.SH SEE ALSO |
| 70 |
.BR sigprocmask (2), |
| 71 |
.BR signal (7) |