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