NAME
getwd() — get pathname of current working directory
SYNOPSIS
#include <unistd.h>
char *getwd(char *buf);
DESCRIPTION
getwd()
places the absolute pathname of the current working directory
in the array pointed to by
buf,
and returns
buf.
If the length of the pathname of the current working directory is
greater than
PATH_MAX+1
bytes,
getwd()
fails and returns a null pointer.
RETURN VALUE
Upon successful completion,
getwd()
returns a pointer to the current directory pathname.
Otherwise, it returns
NULL
with
errno
set.
ERRORS
getwd()
fails if the following condition is encountered:
- [ENAMETOOLONG]
The length of the specified path name exceeds
PATH_MAX+1
bytes, or the length of a component of the path name exceeds
NAME_MAX
bytes while
_POSIX_NO_TRUNC
is in effect.
getwd()
may fail if any of the following conditions are encountered:
- [EACCES]
Read or search permission is denied for a component of pathname.
- [EFAULT]
buf
points outside the allocated address space of the process.
getwd()
may not always detect this error.
EXAMPLES
#include <stdio.h>
#include <unistd.h>
char *cwd;
char buf[PATH_MAX+1];
...
if ((cwd = getwd(buf)) == NULL) {
perror("getwd");
exit(1);
}
puts(cwd);
APPLICATION USAGE
getwd()
is thread-safe. It is not async-cancel-safe.
A cancellation point may occur when a thread is executing
getwd().
WARNINGS
For portability,
getcwd()
is preferred over this function.
AUTHOR
getwd()
was developed by HP and the University of California, Berkeley.
STANDARDS CONFORMANCE
getwd(): XPG4.2
