man2/sgetmask.2

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