GETWD(3C) Standard C Library Functions GETWD(3C)
NAME
getwd - get current working directory pathname
SYNOPSIS
#include <unistd.h> char * getwd(
char *path_name);
DESCRIPTION
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.
RETURN VALUES
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.
ERRORS
No errors are defined.
USAGE
The
getwd() function is supplied for backwards compatibility. The
getcwd(3C) should be used instead.
INTERFACE STABILITY
Obsolete Standard.
SEE ALSO
getcwd(3C),
standards(7)STANDARDS
The
getwd() function is available in the following compilation
environments. See
standards(7).
+o X/Open Portability Guide Issue 4, Version 2 ("XPG4.2")
+o Version 2 of the Single UNIX Specification ("SUSv2")
+o Version 3 of the Single UNIX Specification ("SUSv3")
It was marked obsolete in Version 3 of the Single UNIX Specification
("SUSv3") and removed from IEEE Std 1003.1-2008 ("POSIX.1").
illumos March 30, 2015 illumos
