Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 19 Jan 2010 20:48:57 +0000 (UTC)
From:      John Baldwin <jhb@FreeBSD.org>
To:        src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-stable@freebsd.org, svn-src-stable-7@freebsd.org
Subject:   svn commit: r202653 - stable/7/share/man/man9
Message-ID:  <201001192048.o0JKmvmK003615@svn.freebsd.org>

next in thread | raw e-mail | index | archive | help
Author: jhb
Date: Tue Jan 19 20:48:57 2010
New Revision: 202653
URL: http://svn.freebsd.org/changeset/base/202653

Log:
  MFC 202284,202650:
  - Update required headers for namei() to remove <sys/proc.h>.
  - Add RETURN VALUES and ERROR sections for namei()'s error return values.
  - Add a missing link to NDHASGIANT.9.

Modified:
  stable/7/share/man/man9/Makefile
  stable/7/share/man/man9/namei.9
Directory Properties:
  stable/7/share/man/man9/   (props changed)

Modified: stable/7/share/man/man9/Makefile
==============================================================================
--- stable/7/share/man/man9/Makefile	Tue Jan 19 20:48:23 2010	(r202652)
+++ stable/7/share/man/man9/Makefile	Tue Jan 19 20:48:57 2010	(r202653)
@@ -852,6 +852,7 @@ MLINKS+=mutex.9 mtx_assert.9 \
 	mutex.9 mtx_unlock_spin.9 \
 	mutex.9 mtx_unlock_spin_flags.9
 MLINKS+=namei.9 NDFREE.9 \
+	namei.9 NDHASGIANT.9 \
 	namei.9 NDINIT.9
 MLINKS+=pbuf.9 getpbuf.9 \
 	pbuf.9 relpbuf.9 \

Modified: stable/7/share/man/man9/namei.9
==============================================================================
--- stable/7/share/man/man9/namei.9	Tue Jan 19 20:48:23 2010	(r202652)
+++ stable/7/share/man/man9/namei.9	Tue Jan 19 20:48:57 2010	(r202653)
@@ -44,7 +44,7 @@
 .Nd pathname translation and lookup operations
 .Sh SYNOPSIS
 .In sys/param.h
-.In sys/proc.h
+.\".In sys/fcntl.h
 .In sys/namei.h
 .Ft int
 .Fn namei "struct nameidata *ndp"
@@ -315,6 +315,34 @@ flag can be passed to the
 .Fn NDFREE
 function.
 .El
+.Sh RETURN VALUES
+If successful,
+.Fn namei
+will return 0, otherwise it will return an error.
+.Sh ERRORS
+Errors which
+.Fn namei
+may return:
+.Bl -tag -width Er
+.It Bq Er ENOTDIR
+A component of the specified pathname is not a directory when a directory is
+expected.
+.It Bq Er ENAMETOOLONG
+A component of a pathname exceeded 255 characters,
+or an entire pathname exceeded 1023 characters.
+.It Bq Er ENOENT
+A component of the specified pathname does not exist,
+or the pathname is an empty string.
+.It Bq Er ACCES
+An attempt is made to access a file in a way forbidden by its file access
+permissions.
+.It Bq Er ELOOP
+Too many symbolic links were encountered in translating the pathname.
+.It Bq Er EISDIR
+An attempt is made to open a directory with write mode specified.
+.It Bq Er EROFS
+An attempt is made to modify a file or directory on a read-only file system.
+.El
 .Sh FILES
 .Bl -tag
 .It Pa src/sys/kern/vfs_lookup.c



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201001192048.o0JKmvmK003615>