From owner-freebsd-doc@FreeBSD.ORG  Thu Jan 14 15:03:51 2010
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 9F1E81065670;
	Thu, 14 Jan 2010 15:03:51 +0000 (UTC) (envelope-from jhb@freebsd.org)
Received: from cyrus.watson.org (cyrus.watson.org [65.122.17.42])
	by mx1.freebsd.org (Postfix) with ESMTP id 707868FC1C;
	Thu, 14 Jan 2010 15:03:51 +0000 (UTC)
Received: from bigwig.baldwin.cx (66.111.2.69.static.nyinternet.net
	[66.111.2.69])
	by cyrus.watson.org (Postfix) with ESMTPSA id 1CDF946B0D;
	Thu, 14 Jan 2010 10:03:51 -0500 (EST)
Received: from jhbbsd.localnet (smtp.hudson-trading.com [209.249.190.9])
	by bigwig.baldwin.cx (Postfix) with ESMTPA id AF7258A01D;
	Thu, 14 Jan 2010 10:03:38 -0500 (EST)
From: John Baldwin <jhb@freebsd.org>
To: freebsd-doc@freebsd.org
Date: Thu, 14 Jan 2010 09:30:43 -0500
User-Agent: KMail/1.12.1 (FreeBSD/7.2-CBSD-20091231; KDE/4.3.1; amd64; ; )
References: <201001140520.o0E5KsgU030632@www.freebsd.org>
In-Reply-To: <201001140520.o0E5KsgU030632@www.freebsd.org>
MIME-Version: 1.0
Content-Type: Text/Plain;
  charset="iso-8859-15"
Content-Transfer-Encoding: 7bit
Message-Id: <201001140930.43322.jhb@freebsd.org>
X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.0.1
	(bigwig.baldwin.cx); Thu, 14 Jan 2010 10:03:38 -0500 (EST)
X-Virus-Scanned: clamav-milter 0.95.1 at bigwig.baldwin.cx
X-Virus-Status: Clean
X-Spam-Status: No, score=-2.6 required=4.2 tests=AWL,BAYES_00 autolearn=ham
	version=3.2.5
X-Spam-Checker-Version: SpamAssassin 3.2.5 (2008-06-10) on bigwig.baldwin.cx
Cc: freebsd-gnats-submit@freebsd.org,
	Lachlan Kang <LCRTRIfFu91c710azO2Y@live.co.uk>
Subject: Re: docs/142816: [patch] namei(9) return values
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
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, 14 Jan 2010 15:03:51 -0000

On Thursday 14 January 2010 12:20:54 am Lachlan Kang wrote:
> 
> >Number:         142816
> >Category:       docs
> >Synopsis:       [patch] namei(9) return values
> >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 Jan 14 05:30:02 UTC 2010
> >Closed-Date:
> >Last-Modified:
> >Originator:     Lachlan Kang
> >Release:        FreeBSD 8.0-RELEASE
> >Organization:
> >Environment:
> >Description:
> The manpage namei(9) does not specify the return value of the function 
namei().
> The function namei() returns 0 on success, or errno on failure.
> I skimmed through the namei() source code (src/sys/kern/vfs_lookup.c) and 
added a simple RETURN VALUES and ERRORS section to the namei(9) manpage.
> The error code descriptions were simply copied from intro(2).
> >How-To-Repeat:
> man 9 namei
> >Fix:
> Add a RETURN VALUES and ERRORS section to namei(9).
> 
> Patch attached with submission follows:

Thanks!  I've modified this slightly (added missing line breaks to ease 
translation work) and changed the error descriptions to more closely match 
what is used in open(2).

-- 
John Baldwin