kc3-lang/gnulib/doc/posix-functions/ptsname_r.texi

• Show log

  Commit

• Hash : f52b2a3d
  Author :
  Date : 2025-01-24T21:36:11
  

  ptsname_r: Work around ptsname_r bug on Solaris 11 OmniOS.
  
  * lib/ptsname_r.c (ptsname_r): Ensure the resulting buffer is not
  clobbered if it is too small on Solaris 11 OmniOS.
  * m4/ptsname_r.m4 (gl_FUNC_PTSNAME_R): On Solaris 11 OmniOS, arrange to
  override ptsname_r.
  * doc/posix-functions/ptsname_r.texi: Document the bug.
  

Download

• doc/posix-functions/ptsname_r.texi

• @node ptsname_r
  @subsection @code{ptsname_r}
  @findex ptsname_r
  
  POSIX specification:@* @url{https://pubs.opengroup.org/onlinepubs/9799919799/functions/ptsname_r.html}
  
  Documentation:
  @itemize
  @item
  @ifinfo
  @ref{Allocation,,Allocating Pseudo-Terminals,libc},
  @end ifinfo
  @ifnotinfo
  @url{https://www.gnu.org/software/libc/manual/html_node/Allocation.html},
  @end ifnotinfo
  @item
  @uref{https://www.kernel.org/doc/man-pages/online/pages/man3/ptsname_r.3.html,,man ptsname_r}.
  @end itemize
  
  Gnulib module: ptsname_r
  @mindex ptsname_r
  
  Portability problems fixed by Gnulib:
  @itemize
  @item
  This function is missing on some platforms:
  Mac OS X 10.12, FreeBSD 12.0, NetBSD 5.0, OpenBSD 7.5, Minix 3.1.8,
  AIX 5.1, HP-UX 11, Solaris 11.4, Cygwin 1.7.9, mingw,
  MSVC 14.
  @item
  When this function fails, it returns -1 instead of the error code
  on some platforms:
  macOS 14, FreeBSD 14.0, Android 4.3.
  @item
  When this function fails with ERANGE, it stores an empty string as result
  on some platforms:
  NetBSD 10.0, Solaris 11 OmniOS.
  @end itemize
  
  Portability problems not fixed by Gnulib:
  @itemize
  @item
  When this function fails, it returns 0 and stores an empty string as result
  on some platforms:
  Cygwin 2.9.
  @end itemize
  
  Note: Portable programs should expect to find the error code as the
  return value of this function, not as the value of @code{errno}.
  This is needed for compatibility with musl libc and with the
  forthcoming POSIX Issue 8.
  

Download