getwd(3) [ultrix man page]

getwd(3)						     Library Functions Manual							  getwd(3)

Name
       getwd - get current working directory pathname

Syntax
       char *getwd(pathname)
       char *pathname;

Description
       The subroutine copies the absolute pathname of the current working directory to pathname and returns a pointer to the result.

Restrictions
       The subroutine may fail to return to the current directory if an error occurs.

       Pathnames can be no longer than MAXPATHLEN as defined in <sys/param.h>.

Return Values
       The subroutine returns zero and places a message in pathname if an error occurs.

																	  getwd(3)

getwd(3C)						   Standard C Library Functions 						 getwd(3C)

NAME

       getwd - 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
       function.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       getcwd(3C), attributes(5), standards(5)

SunOS 5.10							    24 Jul 2002 							 getwd(3C)