realpath.3: update EINVAL description

PATCH In review Seonghun Lim 2 participants 2 messages Aug 31, 2011 – Sep 17, 2011 1 message not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore

Share & tools

lore

Seonghun Lim

author

2011-08-31 15:20 UTC #0 lore raw

PATCH 1/1 realpath.3: update EINVAL description

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.

man3/realpath.3 +0 -0

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

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

Michael Kerrisk

2011-09-17 05:13 UTC #2 lore raw

Hello Seonghun,

2011/8/31 Seonghun Lim <[email protected]>:

Quoted 16 lines

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.
man3/realpath.3 +0 -0
@@ -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

Quoted 8 lines

-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

man3/realpath.3 +6 -6

index 56d85d8..339ccdf 100644
@@ -23,7 +23,7 @@
 .\" Rewritten old page, 990824, [email protected]
 .\" 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.

Signature · 7 lines

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 [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html