NAME

getwd − Get current directory pathname

SYNOPSIS

#include <unistd.h>
char ∗getwd(
        char ∗path_name );

LIBRARY

Standard C Library (libc)

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

getwd():  XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags. 

PARAMETERS

path_name
Points to the full pathname.

DESCRIPTION

The getwd() function determines the absolute pathname of the current directory, then copies that pathname into the array pointed to by the path_name parameter. 

The maximum pathname length, in characters, is set by the PATH_MAX definition, as specified in the limits.h file.  If the length of the pathname of the current 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 absolute pathname of the current directory is returned. If an error occurs, the getwd() function returns a null pointer. and places a message in the path_name parameter. 

SEE ALSO

Functions: getcwd(3)

Standards: standards(5)