GETWD(3C)GETWD(3C)NAMEgetwd - 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 func‐
tion.
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌────────────────────┬─────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├────────────────────┼─────────────────┤
│Interface Stability │ Standard │
└────────────────────┴─────────────────┘
SEE ALSOgetcwd(3C), attributes(5), standards(5)
Jul 24, 2002 GETWD(3C)