From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1757246Ab3GVQue (ORCPT ); Mon, 22 Jul 2013 12:50:34 -0400 Received: from mail-pb0-f54.google.com ([209.85.160.54]:62820 "EHLO mail-pb0-f54.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755790Ab3GVQud (ORCPT ); Mon, 22 Jul 2013 12:50:33 -0400 Message-ID: <51ED0D31.8020406@gmail.com> Date: Mon, 22 Jul 2013 12:45:05 +0200 From: "Michael Kerrisk (man-pages)" User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:17.0) Gecko/20130311 Thunderbird/17.0.4 MIME-Version: 1.0 To: Peter Schiffer CC: Michael Kerrisk , Al Viro , lkml , Mike Frysinger , "Theodore Ts'o" , "Aneesh Kumar K.V" , linux-man , benjamin@python.org Subject: Re: [PATCH] open(2): document O_PATH References: <20130720114017.GA2118@ZenIV.linux.org.uk> <51EAF997.2090300@gmail.com> <51ECF166.4080007@redhat.com> In-Reply-To: <51ECF166.4080007@redhat.com> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 07/22/13 10:46, Peter Schiffer wrote: > 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: Thanks, Peter. Applied. Cheers, Michael > 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 . > > >