Manual Pages for UNIX Operating System command usage for man getwd

Standard C Library Functions                            getwd(3C)



NAME
     getwd - get current working directory pathname

SYNOPSIS
     #include 

     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  direc-
     tory 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 contain-
     ing  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 unde-
     fined.

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  attri-
     butes:



     ____________________________________________________________
    | ATTRIBUTE TYPE              | ATTRIBUTE VALUE             |
    |_____________________________|_____________________________|
    | Interface Stability         | Standard                    |
    |_____________________________|_____________________________|


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





SunOS 5.11          Last change: 24 Jul 2002                    1