Print this page
5776 vfork and getwd should not be exposed under XPG7

Split Close
Expand all
Collapse all
          --- old/usr/src/man/man3c/getwd.3c.man.txt
          +++ new/usr/src/man/man3c/getwd.3c.man.txt
   1    1  GETWD(3C)                Standard C Library Functions                GETWD(3C)
   2    2  
   3      -
   4      -
   5    3  NAME
   6      -       getwd - get current working directory pathname
        4 +     getwd  get current working directory pathname
   7    5  
   8    6  SYNOPSIS
   9      -       #include <unistd.h>
        7 +     #include <unistd.h>
  10    8  
  11      -       char *getwd(char *path_name);
        9 +     char *
       10 +     getwd(char *path_name);
  12   11  
  13      -
  14   12  DESCRIPTION
  15      -       The getwd() function determines an absolute pathname of the current
  16      -       working directory of the calling process, and copies that pathname into
  17      -       the array pointed to by the path_name argument.
       13 +     The getwd() function determines an absolute pathname of the current
       14 +     working directory of the calling process, and copies that pathname into
       15 +     the array pointed to by the path_name argument.
  18   16  
       17 +     If the length of the pathname of the current working directory is greater
       18 +     than (PATH_MAX + 1) including the null byte, getwd() fails and returns a
       19 +     null pointer.
  19   20  
  20      -       If the length of the pathname of the current working directory is
  21      -       greater than (PATH_MAX + 1) including the null byte, getwd() fails and
  22      -       returns a null pointer.
  23      -
  24   21  RETURN VALUES
  25      -       Upon successful completion, a pointer to the string containing the
  26      -       absolute pathname of the current working directory is returned.
  27      -       Otherwise, getwd() returns a null pointer and the contents of the array
  28      -       pointed to by path_name are undefined.
       22 +     Upon successful completion, a pointer to the string containing the
       23 +     absolute pathname of the current working directory is returned.
       24 +     Otherwise, getwd() returns a null pointer and the contents of the array
       25 +     pointed to by path_name are undefined.
  29   26  
  30   27  ERRORS
  31      -       No errors are defined.
       28 +     No errors are defined.
  32   29  
  33   30  USAGE
  34      -       For portability to implementations conforming to versions of the X/Open
  35      -       Portability Guide prior to SUS, getcwd(3C) is preferred over this
  36      -       function.
       31 +     The getwd() function is supplied for backwards compatibility.  The
       32 +     getcwd(3C) should be used instead.
  37   33  
  38      -ATTRIBUTES
  39      -       See attributes(5) for descriptions of the following attributes:
       34 +INTERFACE STABILITY
       35 +     Obsolete Standard.
  40   36  
  41      -
  42      -
  43      -
  44      -       +--------------------+-----------------+
  45      -       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
  46      -       +--------------------+-----------------+
  47      -       |Interface Stability | Standard        |
  48      -       +--------------------+-----------------+
  49      -
  50   37  SEE ALSO
  51      -       getcwd(3C), attributes(5), standards(5)
       38 +     getcwd(3C), standards(5)
  52   39  
       40 +STANDARDS
       41 +     The getwd() function is available in the following compilation
       42 +     environments. See standards(5).
  53   43  
       44 +        X/Open Portability Guide Issue4, Version2 (XPG4.2)
       45 +        Version2 of the Single UNIX Specification (SUSv2)
       46 +        Version3 of the Single UNIX Specification (SUSv3)
  54   47  
  55      -                                 July 24, 2002                       GETWD(3C)
       48 +     It was marked obsolete in Version3 of the Single UNIX Specification
       49 +     (SUSv3) and removed from IEEE Std 1003.1-2008 (POSIX.1).
       50 +
       51 +illumos                         March 30, 2015                         illumos
    
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX