GETWD(3C) | Standard C Library Functions | GETWD(3C) |
getwd
— get
current working directory pathname
#include
<unistd.h>
char *
getwd
(char
*path_name);
The
getwd
()
function determines an absolute pathname of the current working directory of
the calling process, and copies that pathname into the array pointed to by
the path_name argument.
If the length of the pathname of the current working
directory is greater than (PATH_MAX + 1
) including
the null byte,
getwd
()
fails and returns a null pointer.
Upon successful completion, a pointer to the string containing the
absolute pathname of the current working directory is returned. Otherwise,
getwd
() returns a null pointer and the contents of
the array pointed to by path_name are undefined.
No errors are defined.
The getwd
() function is supplied for
backwards compatibility. The
getcwd(3C) should be used
instead.
The getwd
() function is available in the
following compilation environments. See
standards(7).
It was marked obsolete in Version 3 of the Single UNIX Specification (“SUSv3”) and removed from IEEE Std 1003.1-2008 (“POSIX.1”).
March 30, 2015 | OmniOS |