Re: [patch] realpath.3: update EINVAL description

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



Hello Seonghun,

2011/8/31 Seonghun Lim <wariua@xxxxxxxxx>:
> man-pages version: latest git repository
> why: The argument resolved_path can be NULL and it's not
> a error condition any more. See the last paragraph of the
> DESCRIPTION, and the last paragraph of CONFORMING TO.
> See also the commit c49e8fc9.
>
>
> diff --git a/man3/realpath.3 b/man3/realpath.3
> --- a/man3/realpath.3
> +++ b/man3/realpath.3
> @@ -104,13 +104,9 @@ is set to indicate the error.
> Read or search permission was denied for a component of the path prefix.
> .TP
> .B EINVAL
> -Either
> .I path
> -or
> -.I resolved_path
> is NULL.
> (In libc5 this would just cause a segfault.)
> -But, see NOTES below.
> .TP
> .B EIO
> An I/O error occurred while reading from the file system.

Thanks for this report. I applied a different patch, below.

Cheers,

Michael

diff --git a/man3/realpath.3 b/man3/realpath.3
index 56d85d8..339ccdf 100644
--- a/man3/realpath.3
+++ b/man3/realpath.3
@@ -23,7 +23,7 @@
 .\" Rewritten old page, 990824, aeb@xxxxxx
 .\" 2004-12-14, mtk, added discussion of resolved_path == NULL
 .\"
-.TH REALPATH 3  2010-09-20 "" "Linux Programmer's Manual"
+.TH REALPATH 3  2011-09-10 "" "Linux Programmer's Manual"
 .SH NAME
 realpath \- return the canonicalized absolute pathname
 .SH SYNOPSIS
@@ -104,13 +104,13 @@ is set to indicate the error.
 Read or search permission was denied for a component of the path prefix.
 .TP
 .B EINVAL
-Either
 .I path
-or
-.I resolved_path
 is NULL.
-(In libc5 this would just cause a segfault.)
-But, see NOTES below.
+.\" (In libc5 this would just cause a segfault.)
+(In glibc versions before 2.3,
+this error is also returned if
+.IR resolved_path
+is NULL.)
 .TP
 .B EIO
 An I/O error occurred while reading from the file system.


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface"; http://man7.org/tlpi/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux