getwd(3)getwd(3)NAMEgetwd - 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 stan‐
dards as follows:
getwd(): XPG4-UNIX
Refer to the standards(5) reference page for more information about
industry standards and associated tags.
PARAMETERS
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 def‐
inition, as specified in the limits.h file. If the length of the path‐
name 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 parame‐
ter.
SEE ALSO
Functions: getcwd(3)
Standards: standards(5)getwd(3)