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").

OmniOS March 30, 2015 OmniOS