summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJoel Sherrill <joel.sherrill@OARcorp.com>2000-06-30 12:49:40 +0000
committerJoel Sherrill <joel.sherrill@OARcorp.com>2000-06-30 12:49:40 +0000
commite86236b481d9d6b54704fc8e4f91234108a18286 (patch)
treee38aafab5163d385c58ba0a827277c85bc2aaeab /doc
parente8fd6336c1e837b2047f3b0ba2dd53056eeb13c5 (diff)
downloadrtems-e86236b481d9d6b54704fc8e4f91234108a18286.tar.bz2
Added fchdir().
Diffstat (limited to 'doc')
-rw-r--r--doc/posix_users/files.t63
1 files changed, 63 insertions, 0 deletions
diff --git a/doc/posix_users/files.t b/doc/posix_users/files.t
index 16018bb647..fa153fed35 100644
--- a/doc/posix_users/files.t
+++ b/doc/posix_users/files.t
@@ -23,6 +23,7 @@ The directives provided by the files and directories manager are:
@item @code{closedir} - Ends directory read operation
@item @code{getdents} - Get directory entries
@item @code{chdir} - Changes the current working directory
+@item @code{fchdir} - Changes the current working directory
@item @code{getcwd} - Gets current working directory
@item @code{open} - Opens a file
@item @code{creat} - Create a new file or rewrite an existing one
@@ -399,6 +400,9 @@ int chdir(
@subheading STATUS CODES:
+On error, this routine returns -1 and sets @code{errno} to one of
+the following:
+
@table @b
@item EACCES
Search permission is denied for a directory in a file's path prefix.
@@ -433,6 +437,65 @@ NONE
@c
@c
@page
+@subsection fchdir - Changes the current working directory
+
+@findex fchdir
+@cindex changes the current working directory
+
+@subheading CALLING SEQUENCE:
+
+@ifset is-C
+@example
+#include <unistd.h>
+
+int fchdir(
+ int fd
+);
+@end example
+@end ifset
+
+@ifset is-Ada
+@end ifset
+
+@subheading STATUS CODES:
+
+On error, this routine returns -1 and sets @code{errno} to one of
+the following:
+
+@table @b
+@item EACCES
+Search permission is denied for a directory in a file's path prefix.
+
+@item ENAMETOOLONG
+Length of a filename string exceeds PATH_MAX and _POSIX_NO_TRUNC is
+in effect.
+
+@item ENOENT
+A file or directory does not exist.
+
+@item ENOTDIR
+A component of the specified pathname was not a directory when directory
+was expected.
+
+@end table
+
+@subheading DESCRIPTION:
+
+The @code{fchdir()} function causes the directory named by @code{fd} to
+become the current working directory; that is, the starting point for
+searches of pathnames not beginning with a slash.
+
+If @code{fchdir()} detects an error, the current working directory is not
+changed.
+
+@subheading NOTES:
+
+NONE
+
+@c
+@c
+@c
+@page
@subsection getcwd - Gets current working directory
@findex getcwd