Subject: misc/23565: intro(2) has obsolete line
To: None <gnats-bugs@gnats.netbsd.org>
From: None <saitoh@ics.es.osaka-u.ac.jp>
List: netbsd-bugs
Date: 11/25/2003 23:50:49
>Number: 23565
>Category: misc
>Synopsis: Pathname definition in intro(2) is obsolete
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: misc-bug-people
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Tue Nov 25 14:54:00 UTC 2003
>Closed-Date:
>Last-Modified:
>Originator: SAITOH Akinori
>Release: NetBSD 1.6F
>Organization:
Osaka University, Japan
>Environment:
System: NetBSD sugar 1.6F NetBSD 1.6F (SUGAR-$Revision: 1.465 $) #50: Tue Apr 1 16:32:22 JST 2003 root@sugar:/usr/src/sys/arch/i386/compile/SUGAR i386
Architecture: i386
Machine: i386
>Description:
In INTRO(2), pathname is defined as follows.
>Path Name
> A path name is a NUL-terminated character string starting with an
> optional slash `/', followed by zero or more directory names sep-
> arated by slashes, optionally followed by a file name. The total
> length of a path name must be less than 1024 (MAXPATHLEN) charac-
> ters.
>
> If a path name begins with a slash, the path search begins at the
> root directory. Otherwise, the search begins from the current
> working directory. A slash by itself names the root directory.
> An empty pathname refers to the current directory.
But for POSIX conformance, NetBSD namei(9) implementation had
already changed.
Empty pathname is treated as a illegal pathname(ENOENT),
as mentiond in vfs_lookup.c comment.
>How-To-Repeat:
% man 2 intro
>Fix:
- An empty pathname refers to the current directory.
+ A null pathname is invalid.
>Release-Note:
>Audit-Trail:
>Unformatted: