Subject: misc/23565: intro(2) has obsolete line
To: None <>
From: None <>
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
>Originator:     SAITOH Akinori
>Release:        NetBSD 1.6F
	Osaka University, Japan
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
	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.

	% man 2 intro
	- An empty pathname refers to the current directory.
	+ A null pathname is invalid.