From c48ef83f02cd2f7c101615e544cda2d8ce90bf33 Mon Sep 17 00:00:00 2001 From: Michael Kerrisk Date: Mon, 25 Jun 2007 12:01:55 +0000 Subject: [PATCH] A real man page for sgetmask(2) and ssetmask(2). --- man2/sgetmask.2 | 75 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 man2/sgetmask.2 diff --git a/man2/sgetmask.2 b/man2/sgetmask.2 new file mode 100644 index 000000000..8b176a08c --- /dev/null +++ b/man2/sgetmask.2 @@ -0,0 +1,75 @@ +'\" t +.\" Copyright (c) 2007 by Michael Kerrisk +.\" +.\" Permission is granted to make and distribute verbatim copies of this +.\" manual provided the copyright notice and this permission notice are +.\" preserved on all copies. +.\" +.\" Permission is granted to copy and distribute modified versions of this +.\" manual under the conditions for verbatim copying, provided that the +.\" entire resulting derived work is distributed under the terms of a +.\" permission notice identical to this one. +.\" +.\" Since the Linux kernel and libraries are constantly changing, this +.\" manual page may be incorrect or out-of-date. The author(s) assume no +.\" responsibility for errors or omissions, or for damages resulting from +.\" the use of the information contained herein. +.\" +.\" Formatted or processed versions of this manual, if unaccompanied by +.\" the source, must acknowledge the copyright and authors of this work. +.\" +.TH SGETMASK 7 2007-07-05 "Linux" "Linux Programmer's Manual" +.SH NAME +sgetmask, ssetmask \- manipulation of signal mask (obsolete) +.SH SYNOPSIS +.BI "long sgetmask(void);" +.sp +.BI "long ssetmask(long " newmask ); +.SH DESCRIPTION +These system calls are obsolete. +.IR "Do not use them" ; +use +.BR sigprocmask (2) +instead. + +.BR sgetmask () +returns the signal mask of the calling process. + +.BR ssetmask () +sets the +signal mask of the calling process to the value given in +.IR newmask . +The previous signal mask is returned. + +The signal masks dealt with by these two system calls +are plain bit masks (unlike the +.I sigset_t +used by +.BR sigprocmask (2)); +use the +.BR sigmask (3) +function to create and inspect these masks. +.SH RETURN VALUE +.BR sgetmask () +always successfully returns the signal mask. +.BR ssetmask () +always succeeds, and returns the previous signal mask. +.SH ERRORS +These system calls always succeed. +.SH CONFORMING TO +These system calls are Linux specific. +.SH NOTES +Glibc does not provide wrappers for these system calls; use +.BR syscall (2). + +These system calls are unaware of signal numbers greater than 31 +(i.e., real-time signals). + +It is not possible to block +.B SIGSTOP +or +.BR SIGKILL . +.SH SEE ALSO +.BR sigprocmask (7), +.BR signal (7) +.\" Add see also from signal.7