osf1 man page for getwd

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 standards 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 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() func-
       tion returns a null pointer.  and places a message in the path_name parameter.

RELATED INFORMATION
       Functions: getcwd(3)

       Standards: standards(5) delim off

																	  getwd(3)