*** UNIX MANUAL PAGE BROWSER ***

getwd(3) Library Functions Manual getwd(3) NAME getwd - Gets current directory pathname LIBRARY Standard C Library (libc.so, libc.a) SYNOPSIS #include <unistd.h> char *getwd( char *path_name); 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 in- dustry 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() func- tion returns a null pointer. and places a message in the path_name pa- rameter. RELATED INFORMATION Functions: getcwd(3) Standards: standards(5) delim off getwd(3)