Re: [PATCH] ptsname.3: ERRORS: remove EINVAL

Michael Kerrisk (man-pages)
2017-06-16T07:46:15Z

On 06/08/2017 02:52 PM, Arjun Shankar wrote:
> The glibc implementation of 'ptsname_r' no longer checks if it has
> been called with a NULL 'buf' [1], and therefore cannot return an
> EINVAL error.
>
> [1] https://sourceware.org/git/?p=glibc.git;a=commitdiff;h=8f0a947
> (prior to the release of glibc 2.26)
>
> Signed-off-by: Arjun Shankar <arjun.is-xDe9EDckjEKzQB+pC5nmwQ@public.gmane.org>
> ---
> man3/ptsname.3 | 6 ------
> 1 file changed, 6 deletions(-)
>
> diff --git a/man3/ptsname.3 b/man3/ptsname.3
> index 90133fe..fd98b6b 100644
> --- a/man3/ptsname.3
> +++ b/man3/ptsname.3
> @@ -58,12 +58,6 @@ is set to indicate the error.
> .\" result -- MTK, Dec 04
> .SH ERRORS
> .TP
> -.B EINVAL
> -.RB ( ptsname_r ()
> -only)
> -.I buf
> -is NULL.
> -.TP
> .B ENOTTY
> .I fd
> does not refer to a pseudoterminal master device.

Thanks, Arjun. I applied a slightly different patch:

diff --git a/man3/ptsname.3 b/man3/ptsname.3
index 0ce88a1..05f4958 100644
--- a/man3/ptsname.3
+++ b/man3/ptsname.3
@@ -76,6 +76,9 @@ is set to indicate the error.
only)
.I buf
is NULL.
+(This error is returned only for
+.\" glibc commit 8f0a947cf55f3b0c4ebdf06953c57eff67a22fa9
+glibc 2.25 and earlier.)
.TP
.B ENOTTY
.I fd

Cheers,

Michael

--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at http://vger.kernel.org/majordomo-info.html