From mboxrd@z Thu Jan 1 00:00:00 1970 From: Ville =?iso-8859-1?Q?Syrj=E4l=E4?= Subject: Re: [PATCH] dma-buf: document fd flags and O_CLOEXEC requirement Date: Mon, 19 Mar 2012 17:44:33 +0200 Message-ID: <20120319154433.GP4917@intel.com> References: <1332171715-1484-1-git-send-email-daniel.vetter@ffwll.ch> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: QUOTED-PRINTABLE Return-path: Content-Disposition: inline In-Reply-To: <1332171715-1484-1-git-send-email-daniel.vetter@ffwll.ch> Sender: linux-kernel-owner@vger.kernel.org To: Daniel Vetter Cc: linaro-mm-sig@lists.linaro.org, LKML , DRI Development , linux-media@vger.kernel.org List-Id: dri-devel@lists.freedesktop.org On Mon, Mar 19, 2012 at 04:41:55PM +0100, Daniel Vetter wrote: > Otherwise subsystems will get this wrong and end up with a second > export ioctl with the flag and O_CLOEXEC support added. >=20 > v2: Fixup the function name and caution exporters to limit the flags > to only O_CLOEXEC. Noted by Dave Airlie. >=20 > Cc: Dave Airlie > Signed-Off-by: Daniel Vetter > --- > Documentation/dma-buf-sharing.txt | 6 ++++++ > 1 files changed, 6 insertions(+), 0 deletions(-) >=20 > diff --git a/Documentation/dma-buf-sharing.txt b/Documentation/dma-bu= f-sharing.txt > index 9f3aeef..a6d4c37 100644 > --- a/Documentation/dma-buf-sharing.txt > +++ b/Documentation/dma-buf-sharing.txt > @@ -319,6 +319,12 @@ Miscellaneous notes > - Any exporters or users of the dma-buf buffer sharing framework mus= t have > a 'select DMA_SHARED_BUFFER' in their respective Kconfigs. > =20 > +- To avoid the wrath of userspace library writers exporting subsyste= ms must have > + a flag parameter in the ioctl that creates the dma-buf fd which ne= eds to > + support at least the O_CLOEXEC fd flag. This needs to be passed in= the flag > + parameter of dma_buf_fd. Without any other reasons applying it is = recommended > + that exporters limit the flags passed to dma_buf_fd to only O_CLOE= XEC. Difficult to parse. Needs more punctuation. --=20 Ville Syrj=E4l=E4 Intel OTC