getwd(3C)																 getwd(3C)

NAME

       getwd() - get pathname of current working directory

SYNOPSIS

DESCRIPTION

       places the absolute pathname of the current working directory in the array pointed to by buf, and returns buf.

       If the length of the pathname of the current working directory is greater than bytes, fails and returns a null pointer.

RETURN VALUE

       Upon successful completion, returns a pointer to the current directory pathname.  Otherwise, it returns NULL with set.

ERRORS

       fails if the following condition is encountered:

	      The length of the specified path name exceeds
				  bytes, or the length of a component of the path name exceeds bytes while is in effect.

       may fail if any of the following conditions are encountered:

	      Read or search permission is denied for a component of pathname.

	      buf		  points outside the allocated address space of the process.  may not always detect this error.

EXAMPLES

       #include <stdio.h>
       #include <unistd.h>
       char *cwd;
       char buf[PATH_MAX+1];
		 ...
       if ((cwd = getwd(buf)) == NULL) {
	   perror("getwd");
	   exit(1);
       }
       puts(cwd);

WARNINGS

       For portability, is preferred over this function.

AUTHOR

       was developed by HP and the University of California, Berkeley.

SEE ALSO

       getcwd(3C), thread_safety(5).

STANDARDS CONFORMANCE

																	 getwd(3C)