From owner-freebsd-doc  Thu Apr 12 12:50: 6 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id B80B337B43E
	for <freebsd-doc@freebsd.org>; Thu, 12 Apr 2001 12:50:01 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f3CJo1938094;
	Thu, 12 Apr 2001 12:50:01 -0700 (PDT)
	(envelope-from gnats)
Received: from fledge.watson.org (fledge.watson.org [204.156.12.50])
	by hub.freebsd.org (Postfix) with ESMTP id E8F1537B43F
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 12 Apr 2001 12:43:22 -0700 (PDT)
	(envelope-from robert@fledge.watson.org)
Received: (from robert@localhost)
	by fledge.watson.org (8.11.3/8.11.3) id f3CJaHZ09458;
	Thu, 12 Apr 2001 15:36:17 -0400 (EDT)
	(envelope-from robert)
Message-Id: <200104121936.f3CJaHZ09458@fledge.watson.org>
Date: Thu, 12 Apr 2001 15:36:17 -0400 (EDT)
From: rwatson@freebsd.org
Reply-To: rwatson@freebsd.org
To: FreeBSD-gnats-submit@freebsd.org
X-Send-Pr-Version: 3.113
Subject: docs/26520: getpgid(2) doesn't describe error conditions for getpgid()
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org


>Number:         26520
>Category:       docs
>Synopsis:       getpgid(2) doesn't describe error conditions for getpgid()
>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 Apr 12 12:50:01 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Robert Watson
>Release:        FreeBSD 4.3-RC i386
>Organization:
>Environment:
System: FreeBSD fledge.watson.org 4.3-RC FreeBSD 4.3-RC #0: Wed Apr 4 11:31:14 EDT 2001 robert@fledge.watson.org:/usr/obj/data/fbsd-stable/src/sys/FLEDGE i386

>Description:

Most system call man pages make an effort to describe potential error
return conditions for the call.  getpgid(2), however, neglects to note that
the returned pid can be (-1), indicating that errno should be inspected,
in the style of getsid(2).

>How-To-Repeat:

man 2 getpgid

>Fix:

Probably need to copy the relevant part of getsid(2) into getpgid(2).
However, this probably involves first consulting relevant specs defining
getpgid(2) to determine if our implementation complies or not.

>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message