Date: Thu, 14 Jan 2010 14:40:06 GMT From: dfilter@FreeBSD.ORG (dfilter service) To: freebsd-doc@FreeBSD.org Subject: Re: docs/142815: commit references a PR Message-ID: <201001141440.o0EEe692087877@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/142815; it has been noted by GNATS. From: dfilter@FreeBSD.ORG (dfilter service) To: bug-followup@FreeBSD.org Cc: Subject: Re: docs/142815: commit references a PR Date: Thu, 14 Jan 2010 14:36:53 +0000 (UTC) Author: jhb Date: Thu Jan 14 14:36:39 2010 New Revision: 202284 URL: http://svn.freebsd.org/changeset/base/202284 Log: - Update required headers for namei() to add <sys/fcntl.h> and remove <sys/proc.h>. - Add RETURN VALUES and ERROR sections for namei()'s error return values. - Add a missing link to NDHASGIANT.9. PR: docs/142815, docs/142816 Submitted by: Lachlan Kang (1, 2) MFC after: 3 days Modified: head/share/man/man9/Makefile head/share/man/man9/namei.9 Modified: head/share/man/man9/Makefile ============================================================================== --- head/share/man/man9/Makefile Thu Jan 14 14:30:54 2010 (r202283) +++ head/share/man/man9/Makefile Thu Jan 14 14:36:39 2010 (r202284) @@ -903,7 +903,8 @@ 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 NDINIT.9 + namei.9 NDINIT.9 \ + namei.9 NDHASGIANT.9 MLINKS+=pbuf.9 getpbuf.9 \ pbuf.9 relpbuf.9 \ pbuf.9 trypbuf.9 Modified: head/share/man/man9/namei.9 ============================================================================== --- head/share/man/man9/namei.9 Thu Jan 14 14:30:54 2010 (r202283) +++ head/share/man/man9/namei.9 Thu Jan 14 14:36:39 2010 (r202284) @@ -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 _______________________________________________ svn-src-all@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/svn-src-all To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201001141440.o0EEe692087877>