From owner-freebsd-doc@FreeBSD.ORG Thu Oct 30 00:40:12 2003 Return-Path: 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 6B6CF16A4CE for ; Thu, 30 Oct 2003 00:40:12 -0800 (PST) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id B360143FBF for ; Thu, 30 Oct 2003 00:40:10 -0800 (PST) (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 h9U8eAFY080714 for ; Thu, 30 Oct 2003 00:40:10 -0800 (PST) (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.12.9/8.12.9/Submit) id h9U8eAtA080713; Thu, 30 Oct 2003 00:40:10 -0800 (PST) (envelope-from gnats) Resent-Date: Thu, 30 Oct 2003 00:40:10 -0800 (PST) Resent-Message-Id: <200310300840.h9U8eAtA080713@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 Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4E9DC16A4CE for ; 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 ; 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/58710: killpg(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 List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 30 Oct 2003 08:40:12 -0000 >Number: 58710 >Category: docs >Synopsis: killpg(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 30 00:40:08 PST 2003 >Closed-Date: >Last-Modified: >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: >Unformatted: