[PATCH] ptsname.3: ERRORS: remove EINVAL

[PATCH] ptsname.3: ERRORS: remove EINVAL

[Arjun Shankar]

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.
-- 
2.9.4

--
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

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

[Michael Kerrisk (man-pages)]

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