pintos-os.org Git - pspp/blob - doc/posix-functions/getcwd.texi

   1 @node getcwd
   2 @section @code{getcwd}
   3 @findex getcwd
   4
   5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/getcwd.html}
   6
   7 Gnulib module: getcwd or getcwd-lgpl
   8
   9 Portability problems fixed by either Gnulib module @code{getcwd} or
  10 @code{getcwd-lgpl}:
  11 @itemize
  12 @item
  13 On glibc platforms, @code{getcwd (NULL, n)} allocates memory for the result.
  14 On some other platforms, this call is not allowed.
  15 @item
  16 On some platforms, the prototype for @code{getcwd} uses @code{int}
  17 instead of @code{size_t} for the size argument:
  18 mingw.
  19 @end itemize
  20
  21 Portability problems fixed by Gnulib module @code{getcwd}:
  22 @itemize
  23 @item
  24 This function is missing on some older platforms.
  25 @item
  26 This function does not handle long file names (greater than @code{PATH_MAX})
  27 correctly on some platforms.
  28 @end itemize
  29
  30 Portability problems not fixed by Gnulib:
  31 @itemize
  32 @item
  33 When using @code{getcwd(NULL, nonzero)}, some platforms, such as glibc
  34 or cygwin, allocate exactly @code{nonzero} bytes and fail with
  35 @code{ERANGE} if it was not big enough, while other platforms, such as
  36 FreeBSD or mingw, ignore the size argument and allocate whatever size
  37 is necessary.  If this call succeeds, an application cannot portably
  38 access beyond the string length of the result.
  39 @end itemize