From owner-freebsd-doc Fri Jan 5 13: 6:31 2001 From owner-freebsd-doc@FreeBSD.ORG Fri Jan 5 13:06:22 2001 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from scientia.demon.co.uk (scientia.demon.co.uk [212.228.14.13]) by hub.freebsd.org (Postfix) with ESMTP id EA26937B6B6 for ; Fri, 5 Jan 2001 13:06:20 -0800 (PST) Received: from strontium.scientia.demon.co.uk ([192.168.91.36] ident=root) by scientia.demon.co.uk with esmtp (Exim 3.20 #1) id 14Ee43-00048u-00; Fri, 05 Jan 2001 21:06:19 +0000 Received: (from ben@localhost) by strontium.scientia.demon.co.uk (8.11.1/8.11.1) id f05L6Jm55296; Fri, 5 Jan 2001 21:06:19 GMT (envelope-from ben) Date: Fri, 5 Jan 2001 21:06:18 +0000 From: Ben Smithurst To: Will Andrews Cc: doc@FreeBSD.org Subject: Re: sigmask(2) MLINK? against sigsetmask(2)/sigblock(2) manpages... Message-ID: <20010105210618.P85794@strontium.scientia.demon.co.uk> References: <20010104115943.F86630@argon.firepipe.net> <20010104174731.J85794@strontium.scientia.demon.co.uk> <20010104132137.H86630@argon.firepipe.net> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5i In-Reply-To: <20010104132137.H86630@argon.firepipe.net> Sender: ben@scientia.demon.co.uk Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org 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 .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