Changeset e86236b in rtems


Ignore:
Timestamp:
Jun 30, 2000, 12:49:40 PM (20 years ago)
Author:
Joel Sherrill <joel.sherrill@…>
Branches:
4.10, 4.11, 4.8, 4.9, master
Children:
3af0828
Parents:
e8fd633
Message:

Added fchdir().

File:
1 edited

Legend:

Unmodified
Added
Removed
  • doc/posix_users/files.t

    re8fd633 re86236b  
    2424@item @code{getdents} - Get directory entries
    2525@item @code{chdir} - Changes the current working directory
     26@item @code{fchdir} - Changes the current working directory
    2627@item @code{getcwd} - Gets current working directory
    2728@item @code{open} - Opens a file
     
    400401@subheading STATUS CODES:
    401402
     403On error, this routine returns -1 and sets @code{errno} to one of
     404the following:
     405
    402406@table @b
    403407@item EACCES
     
    424428
    425429If @code{chdir()} detects an error, the current working directory is not
     430changed.
     431
     432@subheading NOTES:
     433
     434NONE
     435
     436@c
     437@c
     438@c
     439@page
     440@subsection fchdir - Changes the current working directory
     441
     442@findex fchdir
     443@cindex  changes the current working directory
     444
     445@subheading CALLING SEQUENCE:
     446
     447@ifset is-C
     448@example
     449#include <unistd.h>
     450
     451int fchdir(
     452  int fd
     453);
     454@end example
     455@end ifset
     456
     457@ifset is-Ada
     458@end ifset
     459
     460@subheading STATUS CODES:
     461
     462On error, this routine returns -1 and sets @code{errno} to one of
     463the following:
     464
     465@table @b
     466@item EACCES
     467Search permission is denied for a directory in a file's path prefix.
     468
     469@item ENAMETOOLONG
     470Length of a filename string exceeds PATH_MAX and _POSIX_NO_TRUNC is
     471in effect.
     472
     473@item ENOENT
     474A file or directory does not exist.
     475
     476@item ENOTDIR
     477A component of the specified pathname was not a directory when directory
     478was expected.
     479
     480@end table
     481
     482@subheading DESCRIPTION:
     483
     484The @code{fchdir()} function causes the directory named by @code{fd} to
     485become the current working directory; that is, the starting point for
     486searches of pathnames not beginning with a slash.
     487
     488If @code{fchdir()} detects an error, the current working directory is not
    426489changed.
    427490
Note: See TracChangeset for help on using the changeset viewer.