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. Other-
wise, getwd() returns a null pointer and the contents of the array pointed to by path_name are undefined.
ERRORS
No errors are defined.
USAGE
For portability to implementations conforming to versions of the X/Open Portability Guide prior to SUS, getcwd(3C) is preferred over this
function.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
|ATTRIBUTE TYPE |ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|Interface Stability |Standard |
+-----------------------------+-----------------------------+
SEE ALSO
getcwd(3C), attributes(5), standards(5)
SunOS 5.11 24 Jul 2002 getwd(3C)
