Re: [PATCH] open(2): document O_PATH

From: Peter Schiffer
Date: Mon Jul 22 2013 - 04:47:27 EST


On 07/20/2013 10:56 PM, Michael Kerrisk wrote:
On 07/20/13 13:40, Al Viro wrote:
On Thu, Mar 14, 2013 at 10:35:59AM +0100, Michael Kerrisk (man-pages) wrote:
Hello Al et al,

Documenting O_PATH fell by the wayside last year
(http://thread.gmane.org/gmane.linux.man/2790) as I got distracted
with other tasks. A recent prod or two have reminded me restart this.
I have the following patch queued to document O_PATH.

Could you please review. I've provided the O_PATH doc both as
formatted text, for ease of reviewing, and as a patch and entire file
(attached).

Seems to be mostly correct; the only thing missing is that F_GETFL is also
allowed (and return value will contain O_PATH for such descriptors). Had
been there since the very beginning...

Thanks, Al. I have added that piece.


Michael,

there is a typo within added piece:

diff --git a/man2/open.2 b/man2/open.2
index c61ea7f..ef0f664 100644
--- a/man2/open.2
+++ b/man2/open.2
@@ -489,7 +489,7 @@ and
.IP *
Retrieving open file status flags using the
.BR fcntl (2)
-.BR F_GETFD
+.BR F_GETFL
operation: the returned flags will include the bit
.BR O_PATH .


--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/