Click this button to go to the index for this section.

getwd(3)
NAME
  getwd - Gets current directory pathname

LIBRARY
  Standard C Library (libc.so, libc.a)

SYNOPSIS
  #include <unistd.h>

  char *getwd(
	  char *path_name);

STANDARDS
  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
  path_name Points to the full pathname.

DESCRIPTION
  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
  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.

RELATED INFORMATION
  Functions: getcwd(3)

  Standards: standards(5)