From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.8 required=3.0 tests=DKIM_INVALID,DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id 82D94C282CE for ; Tue, 4 Jun 2019 10:33:29 +0000 (UTC) Received: from lists.ozlabs.org (lists.ozlabs.org [203.11.71.2]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 08AC0245C5 for ; Tue, 4 Jun 2019 10:33:28 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="ahI9Qmwo" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 08AC0245C5 Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=linuxppc-dev-bounces+linuxppc-dev=archiver.kernel.org@lists.ozlabs.org Received: from lists.ozlabs.org (lists.ozlabs.org [IPv6:2401:3900:2:1::3]) by lists.ozlabs.org (Postfix) with ESMTP id 45J7Yg1r12zDqPP for ; Tue, 4 Jun 2019 20:33:27 +1000 (AEST) Authentication-Results: lists.ozlabs.org; spf=none (mailfrom) smtp.mailfrom=bombadil.srs.infradead.org (client-ip=2607:7c80:54:e::133; helo=bombadil.infradead.org; envelope-from=batv+7243a8a963bcae4fad07+5763+infradead.org+mchehab@bombadil.srs.infradead.org; receiver=) Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: lists.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=infradead.org header.i=@infradead.org header.b="ahI9Qmwo"; dkim-atps=neutral Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:e::133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 45J6rG3xsJzDqN2 for ; Tue, 4 Jun 2019 20:01:02 +1000 (AEST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20170209; h=Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-ID:Subject:Cc:To: From:Date:Sender:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=Omh6TzV4Gmx81j5VEp+7dLuZclw2RBTzNTaS7uo9g/w=; b=ahI9Qmwo3+3p7PXlpDr67Lf+f exS3e8UxHuG/BT7M1ThoePbPfaJiWqASMOiDsQQ+hQ/1Exz3iBYEE8Oiup0jdHRHMpQtOVf51JPB5 wAUl11j91om/kx5A03GVcpYYKhGxYIGfY8P+FKa+/T4RtCnf6JbJ154w+GdxgtfRPwoMOX6/7k4tr dhtH+IsR9vlCiEPhrn4WWtkkePrgGuLJJSSweQ26ld9L6uNGSkRHxxbtYgKYHomINREtkHjHRQHRj Y6nXe/FiiILXkJQ4nx/d30EWvlqtmljmh3NWrZuBagGU4bOhYyNzK1bjyUHN4CjoGkcht4/og3vYJ YpihbVGnQ==; Received: from [187.113.6.249] (helo=coco.lan) by bombadil.infradead.org with esmtpsa (Exim 4.90_1 #2 (Red Hat Linux)) id 1hY6D8-0008Uz-UV; Tue, 04 Jun 2019 09:58:31 +0000 Date: Tue, 4 Jun 2019 06:58:02 -0300 From: Mauro Carvalho Chehab To: Christophe Leroy Subject: Re: [PATCH 22/22] docs: fix broken documentation links Message-ID: <20190604065802.47a9d24b@coco.lan> In-Reply-To: <20190604064614.67cde821@coco.lan> References: <64e136de-1a7b-3436-9675-44ea9fa7b64a@c-s.fr> <20190604064614.67cde821@coco.lan> X-Mailer: Claws Mail 3.17.3 (GTK+ 2.24.32; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-SRS-Rewrite: SMTP reverse-path rewritten from by bombadil.infradead.org. See http://www.infradead.org/rpr.html X-Mailman-Approved-At: Tue, 04 Jun 2019 20:30:48 +1000 X-BeenThere: linuxppc-dev@lists.ozlabs.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Linux on PowerPC Developers Mail List List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: Andrew Lunn , Thomas Preston , Wolfram Sang , Catalin Marinas , Linus Walleij , Will Deacon , Russell King , Paul Mackerras , Alessia Mantegazza , Jakub Wilk , AKASHI Takahiro , Kevin Hilman , James Morris , linux-acpi@vger.kernel.org, Andy Gross , xen-devel@lists.xenproject.org, Jason Wang , Alexander Popov , Qian Cai , Al Viro , Andy Lutomirski , Thomas Gleixner , Kairui Song , Quentin Perret , Greg Kroah-Hartman , "Rafael J. Wysocki" , linux-kernel@vger.kernel.org, Paul Burton , Jiri Kosina , Casey Schaufler , Andrew Morton , Lu Baolu , Mark Rutland , Feng Tang , Linux Doc Mailing List , Dave Hansen , Mimi Zohar , Kamalesh Babulal , Masahiro Yamada , Yannik Sembritzki , Harry Wei , linux-i2c@vger.kernel.org, Shuah Khan , Stephen Rothwell , "Paul E. McKenney" , Alexandre Ghiti , YueHaibing , Robert Moore , Bartosz Golaszewski , Len Brown , David Brown , Joerg Roedel , linux-arm-msm@vger.kernel.org, linux-gpio@vger.kernel.org, Claudiu Manoil , Florian Fainelli , Jacek Anaszewski , Bjorn Helgaas , linux-amlogic@lists.infradead.org, Boris Ostrovsky , Mika Westerberg , linux-arm-kernel@lists.infradead.org, Tony Luck , Sean Christopherson , Rob Herring , James Morse , Robin Murphy , Samuel Mendoza-Jonas , linux-pci@vger.kernel.org, Bhupesh Sharma , Josh Poimboeuf , platform-driver-x86@vger.kernel.org, Ding Xiang , linux-kselftest@vger.kernel.org, Alex Shi , Lorenzo Pieralisi , Baoquan He , Jonathan Corbet , Raphael Gault , Joel Stanley , Federico Vaga , Darren Hart , Erik Schmauss , "Serge E. Hallyn" , Palmer Dabbelt , Kees Cook , Bartlomiej Zolnierkiewicz , Jonathan =?UTF-8?B?TmV1c2No?= =?UTF-8?B?w6RmZXI=?= , SeongJae Park , Mark Brown , Borislav Petkov , Sunil Muthuswamy , virtualization@lists.linux-foundation.org, devel@acpica.org, Ard Biesheuvel , Liam Girdwood , Sakari Ailus , Olof Johansson , Logan Gunthorpe , "David S. Miller" , "Kirill A. Shutemov" , Sven Van Asbroeck , Michal Hocko , kvm@vger.kernel.org, "Michael S. Tsirkin" , Peter Zijlstra , Thorsten Leemhuis , David Howells , linux-mm@kvack.org, "H. Peter Anvin" , devel@driverdev.osuosl.org, Manfred Spraul , Luis Chamberlain , x86@kernel.org, Pavel Tatashin , Mike Rapoport , Ingo Molnar , Dave Young , devicetree@vger.kernel.org, Arnaldo Carvalho de Melo , Jerome Glisse , Stefano Stabellini , Jonathan Cameron , Dmitry Vyukov , linux-edac@vger.kernel.org, Juergen Gross , Denis Efremov , netdev@vger.kernel.org, Nicolas Ferre , Changbin Du , linux-security-module@vger.kernel.org, linuxppc-dev@lists.ozlabs.org, Andy Shevchenko Errors-To: linuxppc-dev-bounces+linuxppc-dev=archiver.kernel.org@lists.ozlabs.org Sender: "Linuxppc-dev" Em Tue, 4 Jun 2019 06:46:14 -0300 Mauro Carvalho Chehab escreveu: > Em Mon, 3 Jun 2019 09:34:15 +0200 > Christophe Leroy escreveu: > > > [...] > > > > > diff --git a/arch/powerpc/Kconfig b/arch/powerpc/Kconfig > > > index 8c1c636308c8..e868d2bd48b8 100644 > > > --- a/arch/powerpc/Kconfig > > > +++ b/arch/powerpc/Kconfig > > > @@ -898,7 +898,7 @@ config PPC_MEM_KEYS > > > page-based protections, but without requiring modification of the > > > page tables when an application changes protection domains. > > > > > > - For details, see Documentation/vm/protection-keys.rst > > > + For details, see Documentation/x86/protection-keys.rst > > > > It looks strange to reference an x86 file, for powerpc arch. > > Indeed. Yet, seeking for the API documented there: > > $ git grep -l pkey_mprotect > Documentation/x86/protection-keys.rst > arch/alpha/kernel/syscalls/syscall.tbl > arch/arm/tools/syscall.tbl > arch/arm64/include/asm/unistd32.h > arch/ia64/kernel/syscalls/syscall.tbl > arch/m68k/kernel/syscalls/syscall.tbl > arch/microblaze/kernel/syscalls/syscall.tbl > arch/mips/kernel/syscalls/syscall_n32.tbl > arch/mips/kernel/syscalls/syscall_n64.tbl > arch/mips/kernel/syscalls/syscall_o32.tbl > arch/parisc/kernel/syscalls/syscall.tbl > arch/powerpc/kernel/syscalls/syscall.tbl > arch/s390/kernel/syscalls/syscall.tbl > arch/sh/kernel/syscalls/syscall.tbl > arch/sparc/kernel/syscalls/syscall.tbl > arch/x86/entry/syscalls/syscall_32.tbl > arch/x86/entry/syscalls/syscall_64.tbl > arch/xtensa/kernel/syscalls/syscall.tbl > include/linux/syscalls.h > include/uapi/asm-generic/unistd.h > kernel/sys_ni.c > mm/mprotect.c > tools/include/uapi/asm-generic/unistd.h > tools/perf/arch/powerpc/entry/syscalls/syscall.tbl > tools/perf/arch/x86/entry/syscalls/syscall_64.tbl > tools/perf/builtin-trace.c > tools/testing/selftests/x86/protection_keys.c > > Despite being used on several archs, the only documentation for it > is inside the x86 directory, as it seems that this is not > arch-specific. > > Perhaps the file should, instead, be moved to another book. I guess the best is to have this inside the core-api book. Patch enclosed. Regards, Mauro [PATCH] docs: move protection-keys.rst to the core-api book This document is used by multiple architectures: $ echo $(git grep -l pkey_mprotect arch|cut -d'/' -f 2|sort|uniq) alpha arm arm64 ia64 m68k microblaze mips parisc powerpc s390 sh sparc x86 xtensa So, let's move it to the core book and adjust the links to it accordingly. Signed-off-by: Mauro Carvalho Chehab diff --git a/Documentation/core-api/index.rst b/Documentation/core-api/index.rst index ee1bb8983a88..2466a4c51031 100644 --- a/Documentation/core-api/index.rst +++ b/Documentation/core-api/index.rst @@ -34,6 +34,7 @@ Core utilities timekeeping boot-time-mm memory-hotplug + protection-keys Interfaces for kernel debugging diff --git a/Documentation/x86/protection-keys.rst b/Documentation/core-api/protection-keys.rst similarity index 100% rename from Documentation/x86/protection-keys.rst rename to Documentation/core-api/protection-keys.rst diff --git a/Documentation/x86/index.rst b/Documentation/x86/index.rst index ae36fc5fc649..f2de1b2d3ac7 100644 --- a/Documentation/x86/index.rst +++ b/Documentation/x86/index.rst @@ -19,7 +19,6 @@ x86-specific Documentation tlb mtrr pat - protection-keys intel_mpx amd-memory-encryption pti diff --git a/arch/powerpc/Kconfig b/arch/powerpc/Kconfig index 8c1c636308c8..3b795a0cab62 100644 --- a/arch/powerpc/Kconfig +++ b/arch/powerpc/Kconfig @@ -898,7 +898,7 @@ config PPC_MEM_KEYS page-based protections, but without requiring modification of the page tables when an application changes protection domains. - For details, see Documentation/vm/protection-keys.rst + For details, see Documentation/core-api/protection-keys.rst If unsure, say y. diff --git a/arch/x86/Kconfig b/arch/x86/Kconfig index 2bbbd4d1ba31..d87d53fcd261 100644 --- a/arch/x86/Kconfig +++ b/arch/x86/Kconfig @@ -1911,7 +1911,7 @@ config X86_INTEL_MEMORY_PROTECTION_KEYS page-based protections, but without requiring modification of the page tables when an application changes protection domains. - For details, see Documentation/x86/protection-keys.txt + For details, see Documentation/core-api/protection-keys.rst If unsure, say y. diff --git a/tools/testing/selftests/x86/protection_keys.c b/tools/testing/selftests/x86/protection_keys.c index 5d546dcdbc80..480995bceefa 100644 --- a/tools/testing/selftests/x86/protection_keys.c +++ b/tools/testing/selftests/x86/protection_keys.c @@ -1,6 +1,6 @@ // SPDX-License-Identifier: GPL-2.0 /* - * Tests x86 Memory Protection Keys (see Documentation/x86/protection-keys.txt) + * Tests x86 Memory Protection Keys (see Documentation/core-api/protection-keys.rst) * * There are examples in here of: * * how to set protection keys on memory