NAME    [Toc]    [Back]

       getwd - Get current directory pathname

SYNOPSIS    [Toc]    [Back]

       #include <unistd.h>

       char *getwd(
               char *path_name );

LIBRARY    [Toc]    [Back]

       Standard C Library (libc)

STANDARDS    [Toc]    [Back]

       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    [Toc]    [Back]

       Points to the full pathname.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       Upon  successful  completion,  a  pointer  to the absolute
       pathname of the current directory is returned. If an error
       occurs,  the  getwd() function returns a null pointer. and
       places a message in the path_name parameter.

SEE ALSO    [Toc]    [Back]

       Functions: getcwd(3)

       Standards: standards(5)



                                                         getwd(3)