Received: by 2002:a25:824b:0:0:0:0:0 with SMTP id d11csp497466ybn; Thu, 3 Oct 2019 08:04:26 -0700 (PDT) X-Google-Smtp-Source: APXvYqwNiUrZNGC4c45h56vSP96LyY8QPBkI89UL9vNfmP8LF2exitRdR9al2jAKZN8CzC1ONbHP X-Received: by 2002:a50:ed82:: with SMTP id h2mr10087485edr.206.1570115066671; Thu, 03 Oct 2019 08:04:26 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1570115066; cv=none; d=google.com; s=arc-20160816; b=ui8inYgTHAX+QhVPdOTgkQlhlfmHOL4M7cfOWcsFfMPwyexI62+0IxMmazlwm4gofZ JWVSapGqinQopS4SHtC4yi9wWHYaIr95QIfTyJeqDHGVxwvEJZo495MiGLUmIdPuDV66 XmyUrkpLrjXEUVorRaKYwVYQ976CWkdPwqRpy8v5dFu9M7kKx5hnqdRjD49uzjokd3Rd wd+7wscREIr/V69X4XNn+d21+6Iaec4kHb/Peowy2VjqE50DaKYp0hJ6152KR1JaI1Gg G6Ozgo0Q7VWoQy0Vfzz4s8ZqvZIyFWTaO5ygtG+pr5de7y6PyLZReHwoe/IDs0bW29fC kvpQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :message-id:date:subject:cc:to:from; bh=tqKOXUbEt3d6WMMeVXWMvReSj1J08PqeOrDjtT4c+Zc=; b=XH4nz3kx+T63uTpqgIQTTtu2wMM1TBgEtoPysYch0le76IrwK7Vcv5sns5BAprydHj VveoI1jpjWiDg2snxLw069KySKFGP4E55rRhe5v8qui1aAu/yPZ7fTks5/7/0B4E/0l0 BbkI/jSCfTfjbWnkCw4Z8S/NtQLKsWbBerWxcod3p0wTWL/oI0MCGstuubGWoSF1UJuc Od1U9tjiDkfzQgShQixhP2XwgdMpzLeAU9yaSllQ7ctiddAnKFNjieafR9QvpnbGS3IV NVrTK+w8zLIzH+XDgNa4x83vIXun3RWONRdyxNUsnn6wlemzwpuLvgFzbuHPHIpOA3ZS DGoA== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id g22si1725093eda.27.2019.10.03.08.03.57; Thu, 03 Oct 2019 08:04:26 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729838AbfJCO4M (ORCPT + 99 others); Thu, 3 Oct 2019 10:56:12 -0400 Received: from mx2.mailbox.org ([80.241.60.215]:10782 "EHLO mx2.mailbox.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726364AbfJCO4M (ORCPT ); Thu, 3 Oct 2019 10:56:12 -0400 Received: from smtp2.mailbox.org (smtp1.mailbox.org [80.241.60.240]) (using TLSv1.2 with cipher ECDHE-RSA-CHACHA20-POLY1305 (256/256 bits)) (No client certificate requested) by mx2.mailbox.org (Postfix) with ESMTPS id C771AA2155; Thu, 3 Oct 2019 16:56:09 +0200 (CEST) X-Virus-Scanned: amavisd-new at heinlein-support.de Received: from smtp2.mailbox.org ([80.241.60.240]) by spamfilter04.heinlein-hosting.de (spamfilter04.heinlein-hosting.de [80.241.56.122]) (amavisd-new, port 10030) with ESMTP id 4j0O3i7iw2cz; Thu, 3 Oct 2019 16:56:05 +0200 (CEST) From: Aleksa Sarai To: Al Viro , Michael Kerrisk Cc: Aleksa Sarai , Christian Brauner , Aleksa Sarai , linux-man@vger.kernel.org, linux-api@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH RFC 0/3] document openat2(2) patch series Date: Fri, 4 Oct 2019 00:55:38 +1000 Message-Id: <20191003145542.17490-1-cyphar@cyphar.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org This is a first draft of the man-page changes for the openat2(2) patch series I'm working on[1]. It includes information about the magic-link changes as well as the primary new features (O_EMPTYPATH and openat2). Let me know what you think. I might go into too much detail about how extension of openat2(2) will work -- let me know if that section should be dropped (while it is useful for userspace to understand, it isn't really that necessary to explain exactly what the semantics are -- it will usually just transparently work). [1]: https://lore.kernel.org/lkml/20190930183316.10190-1-cyphar@cyphar.com/ Aleksa Sarai (3): symlink.7: document magic-links more completely open.2: add O_EMPTYPATH documentation openat2.2: document new openat2(2) syscall man2/open.2 | 47 ++++- man2/openat2.2 | 381 +++++++++++++++++++++++++++++++++++++++++ man7/path_resolution.7 | 89 ++++++++-- man7/symlink.7 | 39 ++++- 4 files changed, 528 insertions(+), 28 deletions(-) create mode 100644 man2/openat2.2 -- 2.23.0