DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

getwd(3C)


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, then getwd fails and returns a NULL pointer. (See limits(4) for a description of PATH_MAX.)

Return value

Upon successful completion, a pointer to the string containing the absolute pathname of the current working directory is returned. Otherwise, getwd returns a NULL pointer and the contents of the array pointed to by path_name are undefined.

Compatibility

For portability to earlier implementations of the UNIX® system, getcwd(3C) is preferred over this function.

References

getcwd(3C)

Standards conformance

This routine conforms to X/Open System Interfaces and Headers, Issue 4, Version 2.
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004