Index for Section 3

Alphabetical listing for G

Bottom of page

getwd(3)
NAME
  getwd - Get current directory pathname

SYNOPSIS
  #include <unistd.h>

  char *getwd(
	  char *path_name );

LIBRARY
  Standard C Library (libc)

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.

SEE ALSO
  Functions: getcwd(3)

  Standards: standards(5)

Index for Section 3

Alphabetical listing for G

Top of page