Date: Fri, 5 Jan 2001 21:06:18 +0000 From: Ben Smithurst <ben@FreeBSD.org> To: Will Andrews <will@physics.purdue.edu> Cc: doc@FreeBSD.org Subject: Re: sigmask(2) MLINK? against sigsetmask(2)/sigblock(2) manpages... Message-ID: <20010105210618.P85794@strontium.scientia.demon.co.uk> In-Reply-To: <20010104132137.H86630@argon.firepipe.net> References: <20010104115943.F86630@argon.firepipe.net> <20010104174731.J85794@strontium.scientia.demon.co.uk> <20010104132137.H86630@argon.firepipe.net>
next in thread | previous in thread | raw e-mail | index | archive | help
Will Andrews wrote:
> Well, I'm trying to figure out why it should be in *BOTH* manpages. And
> then there's the question of which one it should be in.
Thinking about it, the best solution might be to put sigblock,
sigsetmask and sigmask all in one manpage with appropriate MLINKS.
Something like this.
Index: Makefile.inc
===================================================================
RCS file: /usr/cvs/src/lib/libc/compat-43/Makefile.inc,v
retrieving revision 1.9
diff -u -r1.9 Makefile.inc
--- Makefile.inc 1999/08/27 23:58:12 1.9
+++ Makefile.inc 2001/01/05 21:01:16
@@ -8,9 +8,12 @@
setrgid.c setruid.c sigcompat.c
.if ${LIB} == "c"
-MAN2+= creat.2 killpg.2 sigblock.2 sigpause.2 sigsetmask.2 sigvec.2
+MAN2+= creat.2 killpg.2 sigpause.2 sigsetmask.2 sigvec.2
MAN3+= gethostid.3 setruid.3
MLINKS+=gethostid.3 sethostid.3
MLINKS+=setruid.3 setrgid.3
+
+MLINKS+=sigsetmask.2 sigblock.2
+MLINKS+=sigsetmask.2 sigmask.2
.endif
Index: sigsetmask.2
===================================================================
RCS file: /usr/cvs/src/lib/libc/compat-43/sigsetmask.2,v
retrieving revision 1.8
diff -u -r1.8 sigsetmask.2
--- sigsetmask.2 2000/04/21 09:39:18 1.8
+++ sigsetmask.2 2001/01/05 21:05:14
@@ -36,15 +36,19 @@
.Dt SIGSETMASK 2
.Os BSD 4.2
.Sh NAME
-.Nm sigsetmask
-.Nd set current signal mask
+.Nm sigsetmask ,
+.Nm sigblock
+.Nd manipulate current signal mask
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.Fd #include <signal.h>
.Ft int
.Fn sigsetmask "int mask"
-.Fn sigmask signum
+.Ft int
+.Fn sigblock "int mask"
+.Ft int
+.Fn sigmask "int signum"
.Sh DESCRIPTION
.Bf -symbolic
This interface is made obsolete by:
@@ -52,11 +56,19 @@
.Xr sigprocmask 2 .
.Pp
.Fn Sigsetmask
-sets the current signal mask. Signals
-are blocked from delivery if the
-corresponding bit in
+sets the current signal mask to the specified
+.Fa mask .
+Signals are blocked from delivery if the corresponding bit in
+.Fa mask
+is a 1.
+.Fn Sigblock
+adds the signals in the specified
.Fa mask
-is a 1; the macro
+to the current signal mask,
+rather than overwriting it as
+.Fn sigsetmask
+does.
+The macro
.Fn sigmask
is provided to construct the mask for a given
.Fa signum .
@@ -68,11 +80,13 @@
.Dv SIGSTOP
to be blocked.
.Sh RETURN VALUES
-The previous set of masked signals is returned.
+.Fn Sigblock
+and
+.Fn sigsetmask
+return the previous set of masked signals.
.Sh SEE ALSO
.Xr kill 2 ,
.Xr sigaction 2 ,
-.Xr sigblock 2 ,
.Xr sigprocmask 2 ,
.Xr sigsuspend 2 ,
.Xr sigvec 2 ,
@@ -80,6 +94,8 @@
.Sh HISTORY
The
.Fn sigsetmask
-function call appeared in
+and
+.Fn sigblock
+function calls first appeared in
.Bx 4.2
-and has been deprecated.
+and have been deprecated.
and cvs rm sigblock.2
--
Ben Smithurst / ben@FreeBSD.org / PGP: 0x99392F7D
To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010105210618.P85794>