From ryan@turing.vangyzen.net  Thu Oct 30 00:32:19 2003
Return-Path: <ryan@turing.vangyzen.net>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4E9DC16A4CE
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 30 Oct 2003 00:32:19 -0800 (PST)
Received: from turing.vangyzen.net (turing.vangyzen.net [152.3.22.133])
	by mx1.FreeBSD.org (Postfix) with ESMTP id CE3B743FE0
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 30 Oct 2003 00:32:18 -0800 (PST)
	(envelope-from ryan@turing.vangyzen.net)
Received: by turing.vangyzen.net (Postfix, from userid 1010)
	id F0A4B11460; Thu, 30 Oct 2003 03:32:17 -0500 (EST)
Message-Id: <20031030083217.F0A4B11460@turing.vangyzen.net>
Date: Thu, 30 Oct 2003 03:32:17 -0500 (EST)
From: Ryan Younce <ryany@pobox.com>
Reply-To: Ryan Younce <ryany@pobox.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: killpg(2) contains an error regarding sending SIGCONT
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         58710
>Category:       docs
>Synopsis:       killpg(2) contains an error regarding sending SIGCONT
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 30 00:40:08 PST 2003
>Closed-Date:    Sun Oct 29 16:44:17 GMT 2006
>Last-Modified:  Sun Oct 29 16:44:17 GMT 2006
>Originator:     Ryan Younce
>Release:        FreeBSD 5.1-RELEASE i386
>Organization:
>Environment:
FreeBSD kara 5.1-RELEASE FreeBSD 5.1-RELEASE #3: Mon Oct  6 22:31:51 GMT 2003     root@kara:/usr/src/sys/i386/compile/KARA  i386

>Description:

	This is akin to PR docs/58413.

	The killpg(2) manual page in /usr/src/lib/libc/compat-43/killpg.2
	has the same error the kill(2) manpage had before the commit for
	the aforementioned PR, specifically the text:

	"As a single special case the continue signal SIGCONT may be sent
	to any process that is a descendant of the current process."

	This is incorrect:  as in the case for kill(2), SIGCONT may be
	sent, regardless of credentials, to any process in the same
	session; it is neither sufficient nor necessary for the recipient
	to be a descendent if user IDs differ.

	Since killpg() relies on kill(), which relies on killpg1() in
	/sys/kern/kern_sig.c, which relies on p_cansignal() in
	/sys/kern/kern_prot.c, the semantics are the same.  This has 
	also been tested.

>How-To-Repeat:

	man 2 killpg

>Fix:

	Change sentence in question to:

	"As a single special case the continue signal SIGCONT may be sent
	to any process with the same session ID as the caller.
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->patched 
State-Changed-By: maxim 
State-Changed-When: Tue Oct 10 11:38:39 UTC 2006 
State-Changed-Why:  
Fixed in HEAD.  Thanks and sorry it took so long. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=58710 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/58710: commit references a PR
Date: Tue, 10 Oct 2006 11:37:59 +0000 (UTC)

 maxim       2006-10-10 11:37:41 UTC
 
   FreeBSD src repository
 
   Modified files:
     lib/libc/compat-43   killpg.2 
   Log:
   o From kern_prot.c::p_cansignal():
   
   UNIX signalling semantics require that processes in the same
   session always be able to deliver SIGCONT to one another,
   overriding the remaining protections.
   
   Fix SIGCONT special case description similar to rev. 1.22 kill.2.
   
   PR:             docs/58710
   Submitted by:   Ryan Younce
   MFC after:      2 weeks
   
   Revision  Changes    Path
   1.13      +2 -2      src/lib/libc/compat-43/killpg.2
 _______________________________________________
 cvs-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/cvs-all
 To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: maxim 
State-Changed-When: Sun Oct 29 16:43:59 UTC 2006 
State-Changed-Why:  
Merged to RELENG_6. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=58710 
>Unformatted:
