GETWD(3C) Standard C Library Functions GETWD(3C)

NAME

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, getwd() fails and
returns a null pointer.

RETURN VALUES

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.

ERRORS

No errors are defined.

USAGE

The getwd() function is supplied for backwards compatibility. The
getcwd(3C) should be used instead.

INTERFACE STABILITY

Obsolete Standard.

SEE ALSO

getcwd(3C), standards(7)

STANDARDS

The getwd() function is available in the following compilation
environments. See standards(7).

+o X/Open Portability Guide Issue 4, Version 2 ("XPG4.2")
+o Version 2 of the Single UNIX Specification ("SUSv2")
+o Version 3 of the Single UNIX Specification ("SUSv3")

It was marked obsolete in Version 3 of the Single UNIX Specification
("SUSv3") and removed from IEEE Std 1003.1-2008 ("POSIX.1").

illumos March 30, 2015 illumos