From owner-freebsd-doc  Fri Apr 13  4:10: 8 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 BC02037B424
	for <freebsd-doc@freebsd.org>; Fri, 13 Apr 2001 04:10:04 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f3DBA4s30507;
	Fri, 13 Apr 2001 04:10:04 -0700 (PDT)
	(envelope-from gnats)
Date: Fri, 13 Apr 2001 04:10:04 -0700 (PDT)
Message-Id: <200104131110.f3DBA4s30507@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Bruce Evans <bde@zeta.org.au>
Subject: Re: docs/26520: getpgid(2) doesn't describe error conditions for
 getpgid() 
Reply-To: Bruce Evans <bde@zeta.org.au>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/26520; it has been noted by GNATS.

From: Bruce Evans <bde@zeta.org.au>
To: Dima Dorfman <dima@unixfreak.org>
Cc: rwatson@freebsd.org, FreeBSD-gnats-submit@freebsd.org,
	bde@freebsd.org
Subject: Re: docs/26520: getpgid(2) doesn't describe error conditions for
 getpgid() 
Date: Fri, 13 Apr 2001 21:08:47 +1000 (EST)

 On Fri, 13 Apr 2001, Dima Dorfman wrote:
 
 > [ cc'd to bde since he has (some copy of) the POSIX spec ]
 > 
 > rwatson@freebsd.org writes:
 > > 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).
 > > 
 > > >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.
 > 
 > Bruce, can you check if this is true?  If that's the case, I'll fix
 > the man page.
 
 SUSv2 says that getpgid() returns (pid_t)-1 and sets errno on error.
 
 (The cast is not really necessary in this case, unlike for ((time_t)-1),
 since -1 is small and pid_t is signed.)
 
 Bruce
 

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