From nobody Wed Apr 29 12:25:05 2026 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 75D01C433EF for ; Mon, 13 Jun 2022 08:20:03 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S236461AbiFMIUC (ORCPT ); Mon, 13 Jun 2022 04:20:02 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:51540 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S233189AbiFMIUA (ORCPT ); Mon, 13 Jun 2022 04:20:00 -0400 Received: from conuserg-08.nifty.com (conuserg-08.nifty.com [210.131.2.75]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 08E9C1EAE5; Mon, 13 Jun 2022 01:19:58 -0700 (PDT) Received: from grover.sesame (133-32-177-133.west.xps.vectant.ne.jp [133.32.177.133]) (authenticated) by conuserg-08.nifty.com with ESMTP id 25D8Hqcs011074; Mon, 13 Jun 2022 17:17:52 +0900 DKIM-Filter: OpenDKIM Filter v2.10.3 conuserg-08.nifty.com 25D8Hqcs011074 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nifty.com; s=dec2015msa; t=1655108273; bh=CmhbukpBhZs7hao25rQlICLG+Ns0/87DXmi5jDvd2iE=; h=From:To:Cc:Subject:Date:From; b=hBKp+jS9P7HmrcT7zp7l6kQNJUNh88ugzYtEluVI0KDn7TlAkLIDc8ju3Mi1RuIeH N5S8Z6ThORDDGC/9XFYl+0Zod6QhGHMSD7Ds4vB+DnLevHTpIi8lZcB6NtoxMxRfbX bTCLu7klIZirLYKtICeNotC+RVxKTvmM+qAH2v7jrhz5zjVquH0z4tSbw+U510lBrN oh5JlCQJy7sMEamM1ncpm4+yIe8e/puiVt2+HU+ka2BNfHM9hZY2hio62Oy2Ir1vVO UwKckHWfho3ccbl9oir28ZefJYO1uSj4xgWcjC4wI3buDWwwhHoYScccyxw7eWa4K2 IFrRwCAKfKCZg== X-Nifty-SrcIP: [133.32.177.133] From: Masahiro Yamada To: Luis Chamberlain , linux-modules@vger.kernel.org Cc: Josh Poimboeuf , Jiri Kosina , Miroslav Benes , Petr Mladek , Joe Lawrence , live-patching@vger.kernel.org, Masahiro Yamada , Alex Shi , Federico Vaga , Jonathan Corbet , Matthias Maennich , Yanteng Si , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH] doc: module: update file references Date: Mon, 13 Jun 2022 17:17:40 +0900 Message-Id: <20220613081741.1699713-1-masahiroy@kernel.org> X-Mailer: git-send-email 2.32.0 MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Adjust documents to the file moves made by commit cfc1d277891e ("module: Move all into module/"). Signed-off-by: Masahiro Yamada Acked-by: Yanteng Si --- I did not touch Documentation/translations/zh_CN/core-api/kernel-api.rst because I cannot modify it. Documentation/core-api/kernel-api.rst | 2 +- Documentation/core-api/symbol-namespaces.rst | 4 ++-- Documentation/livepatch/module-elf-format.rst | 10 +++++----- .../translations/it_IT/core-api/symbol-namespaces.rst | 6 +++--- .../translations/zh_CN/core-api/symbol-namespaces.rst | 2 +- 5 files changed, 12 insertions(+), 12 deletions(-) diff --git a/Documentation/core-api/kernel-api.rst b/Documentation/core-api= /kernel-api.rst index d6b3f94b9f1f..0793c400d4b0 100644 --- a/Documentation/core-api/kernel-api.rst +++ b/Documentation/core-api/kernel-api.rst @@ -223,7 +223,7 @@ Module Loading Inter Module support -------------------- =20 -Refer to the file kernel/module.c for more information. +Refer to the files in kernel/module/ for more information. =20 Hardware Interfaces =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/core-api/symbol-namespaces.rst b/Documentation/c= ore-api/symbol-namespaces.rst index 5ad9e0abe42c..12e4aecdae94 100644 --- a/Documentation/core-api/symbol-namespaces.rst +++ b/Documentation/core-api/symbol-namespaces.rst @@ -51,8 +51,8 @@ namespace ``USB_STORAGE``, use:: The corresponding ksymtab entry struct ``kernel_symbol`` will have the mem= ber ``namespace`` set accordingly. A symbol that is exported without a namespa= ce will refer to ``NULL``. There is no default namespace if none is defined. ``mod= post`` -and kernel/module.c make use the namespace at build time or module load ti= me, -respectively. +and kernel/module/main.c make use the namespace at build time or module lo= ad +time, respectively. =20 2.2 Using the DEFAULT_SYMBOL_NAMESPACE define =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/livepatch/module-elf-format.rst b/Documentation/= livepatch/module-elf-format.rst index dbe9b400e39f..7347638895a0 100644 --- a/Documentation/livepatch/module-elf-format.rst +++ b/Documentation/livepatch/module-elf-format.rst @@ -210,11 +210,11 @@ module->symtab. =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D Normally, a stripped down copy of a module's symbol table (containing only "core" symbols) is made available through module->symtab (See layout_symta= b() -in kernel/module.c). For livepatch modules, the symbol table copied into m= emory -on module load must be exactly the same as the symbol table produced when = the -patch module was compiled. This is because the relocations in each livepat= ch -relocation section refer to their respective symbols with their symbol ind= ices, -and the original symbol indices (and thus the symtab ordering) must be +in kernel/module/kallsyms.c). For livepatch modules, the symbol table copi= ed +into memory on module load must be exactly the same as the symbol table pr= oduced +when the patch module was compiled. This is because the relocations in each +livepatch relocation section refer to their respective symbols with their = symbol +indices, and the original symbol indices (and thus the symtab ordering) mu= st be preserved in order for apply_relocate_add() to find the right symbol. =20 For example, take this particular rela from a livepatch module::: diff --git a/Documentation/translations/it_IT/core-api/symbol-namespaces.rs= t b/Documentation/translations/it_IT/core-api/symbol-namespaces.rst index 42f5d04e38ec..0f6898860d6d 100644 --- a/Documentation/translations/it_IT/core-api/symbol-namespaces.rst +++ b/Documentation/translations/it_IT/core-api/symbol-namespaces.rst @@ -50,9 +50,9 @@ Di conseguenza, nella tabella dei simboli del kernel ci s= ar=C3=A0 una voce rappresentata dalla struttura ``kernel_symbol`` che avr=C3=A0 il campo ``namespace`` (spazio dei nomi) impostato. Un simbolo esportato senza uno = spazio dei nomi avr=C3=A0 questo campo impostato a ``NULL``. Non esiste uno spazi= o dei nomi -di base. Il programma ``modpost`` e il codice in kernel/module.c usano lo = spazio -dei nomi, rispettivamente, durante la compilazione e durante il caricamento -di un modulo. +di base. Il programma ``modpost`` e il codice in kernel/module/main.c usan= o lo +spazio dei nomi, rispettivamente, durante la compilazione e durante il +caricamento di un modulo. =20 2.2 Usare il simbolo di preprocessore DEFAULT_SYMBOL_NAMESPACE =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/translations/zh_CN/core-api/symbol-namespaces.rs= t b/Documentation/translations/zh_CN/core-api/symbol-namespaces.rst index 6abf7ed534ca..bb16f0611046 100644 --- a/Documentation/translations/zh_CN/core-api/symbol-namespaces.rst +++ b/Documentation/translations/zh_CN/core-api/symbol-namespaces.rst @@ -52,7 +52,7 @@ =20 =E7=9B=B8=E5=BA=94=E7=9A=84 ksymtab =E6=9D=A1=E7=9B=AE=E7=BB=93=E6=9E=84= =E4=BD=93 ``kernel_symbol`` =E5=B0=86=E6=9C=89=E7=9B=B8=E5=BA=94=E7=9A=84= =E6=88=90=E5=91=98 ``=E5=91=BD=E5=90=8D=E7=A9=BA=E9=97=B4`` =E9=9B=86=E3=80= =82 =E5=AF=BC=E5=87=BA=E6=97=B6=E6=9C=AA=E6=8C=87=E6=98=8E=E5=91=BD=E5=90=8D= =E7=A9=BA=E9=97=B4=E7=9A=84=E7=AC=A6=E5=8F=B7=E5=B0=86=E6=8C=87=E5=90=91 ``= NULL`` =E3=80=82=E5=A6=82=E6=9E=9C=E6=B2=A1=E6=9C=89=E5=AE=9A=E4=B9=89=E5= =91=BD=E5=90=8D=E7=A9=BA=E9=97=B4=EF=BC=8C=E5=88=99=E9=BB=98=E8=AE=A4=E6=B2= =A1=E6=9C=89=E3=80=82 -``modpost`` =E5=92=8Ckernel/module.c=E5=88=86=E5=88=AB=E5=9C=A8=E6=9E=84= =E5=BB=BA=E6=97=B6=E6=88=96=E6=A8=A1=E5=9D=97=E5=8A=A0=E8=BD=BD=E6=97=B6=E4= =BD=BF=E7=94=A8=E5=90=8D=E7=A7=B0=E7=A9=BA=E9=97=B4=E3=80=82 +``modpost`` =E5=92=8Ckernel/module/main.c=E5=88=86=E5=88=AB=E5=9C=A8=E6=9E= =84=E5=BB=BA=E6=97=B6=E6=88=96=E6=A8=A1=E5=9D=97=E5=8A=A0=E8=BD=BD=E6=97=B6= =E4=BD=BF=E7=94=A8=E5=90=8D=E7=A7=B0=E7=A9=BA=E9=97=B4=E3=80=82 =20 2.2 =E4=BD=BF=E7=94=A8DEFAULT_SYMBOL_NAMESPACE=E5=AE=9A=E4=B9=89 =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D --=20 2.32.0