Print this page
5776 vfork and getwd should not be exposed under XPG7
@@ -1,28 +1,25 @@
GETWD(3C) Standard C Library Functions GETWD(3C)
-
-
NAME
- getwd - get current working directory pathname
+ getwd get current working directory pathname
SYNOPSIS
#include <unistd.h>
- char *getwd(char *path_name);
+ 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.
- 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.
@@ -29,27 +26,26 @@
ERRORS
No errors are defined.
USAGE
- For portability to implementations conforming to versions of the X/Open
- Portability Guide prior to SUS, getcwd(3C) is preferred over this
- function.
+ The getwd() function is supplied for backwards compatibility. The
+ getcwd(3C) should be used instead.
-ATTRIBUTES
- See attributes(5) for descriptions of the following attributes:
+INTERFACE STABILITY
+ Obsolete Standard.
-
-
-
- +--------------------+-----------------+
- | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
- +--------------------+-----------------+
- |Interface Stability | Standard |
- +--------------------+-----------------+
-
SEE ALSO
- getcwd(3C), attributes(5), standards(5)
+ getcwd(3C), standards(5)
+STANDARDS
+ The getwd() function is available in the following compilation
+ environments. See standards(5).
+ X/Open Portability Guide Issue4, Version2 (XPG4.2)
+ Version2 of the Single UNIX Specification (SUSv2)
+ Version3 of the Single UNIX Specification (SUSv3)
- July 24, 2002 GETWD(3C)
+ It was marked obsolete in Version3 of the Single UNIX Specification
+ (SUSv3) and removed from IEEE Std 1003.1-2008 (POSIX.1).
+
+illumos March 30, 2015 illumos