canonicalize-lgpl: work around AIX realpath bug
[gnulib.git] / doc / posix-functions / realpath.texi
1 @node realpath
2 @section @code{realpath}
3 @findex realpath
4
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/realpath.html}
6
7 Gnulib module: canonicalize-lgpl
8
9 Portability problems fixed by Gnulib:
10 @itemize
11 @item
12 This function is missing on some platforms:
13 mingw, BeOS.
14 @item
15 This function does not allow for a NULL @samp{resolved} parameter on
16 some platforms:
17 MacOS X 10.5, FreeBSD 6.4, OpenBSD 4.4, Solaris 10.
18 @item
19 This function does not always return an absolute path on some
20 platforms:
21 Solaris 10.
22 @item
23 This function fails to detect trailing slashes on non-directories on
24 some platforms:
25 glibc 2.3.5.
26 @item
27 This function fails to recognize non-directories followed @samp{..} on
28 some platforms:
29 cygwin.
30 @item
31 This function misbehaves on consecutive slashes on some platforms:
32 AIX 7.
33 @end itemize
34
35 Portability problems not fixed by Gnulib:
36 @itemize
37 @item
38 This function does not allow to determine the required size of output buffer;
39 the use of a non-NULL @samp{resolved} buffer is non-portable, since
40 PATH_MAX --- if it is defined --- is nothing more than a guess.
41 @end itemize