From owner-freebsd-doc@FreeBSD.ORG  Thu Oct 23 01:00:32 2003
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@hub.freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 4F07716A4B3
	for <freebsd-doc@hub.freebsd.org>;
	Thu, 23 Oct 2003 01:00:32 -0700 (PDT)
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 1EFCF43FA3
	for <freebsd-doc@hub.freebsd.org>;
	Thu, 23 Oct 2003 01:00:30 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1])
	by freefall.freebsd.org (8.12.9/8.12.9) with ESMTP id h9N80TFY074286
	for <freebsd-doc@freefall.freebsd.org>;
	Thu, 23 Oct 2003 01:00:29 -0700 (PDT)
	(envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h9N80TLQ074285;
	Thu, 23 Oct 2003 01:00:29 -0700 (PDT)
	(envelope-from gnats)
Resent-Date: Thu, 23 Oct 2003 01:00:29 -0700 (PDT)
Resent-Message-Id: <200310230800.h9N80TLQ074285@freefall.freebsd.org>
Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer)
Resent-To: freebsd-doc@FreeBSD.org
Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org,
	Ryan Younce <ryany@pobox.com>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 08F8216A4B3
	for <FreeBSD-gnats-submit@freebsd.org>;
	Thu, 23 Oct 2003 00:56:43 -0700 (PDT)
Received: from turing.vangyzen.net (turing.vangyzen.net [152.3.22.133])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 132FA43FE1
	for <FreeBSD-gnats-submit@freebsd.org>;
	Thu, 23 Oct 2003 00:56:42 -0700 (PDT)
	(envelope-from ryan@turing.vangyzen.net)
Received: by turing.vangyzen.net (Postfix, from userid 1010)
	id C849911532; Thu, 23 Oct 2003 04:19:09 -0400 (EDT)
Message-Id: <20031023081909.C849911532@turing.vangyzen.net>
Date: Thu, 23 Oct 2003 04:19:09 -0400 (EDT)
From: Ryan Younce <ryan@tribug.org>
To: FreeBSD-gnats-submit@FreeBSD.org
X-Send-Pr-Version: 3.113
Subject: docs/58413: kill(2) contains an error regarding sending SIGCONT
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
Reply-To: Ryan Younce <ryany@pobox.com>
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 23 Oct 2003 08:00:32 -0000


>Number:         58413
>Category:       docs
>Synopsis:       kill(2) contains an error regarding sending SIGCONT
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 23 01:00:27 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Ryan Younce
>Release:        FreeBSD 5.1-BETA i386
>Organization:
>Environment:
System: FreeBSD turing.vangyzen.net 5.1-BETA FreeBSD 5.1-BETA #0: Tue May 6 12:07:36 GMT 2003 root@hollin.btc.adaptec.com:/usr/obj/usr/src/sys/GENERIC i386

>Description:

The kill(2) manual page for CURRENT states "A single exception is the
signal SIGCONT, which may always be sent to any descendent of the current
process."

In CURRENT, however, this provision is false:  the process can send
SIGCONT to any other process in the caller's session (to align with POSIX).

Behavior has been tested, also reference:
p_cansignal() function in /sys/kern/kern_prot.c

>How-To-Repeat:

man 2 kill

>Fix:

Change sentence in question to:

	"A single exception is the signal SIGCONT, which may always be sent
	to any process with the same session ID as the caller."

or something similar.
>Release-Note:
>Audit-Trail:
>Unformatted: