doc: Document ptsname_r bug on Cygwin.
[gnulib.git] / doc / glibc-functions / ptsname_r.texi
bloba79e751d654276917e8ad1577a6dc29a146d574f
1 @node ptsname_r
2 @subsection @code{ptsname_r}
3 @findex ptsname_r
5 Documentation:
6 @itemize
7 @item
8 @ifinfo
9 @ref{Allocation,,Allocating Pseudo-Terminals,libc},
10 @end ifinfo
11 @ifnotinfo
12 @url{https://www.gnu.org/software/libc/manual/html_node/Allocation.html},
13 @end ifnotinfo
14 @item
15 @uref{https://www.kernel.org/doc/man-pages/online/pages/man3/ptsname_r.3.html,,man ptsname_r}.
16 @end itemize
18 Gnulib module: ptsname_r
20 Portability problems fixed by Gnulib:
21 @itemize
22 @item
23 This function is missing on some platforms:
24 Mac OS X 10.5, FreeBSD 6.0, NetBSD 5.0, OpenBSD 6.7, Minix 3.1.8,
25 AIX 5.1, HP-UX 11, IRIX 6.5, Solaris 11.4, Cygwin 1.7.9, mingw,
26 MSVC 14.
27 @item
28 When this function fails, it returns -1 instead of the error code
29 on some platforms:
30 Mac OS X 10.13, Android 4.3.
31 @end itemize
33 Portability problems not fixed by Gnulib:
34 @itemize
35 @item
36 When this function fails, it returns 0 and stores an empty string as result
37 on some platforms:
38 Cygwin 2.9.
39 @end itemize
41 Note: Portable programs should expect to find the error code as the
42 return value of this function, not as the value of @code{errno}.
43 This is needed for compatibility with musl libc and with the
44 forthcoming POSIX Issue 8.