From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pf1-f174.google.com (mail-pf1-f174.google.com [209.85.210.174]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 182142857C2; Fri, 29 Aug 2025 07:55:34 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.174 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454136; cv=none; b=Q8LKIXom0ZPSk6RjokwxmpPl9dlgvpFy1Pt+b/X25jEYYUO4rmXRaMmJf4KDlVcnPJiomR3hKUY0nEdaQKkSslglm2nxlXIFS44fLoZ166+WwGQQZ4KN5HEVJ9xJL3Rxr4T/9Yv3fatyltBG84ys7alNZnEF7M0DpGFMT7BxqBY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454136; c=relaxed/simple; bh=oQ/U51BIIgNGsRun+kwInz/tmig5xTqHruGeEvNRxQQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Z3y8+ewm+716inBxYqThUiibZ6wAk6v6HCJT7/C8uHZmqoeg51th9CpRMCAZ8sHSG3dYGurUtgXwPE8P6NitSrL8LCo9QG6di5uNpO4WJ8mSjdjIjaLl/Tck4B4K9Flrf2NXIiBsTn3UkBXqRyPcyf7DZ9wjUQZCALUSF7/c9NM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=KAuafXqG; arc=none smtp.client-ip=209.85.210.174 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="KAuafXqG" Received: by mail-pf1-f174.google.com with SMTP id d2e1a72fcca58-7704f3c4708so2199480b3a.1; Fri, 29 Aug 2025 00:55:34 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454134; x=1757058934; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=PKHUedwTpnE+6902OLKWJUrKeeyE0icmaP4M6h8VeIM=; b=KAuafXqG690UxpnLiISh4UMSpaxxvihp1iG4ytY70oJDiF/BIneIX0COIzV7wOP8JM yNV/EbONZ8YqwAMIxVlWDHncHGE7oM/uBT78ilF22gSZGn4nDElHw8yOi6YIjeM0IKa5 39mS5COThbqekVNxIxA8QEgLgNhFRxbvUtIURDT9Po9nfjsoXsEAzupZ0yLMT3UlHwfs 0howrt/wMc6zd/L0MRf3Aj7suFyFiAWes9wkO/nWRFDdz5xZDVwOSmW6/QfPiJD1HHWU YPWVZnVSVZp5++TL25gm4Sta0DXPY5ywrPWRYPpbEFAcZAoQCFNSix2Yc390IwAtT+Fm bRIw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454134; x=1757058934; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=PKHUedwTpnE+6902OLKWJUrKeeyE0icmaP4M6h8VeIM=; b=MLIuJ5U4zs9Gkm26FVYwNWN9t0+OjCO1lwejLp5C0K5jcgeIVoiRKSDdDdsKmvBNV8 Xrg7cmmJER38QW8oPZC6Pvg9UQ0qFruFoQVtggXy+BQhYxWU0PKFsk8QXRqhrfmSiJgG UG1mKC7rETt6Cjb4SmThvtWpQ+/uzl+NRi3m/GkrAseF7AZ6EYfDbwNgZcMFgdxglHC+ AQOiEqb9eBJuJbwtVR5uynKY60Tu5e6ebMTozWdJepkR7uTS3WX1DTulqhYquD27tNVu m00wrugPB7eAIO8ZfFM1X/l0KsDCnCeAIeBjMbBe634LxI0wnALysVN3B8CyrPLKWEpL FwGA== X-Forwarded-Encrypted: i=1; AJvYcCUpKGhp630GUvtASmmtI6Q8Poyu3ABWRLYM/RQ4S/Uj4Ujx4Yo0EtDV4g9Y7U1d75/6t1wFf7oHO3DxrWg0@vger.kernel.org, AJvYcCUybJM8DNGlfop5IezwRLuFpyPEN9oBApyg+5aaQJYD9lM18R4GnNcETneOWg2PbNRDVzkGxtPVCe4l@vger.kernel.org, AJvYcCVO2k8tUEpCQOqOQb7gtLdvIiqOTsI4AIGKAC99qeYOl1DfXf48YALTeecImkhXFMQeWsFvr7SR@vger.kernel.org, AJvYcCVW7d/uYhzsShiGGk7yXHKZcn/EA9B1vz+2l0FeLBFCyGTgTVs9AmaPS1wYW6flZhM86DXdOoA5X6Q=@vger.kernel.org, AJvYcCVpqvowjwXlibtYcxIJx4vTXIY78eLDltiQY7XAAKeWU7jQJ3cYu78d005mBkYXYZ84IMAf1xQSRy55DQ==@vger.kernel.org, AJvYcCWYtVCvgGlJrAiUaIh8aksIV49tpe9lwAgZMcoJyaxBsj45CQo3bwWlvNXMqheFc61DuSPHEqaRuaWL@vger.kernel.org, AJvYcCX3Evo3bwRHlNUJpm5l9xkGz5UhHeAldGof9/fU8m6AUWgQH5Z2fssUO0rJYbIWWqv43dc=@vger.kernel.org, AJvYcCXUW7YMa8ujA9K+FHkfSRNE9jrniwJ42/OntZx1bz2AiHBUoAgDOKkDiYaZRqbjNJZVtrsdoYa0+c0h+vc=@vger.kernel.org, AJvYcCXmFsATSh0SihdklJVY7lH5kfoyF6toDnnQARN1N9Az+f1ISyaD6deNHc/KgRENqT97+MfxebsjpaavaFY=@vger.kernel.org X-Gm-Message-State: AOJu0YyzIcF2JgmT6NqW6FfTpYYpYBk5ueEj+X5yYkT77irxu1L7QMLb LxJ3GHvbkjJRi6jlHY1BlxbQSeXTBNi0BHGvksMkyXrA1y40riLqNbo6 X-Gm-Gg: ASbGncsaU/g/ikjKDIZ57aPa1mbZnbMItZkJXU2WTlzZEQ0lhMLfT0590RWpUEb2htN woC6Pg13HLV46s05Fpq5f0TTPevIJTIsAJnnvtW0l681MsPTCpjsXD+c6X8h2UL3qVm0sgoKkna scmgMrIOOmQbJ1IgrKnTxcTm0bisPcRok/7MTWlVYOs/lU8ObKg0cLmoS4gLoG/PuSzxS1pkKeT x1FCYyMsTIkm5Gqhv/fb8GDE4w/NRTr1V/fHJylDRZ5m2qIkf69fN+3tFHqJJy5fu1RK7SN/bC0 GwGSd1NaR94zStvJjQGNOE7vOqO2tdv6NHuxdptxDvVlfDheOnggFccZMMfFf1RBiQ3B7snYo2A vdQRDBpjkFgWQOhHRxsC4EPiTcQ== X-Google-Smtp-Source: AGHT+IGAIwvY26FUOsw+74AGPHA13vcCLFsNdM4e5R6RQVZDqKcVncdSUEtOIO22R3FiVyKLzy1QwA== X-Received: by 2002:a05:6a21:6d95:b0:243:9824:26f0 with SMTP id adf61e73a8af0-2439824377dmr17475585637.46.1756454134181; Fri, 29 Aug 2025 00:55:34 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-3276fcd336dsm7401665a91.18.2025.08.29.00.55.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:32 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id CE9134016442; Fri, 29 Aug 2025 14:55:27 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 01/14] Documentation: hw-vuln: l1tf: Convert kernel docs external links Date: Fri, 29 Aug 2025 14:55:11 +0700 Message-ID: <20250829075524.45635-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1333; i=bagasdotme@gmail.com; h=from:subject; bh=oQ/U51BIIgNGsRun+kwInz/tmig5xTqHruGeEvNRxQQ=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY144a/JZLY81M41OfrJ5W/1jtyyro8lZM99fCflwN Zg5yrW3o5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABMpCGH4p3zu88Pdlu95fhsv /CZ2ieHwual5ab7C13i5XivpL/Ip/M7IMI9vYUN6A5f856j5POvK+r6kxCYoXlPd7vthl2/zPqb NrAA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert external links to kernel docs to use internal cross-references. Signed-off-by: Bagas Sanjaya --- Documentation/admin-guide/hw-vuln/l1tf.rst | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/Documentation/admin-guide/hw-vuln/l1tf.rst b/Documentation/adm= in-guide/hw-vuln/l1tf.rst index 3eeeb488d95527..60bfabbf0b6e2d 100644 --- a/Documentation/admin-guide/hw-vuln/l1tf.rst +++ b/Documentation/admin-guide/hw-vuln/l1tf.rst @@ -239,9 +239,8 @@ Guest mitigation mechanisms scenarios. =20 For further information about confining guests to a single or to a group - of cores consult the cpusets documentation: - - https://www.kernel.org/doc/Documentation/admin-guide/cgroup-v1/cpusets.= rst + of cores consult the :doc:`cgroup cpusets documentation + <../cgroup-v1/cpusets>`. =20 .. _interrupt_isolation: =20 @@ -266,9 +265,7 @@ Guest mitigation mechanisms =20 Interrupt affinity can be controlled by the administrator via the /proc/irq/$NR/smp_affinity[_list] files. Limited documentation is - available at: - - https://www.kernel.org/doc/Documentation/core-api/irq/irq-affinity.rst + available at Documentation/core-api/irq/irq-affinity.rst. =20 .. _smt_control: =20 --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pg1-f177.google.com (mail-pg1-f177.google.com [209.85.215.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 92D422857D8; Fri, 29 Aug 2025 07:55:35 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.177 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454137; cv=none; b=LFfEPTlLEKYULk96P1Hg2Unduv6X0Rm0lLlHJMGK5xSA6aynV93nOmMIMVNFW0IwJyzek6G5koGU7H2cJwMYEQlyXssrkQ5FiKB8iKGO2gc4xn8h3HtHLWQv3YS+a0UeyqAx9Erwj9En4D/OQHRAKq6YwuW2j8GSkOKntDnzsvo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454137; c=relaxed/simple; bh=br/gH56HVzhrfYYqrTP3c/xceN5BBvTsvI3pBYQ/yVo=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=glQC/bNwrQUcFSDftVSQ0ibxHTZkFJ8UcDFmwtlA5nUhI5V7dYWrcL2+1Dr6MZxCnjA+njYiMFw90KD9RiHYs77hiVxy6Zm4QiACezYpvzRWGQEjFX0DEpDkzlxpVGHl/rgaIyW6m9oiJThXhRbwvV9wTLwdKTVWd/4Dj+ezNM4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=KCB35WBv; arc=none smtp.client-ip=209.85.215.177 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="KCB35WBv" Received: by mail-pg1-f177.google.com with SMTP id 41be03b00d2f7-b47174c3b3fso1069873a12.2; Fri, 29 Aug 2025 00:55:35 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454135; x=1757058935; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=GkZ2LL+fO6oH27E7YsqUKpWK9h0JvMFOl/W1FWHyGxk=; b=KCB35WBve4e6UTfHwrny+HSVx7v70TOwwL1c5VOeY7G1bmxzxvE0PQ3I3SuhF12xEk W3AR7q928vrPGTpEPqi6ZbrXOq64wAkddHRPdRUedbd+3EsrjqswPRZU6XnieGLpVKj5 ctTY51+ZjPqU+4zD5C2VP597l77BRFhVJEV2SE8YLp5G7dIMxyGeiArIKK3my6pTti8t Ow/t8kQY98murSecNiya28pQkaeQtkzzLkLqCLK4exupb5pVHyZzXgKmtVWLbnF/OCVs jcB7WMBGAMkTf8e2jqrStF6MJXyhhi7RxdwpAmJt5W6KBvcyp6TLxxGfKNiPnACF2tw6 WmFw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454135; x=1757058935; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=GkZ2LL+fO6oH27E7YsqUKpWK9h0JvMFOl/W1FWHyGxk=; b=l0vHY1DscbYGRdbYX6CxOyC75kyrDoCvd5H4D7Y3oxLt7XS773U/c//kbTIGJQFohr EZ3JOxb2JBkd3fDSYadadMTZowx3IOEDBwR3Q1984DszMFS0PcDmuZJ6Ib0Hhl4mLmej QGzORgoOOCDX44u90G0XBDpzWAv1e4oBubrrt6NtXU4P5Lmt32WSspgbJ/8Lx53klV5X EPIaZ9BDS1Q0yZVSAdXdeZaRmMWigqqlnzGClGvabseeaCqdWHcPO5wvKt7lDGy/tcY3 A9WeqnmSUkwlHpd5BzZFcGMv0FbErdI8LRaPwBxhdPxJtVjQrMidyxUiU4q6+Mkbpr5j aGVQ== X-Forwarded-Encrypted: i=1; AJvYcCU64oQVEL+OxZyx2YNUogZutEMt3cZUfwgLZP/NI1hnPzUne5bvNy0TyVsUEynmXrj7l+ldHMlZ@vger.kernel.org, AJvYcCUE70F/cigPho4FviM6KMdQugCVwpbV7mmXDUJqJYG2c5QIIW5BT4OKiC03AFFyskFubybmcTPcOcNX@vger.kernel.org, AJvYcCUZ46R6uovYzTJGtbSk/XDFr7bosY1gtVHVXmI49tluBQh68q657xchyOlznZyhcplOP6M5dKB99xop@vger.kernel.org, AJvYcCWyzohVfhs/Fwr/88y+6HYobfAC4aMuyeFb0+JEPWOv0l1lL3lUqTiCkLURyu4pNkOD+mSeIGraq4w=@vger.kernel.org, AJvYcCX6ZhHv9DNt1iBoA7S6zfdg5nwpuEG1ZJEHzrFbNecQkDV0Vye/pZKdbDDOTIpHKXRjBt8=@vger.kernel.org, AJvYcCXAU3RJe0P0Hu54U/fWVZsA1eeNQDw+fbxbZrs+YxwX59cwAkle9gbFt0a+MaYqK9hkawElbBQRM8rgbaQ=@vger.kernel.org, AJvYcCXJw6B7/jvqphUksbxkacXiIDa9zkqeO/lNJW+j53O4jX4D4ArldwkU/SzWx1Ft38D12+nzM5s6fF+XFw==@vger.kernel.org, AJvYcCXLkTSJpVC4mnl7UObD6Q97bZvKnE263e3zuhdrTsllbqJY2Fh0Eo3ighxR/ei457qYwKtGptZKUF2XASk=@vger.kernel.org, AJvYcCXj76KljxzPssMLsh9GnasOow0v/RDIdDASlKRPKfAE58ZW2ISAsqp7grCTbvuxtcTvxbNNxPCu+jXH3gIj@vger.kernel.org X-Gm-Message-State: AOJu0Yyy0fA175X84SsqW9P12YPw1lcpQmSe86m8NmaFiImzybpU4DEX MAdLr9RPQ4AXtNTXi0WIlI7bbelGJY0DnmzWm2VmJfw/B7tne0CLL3Zw X-Gm-Gg: ASbGncvnj9jz+5mEBoO1adnj1OeOhtBtPkC+sJn+cF8g8D36gc99onHzvHXq4g1iauS 4exzpY5XJoSROTJ75QhjnTAp2vjpos6qZZ2uxHL25eSvLkGXihi0Kmtu2SBvZDyELAkz4wZHxWZ xLFSMpVPbQhMYeZDKOWIcPAq+jSB2w7EPXVurLEnDqdB/Lxb/XRE82si98og5XfnA6Ik605Qabp RK1z83lYdklgL8pmswcKimuXx7kMeA4EnLxGieT5hVAeY/O/Kw7niiK2N3fPfFXpwDD8N9czX3W YWS2OgIR8oVOqG5IClNAfpQm8Ra/dfSZvoSH21jo7eS22fS2MEeBdOdEfagX6QX0wDi62vtdATE Erf34ew9esktryGjwEffD9zWaabFnlDFZr+2D X-Google-Smtp-Source: AGHT+IHJ0etjvptegteXgkUWoFIILA9nIajrzCKr99WRD5OzNxzSggv2jyDezns1lof2dGSUjRUcTQ== X-Received: by 2002:a17:903:4b07:b0:249:2297:c424 with SMTP id d9443c01a7336-2492297c777mr3315565ad.15.1756454134776; Fri, 29 Aug 2025 00:55:34 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-24903724ec8sm16944365ad.41.2025.08.29.00.55.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:34 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id EF6DE4444CA3; Fri, 29 Aug 2025 14:55:27 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 02/14] Documentation: damon: reclaim: Convert "Free Page Reporting" citation link Date: Fri, 29 Aug 2025 14:55:12 +0700 Message-ID: <20250829075524.45635-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=839; i=bagasdotme@gmail.com; h=from:subject; bh=br/gH56HVzhrfYYqrTP3c/xceN5BBvTsvI3pBYQ/yVo=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY14UOzeckV2lWTlnxluBwiWvpt1jF+xvT61/ejpwa tSzw60XO0pZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjAR0x5GhlnvrvsFdd3e6TjZ g2FTa8uK3U48C+++2yu+oPH13XO8khKMDP0RbvPq2Hk2WQbMuFkV7P77fsRatst+E/e4qhe89eI LYAcA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Use internal cross-reference for the citation link to Free Page Reporting docs. Signed-off-by: Bagas Sanjaya Reviewed-by: SeongJae Park --- Documentation/admin-guide/mm/damon/reclaim.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/admin-guide/mm/damon/reclaim.rst b/Documentation= /admin-guide/mm/damon/reclaim.rst index af05ae6170184f..92bb7cf1b5587a 100644 --- a/Documentation/admin-guide/mm/damon/reclaim.rst +++ b/Documentation/admin-guide/mm/damon/reclaim.rst @@ -298,4 +298,4 @@ granularity reclamation. :: =20 .. [1] https://research.google/pubs/pub48551/ .. [2] https://lwn.net/Articles/787611/ -.. [3] https://www.kernel.org/doc/html/latest/mm/free_page_reporting.html +.. [3] Documentation/mm/free_page_reporting.rst --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pl1-f177.google.com (mail-pl1-f177.google.com [209.85.214.177]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 477DC29DB96; Fri, 29 Aug 2025 07:55:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.177 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454140; cv=none; b=SLm74xoxEhvH5+tfg6svMAt+Rks/Q9Hk7bPZsgxlxUxsxv2npTwm4J4t/ALAQB3QjMyyPk+SZUv1xS8d96GSqzWuPz4CvXGZeNDWnObcx0V876mPmqdFUmVCBhgRntBgESSBgKFWImeyblA1/uUruK+HWFVQ6xb7JR1Z6tbCwAg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454140; c=relaxed/simple; bh=OYt2QegR/+u0q3CRKm7Zg38q7SY9D/3L6tdzv43Jflg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Q6AT7vPKRfZGZKRFgkvZNnBRRbEM6Zs8Z8TV0qvs+3xI72sPGksdz/ocijGLQf9esMKIcD5ASzVEeoeXWtlg7hXgJHx4bWii5GXClkWiKRmpSVUGOG5T44iQOZp9QAv2LraZtu6byKQ8LnAzt0ydH4BbJC4c9I1Y2O7mjX/Ywag= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=FwmMYXe2; arc=none smtp.client-ip=209.85.214.177 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="FwmMYXe2" Received: by mail-pl1-f177.google.com with SMTP id d9443c01a7336-244580523a0so18917595ad.1; Fri, 29 Aug 2025 00:55:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454137; x=1757058937; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=0koFSnJrv2UowuMhMeqtiJIslvN7BbZv6mHXQ/mKo7A=; b=FwmMYXe2zWhbsv5Vnm0izxirizTMf/fPpkqcaHVNtEvps/DGNTHJOSrZQuoID25o/T Kt1KdSmj3Ep6mViLtJPU6+79oRoKFMKCHotSdB5KX0JXi8oYiU+qnEUYt6A0H5uu9tQ+ 8jfk45/iQWJzLmFOFFj+sCuNPjE/BEFJwqflL/PusXPhfiWaht7QANUXoadoVkztCd0q P1KrTQIL+4ttxqS74MsHLE1xh+r+ikkrqPi4LUtcwGynBHSirK0oHN62Wpo63D4BWzLG 28uItPNgxBzmUeH4tmhgJKWGeLerRzxIRe8Wr+8R+QWmN7H6LwQ6nleFfsbdg5GTdDMT x/dA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454137; x=1757058937; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=0koFSnJrv2UowuMhMeqtiJIslvN7BbZv6mHXQ/mKo7A=; b=h3unaKe4APG+W9u1jiNoYuQI6jWMaLMWN4PmAEyJCUIpxIdaGNeem9++Hna2Zlh5XU 8+TUFMPE3+szaSiilUNYSVG0wVzt3ypIXN+Y7x5eVPTCVYx11S+dHMBxvRuPC6Q1ntn4 XWRjjoVqaB5y4ohsCW1SOSfdZrbDvk0W03qLmTFc/fyq5jjPZtw93ovRfswaM+m548De J5gnt24IdCsOYliBn2Mh4tACJnV/JV5GtmhttIR28VtUqoPH9Sh7gZVXsNtQtfxhvDLw 1RM0gmlrouMsWjeQiI+pTB+tVOnI2Soy8oiHb2YADw6k5t6dKCOeZVnC7Rg9clfMZdLD xq9g== X-Forwarded-Encrypted: i=1; AJvYcCUE2aGVVvFHC5NyiyHSniBgCFplubWu29422yybQ5eRim+ToY0g35KouuK2jsM8P5bnGevVhrBP2W7h@vger.kernel.org, AJvYcCUOQVqOmC4FDMzFCoTbgDeZJgJ1ueQ9t6rsU1WBGcFNa2nOWB5niNa+aw5tCLJOmfxTBI8e1j3PryTLNg==@vger.kernel.org, AJvYcCUSb9a0jXUCpXdfRbb1umi/gPjvqJs/iy5ml4bEdLpL6ar+KmPmeGsMWE2X3GU3TvUcSMk=@vger.kernel.org, AJvYcCV2AxA/S0lVzjXdEh9ZSNv4W3NIA2yBUAPxNd6qSFd846H2TEYylK7QJXlHZYj1Y0yf9cV5xfECfzmN@vger.kernel.org, AJvYcCVMbrogkDkp2UfT/u67OVkjSJeg8c493GkKh7wjhjlHk6y4T9e9PM+6PurUshaNDy+KHXEzDj0t2sgylpc=@vger.kernel.org, AJvYcCWwgsViaOkG+NGfWWKqBKZAOf2V/665V1wi+GbvD9ZaIq4rSnzW000lY5BVA/7fLGp78P64ULaMafOtXeo=@vger.kernel.org, AJvYcCX+lDM0lC+DrjmEmdO9KU6wZVucLV3AnZjUR0+v+NCehGpcJ+hUrfX/CHAfeYoVFhQyM46O4f26@vger.kernel.org, AJvYcCX2+yw1mvYG9acfYGMw479QTCCSJANLhFNQg946mnDnQBqmcRujqj7XiW4gG4lC6ACHaQMDLWDGbwDBD+Dd@vger.kernel.org, AJvYcCX2y3tDA2K/URoOVI2Dg3qJJ09229SYpCjn37xM7xB3H4O4Ib2wZ5f4KqZs8gITiDYg872+YV/XtZo=@vger.kernel.org X-Gm-Message-State: AOJu0YzEYh4oMHPHFWDa+rkcQRFh02/7bfU5gYcsEyn9ygglwLfFiYyQ S1WyKQzcu4sQHzkaUYUGzmfGpXhDnlr9bgewgxginN/d828q4Q3tbB8B X-Gm-Gg: ASbGncur/OY30V5gm/9/RdHEEM2+ypOiFelKVl7Io4PMFC49ioT8QCfMJ/AbZPPbeDI WkbDHRp9DBXTa7/7MrNPD9PVD8QKFubRq5aDcbljxsmdaA1hpMKNQvXPWhNv/aw8jPL61uJLcaC YuOQTQz8Gx64Hdovb8lNvxc0OiSeLsAFb8xi78TemBDq5jxCQaLaE3NusAqzl0g9o0da5WN+hxf inSuLPY4fjZXdoZUmY3QzLaZvNd29BhmJYpOUYbQxtBVqM4NAdF2pfHrnS+Ep5X4uCFE7VS/OKm OsupzuSRERzdTrutgOwIDj89Fo0bmpD8MR7/yD0tgsDn/qxBwH1/3XDv/AEKazs31BQAAgBteag PS+WbxpzdckSQ2fv0pgapdFrIFw== X-Google-Smtp-Source: AGHT+IGNjBdTFArxVwVJhrEyw48u+wDRa+YP0G1KaeCtmArj8lT7+bi74vyrPcJB8r8IUDLpPVmmVA== X-Received: by 2002:a17:902:e888:b0:240:a54e:21a0 with SMTP id d9443c01a7336-2462ee13154mr358734785ad.19.1756454137188; Fri, 29 Aug 2025 00:55:37 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-24905da26b9sm16688215ad.93.2025.08.29.00.55.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:35 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 2F80944808DE; Fri, 29 Aug 2025 14:55:27 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 03/14] Documentation: perf-security: Convert security credentials bibliography link Date: Fri, 29 Aug 2025 14:55:13 +0700 Message-ID: <20250829075524.45635-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1135; i=bagasdotme@gmail.com; h=from:subject; bh=OYt2QegR/+u0q3CRKm7Zg38q7SY9D/3L6tdzv43Jflg=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY17WLH+uxHuD5TvzhcJo65MVRz8evf+ht/Kg8H3eu d3xR8redZSyMIhxMciKKbJMSuRrOr3LSORC+1pHmDmsTCBDGLg4BeAmZzL8r1qVsXFN0aQnhlcd HbX/7Z5y0OBc87cVSY827u/OC7GTfMTI8J1f/vkt1YY1nGfMLy+IOlnmXaYQu3XLZy7bCT/2T+u /xQUA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Use internal cross-reference for bibliography link to security credentials docs. Signed-off-by: Bagas Sanjaya --- Documentation/admin-guide/perf-security.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/admin-guide/perf-security.rst b/Documentation/ad= min-guide/perf-security.rst index 34aa334320cad3..ec308e00771427 100644 --- a/Documentation/admin-guide/perf-security.rst +++ b/Documentation/admin-guide/perf-security.rst @@ -311,7 +311,7 @@ Bibliography .. [2] ``_ .. [3] ``_ .. [4] ``_ -.. [5] `= `_ +.. [5] Documentation/security/credentials.rst .. [6] ``_ .. [7] ``_ .. [8] ``_ --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pl1-f176.google.com (mail-pl1-f176.google.com [209.85.214.176]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9B83F2C11CE; Fri, 29 Aug 2025 07:55:40 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.176 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454142; cv=none; b=XEtFiTF6OGdKv95lIa3wWq3c3i6qS+k5U8IRkJsPytf6bV7aXwHJDPVPb61SGsnPfBsuDczH5w6wNKsYQl9uwPCok+EwUA98R/Y+qF1/f/M1aLtSdZ2NMDKlfJQk9D5XMkOq53Dq394uf1BVdlecV2BKbSwKTMQ2umwCvwfFJfI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454142; c=relaxed/simple; bh=YCjSy3OR+PtbNsOx3d7dblyTwJjnDEtFBwBCle5X25g=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Ntb4/KPzgMBpSX6YYbhb8lAnyjy/U28G3ipc9FsOLVRlXXlQFvqW0H7SqudvqXZEHfzzZgEIleAN86NMJSUK62NagFnJ90Zc55d43sWDSDcZ/1nzlYozg07R4uCKTas/JYzJySJHBf8qJIoFONMUsQ7lY2Idfun+bVED70ZlRSc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=YiuBKP/c; arc=none smtp.client-ip=209.85.214.176 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="YiuBKP/c" Received: by mail-pl1-f176.google.com with SMTP id d9443c01a7336-248d5074ff7so11457605ad.0; Fri, 29 Aug 2025 00:55:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454140; x=1757058940; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=4+SUGCH8uEjWgwJ6PdsO74F0lOA4arnp0TuRWyoM63o=; b=YiuBKP/calz5FJvlz6ZcrEMDDWLaa9RCSes0mwWQBJs66Uiyjt+r6XYjAqb/Fu+Mas IJDLUAN21ovzvGUesHT/FHEH8sUVisCGhMkzLo4jimNLJb7FoTpQe6pZDZkPR9J+VxlB qF3JIxDhLgdM5/q+fyYYef181ADfC9198spisVT3rs1ajMfyQcBseUpuey0ieqVxbyex 0M1jy6TwTM1XW6BE7H5I/M7S0TfOXFxnHNfekjBs9VlUe3d1yeHXOQGML1TyWikOrc31 oJ1Bg/cMnmrd1U+RpFqLYeZGWjpZefg/bofES3JdxNdbKHVXCl+K2IKk9naQwtZPBy2H Uy4A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454140; x=1757058940; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=4+SUGCH8uEjWgwJ6PdsO74F0lOA4arnp0TuRWyoM63o=; b=Xz7VdliowwSHoNUl2I5/Ajm1Sb9YBo3NSV1pteGlY44qembxmjdfHqsFuJf02jx8RA cO1Ubcwgq/jx1E/t3sjidL93RS0VJ75AjJdW5muyKZHXu2s6HfF2O/bqRquOBKpN+stO /SCcWHVXKrG8I0TVlTIyuhk/M5s6uVfyMrDi7/Qzt0WV/7rC3Rqm0awNJTmedMVih1HV ICn/+k63Vs+WIa45vXQ8W5KU1V3qWLk+NHERNHb1Szi9/TyXZpHk1e0uuRWs+LW6CwZv Wh2QrLKkWz1y1/hd7s+4MaMaAyhjzMYALhdyB7Nab8anTZBZpzhRhskZRrXxrL08su+S OaYg== X-Forwarded-Encrypted: i=1; AJvYcCU+/7CVTYQo1q8bpZQ96qjza+jpJQlmOMAqpk7Vf6J6mRaASMb0MNKUp4CQOxJPmgR3yGNc4TgAz/kES1k=@vger.kernel.org, AJvYcCU7tPvGvC6wqEZ+YkNtPd7Srhmhoh9zDGy5OMQAvjM7354mO5T7nSnwkNsTmh1lVK0xMJsVADXPNWFuvQ==@vger.kernel.org, AJvYcCVbhcH7Zf0wvD426cQhJEvnNEZFJxWojPfWhRWBAevAmgmcSoSLZbtjk19QqsynNqzIs+R/aVoYe9iPVOY=@vger.kernel.org, AJvYcCVxzk10e6/FddqyskRfswyEq/Q8BvhKH3kTNJZFAi5pWn/3fWQVf2h/80+Yzp8gDCLM0KIoVSJIjKs=@vger.kernel.org, AJvYcCW4EASCaEaKcizlRCYTTRAe8c2/1jHQcEDNNaKbiISH2TK6pgN0SmJwZ5hptHCQvjXWvwH5/h1tsFeEsAg7@vger.kernel.org, AJvYcCWGRMq2Ec5aKedsAfhjFGjv7sY4MJqnVK6Dats0GFwX9jBr/A2YKPB3Jk2+E5521dzGcP1ltSWV/jEF@vger.kernel.org, AJvYcCXER+qTda1m+uqnoUoW3JVjNzWjQnIHrUz6PzLXHFp/YSykE7+WwM39FxVNhpBKeJxXgag=@vger.kernel.org, AJvYcCXO6D7P6IJWmdI6/XBHxXRhmAj/NPDtJI4DI3mYmXtk4WL1YYcDnhMvw3BOB64gNsyKyi4iJmIv@vger.kernel.org, AJvYcCXsRsihCZnK/RGrvfgZH8I0QUf8qT2HxJA0gAEsueeFXiAvLdVYzmzbtAY2zQZg0fPN8yk+l0O4dSEB@vger.kernel.org X-Gm-Message-State: AOJu0YyIQX/r6Yk94uoZC6KIgzU4mEGqcqifKB+h+NcPObg53zB/V8r6 yvrfxuCMlD66GGos2Lb7hYL/A0nb0MJkypeL0rdRPkr23/iw9XKuUxeY X-Gm-Gg: ASbGncs9FjYSXFOPgPD71aWjC34rGVb73ybAjxFRuZxZi3HoGu/370R3C7GtWlU8VDk Hosw1ezy8lannM7DztpJANUHnGHGeBOz9cvPQGvASIFMVcSjF1KJEmq+6QHRJ9TzSg4BmXJN8N6 aGdDooetqokDsrhSF7h25NwST1EH6PIAbfkCagTxSainByG0hP7XUbL3Nau9gNKN7VaSYsnxeoR t9TDDcfxogCuE5e0kNZ7zDhUhUsxL45t23N3rbH7hlaU6S2pjKg9BxBihweWHAunqoqfZXrFWWC ah+ir2UoF5tVp0DhS2SRWlafuS4+oshIte4tfuwJxZ812Gk5fHJSWdMuUIEu8VbWvcUu1PM7psS VXn8PxnUXJcBNVxUhLkatGVtytzyO/Y21SgXF X-Google-Smtp-Source: AGHT+IEUIbmp5KZdMZPn0c0CGQYstQ2DxLDepEvVflAGtJJLsQl7+Hp4DCT56TGBU1NzXfP4o4RcNw== X-Received: by 2002:a17:902:d510:b0:249:11cc:2afc with SMTP id d9443c01a7336-24911cc303bmr18192475ad.7.1756454139741; Fri, 29 Aug 2025 00:55:39 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-24903704379sm17029615ad.29.2025.08.29.00.55.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:37 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 5F71C44808E5; Fri, 29 Aug 2025 14:55:27 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 04/14] Documentation: amd-pstate: Use internal link to kselftest Date: Fri, 29 Aug 2025 14:55:14 +0700 Message-ID: <20250829075524.45635-5-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=889; i=bagasdotme@gmail.com; h=from:subject; bh=YCjSy3OR+PtbNsOx3d7dblyTwJjnDEtFBwBCle5X25g=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY14qPYlapHXxetwsqb0JS9jb7/0/73aj6M+zsn/7f 7uJBK+t7ihlYRDjYpAVU2SZlMjXdHqXkciF9rWOMHNYmUCGMHBxCsBEJPkZ/hloBmcs7pqXLvRo 3uW3yzpsL08refrBOejE1FfXjopF7nZk+B9pJzZFXlK9u2zWB3XR7Keu63hWz99heLTAzXSF0Y1 5YmwA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert kselftest docs link to internal cross-reference. Signed-off-by: Bagas Sanjaya Acked-by: Mario Limonciello (AMD) --- Documentation/admin-guide/pm/amd-pstate.rst | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/Documentation/admin-guide/pm/amd-pstate.rst b/Documentation/ad= min-guide/pm/amd-pstate.rst index e1771f2225d5f0..37082f2493a7c1 100644 --- a/Documentation/admin-guide/pm/amd-pstate.rst +++ b/Documentation/admin-guide/pm/amd-pstate.rst @@ -798,5 +798,4 @@ Reference .. [3] Processor Programming Reference (PPR) for AMD Family 19h Model 51h,= Revision A1 Processors https://www.amd.com/system/files/TechDocs/56569-A1-PUB.zip =20 -.. [4] Linux Kernel Selftests, - https://www.kernel.org/doc/html/latest/dev-tools/kselftest.html +.. [4] Documentation/dev-tools/kselftest.rst --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pg1-f171.google.com (mail-pg1-f171.google.com [209.85.215.171]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 5974C2D0C68; Fri, 29 Aug 2025 07:55:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.171 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454145; cv=none; b=LjN8jRyEytrQwg6zNwf4KiRZscNsqp2emrBlQ2JRGj1slhvuQMUMlRnSiO18fgU088TbjCFOyMsKQpBovOOQZ5Ltddaa8xKanPQxnfhj6PGNVRQrl9q9tzdA/4Tb58dPKpHZwG75zQjHkRUyLUCPMDcxLFRapZzf5fB2LP+YJ3A= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454145; c=relaxed/simple; bh=7QXrNRuCbHeHgCYdGUN3dSXlo+bJ6ZwXyeTt5Kf+8Ys=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=uG8OmFFJPDmzJDg/qLK2p6JtBZiMX8gnZ6qLFaEYeSoAQH9kd/6oML/Hb1VJ1cqa7QIhvUs7QwBoj/HpNeLZr2591/nvbW4mRkM2pGsj23bYwTDEXl04wi6Y/DvMYtITaZnHQm/cCqnN6WIvwnvuFQlkFAb6ImSo7PIkQxgRJSA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=OqOASymM; arc=none smtp.client-ip=209.85.215.171 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="OqOASymM" Received: by mail-pg1-f171.google.com with SMTP id 41be03b00d2f7-b4d1e7d5036so157091a12.1; Fri, 29 Aug 2025 00:55:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454143; x=1757058943; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=exY9byyl4etH+4IQEKnm6qXO5lYPceGxvCuurSN7fh0=; b=OqOASymMnjUJjKeyL/rUtaPFRLooC4g2jWK2ADtdVJQn4+ymhMawBk3mG+b3pFcM+0 BS0CplbVZfjWxd44M3/WiI7TExYtYAe7gHlNAxm2Hb+/0sS1lS3xkS67u3HmotbaaMoX JH2kZJhO727dNlOlQJqKMf6qCSy03QDvDLPoH3zOA82VWc5Wu5kUksBBeaUWfMhyQcGT +6g3QDtm/eAzO+mfk711CAEWm4sdglNdhGCAztaFwBHPO376yvPIBuiK4aKMJQYYJ0NV 9ALLZ2/V6rTAmMNJmfAq0jNifn4e1HR3bOhuMrFqPEPUZ/F+NRnpVqqUBkem7r+5bQn+ dUPQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454143; x=1757058943; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=exY9byyl4etH+4IQEKnm6qXO5lYPceGxvCuurSN7fh0=; b=l9+GLUV4dFJD5vvSihNJTnqZ6ZTUGIRKFuVJH1M9gBxjgwt5Ikno4Ia35k8K5yS4Cv oamlTnMAV1TxMmGbFLvNohSRNmHZxmHmjw4Y7UbNf6wnr+S3g7UdM0NtmpN+gS7g7TIW RXXBArE4BW/x2KZTFJaFiNkd0TcjQOmG7ip7FFqKOD2UbJx0VLH0PrJyafE6PAJ465pb 2quFreV5F5xf1g0O6HnwmClJ+gdLni/uzV9seY1hXB+6St9aUH/1XlviCcnarHpPgfGQ 1wWbI6NdW5ywjRHb99ERSucKxUdfi1Ha4ifgKeIIAcHMrzuzFCIrlCPCl3znmSwl+HJz rjyA== X-Forwarded-Encrypted: i=1; AJvYcCU7K0cAcTNy/fJ6HIfpZjNCF+HpSHMKP2WIha8k6EmgepYddBg03QwVK8/5c80NdnVIOLccgSVU/zItcaQ=@vger.kernel.org, AJvYcCUuRngjvVl5Pwrj+iT9Pgb7ajN/qJrwF9TvhhgModS9ZIGw6YLSTPx0Lv4QmSFAdaLlQn+gghQ3@vger.kernel.org, AJvYcCV3JeSE/oprnKCLl6J7G1rB6fd57m0Mvz8n/yoOMc2OKScA6RQBhoAWJNa3mA9tMHpxRfhOA7vTOxLDhA==@vger.kernel.org, AJvYcCW0TCQh2YqkNRqypQVTmG5L/+wCVEp8tvTuEzRgh+89Iju5TE3KA325J9kx7WTr8i6npJ3V1XBqF52BNyry@vger.kernel.org, AJvYcCWkX02qjw4tCQmV0Yx7D40HUIB55gNWAvKu0GXJq0mwcWCMT7z0RTIsdt06EdFL/5mHH2Zyc0f2BEW9@vger.kernel.org, AJvYcCWzQzeG/1q+DOBPv8wBLhkByCWnLBz5iLeHh1gy+uce6Zgkys2PMSWYkhVFHcjxMM/kHaXyNvrtfGH0mns=@vger.kernel.org, AJvYcCXDzgW1hXLAKLqI1zFQ78XguRTgz1sNulZfwmTaiNlKz0X/IiCj5NZNLGUPQJVvjINRCuw=@vger.kernel.org, AJvYcCXcW5dJGKHNSErA323iI+HZJ/7JkrWDHgaRbiwdjxc3WH4uuVZM4283FNAOiLQZ9erjzqRqUdU/3xs=@vger.kernel.org, AJvYcCXwD5a872mHdKbc9lYzrL511z6e6hSGnnHiSlJfTk9zW5CN1LnYCBFZgXb0OeJeb839WAb57jto8AzN@vger.kernel.org X-Gm-Message-State: AOJu0YwUvW89flVKfw+aaYFYvtu3SGsVJqZ6yZ3zH/oXiNZw3Cy8HxcZ rq0cxv+MxK5yxG7aC4LKV9oHQb/scUtm6MVgwsPxgaFJCwAVEi4RK07S X-Gm-Gg: ASbGncvsv/we8fbXEU8isfscIChvW9t3YeKU/Gn2n+KlZj64WnCuzPZcoJxneAzpyo1 anLHwUp5FvTRTZdmU5nVDxmtqAbjMNWfk/Wl19KstNZ1vtcOJtQ6mH29IUay/L6E7DH369zx3Q1 Fwy8PvDhyJUa8a1MhZX/dMU6ozGpaAMF60rFFGbZDd6qBb8GeZLdeuylhMWWE9miQXHM8WZYGsA X3KPUQiFf5o9gSlbN+FP70tRcjIGg7SwhLPquNz8mamXZlazmSYLjs2u6EzB7xV/8oJ48z9eUHF VkkmB4KsYVV/FAm1gbENAzkYZIu3dDt2jCuNEbA/QwIcjTn1KFEn05+Rm0p7Vv25sXyeOiMuISA dhPE1tNNd/vfb5qcKgS55ZXvtL8vRvTIkEKkowRni0z2GK8k= X-Google-Smtp-Source: AGHT+IGl2H1cpKBrzVIc01ALD2l+GqNGGEJdm0M1vP0Ajl0ap9rVA4eE5ntn2ncpRPD9DtXSzK3gDA== X-Received: by 2002:a05:6a20:1585:b0:232:7c7b:1c7b with SMTP id adf61e73a8af0-24340c429e2mr42540329637.14.1756454142509; Fri, 29 Aug 2025 00:55:42 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-7722a2aaa70sm1550930b3a.24.2025.08.29.00.55.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:37 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 7A9CF44808EB; Fri, 29 Aug 2025 14:55:27 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 05/14] Documentation: blk-mq: Convert block layer docs external links Date: Fri, 29 Aug 2025 14:55:15 +0700 Message-ID: <20250829075524.45635-6-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2751; i=bagasdotme@gmail.com; h=from:subject; bh=7QXrNRuCbHeHgCYdGUN3dSXlo+bJ6ZwXyeTt5Kf+8Ys=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY17q3TFftH6q+kyOiIzsCLYVR/ZOd/GUnnS+Yu6/k 6t6/fl6OkpZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjARpWqGfwYJyctD8hT/NwY/ sO81mNZXoe/tpx8864flkqYm66Aruxn+V81fprfBrut+sv/0I1K75vi+e3t4WtGyeRzBVy1DeSv K+QE= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert external links to block layer docs to use internal linking. Signed-off-by: Bagas Sanjaya --- Documentation/block/blk-mq.rst | 23 +++++++++++------------ 1 file changed, 11 insertions(+), 12 deletions(-) diff --git a/Documentation/block/blk-mq.rst b/Documentation/block/blk-mq.rst index fc06761b6ea906..4d511feda39cfd 100644 --- a/Documentation/block/blk-mq.rst +++ b/Documentation/block/blk-mq.rst @@ -87,17 +87,16 @@ IO Schedulers There are several schedulers implemented by the block layer, each one foll= owing a heuristic to improve the IO performance. They are "pluggable" (as in plug and play), in the sense of they can be selected at run time using sysfs. Y= ou -can read more about Linux's IO schedulers `here -`_. The scheduling -happens only between requests in the same queue, so it is not possible to = merge -requests from different queues, otherwise there would be cache trashing an= d a -need to have a lock for each queue. After the scheduling, the requests are -eligible to be sent to the hardware. One of the possible schedulers to be -selected is the NONE scheduler, the most straightforward one. It will just -place requests on whatever software queue the process is running on, witho= ut -any reordering. When the device starts processing requests in the hardware -queue (a.k.a. run the hardware queue), the software queues mapped to that -hardware queue will be drained in sequence according to their mapping. +can read more about Linux's IO schedulers at Documentation/block/index.rst. +The scheduling happens only between requests in the same queue, so it is n= ot +possible to merge requests from different queues, otherwise there would be +cache trashing and a need to have a lock for each queue. After the schedul= ing, +the requests are eligible to be sent to the hardware. One of the possible +schedulers to be selected is the NONE scheduler, the most straightforward = one. +It will just place requests on whatever software queue the process is runn= ing +on, without any reordering. When the device starts processing requests in = the +hardware queue (a.k.a. run the hardware queue), the software queues mapped= to +that hardware queue will be drained in sequence according to their mapping. =20 Hardware dispatch queues ~~~~~~~~~~~~~~~~~~~~~~~~ @@ -143,7 +142,7 @@ Further reading =20 - `NOOP scheduler `_ =20 -- `Null block device driver `_ +- Documentation/block/null_blk.rst =20 Source code documentation =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 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pj1-f48.google.com (mail-pj1-f48.google.com [209.85.216.48]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 8085428640F; Fri, 29 Aug 2025 07:55:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454145; cv=none; b=DUIUonqfH5/6F92Jd9rRVqc0t0q0qYTJeELStwd3mIda7k34faE0rh6FZV24Eom4Z6BbfMBUxIwak4ILH5xeZNhAlKSO4WqqrGNqo4lmXKGGZGg0qfAnVkp2KkGMkh/I2hACi76uEQ9phXwppITGBkzGTTpmG5z4ovvLQpwpzpc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454145; c=relaxed/simple; bh=IiAjp2UiG4E4i0m+2wynqH3PCAcCcaK0of1KdBtx1KU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=WOIru1Sc4zkjydISOpZ6ugOvVwhUsUfc5zCtyKZU3sIF1nnhXpm3UbU7CIwP6W33K34N9my0AiqehwXXk8cylf3F//1mjx5ymz1nQttUKWeECrKq0WoAqQVuyPkS9S69LVg+1umX4dNRtphQf0D0aZrcVIWnBem/mX5yPj92u1g= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Te+Cyhfc; arc=none smtp.client-ip=209.85.216.48 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Te+Cyhfc" Received: by mail-pj1-f48.google.com with SMTP id 98e67ed59e1d1-327b3e24637so1031159a91.3; Fri, 29 Aug 2025 00:55:43 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454143; x=1757058943; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=rNDvUkQSM5YXWXIzm38SWG/hRRo/bsx6SYKE7k7lSmY=; b=Te+CyhfceB/hQFC2ugw0rJEhmI/KW4JKyTtN6JmTijZOMyL1ATlXiQNNMxif59RyFk umjlc0gjOlz9m9peOKUq3ef0raxlm4B6kiRWLfLciOhjs8b9yBsaL9bO0PFFtzMptDYL 7+pvJIfd/atOXY4ZFSLWOsOBtDH5cMx53k5qvrMzWajCjFG6Me5vrMlweFXkeHZzM3Yy mpxV/LZ9fSFOjVOT44kKxHMciPVYcZ/sU0cBwiFuqmPwJ4uFpU8kRxq814hiin280GMS Ru5oL0BrOtyrBRNzTDX5cZ/C33d2wddUD3q2fj4HoWVcZtb/06lNgy5CLStmfWoen3BZ sd1A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454143; x=1757058943; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=rNDvUkQSM5YXWXIzm38SWG/hRRo/bsx6SYKE7k7lSmY=; b=wMmCa9ArE6Z7qrIJ7qNgbiOp3kLK2sitnlceRUamOCPHQPjeZYN02G2r4aQDVwkeXz vydOF7TghSpe1d/j0zHNwF5kifn4pI4sJ+ap/xB3LEjrqnQr8Q4u8BvoxGCC2UzCtBC7 dVcZVKdT1ou+UETh6ITXYeKO/0WIlTr5+T+lxj88DHOJq2xqqriMEqLNbngC2JXg9vWr H5hWpskitemLL9rkfuUVe9j1YcFFYXehZM7vCbYvW/W/BA7/9yU9IxxMQfd9XbH9uPgX HfQStXmjALEB8sjEC9oWEL4aa8Abz0gKYV75tNAZMmmaOLlHi8SzfG6LpShJrb2YSgPs cd1Q== X-Forwarded-Encrypted: i=1; AJvYcCUrTnF262OXQdmcnzmvBHgJ8/k+lo35OfVSm+9mEL2zj/T+XRbdugiPibPmx4uE6pn/kbNMfuxTDnEDYMux@vger.kernel.org, AJvYcCUwpW5osXliCSgPHwTSCD6xK0o0N5diAJDwLdD/Nz1NoHyHccU3n3AthZUVGlIxdv71pWMdG7bkWSS4UCk=@vger.kernel.org, AJvYcCUxQ9AkO+jV0kQrmNeOHiVVFpPJrBuQbSyfurXzGpfSxCS4o2y1UGG0WPqltpUChlbBrYtCDyt4@vger.kernel.org, AJvYcCVPDmyKfaKr3WUZ10t2tspoMg1zcvt17XLkPCLcr0lrVzvqiWYDs2p68XjdxsH7bIb0YdRDoKqrN9oWfg==@vger.kernel.org, AJvYcCVcFCVLMKzNNvSJan3Wd9rvvC5avPeUJyIMDKUwbmM1DFNh8JLs56bkrubWeySSbOQLU915sjTeAabS@vger.kernel.org, AJvYcCVrbExrglFChbd2JFJNrx26oeRDTPzWJHYudKeP9E3gSMlJ5bHcpwhuCW78E9jc5yxfbU0=@vger.kernel.org, AJvYcCX39Uwy7rYv+oYFOEHVVl/Kkmwsg9izYoaMXTgA+qUsIRvJy9nqGlSGq4//lARzoyOeSm1hiZprfD4=@vger.kernel.org, AJvYcCXN2r209pc4HQy2nn0N0D764ZcbX8UOWE1ptGnf+lic/pYAJtHvLpahG5vpawtLU6SINGQJGYzW2Yf6T8Q=@vger.kernel.org, AJvYcCXlj1z5J6DGPhRFvx/Vs5oLbsY0A8rX3tkamyFnmLSL42ECYL3laa5SLoi5iu3sXEL4hyzOxFXujdiy@vger.kernel.org X-Gm-Message-State: AOJu0YzEeyqw4yjqVGueRTa2RZYkT9RUCbKDkiGdYRb0WuYOth68jx8W JOD/YujKeJxlZOfYVNU/Q7LgtDJOBrSHNOwMENtukLj6/c16FptK6BQl X-Gm-Gg: ASbGncuNlrbTkJOJrn7qsUSWC8WAtKQz2Ut6LgkLO/tgWzkUkgWVfqjP5PnIsqqFog9 zLkwxdXS+iUEu/bslyWX+kKiQ6qsjX0JCZJHFo49IK9msNqsxmlrmrojHtVY73Ks8uJsqWzk3tw FGsIFDUixeRIvHGHFw/q4Crfwl36NAohSqA9ojmFo+p++aa+tni45FC0LTQZmNcquOJ2pgB67ge e7fJUVmzhPVjOYZdGrGPIfA3UOYhDN7t2CKAwV2ezNlJVLPoV5kgukYCWma86RJjb/jJlCgYOe6 2K0zmb+3z3fjhmb7i5l2U3Do71LRwq5oLEdDF1e6raYj2CWJFUbaZY9d9xx5cENjukX2WJbZTJ6 xphfOx+nL7aFdPEJNFPhwtQvaVUClVA8eolsm X-Google-Smtp-Source: AGHT+IG3+4PiXre8myZJXbMXtIyGoT2Zo+1v7SoTFErR1CQFe7OBynTDKWH1/q0UIz7vCvtEP71Wtg== X-Received: by 2002:a17:90b:4c02:b0:324:ece9:6afb with SMTP id 98e67ed59e1d1-32515eadfb6mr30884939a91.3.1756454142399; Fri, 29 Aug 2025 00:55:42 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-3276fcd48cesm7365898a91.19.2025.08.29.00.55.35 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:37 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 8D99044808FE; Fri, 29 Aug 2025 14:55:28 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 06/14] Documentation: bpf: Convert external kernel docs link Date: Fri, 29 Aug 2025 14:55:16 +0700 Message-ID: <20250829075524.45635-7-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2744; i=bagasdotme@gmail.com; h=from:subject; bh=IiAjp2UiG4E4i0m+2wynqH3PCAcCcaK0of1KdBtx1KU=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY162Whs7TnrT1LggM0BOd5LEqfAiXtc37zS3e5gl8 vnwGP7sKGVhEONikBVTZJmUyNd0epeRyIX2tY4wc1iZQIYwcHEKwES+TGNkWCZ94c28TXy5tQ2r bD/4zPoTU9D/g2m/U+vihV++Li1Y5MvI8PjMzk3qf6eEm+VfELaazHDuklKIXI/3z+ub9I0rLF5 X8QIA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert links to other docs pages that use external links into internal cross-references. Signed-off-by: Bagas Sanjaya --- Documentation/bpf/bpf_iterators.rst | 3 +-- Documentation/bpf/map_xskmap.rst | 5 ++--- 2 files changed, 3 insertions(+), 5 deletions(-) diff --git a/Documentation/bpf/bpf_iterators.rst b/Documentation/bpf/bpf_it= erators.rst index 189e3ec1c6c8e0..c8e68268fb3e76 100644 --- a/Documentation/bpf/bpf_iterators.rst +++ b/Documentation/bpf/bpf_iterators.rst @@ -123,8 +123,7 @@ which often takes time to publish upstream and release.= The same is true for pop tools like `ss `_ where a= ny additional information needs a kernel patch. =20 -To solve this problem, the `drgn -`_ tool is often use= d to +To solve this problem, the :doc:`drgn ` tool is often used to dig out the kernel data with no kernel change. However, the main drawback = for drgn is performance, as it cannot do pointer tracing inside the kernel. In addition, drgn cannot validate a pointer value and may read invalid data i= f the diff --git a/Documentation/bpf/map_xskmap.rst b/Documentation/bpf/map_xskma= p.rst index dc143edd923393..58562e37c16a01 100644 --- a/Documentation/bpf/map_xskmap.rst +++ b/Documentation/bpf/map_xskmap.rst @@ -10,7 +10,7 @@ BPF_MAP_TYPE_XSKMAP =20 The ``BPF_MAP_TYPE_XSKMAP`` is used as a backend map for XDP BPF helper call ``bpf_redirect_map()`` and ``XDP_REDIRECT`` action, like 'devmap' and= 'cpumap'. -This map type redirects raw XDP frames to `AF_XDP`_ sockets (XSKs), a new = type of +This map type redirects raw XDP frames to AF_XDP sockets (XSKs), a new typ= e of address family in the kernel that allows redirection of frames from a driv= er to user space without having to traverse the full network stack. An AF_XDP so= cket binds to a single netdev queue. A mapping of XSKs to queues is shown below: @@ -181,12 +181,11 @@ AF_XDP-forwarding programs in the `bpf-examples`_ dir= ectory in the `libxdp`_ rep For a detailed explanation of the AF_XDP interface please see: =20 - `libxdp-readme`_. -- `AF_XDP`_ kernel documentation. +- Documentation/networking/af_xdp.rst. =20 .. note:: The most comprehensive resource for using XSKMAPs and AF_XDP is `libxd= p`_. =20 .. _libxdp: https://github.com/xdp-project/xdp-tools/tree/master/lib/libxdp -.. _AF_XDP: https://www.kernel.org/doc/html/latest/networking/af_xdp.html .. _bpf-examples: https://github.com/xdp-project/bpf-examples .. _libxdp-readme: https://github.com/xdp-project/xdp-tools/tree/master/li= b/libxdp#using-af_xdp-sockets --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pf1-f180.google.com (mail-pf1-f180.google.com [209.85.210.180]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 662EF225788; Fri, 29 Aug 2025 08:02:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.180 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454578; cv=none; b=E4B5OPpV0Lkv+ibWynTSuxzt68zNy2tv7S+JExWQeE5czQBo18HoU/iwMr67zd3NazTE1KjretHgFeAdEBYy1Zr0rlRhjPMyS2tL/DnHzXCQNe3ycVbzGyT3dGoNgyYXg7qz40wPlU/DvuoliI20hMy8DswpAZDq9z4wU6IIKZk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454578; c=relaxed/simple; bh=yEY9P3BA6E4kqaGTHyjuJlgmOOGj2m2ZOET4fPd8xcs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=h6wp2KCZ3AhGjDNASopqKUdMqML1o91N52oBG0xNUXvs57Et+3Q8nxB6rGztTYd9xnvDux1SJMiatNaK3WaG+GJHiAFbDhOWWRjaCQXE73auQDWMhpiJbZ2/Hf5KHUrDNwOFZxFgSeQlwwuZYdOXFgkg5QHYlpX/f5N8awSPjXs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Ier2DQll; arc=none smtp.client-ip=209.85.210.180 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Ier2DQll" Received: by mail-pf1-f180.google.com with SMTP id d2e1a72fcca58-771ed4a8124so1919149b3a.2; Fri, 29 Aug 2025 01:02:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454576; x=1757059376; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=2kNx/lgQaweLHCKpOd5HxLBg5NtnJ9f3nOi2hx/97zs=; b=Ier2DQllCl66+ZUG/wDbK8Mv8skWwLrseAmXvJ4P4ioufdgROx/U6kG7VyUAEGfFnT bMC+wu0Ixa8vwoFIz+NCZO2vvDFLTi2dmtkurd/F5x3FtS4+ayudXTamebtpx2cZzCLt /aHoi3I2BAVwylGoJ9SO05COR3v0ErOi7M1bt0jOXvrNR4o9g+E9EjlJ0CQ7TLL+8bOm dg5ben5eZRNcfUYoReh7F4u0hbsi30VRDAb9PkkfqAyg31L88IV3v2KjKoifVdKAGkp8 7Xi0Cd9FRHmNrKuDQsc/OyfJnKEjbIH3yZeLxRQ4UXtUzeRfgw8ONErYf1/4V9CeQ2+3 K9oQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454576; x=1757059376; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=2kNx/lgQaweLHCKpOd5HxLBg5NtnJ9f3nOi2hx/97zs=; b=DpFYu5dmeVHokwXjco2P9TYlAHLHHcmd601yzjUMUNbBucJzDN5V/Wz/2hieqd4DZe eJ+MPAzAANK/AgNTvAvpxPnrjZZeQMk51m2cTwmXEEpAr2BDK7hr2/HOFX8dHXB7zxQ6 2M3qc/XIK7c0yi0ksLisSDTBDK4KnRpwSVeHt7dT7e97RkQpPo2dV2JI+rKro2eBBq+k JerjNcmycwbQTPy/8U8Zru12Nux9J2JZUEKbqxhcQOaaoWup6/ztb9RcYpaYzDwWp/HF VzGS33jYDhwS7vO4VQ53edcbmwvx1ybZwlKwdNCohCovNFawR2+jHNoJWU5ViBV7mjeT xbtw== X-Forwarded-Encrypted: i=1; AJvYcCU/dZL8h1aS2hp484dYKaurihCfsGGR38hoeCE7DeFseDPlWIoTv4PquFecYDb1cfRLZm2G6NA5W+8inA==@vger.kernel.org, AJvYcCUQERPqlVFDqZ9JhH/bOvSWkDgHraX5mSvscrilJ1hrBBssKlhhrYPzbL35a8+S0QvsZSJTxlulk3d817w/@vger.kernel.org, AJvYcCUWXjJ5FolTY+8/dDulZKhlDtrDuDg8CZt3F3WA+9sSPj3+7L5uOsTLLdhNJ0zmAqKMBPlIP43nR2U=@vger.kernel.org, AJvYcCUeZvNSrUcPvZoFKD06EhsqwldrkFkhgEEfN9TpMGLLabwgVtUdfKraSvfflEgVhji1qYrj30X6k7/7@vger.kernel.org, AJvYcCV/dMKBCA7IdDbWBiqqNIgYTJuUaiL1rIJCCgEhwcwkDO0ocJEsf2NaUVeIpLhDiiqoqtU=@vger.kernel.org, AJvYcCV5eAr55zao6G/2okHvZpeUaIkjDeheCmfyd1fDRY0cz50AUb0IFaOvIOK0RpWVouFi3mYqrJ9q@vger.kernel.org, AJvYcCVpnD4oWZKQl7H0St/jEr9MKNrgs6rKkT+wX+3VScxtXUPptWC28iRN8PLqv8n/OOaS6vO8+udTLuGz50Y=@vger.kernel.org, AJvYcCWZEehTVkloaU/myCDVV9bHLVxD9bbAmqsDD9h5ygZibn826pOL/6NFWGheFn+VmZjHnB1hk2af2l4JJrQ=@vger.kernel.org, AJvYcCXBul9a5ULyslSovejt4PQGuKZuAedo1fht4sXd/Pd6CMbdauIox6+4q+IFASD+LdeAfyBhgW8Jr8kT@vger.kernel.org X-Gm-Message-State: AOJu0YxJMeLINYPqwBWmoYmOunPuSMNznUWkOce8IHieQvvExdr12WoJ BTliMwYhtjgFxeE3y+yN7hOBvRZPq0gQpKmo7LdSMPHwyZZkdnTBRMOL X-Gm-Gg: ASbGncv1Hx4srGqvfhaLJqHCfa3PsDt6iSfqFptAcyq2ufT8QUZ5R/pPKDWqKgZc1gi S0H+asXGzSPL5zY8NMVOTrNM6YpjzkciR20SAnAe630W/D1guctNEy5E7l7E4xWWqHEOIOMxZOR 8H3CX25da6D4ijeFn05urJMF7G19Fr2QvY/ZMMPqThDHKtZMbHwZIXVE+PsWtRQjY840CEMpInh 3JRXk/zNKwWlRfsiGagg0casvqXI8tHHgg0Un/yObLfPfwvCnGnpTSz13RP9dbmlbpLVvC5tCdY BXroUffHP8XGuopcSFXmNgP8BZONeOiDGcUS1CxzSJQRJxl+Kn6LsL17jGvufVfnYuCStUy5zqd k3eDBZWYz4xVu5QmoF9MS6YycB1btjsicGNDx X-Google-Smtp-Source: AGHT+IH+t29amFLYd0pmHfYJonIUbgBYX5deBT907gE9ZXzofCuXi+cmB62DwyrzhPtfYbGnFlKG4w== X-Received: by 2002:a17:902:d2c4:b0:249:25f2:16d0 with SMTP id d9443c01a7336-24925f219ebmr1591865ad.12.1756454575452; Fri, 29 Aug 2025 01:02:55 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-249037254a0sm16722785ad.33.2025.08.29.01.02.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 01:02:54 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id A15474480905; Fri, 29 Aug 2025 14:55:28 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 07/14] Documentation: kasan: Use internal link to kunit Date: Fri, 29 Aug 2025 14:55:17 +0700 Message-ID: <20250829075524.45635-8-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1129; i=bagasdotme@gmail.com; h=from:subject; bh=yEY9P3BA6E4kqaGTHyjuJlgmOOGj2m2ZOET4fPd8xcs=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY15eUeC/XH99x9zD0/p/z/9z+OvEiwfuXjriUbHJw 5Al4fDvwo5SFgYxLgZZMUWWSYl8Tad3GYlcaF/rCDOHlQlkCAMXpwBMZOZehv8FVlI3eaYvZbZV FT1yZ4VwhOvUr/8ro6tZD8+s1FyQW17C8E8vzE754pXFu0SKjG4wxTc6XF7j/+Pma/mjrVH18/Y ypfEAAA== X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Use internal linking to KUnit documentation. Signed-off-by: Bagas Sanjaya --- Documentation/dev-tools/kasan.rst | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/Documentation/dev-tools/kasan.rst b/Documentation/dev-tools/ka= san.rst index 0a1418ab72fdfc..c0896d55c97af8 100644 --- a/Documentation/dev-tools/kasan.rst +++ b/Documentation/dev-tools/kasan.rst @@ -562,7 +562,5 @@ There are a few ways to run the KASAN tests. With ``CONFIG_KUNIT`` and ``CONFIG_KASAN_KUNIT_TEST`` built-in, it is a= lso possible to use ``kunit_tool`` to see the results of KUnit tests in a m= ore readable way. This will not print the KASAN reports of the tests that p= assed. - See `KUnit documentation `_ - for more up-to-date information on ``kunit_tool``. - -.. _KUnit: https://www.kernel.org/doc/html/latest/dev-tools/kunit/index.ht= ml + See :doc:`KUnit documentation ` for more up-to-date inform= ation + on ``kunit_tool``. --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pf1-f178.google.com (mail-pf1-f178.google.com [209.85.210.178]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A88772773DE; Fri, 29 Aug 2025 08:02:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.178 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454578; cv=none; b=Rup5xPbkwn04E2UfHo2SslVrkhKZPeyzWxhoViqA5ewDkWg89eIH3vz+LPzECowMWDhkISIJsoRUy/0sC9kk5QTPhhpZdVk82h/vz65qtI5fmjMNLz8JvcB1pz+kRsSOw30u71dzuqRkRbj6LB5rCCzbw4+HEyICbdQLJTAv8Gs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454578; c=relaxed/simple; bh=lGvjj6RPPbr58GqrWqgYvJfKnQd0kE/Khje7rmfw55Q=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=IfclUnR8Vi2Ycci4B1+IOAB+iWf2TsUFCHV8fdjacbJAUDXA9nSTyaL4Yt5+VreiW5rqy3yjEM1q/1fIpoJHk7RiQPp9hBuejuyD5/bx5z0sJogtjFZSlqJRrIGpPGNfqjQUzng9lT/UVGx+keeaYsDIvcvv1OqsHwLvW6Mpw4g= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=a5tprWdj; arc=none smtp.client-ip=209.85.210.178 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="a5tprWdj" Received: by mail-pf1-f178.google.com with SMTP id d2e1a72fcca58-7704799d798so1522391b3a.3; Fri, 29 Aug 2025 01:02:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454576; x=1757059376; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=GUuceR9E3vzJz5a/JHCoOJAb1uIOOWcnyWbxLYGhp7M=; b=a5tprWdjKWLGHsGIdSRgCYfaYN4Z+HoeN2FkXcZdaqkgj+e4lSILjlU/rLMCB0BPxL /h7O3O0sfFbndGR5aYbr3dQf4W33G5gsNI+szurmassIl+3Iibdmi0Hl7FPg/Oa9x/NZ 9zoKn1cfhjlkFeS10ihZSTNR66ATqtXAB+hFrNWp6U9krZuBKWK39L2EZ26KqZFzB5/J NETQVSyOlS1CUVWTyJgzz4zQ5n5yFXXGaa/izbWXIby20nDJRSP1VD051hYtI/TbNKrr KbRJrThgYGGYzPX+34QV2VhXqjTzAn5lWhWgHGlFWaz64vB55ZgazZBTz/vxhwuCar2Z BNlw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454576; x=1757059376; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=GUuceR9E3vzJz5a/JHCoOJAb1uIOOWcnyWbxLYGhp7M=; b=UTIBguqOCGRmnwurnHJfjRiT4OhZm0x71jmAPqhLlLjTXRPQPsringL+mLngS6nbI7 li4QmUleJEUrpsfnlHS437+9H/dzLUn974PlPUqDe+VAUv/4p99nq9VR1xDk8/izCtP1 bnsgdZYdwQUD3Qde157L4kP/SLy0mYo8CbYF6urJ345uj0uX8nDMnjiC32iDBI86mXjj VShTnvHPMa60yd6DRkUb97WcOmiA8ULoB6t11FqJb8IoYi3DtVFal/ZkrOkzTJT0A/00 x2ZzcwIGAG3NsG1WkCvRguFXAdoevewnh9gF0jaQTAQ2pSbw4jX2HPPH77/bVzFEYkd3 kV4g== X-Forwarded-Encrypted: i=1; AJvYcCU2ZUtTg4xCDaP5kQ26H1vDW/zSrv9xhUPFxxqpYVw2X7T/z4Hoz+SqXmasjN5/oC56HxEBrv79B5fX@vger.kernel.org, AJvYcCUMoA9oSelLZ/SGhDMt+XINHEqffs9g+VtliK0VfM3GDA4oi7gEdH50FuhT9MWQBTjS+f/J6I4KO+fohwo=@vger.kernel.org, AJvYcCV0hyhKUaqChFA2P4pdIu8vzisN0lFND36Wyy0tpvq8Jrzw8YtPHc8J7CGFAoHZJeOCQ9jN5sysMs6l@vger.kernel.org, AJvYcCV25FDlAiQBvJDLbkEgvcYnPZTGMspwNM4ll5h0T1D752Q+zEVXULInx40ngTMm9TkdzKhxxDlZZz0QR3Y=@vger.kernel.org, AJvYcCW+LR0FOlPkKSpZEv97jTPkr5BKD1Oizu9zAUcLqvjSF4nMm6OtgRIPwKue4Tu7j5oqsj7ZWGzq@vger.kernel.org, AJvYcCW1D0pptPHWWuqhQuW/Eix0Yj0uvQG+48L2EmIbkl9HefDlQYmpfJMMvHCILV8ytFCDmZNkB7AGmY14TeRv@vger.kernel.org, AJvYcCWc4NCNGgfItgPB7qc5D8sL/jSk6qR/+1i4BJeF+zXcYR13MiQ9cJxr1dI85XNTGdu5U4s=@vger.kernel.org, AJvYcCX2lRsc4GciPNHa7A0HUZds7RFs6LFTPrDqtx8DlvbUTD+3zJPx6MW5mv2cPsOoM3p0o0Z6EDfhIzaMMg==@vger.kernel.org, AJvYcCXHzOhlVu93wylKgkq1WGWVGOOhH92AbKkrCiM5m5Ur/9unt52AlD8Dpyhb/6+UaOTkhAcGkYMWmbg=@vger.kernel.org X-Gm-Message-State: AOJu0Yytr82nN3PLLl4cn1E0txrRf4C+tL51/aZ4wIxN9tApVbyG+ixz bHqYqnsBN/GlRefAYAJdMSQl/wrWC2WYgPjRKxt7bxfAJm0bCApoINoz X-Gm-Gg: ASbGncsuzo432CR+9es+FIWaXUoOhVnTjAi55VIKsdCu7j6Mx1qljeRQWktYrpT7V7N wGhAINPxeUEaQBIApoEEITrnKLmOF/lZ5OP7WfjL3uEk7/gap9JCxt/CeSXTVJPVX97DKlkVUQ1 ehP9DpIIabO44YYc6O0xPvyyzCL1Q0aR7gco7UNxsp4DS30iK3h1FrPi5AxJL4x07FDPgzFupCb ieyWu2mZhgAg8ng3mlhSxl4kuN/zcR2eQAvfbvvyIhCBkQMwK5kfEvcny4jsUw1OhQnxzdFbM2+ SmggdiouwcCniXisVgIXhZaiHFllsekuvtScah9YprokGUkaAWam4JLvDDt5T3L0glUkncpEuKC rch6K5no3Nrh+xIYU97IoWUg3Q10IDSXKBtwr X-Google-Smtp-Source: AGHT+IFt0CgZnKjzhJ5g4aj0Cm28ZWwwe3q9IBbh2aQ/4X9BQsH63Txhma9tsRWuYD6j70bLTYHjgg== X-Received: by 2002:a17:902:e890:b0:246:bcf4:c82d with SMTP id d9443c01a7336-246bcf4cc37mr269048275ad.52.1756454575739; Fri, 29 Aug 2025 01:02:55 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-249067de9f1sm16493345ad.151.2025.08.29.01.02.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 01:02:54 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id B95C34480990; Fri, 29 Aug 2025 14:55:28 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 08/14] Documentation: gpu: Use internal link to kunit Date: Fri, 29 Aug 2025 14:55:18 +0700 Message-ID: <20250829075524.45635-9-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1122; i=bagasdotme@gmail.com; h=from:subject; bh=lGvjj6RPPbr58GqrWqgYvJfKnQd0kE/Khje7rmfw55Q=; b=kA0DAAoW9rmJSVVRTqMByyZiAGixXOmjSTNEt/JFR6AhPDWfGCcGj/Np82/Az7wMJic3oIar2 Ih1BAAWCgAdFiEEkmEOgsu6MhTQh61B9rmJSVVRTqMFAmixXOkACgkQ9rmJSVVRTqNRJAD+IU+J KWDSPb94prUVj+FntqxPO7boU221XL2jEkITc6cBAKhpWT1CuLYVAMm4rv4hGzdOOa9sljkO4cB hdLolzx8O X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Use internal linking to kunit documentation. Signed-off-by: Bagas Sanjaya Acked-by: Thomas Zimmermann --- Documentation/gpu/todo.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/Documentation/gpu/todo.rst b/Documentation/gpu/todo.rst index be8637da3fe950..efe9393f260ae2 100644 --- a/Documentation/gpu/todo.rst +++ b/Documentation/gpu/todo.rst @@ -655,9 +655,9 @@ Better Testing Add unit tests using the Kernel Unit Testing (KUnit) framework -------------------------------------------------------------- =20 -The `KUnit `_ -provides a common framework for unit tests within the Linux kernel. Having= a -test suite would allow to identify regressions earlier. +The :doc:`KUnit ` provides a common framework for = unit +tests within the Linux kernel. Having a test suite would allow to identify +regressions earlier. =20 A good candidate for the first unit tests are the format-conversion helper= s in ``drm_format_helper.c``. --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pg1-f175.google.com (mail-pg1-f175.google.com [209.85.215.175]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id C07A6286421; Fri, 29 Aug 2025 07:55:46 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.175 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454149; cv=none; b=BLuZ1a8BWVD9uRSesaPSUKFBuMS5+Fm81yUFtYqifbTuQtIcxyZVKHtnH7EU5NntTK7/njUGcF7c4KItO9xndC7z6pZzotMdnrUP30INu2PjNJhdJLKAcHBMm/0AsqZvTyIn0pL++kc6tJu8+2QkRLC5HfYOFFyKeF98LZZsJjM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454149; c=relaxed/simple; bh=Ip9RCWVx3N2eFboDnh1dVntKjUKs5RT6sbpEBdmz23c=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=PR8JhsOYh27wY2pOh10Zz8rce0dbvv2SGBcUgs5sJDof/zkJi+62Xl1TgepOLN0ShOX5iZt37p7M0Hz6NQBG9dpTW52jeOK2Ao+8uCX5jX21itIRQFIVy3vu0XK+6AHFzq6/bVvc1+Xmw4kHRZ6dkyC8dm1hR5mdNb3Eiy+edq4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=mXUGCrDQ; arc=none smtp.client-ip=209.85.215.175 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="mXUGCrDQ" Received: by mail-pg1-f175.google.com with SMTP id 41be03b00d2f7-b4c6fee41c9so1102159a12.1; Fri, 29 Aug 2025 00:55:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454146; x=1757058946; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=fK0hEDM5Yyao3a7xqBzpr49p9H5HB+om5vfXDIKLdeg=; b=mXUGCrDQmBJLuU2PXYJKU3+UhVoS6GW6T8ED6CwRweLnu7LaCnbqxuEqNJEXVauim8 m10tm42f2l6OtMKt8nNOlxiBvo7uMOJ6VieTDOLCK1kgGBHRoB3MHn1FGKF5ntq+tzZ6 e36vZxGAI/blx9eRrD6aBou5EAISoTHPywT+L57CG30TmmPvjFGYvkjzYIsOMw23xwTC wHgnvDZnlpkCBJLzt1FRCbAJUZwwpLQwXBKQfGLS/ngOkh58PMQve7gmQba6F6Vzm6bP 4royouIipJCE0b9T4H8xhwzyHB+TZk3fNVLcgETpN9F4dJqjee4Itf0cdkc8JxEH0yNo dz6Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454146; x=1757058946; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=fK0hEDM5Yyao3a7xqBzpr49p9H5HB+om5vfXDIKLdeg=; b=cj+1fFCj95lCrSrky7pS/YU/Ieal5omuUHv8ypQ4urvQczo8I/elafUZpDgHogKyWH bTqPCwUoFkB6Eh0s1E4p+fpP1dFjuScEW+Qwth2Irye2RmLoHEkvgueGLlq63EvEXrIq s8byQaeh4Yk+LJtWGastDPOuRyc39ODoK8KuGOEJXAxr9r8msm47OBMEykNYQNhcMgAZ FP3n6Gh9TdQgxJfzU9cmXrfBc2DpjWWkAIoOwbqYnfOarawvH3fXhr/iFCPQdjqIN6cO dj1fXR9rIlWTtTzWZzp+188xmw5P+1VsmFJ53iRi58AqdHLkjURzPFVlH77r+Quz98v4 WGzg== X-Forwarded-Encrypted: i=1; AJvYcCU2qvK28KHmF0ynyBY7i55rCBiOuToJWzxRGlxjp4A1v9fttxSr470P5bIZcmF0vvl4pkYN+qsM7zZr@vger.kernel.org, AJvYcCUSV6/NI4NVO30PQbQa0lZKtBA9Xs2HROgO55cQjJ5I5pqkoTlESYmJOkG2/Toa4b5rAOQ=@vger.kernel.org, AJvYcCUUxyHrFQhysIQve993bLt+JW5upTSbLNvEK3vloBM0wMUndlrpy/O02FJp4ER74h15Zt+AWHYahWGp@vger.kernel.org, AJvYcCV3oNcJefRmxfv1KwBQTXCLdANw/cojtNNAwhR6rHQsB/4t2MUy07nueUlURXGFXcslvvqlCGhk@vger.kernel.org, AJvYcCW+NgJE0iIr4C4EUnGzr3okbt4ddT+1n/yAYg1Th/tqb2JbvIk94pjicmv+oKfhMj1gXKZ26xxSeFgFKfE=@vger.kernel.org, AJvYcCW+Rpv1vFynwiliY+9JRexwGrisOFjngVouPHcZ31QXyHOqOf6EK/PiqiATAOrBtsCuNhkOHvBtFxQJUg==@vger.kernel.org, AJvYcCWWtr9IRaGx2+SL8aOHHUSsLbdNH6YJaqe1bXjYEMPxnsXritU9H9JKqlKqIahoJjNEMWlkCEt0r+w=@vger.kernel.org, AJvYcCXRY6qiW6WRn7GAx3E4zz/rLCsePRUPFnhYiFxanKrRC8stmvgTUIsbZQWhFYDxkYJUH5rPpsI3FMMJb4o=@vger.kernel.org, AJvYcCXys3FNPxdeqn1gCY2B97jznEwbLy19/IRcM6qPjPqceqhKdQzKsWf+YnvSkdZSwSfFjuY7dUHLf2WhHwRo@vger.kernel.org X-Gm-Message-State: AOJu0Yyhy7DZbNTwnmAKti8UN0+7FnTKvsLdTqvauPwUQTSglXCgtR6L 0483ZA2FV9RjP71wVF8kPqS0OK82PQq5Lb8MbyeWaOINYgw/jgw3DzkM X-Gm-Gg: ASbGncvv/GVN9GNtE4i5fUFQmIN+486zWV3OS0VfE/YzutwmXGqa7aeLcRyeR7glnv9 lIOjGGDHXOEeCXcb6WqF0ZcjfB7veYoSA/bKPUPTHaabo981wxmb1YgHiLN9RmNAIOLsvWBbNtC s1q2w+0cOFuIhqo80tf4/BuvhzXG6yU9/I0EnAP1l/D0Ul9u8wEoBr4DTbN4K0w4tcx959/h/Ml pAhGcO+6rvD7/rhUwjQWcNYHqtdg/XPM1+FunzcSSLSnT/j7oKlwyIc6eov/2y+WvZH8C8Ib+sd v4/YmEmTNFZJzatQeH4j2V/k+IeN4nN9drM0ndTzCiQw5tmTOAqS3xGDtUkQkzDEkxiIu858sEQ 0MsWOccsuTuFaOvTbfq6HPLL9pd7wtH1Q+dPp X-Google-Smtp-Source: AGHT+IHJbtOvLK7smFZ5Taldvs91dQKYlT3bJQAsV4fZ4iEcDvRKpIMHMCPIqq2aQ2G3ehFn7aA64Q== X-Received: by 2002:a17:902:cf08:b0:248:a4e2:e6d6 with SMTP id d9443c01a7336-248a4f2333bmr133286365ad.39.1756454145980; Fri, 29 Aug 2025 00:55:45 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-24905da4784sm16792615ad.90.2025.08.29.00.55.38 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:43 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id C98394480991; Fri, 29 Aug 2025 14:55:28 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 09/14] Documentation: filesystems: Fix stale reference to device-mapper docs Date: Fri, 29 Aug 2025 14:55:19 +0700 Message-ID: <20250829075524.45635-10-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=2828; i=bagasdotme@gmail.com; h=from:subject; bh=Ip9RCWVx3N2eFboDnh1dVntKjUKs5RT6sbpEBdmz23c=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY16ybj++M2M+e9AK28XZP75VaZfxL/rvM//ttckLa 3oE7/o/6yhlYRDjYpAVU2SZlMjXdHqXkciF9rWOMHNYmUCGMHBxCsBEPq1l+Ke0Kqr32Tmn3/wy 503l2Fb8+Tb1i0vpkb/b//3YUvkmUo6bkeGv6MSGx38SK429ymz0txt6/t/hdS/prR+npRZPk6W qGg8A X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Commit 6cf2a73cb2bc42 ("docs: device-mapper: move it to the admin-guide") moves device mapper docs to Documentation/admin-guide, but left references (which happen to be external ones) behind, hence 404 when clicking them. Fix the references while also converting them to internal ones. Signed-off-by: Bagas Sanjaya --- Documentation/filesystems/fsverity.rst | 11 +++++------ Documentation/filesystems/ubifs-authentication.rst | 4 ++-- 2 files changed, 7 insertions(+), 8 deletions(-) diff --git a/Documentation/filesystems/fsverity.rst b/Documentation/filesys= tems/fsverity.rst index 412cf11e329852..54378a3926de7b 100644 --- a/Documentation/filesystems/fsverity.rst +++ b/Documentation/filesystems/fsverity.rst @@ -15,12 +15,11 @@ of read-only files. Currently, it is supported by the = ext4, f2fs, and btrfs filesystems. Like fscrypt, not too much filesystem-specific code is needed to support fs-verity. =20 -fs-verity is similar to `dm-verity -`_ -but works on files rather than block devices. On regular files on -filesystems supporting fs-verity, userspace can execute an ioctl that -causes the filesystem to build a Merkle tree for the file and persist -it to a filesystem-specific location associated with the file. +fs-verity is similar to :doc:`dm-verity +` but works on files rather than block +devices. On regular files on filesystems supporting fs-verity, userspace = can +execute an ioctl that causes the filesystem to build a Merkle tree for the= file +and persist it to a filesystem-specific location associated with the file. =20 After this, the file is made readonly, and all reads from the file are automatically verified against the file's Merkle tree. Reads of any diff --git a/Documentation/filesystems/ubifs-authentication.rst b/Documenta= tion/filesystems/ubifs-authentication.rst index 106bb9c056f611..9fcad59820915d 100644 --- a/Documentation/filesystems/ubifs-authentication.rst +++ b/Documentation/filesystems/ubifs-authentication.rst @@ -439,9 +439,9 @@ References =20 [DMC-CBC-ATTACK] https://www.jakoblell.com/blog/2013/12/22/practical-m= alleability-attack-against-cbc-encrypted-luks-partitions/ =20 -[DM-INTEGRITY] https://www.kernel.org/doc/Documentation/device-mappe= r/dm-integrity.rst +[DM-INTEGRITY] Documentation/admin-guide/device-mapper/dm-integrity.= rst =20 -[DM-VERITY] https://www.kernel.org/doc/Documentation/device-mappe= r/verity.rst +[DM-VERITY] Documentation/admin-guide/device-mapper/verity.rst =20 [FSCRYPT-POLICY2] https://lore.kernel.org/r/20171023214058.128121-1-ebi= ggers3@gmail.com/ =20 --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pj1-f44.google.com (mail-pj1-f44.google.com [209.85.216.44]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 036DC285068; Fri, 29 Aug 2025 08:02:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.44 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454578; cv=none; b=oP58oLiPUXQPOCpJ8UiRTFAWFZeJWCw3Yk5KRifwueM3KFesJfh/4VqwKzk+oqGbCmezrwZjLJWBuRgiWBqU7Z6iwOGdUORfTOsq/FPrZvKoOmRNw+q8xV8UWiTZiPot8L+qZ3VePJL4p4SL/FlivtOKh3Lupvk5oy7OtQOvVXk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454578; c=relaxed/simple; bh=tVZea1ikNA4Sssls4g09ZchJ08JhUaFOY8Mmt8T2Tzg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=pmX4sT8XfC2MuYioqeeOGyHHT4g6MTD+/ebpveH8zeuyHURa22/Eg+PL5qihVfrh7ziW0eb0dv0bjdGkLvphXYsSbYoKOhTNyEfbi4zqGg73y2krf25lhMaNHhD0Z9q4FOaftOT/QoLtUjsCViTZKtT/AxSXjTjKND/FLAS2cEc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=m6HK6QJr; arc=none smtp.client-ip=209.85.216.44 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="m6HK6QJr" Received: by mail-pj1-f44.google.com with SMTP id 98e67ed59e1d1-3278efed3b0so1412256a91.2; Fri, 29 Aug 2025 01:02:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454576; x=1757059376; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=jdhbTSK6p9ht0YngyCDiyyRtcLCfpgxS9tGDrcGiJGs=; b=m6HK6QJrKCL4NhX5vRmRvx+kKf+UD0SCePCT8SQyijOvyVFAUmvYFeLpKLE/0xgHWi FNwOZKI6qFJBvK8mxDqCQa9QZO31ghE/2F0gETGOKNDB+GJAYSAmLNVDbObTf3yOssgA d6o8kdtYIrxFisM6uTjlvznUIZVuj0W0J6Ru+jW3saIZMn1aQodFz4TsG0yOR1Sdby+S amaAZaTzNcTeE6+wN/urH+7nZCwz4mSFFXJCQKrsbSArm2/bPOek03vleCh45+QA61xR QtVIhjGwt9YANZcbmNMyAa9KyES0pnhBHHBYegyFILKtOclZLv9rJF6VKNSOHVclCAjy WJ6A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454576; x=1757059376; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=jdhbTSK6p9ht0YngyCDiyyRtcLCfpgxS9tGDrcGiJGs=; b=uo1k4zl1PUKCz4j5dJZO2gxyw3cy0Cl+3aKiRNy4I+9oGr6tJF2msC8Dwpd2hX49zB +A4VpP+IeR/QSdVlv8l+HL59avGxWzJCvVL/18qZ3/F9GKlWa+K6Lqy9a0rTp/Eif2xi cKloI3+BxHuGVgfCdbJnlhhLKLrN5CgqCKAf8q2uK1zrMPMor5d5sYktX9+/8XeymQWj qPsZvjlaTx00YBJUoMsu6tKButJxap6tP2SY+DN5jpuPXpA2AbuzSsGu6n1Jv1gx79dc X5vE/I8v71GVpsD9JaVErOunYmKPSDlvY3kXYban7H0EmlaPypnSNAyejw6YTNApzn0U I9Lw== X-Forwarded-Encrypted: i=1; AJvYcCUEzXYUSDACPszdUy9gR6LKJbFJPoX+/czSMh4Z0jy47EnSZtIz4G2ojO9qzSzcC7ij3Ktf/PChYlqUNzg=@vger.kernel.org, AJvYcCV+CiW4TveYanL2/Qe7E6hqFr5RnkAWgTS+qHuodmE8DMQESJgxE+JhWk/vZi+WzNIk3SuQtqCxgi1J@vger.kernel.org, AJvYcCVKLSdat6W0fHNwS+7QS+lWGPwu1jfut0Wecr3MssjYh+1CufcXi8XTbNiGCn3AH4OnEwGbr+Klpi8IRCI=@vger.kernel.org, AJvYcCVjvD5ruNLoBdw5TPsCwLU0MW1mDTec+tI//d6xbir4ooCuVdKmoWUgiz/e+MVSvLBVEdUPtT+74/U=@vger.kernel.org, AJvYcCVohjlWzrfgdeNwhtElJ/W2IDpTaMbCdAm/DfgAbQkS95VbfB/PJ2qmDkYFW77WmjZpshk=@vger.kernel.org, AJvYcCW6SQC3JlEgiKsTM/dfsku5zh25GoTkQquU28xxvhqnLtXOvRPGnQcmSj5AORaq4bJf8/mb4lS5@vger.kernel.org, AJvYcCWRDebciJJWyAzBF4BpCLRSkcqVMgcjLvFXifrkuDpEYxsaYsv7TaIZEZPBXgD/0mjiYLPy2JR/sIWzQiRQ@vger.kernel.org, AJvYcCXHx16CiNI5LXgWbwg7mqHQhhKY/1kODRyvgbzFhddBZ+6GbbZXfbqliv8JynKND9ApPlXwxbJdBxcb3g==@vger.kernel.org, AJvYcCXQ4knurbHGgla9K6V/1r4ubFXP0oxRjxhuNRfSckdCFLATn97oOQFdqghFEPcuNDNHWCvUREzPEMeu@vger.kernel.org X-Gm-Message-State: AOJu0YwVAAIkvGe/mVF1E89R4T5ULBkIrwVRcDC/teEvUsPx1tvyYPeT McrXGfjrwFCZ57sWGphUXK4d2HcbuSmqMGjKjhvH6ihiCbeqpGadrsRE X-Gm-Gg: ASbGnctLcVon0vT/3wZ57GMzuPDYtOFY8OCsJVLcavWPvTk+pka1jJ7Dfxgk+tQbOFL YLIy1DZxEnArym0QKN0Q04K3drcBqOkwx6zTF1dfsVf7oEk7iaW/SkI2RqOTkuRtrIfnMaWpVa2 AylxYYlEQ1SI7A4ppq3VGCs1EwhVsK+m/7RV1qCGk8WNwGWHXrBoNvrnhn6hHLirpSuJ1KiPuyi CSrALq+9SYY4DBIglt8ontGkpR0oe/rLzaqgf3PRUHAhz30ASdIuJbAIGwlXx4xWDMyUaYlc+tz WQRtnYuQqVkPICX75Og/zm/HFZ+mPTgQspmqB2AlnFAf4QkJOrd4hc6eZKKgBT9ATIMsWBkhpRA P545ODSpcigVaHFPQwJGu43f5Ata2A6HKbu6l X-Google-Smtp-Source: AGHT+IE+D5SeDqchp/24MDHXx5CQWTZci+ASgYtlboM+vs82gW00FOC1mk2B4v9sodvZwpxdBzPuFw== X-Received: by 2002:a17:90b:3a87:b0:327:c9c1:4f2a with SMTP id 98e67ed59e1d1-327c9c1642bmr4975594a91.27.1756454576161; Fri, 29 Aug 2025 01:02:56 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-327b01e90e5sm2191228a91.1.2025.08.29.01.02.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 01:02:55 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id E8F6644809A5; Fri, 29 Aug 2025 14:55:28 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 10/14] Documentation: smb: smbdirect: Convert KSMBD docs link Date: Fri, 29 Aug 2025 14:55:20 +0700 Message-ID: <20250829075524.45635-11-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1002; i=bagasdotme@gmail.com; h=from:subject; bh=tVZea1ikNA4Sssls4g09ZchJ08JhUaFOY8Mmt8T2Tzg=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY15VZXUEfpV/XXVSre/C87lNIRyCV5IjnItu7ShZU PiphvtYRykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACbSt4OR4WixGWdF367Ci0f0 5/VHVx3YxHrvMF/c3LtfDf1enBJSvMrwV9hALHj9kQNbWF8l9WcGsahNXW7scuzOjYlmr0LWbpu 3gQUA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert KSMBD docs link to internal link. Signed-off-by: Bagas Sanjaya --- Documentation/filesystems/smb/smbdirect.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/filesystems/smb/smbdirect.rst b/Documentation/fi= lesystems/smb/smbdirect.rst index ca6927c0b2c084..6258de919511fa 100644 --- a/Documentation/filesystems/smb/smbdirect.rst +++ b/Documentation/filesystems/smb/smbdirect.rst @@ -76,8 +76,8 @@ Installation Setup and Usage =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 -- Set up and start a KSMBD server as described in the `KSMBD documentation - `_. +- Set up and start a KSMBD server as described in the :doc:`KSMBD document= ation + `. Also add the "server multi channel support =3D yes" parameter to ksmbd.c= onf. =20 - On the client, mount the share with `rdma` mount option to use SMB Direct --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pl1-f171.google.com (mail-pl1-f171.google.com [209.85.214.171]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4AE9829992E; Fri, 29 Aug 2025 08:03:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.171 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454582; cv=none; b=HwA1YhrDQeTHO4lSm7aWeIYOkZQlrEEgg+V54wsFKgFtCBBilcQRtd2TrHcmw9Z+fuCUsN/kO/oCbsL3s/LCGWkxUHYz9MSzoUnccP07fOgw7D89vpzAcy8sdKquXFmao4Jz0gCMbTFufkA2+Ej/IP47bS8aUpmavIh5EcR/hBE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454582; c=relaxed/simple; bh=eMX/Qh24hdl/D8upWlphNzasCNRD/YCgXxsSIbz5MxY=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=hfWJ3QmlNabph2hpImO2wabaFvpuC1epNPykoJGKSStza1eU4u/ULyKfqko5JapK/W9Bd5C9l+jFDmr5xBKyv+kgWCbkl+J3iQoz1cqquf7aOtArOhQHmsYgFKmXWK+tFKPwya2t7kPX0z/DoNQvw/SarrC3krPjhkMem/v1nLc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=LBB32ZE3; arc=none smtp.client-ip=209.85.214.171 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="LBB32ZE3" Received: by mail-pl1-f171.google.com with SMTP id d9443c01a7336-248df8d82e2so11752065ad.3; Fri, 29 Aug 2025 01:03:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454579; x=1757059379; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=0AfZlK+2PpvnkbeUUWLESRnsPEd9fz1tduXIyE8HjWg=; b=LBB32ZE3h6wVAtBgQkBBDLcZdfoFS6/AbAuz3H+B89It1paqDs8stvayV9p8vCPHJe DnMdKmThMwX/dhaJISNWXMqCZAC7BJeMMdAk7tUgRrzhpWs44bCJA4qQNbZ2qeOp5G7L /dzQiVvAB0bQQLDsRNvmFHahF4Pu0/XaZTakWb+B9L6dC2goVyU2cr2OmGRvImgwhvPQ fxEhM3WU88vilITw4wzjveQjgIbbllGzyc2q6/zsMiNrT7Gv+PhLUu5bvLLpnpAdPMXd 8X5cGJagF0WQuk7Qw/I9mR9U86+xedE7ZMB8NrtljCgz9eU+3Z7IilIyldcFAT8z9ba9 Io2A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454579; x=1757059379; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=0AfZlK+2PpvnkbeUUWLESRnsPEd9fz1tduXIyE8HjWg=; b=vLl+slBl1kWpngjzXE0QeiGJqIRIf2E/oTCcrrwMhpLYGInyF/smv3Ft9OgCQoz4y0 HoUJ2fTtDJvc4nGaLm5whUGnv4TjTd+6BBp6JjORpdaajMQdMPTdsYTmc/kiCUIcPgfP DDN93fIzkdCfRYNlesN35zu4fdMmQH1fh6IGkfcYQUGir/kPdpIAO/0g60H8l6WDLkdX GiPw9fDS0LspOfdYsiGcLLN5QQzcw09FP5r7jAg7iTMqT9ZvL8DAmxX30MK6wrrPRN25 K4b7OSW4kXGn/tCfWnSa6wLOXm5oOPz9P8GhDwHjgI4TnyvfNCef65fBL4Ygi+2dirFm j4jQ== X-Forwarded-Encrypted: i=1; AJvYcCUaMWqDrpxeb/7v2nRwbambWuC09rs1oIwGtve7hIiS2FuMYCPVP7cy0cKMTm7cyG6xux9IZ9KWmkzr5U1F@vger.kernel.org, AJvYcCUbj90W7DDKTzaL2Mgi5VpC+tpVjS/hNkBrjla1cWnmEzWRY5ddQMC82N29/lPqyexyYQsHDrm3i7UZWKs=@vger.kernel.org, AJvYcCV//DjOhQFYcFQ2pjvgscXwzja1kq2dx6/4ryq+O/gvGGOPUNiBM8B+nj0pKMnwsDoTuKqPHsRvqwhG@vger.kernel.org, AJvYcCV7KvlWV81T8xE9UsYX6bnrS38K1KteBR0Qgy3wkpGXGqRCDK510C1FuBElzH3jdd3qthmUlH3Au9Vk@vger.kernel.org, AJvYcCWCgVQHkVgn8Vwj+E4KbZPRAizUpfK5jgQwWXu1T1azxVtA7R1zwThIa/2uw2h2M5pn32Q=@vger.kernel.org, AJvYcCWKUEnvejFhX57qXLEPb3sOLdxKNvCzSJW5KJCOM6a7udakfpV0Jam2kVh3BpAN1D7DEeN8r5IpWsYKMw==@vger.kernel.org, AJvYcCWvbYrR35IyuA5eO+xIDRddVRN1NjSigNg6YTGE3PeRv5KagcNDi9SK2GYZ6VoZf9xS7m38yf+O@vger.kernel.org, AJvYcCX4S/qPMxZubDSOGEKUBxjQ7TZon4s26GVAs+tEXq/6TdGNy1dP6ufXqz3X6LGf0VqlDv6HQSUu3mM=@vger.kernel.org, AJvYcCXtlPlwCnn4+pMeu29VUwD8sszlmm+FW7UfPM2h3Bx9iA18UtMz6NUVpTCstLN6hIgIjf4ydzgusiVk8KY=@vger.kernel.org X-Gm-Message-State: AOJu0YxdO/bnej+Roq27QikLSEVWw9yN1ZITxJO6fJkutxH8AaSnYGAM o7InZzkFkBQbmfi+7zEGNtM5Y/cnEdT4RRPXn21KhKikzY/jr+F36uTM X-Gm-Gg: ASbGncvSD99emGxggympLMXTnmEy9isfsRo9BNklwaWyZXQZ2oBjQkj2DtBksoevyq4 oJ+Tjj1h1vrop7C6CcjoNklUGOCr5rxHBi8alH3sMMVY6eg5qkr/HUhisxCu7Dwmin+e7pSGtTJ KmHN6L78JS/m3i5zv1hULh7WpUWaCuF9B0Ijd+IxXQeWrao8o/+41EGfAUMyz8gHs9TR35jCmB+ WFsFPsZF0TLDz/j78V+ER4W3NhAUX5oexKiuc6pTj3J+ebLcJfT6BMpgT7wIRLzj39JPQf2l0sZ MqFgHk2CEyOHm5L9/9MReRyuhLJQa+wqwlx2uxdXkjvre6CEm5hbBqiwlDe7rBpskSsgBnoYkMB SRsnnsc+3+9Lte70vn03+Sad71bvN1oX+yiMrrxC/tp2AdKU= X-Google-Smtp-Source: AGHT+IEwoXGIzV8akza9wuHnzpdMDJjRSJFuE8pmXkEOlv9nwKY6YvijMOuiPPSYq1k0su7e61Abrw== X-Received: by 2002:a17:903:acd:b0:248:cd0b:344d with SMTP id d9443c01a7336-248cd0b381emr78909285ad.9.1756454579374; Fri, 29 Aug 2025 01:02:59 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-24903702999sm17213525ad.3.2025.08.29.01.02.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 01:02:59 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 08D794489F50; Fri, 29 Aug 2025 14:55:28 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 11/14] Documentation: net: Convert external kernel networking docs Date: Fri, 29 Aug 2025 14:55:21 +0700 Message-ID: <20250829075524.45635-12-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=4099; i=bagasdotme@gmail.com; h=from:subject; bh=eMX/Qh24hdl/D8upWlphNzasCNRD/YCgXxsSIbz5MxY=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY16d1mKOz99m1qX25ldgn5beybqta3f6vFwaVK3P9 qU9Ts6io5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABP5Y8vIsLj5nquL3YaGH+H5 K1M/GSvVfagoWJf+Wf//FmmeVbsWnGJk2HnZqfzd057r3t1TvvSsKTBp/5q8NJD5d+PrUJ8N/JZ PmQE= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert cross-references to kernel networking docs that use external links into internal ones. Signed-off-by: Bagas Sanjaya Reviewed-by: Arthur Kiyanovski --- .../device_drivers/can/ctu/ctucanfd-driver.rst | 3 +-- .../device_drivers/ethernet/amazon/ena.rst | 4 ++-- Documentation/networking/ethtool-netlink.rst | 3 +-- Documentation/networking/snmp_counter.rst | 12 +++++------- 4 files changed, 9 insertions(+), 13 deletions(-) diff --git a/Documentation/networking/device_drivers/can/ctu/ctucanfd-drive= r.rst b/Documentation/networking/device_drivers/can/ctu/ctucanfd-driver.rst index 1661d13174d5b8..4f9f36414333fd 100644 --- a/Documentation/networking/device_drivers/can/ctu/ctucanfd-driver.rst +++ b/Documentation/networking/device_drivers/can/ctu/ctucanfd-driver.rst @@ -40,8 +40,7 @@ About SocketCAN SocketCAN is a standard common interface for CAN devices in the Linux kernel. As the name suggests, the bus is accessed via sockets, similarly to common network devices. The reasoning behind this is in depth -described in `Linux SocketCAN `_. -In short, it offers a +described in Documentation/networking/can.rst. In short, it offers a natural way to implement and work with higher layer protocols over CAN, in the same way as, e.g., UDP/IP over Ethernet. =20 diff --git a/Documentation/networking/device_drivers/ethernet/amazon/ena.rs= t b/Documentation/networking/device_drivers/ethernet/amazon/ena.rst index 14784a0a6a8a10..b7b314de857b01 100644 --- a/Documentation/networking/device_drivers/ethernet/amazon/ena.rst +++ b/Documentation/networking/device_drivers/ethernet/amazon/ena.rst @@ -366,9 +366,9 @@ RSS =20 DEVLINK SUPPORT =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D -.. _`devlink`: https://www.kernel.org/doc/html/latest/networking/devlink/i= ndex.html =20 -`devlink`_ supports reloading the driver and initiating re-negotiation wit= h the ENA device +:doc:`devlink ` supports reloading the driver a= nd +initiating re-negotiation with the ENA device =20 .. code-block:: shell =20 diff --git a/Documentation/networking/ethtool-netlink.rst b/Documentation/n= etworking/ethtool-netlink.rst index ab20c644af2485..3445b575cb5d39 100644 --- a/Documentation/networking/ethtool-netlink.rst +++ b/Documentation/networking/ethtool-netlink.rst @@ -1100,8 +1100,7 @@ This feature is mainly of interest for specific USB d= evices which does not cope well with frequent small-sized URBs transmissions. =20 ``ETHTOOL_A_COALESCE_RX_PROFILE`` and ``ETHTOOL_A_COALESCE_TX_PROFILE`` re= fer -to DIM parameters, see `Generic Network Dynamic Interrupt Moderation (Net = DIM) -`_. +to DIM parameters, see Documentation/networking/net_dim.rst. =20 COALESCE_SET =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D diff --git a/Documentation/networking/snmp_counter.rst b/Documentation/netw= orking/snmp_counter.rst index ff1e6a8ffe2164..c51d6ca9eff2c7 100644 --- a/Documentation/networking/snmp_counter.rst +++ b/Documentation/networking/snmp_counter.rst @@ -782,13 +782,11 @@ TCP ACK skip =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D In some scenarios, kernel would avoid sending duplicate ACKs too frequently. Please find more details in the tcp_invalid_ratelimit -section of the `sysctl document`_. When kernel decides to skip an ACK -due to tcp_invalid_ratelimit, kernel would update one of below -counters to indicate the ACK is skipped in which scenario. The ACK -would only be skipped if the received packet is either a SYN packet or -it has no data. - -.. _sysctl document: https://www.kernel.org/doc/Documentation/networking/i= p-sysctl.rst +section of the Documentation/networking/ip-sysctl.rst. When kernel +decides to skip an ACK due to tcp_invalid_ratelimit, kernel would +update one of below counters to indicate the ACK is skipped in +which scenario. The ACK would only be skipped if the received +packet is either a SYN packet or it has no data. =20 * TcpExtTCPACKSkippedSynRecv =20 --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pf1-f175.google.com (mail-pf1-f175.google.com [209.85.210.175]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D08F22857DE; Fri, 29 Aug 2025 08:02:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.175 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454581; cv=none; b=XKNjLWnkGKs/zxt4Ni7wRV8psVOCXGC4i5ZUA6P/eyVY7+zemDcbUZU8a/sHbuBY7tiOmfFGVSuCTMTlvfljcNE95Y1Kx0MahOgiMifo54PNk54hxf8YPHp25hZ6ObPQ98aGZ6t7UiPOBnlETtRUi1tiQ0V1I3Awh1BVb/IlQCs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454581; c=relaxed/simple; bh=QIAPxg2EoM7XBiBH/OfCd9SfIrsCdhbBl57WJdF7gOo=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Nkb5bOEXPsX79UPWThE29Iv/nZKUEpncDfZaA7Dn2GCnur756RqYvmvv2HCdSWejjMHhJxNR68jbXT3SQAmpBLJ4rMT89veFCwUR/gXLvtern2FpVbl990TplOBcwdNhGI/21EeF6Z9Xk5ooAi/Qn7glyQYAf+zoBTgU+IyJXEQ= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=iz5w3LXU; arc=none smtp.client-ip=209.85.210.175 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="iz5w3LXU" Received: by mail-pf1-f175.google.com with SMTP id d2e1a72fcca58-7720f231174so1555043b3a.1; Fri, 29 Aug 2025 01:02:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454579; x=1757059379; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=Ji3KkW3qUsiM430Q8CaZBzXxSVywrfxa2oAywWyFSjA=; b=iz5w3LXU7XG4NJJFh6JefPvazJrNiHtO6WJ1Cpxe2GJsc9IuITz2gDST5g9A12ywz6 5nRD2LcBNbOQN0G3Lf++FWqahxBkPsZIZgcsjxi0alLe8JsmvWZ9SNyApUMiSjQgM88A A9bSidnrzdKRldwyOx1kduh6mh03uBXRvoBDXhLSHuyZYKHazy6DFnLKCSJ+Zu9E+ofL ioQcMc+VqJ3HskJTy1B3ff5hqNbPr613J+m3MgnYs6bgnSQ2y0Be9jpnnb/ixwh3ADq7 3kAgBj42FMCzGWYlDmR46MjEJidq8ePt17Smk/kvLLuf/0mfOYPEmPg3h1UA84X4RlRK ZsLA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454579; x=1757059379; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Ji3KkW3qUsiM430Q8CaZBzXxSVywrfxa2oAywWyFSjA=; b=bO6Kb9itXNqe/7mZ5mCLFhD4Ps5h6gYkVa/2lqSKKZoom5sMWOc50uQl+QIvSLRuyo NVQ4N8QSOOo8Qh4db+kcHt4ZpK94/hrOtElRWuVcAqBQBzP0+zDoirqklaZ2OmOVYYSS dL4WYnxd4XdF8xKpS1s5iKvTB87m0mu+DjD65ym1uT5ZfRIM0MhPAbMrciefGzKOh5My mmJ05glKgZTQPZahYEzHaY+Jqdzah2Z1WdHXWscG7fRmrJqsODGa1LMQuV+461itbPO0 7jxTI0PzbFq/NTU8qpEVU37+/IceyYmjfqMlkGDBSuX3LHMs3PsF5tTjDBFbZxXM6yVm vJDQ== X-Forwarded-Encrypted: i=1; AJvYcCU4otoMrVFm24C0rn+TBc/oCIIYzdgpJngJyKPaMFP3rQyMxX7US6osigjfFJTFuYXldUAygv3X@vger.kernel.org, AJvYcCUMq9OofPdjCb/k8aiYBW2xeCGcagQEWm+bPoyCPPk+f2N+q0dLU+EIJts+itz0w+RKOy+hsGX1qKEQeqo=@vger.kernel.org, AJvYcCUX6dDPgJdUjdYB39iA2S24EU+gksdi4x5BaCb8BeiJ5Dh9yMDEmmTEuPwNw3EIX3azm6t54xtpDpO+@vger.kernel.org, AJvYcCUeolW69DQmdmT7ZNkuOFpP8gW4CQCvjOypBTDEvted89iuEXTlIOAL4qzGEfTVt9/ti8COikFGtEEAwQ==@vger.kernel.org, AJvYcCUuy+verHzC1MT+5D9Nnn1KK8Y8aFMoJBGhQ3fpRFl9Gi1ZflkQjrXuazlvJSdqBo/lyEI=@vger.kernel.org, AJvYcCVJjOjQgPPZAf1FdT1ZRF9aVeZyvoTg5s6fcDiwRflMWhi6I4QKdCwF5T7jv1SwHtL/fFrmn3DNI7R0TDcy@vger.kernel.org, AJvYcCWbq5h1c93VS0ok6CgusN/uk7QxadgNI84+nLL88kR2EaRkXTOWq84KEB5wTxAG/2sIAE6QFirG+txVHEM=@vger.kernel.org, AJvYcCWn/xf+8HPUKNZlHLk1KJIZcsT0oyM5U1m7c0RKYIsCHwHkzfKG8KIV7HBYM9YbWWGjy/k07RvX0S/0@vger.kernel.org, AJvYcCXN0qtDi7sLM9hEr50+1aGGEkS+KOWtTw/4/nIHrAtaPgp6znWsANFtzE5ZNAD5ARzPQ+VkYbRPBZM=@vger.kernel.org X-Gm-Message-State: AOJu0YwiUlmwUsAu6R0o003MWYf2kazlutMaLwEtMRBvxqNgn8a2Q8Sb 36fJU7MMxegq54hMc3Ekh5WpUMkc94zneK3768BMOfzuVpXSEhMUeJIA X-Gm-Gg: ASbGncv3kWYDobCixjrs82gpp9GoqCj0aUJN9jlp2HjdN1+oVZXqtXTX+eAeDz4gdb5 QJR91YLFGfCcTAymyanAkS2Bh5T4CoPC6NIo0fkUf8vTu6yYkFk9fjI8LBhhNR2vkLlGpxPDlMa VXNiWkmuh/BhhsHwtv1QIFSZsmXvyOMvePGUj6R1ySEunr1hAY8Z0ZLfli0BdNzDK+PPhAA8nPG aT5uGhlEg3MBMZ6SMp1Got0Akft9cl2FOp8GCBtxkqydc3CObouE6+6HrJfqg5Z4epLPk/N555M gJBp8d9ok7hyzoySG23MYatZGQ0UXiRQMCiKogqJpyKxsdv6yptBjTXyIG69NK5Swnhm8esayT9 ReJkeKSgtf7kBoejm63jPkrFTzV8o4Tkqtkn1983FrPo9mOk= X-Google-Smtp-Source: AGHT+IG4XzsUhVmrn4fJ8v1PNDsbGNCghgUfxDPbkeqpUjvEg9N6RxHWj66Wbdw1AdmD0ATs4dsvZw== X-Received: by 2002:a05:6a20:3ca8:b0:240:750:58f with SMTP id adf61e73a8af0-24340d91edcmr35447322637.30.1756454578938; Fri, 29 Aug 2025 01:02:58 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b4cd0e1c0besm1461992a12.24.2025.08.29.01.02.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 01:02:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 1E9654489F51; Fri, 29 Aug 2025 14:55:28 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 12/14] ASoC: doc: Internally link to Writing an ALSA Driver docs Date: Fri, 29 Aug 2025 14:55:22 +0700 Message-ID: <20250829075524.45635-13-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1684; i=bagasdotme@gmail.com; h=from:subject; bh=QIAPxg2EoM7XBiBH/OfCd9SfIrsCdhbBl57WJdF7gOo=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY14FftK8Ic/EqPdDdzlDXfSrtOCCiCo1tq0af6f2T rxS2nS/o5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABP5M42RYQe/RHjLfYX8tv8L 9vQt6eKUm/OnRm/3gUlFq/44pi2Xf8HI0BjxjsH0R+yFD+urVrRxaVu1SiT8M9vxwkWu7L/ecZP DfAA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" ASoC codec and platform driver docs contain reference to writing ALSA driver docs, as an external link. Use :doc: directive for the job instead. Signed-off-by: Bagas Sanjaya --- Documentation/sound/soc/codec.rst | 4 ++-- Documentation/sound/soc/platform.rst | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/Documentation/sound/soc/codec.rst b/Documentation/sound/soc/co= dec.rst index af973c4cac9309..b9d87a4f929b5d 100644 --- a/Documentation/sound/soc/codec.rst +++ b/Documentation/sound/soc/codec.rst @@ -131,8 +131,8 @@ The codec driver also supports the following ALSA PCM o= perations:- int (*prepare)(struct snd_pcm_substream *); }; =20 -Please refer to the ALSA driver PCM documentation for details. -https://www.kernel.org/doc/html/latest/sound/kernel-api/writing-an-alsa-dr= iver.html +Please refer to the :doc:`ALSA driver PCM documentation +<../kernel-api/writing-an-alsa-driver>` for details. =20 =20 DAPM description diff --git a/Documentation/sound/soc/platform.rst b/Documentation/sound/soc= /platform.rst index 7036630eaf016c..bd21d0a4dd9b0b 100644 --- a/Documentation/sound/soc/platform.rst +++ b/Documentation/sound/soc/platform.rst @@ -45,8 +45,8 @@ snd_soc_component_driver:- ... }; =20 -Please refer to the ALSA driver documentation for details of audio DMA. -https://www.kernel.org/doc/html/latest/sound/kernel-api/writing-an-alsa-dr= iver.html +Please refer to the :doc:`ALSA driver documentation +<../kernel-api/writing-an-alsa-driver>` for details of audio DMA. =20 An example DMA driver is soc/pxa/pxa2xx-pcm.c =20 --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pg1-f174.google.com (mail-pg1-f174.google.com [209.85.215.174]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9DEC62D8388; Fri, 29 Aug 2025 07:55:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.174 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454151; cv=none; b=MWA5IfmK7Jl104QlqJfjEcHI/17+jOHLbC9TriMYI3iQewVsrSvsn0EWwUOw3WinmEiM2EXQaJvy9ZYELSHIFi/2hKDHnUWeKqS7O77WkE9zw1hx4hLuE0E94ksfj8fpbE+Lg5p/Owqa5Rq1KAXPmhfOtlFJTN56BTaqtxzpnzo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454151; c=relaxed/simple; bh=evrdLEAoXKuQzTljW81Kh3KyWLApG8gUObVzJ2YlNgE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=pThoW70Ipe6UdxQvJmqLNJQxDtvQ6pl3eyRgF+TlWsYrIx0Vhm3BmsLLkKoTIs5kncGqw5BvRx+yEvTj+LBNqz5hbfyW+W6PRe1OnFH2IriuU2POUDrCzryA7BPpfTXmVNDug/QKt/g3wK5frMCALNTtDdO1aT9sMg1Ufy9ljxU= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=T/PrkAbE; arc=none smtp.client-ip=209.85.215.174 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="T/PrkAbE" Received: by mail-pg1-f174.google.com with SMTP id 41be03b00d2f7-b4755f37c3eso1570525a12.3; Fri, 29 Aug 2025 00:55:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454149; x=1757058949; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=mQcUO3MMNiHKjyp0GXG4A4uvsTQgAsYSLBA8ucpISkE=; b=T/PrkAbEDgjnmooE6ttNcyK3EB3/X33I1ZV1rEbxXFyHf+Aj35dnQhz7bfaWzgxcd1 sc+EQQn403MHJ+gE88k2ZoqEvsu9l7pvYduPA3u0Y53wNMvVaKajDMtMoP4k6zQB5FO6 sUdkchM0EMLwLnNowwb9LM3MQc8LKoAv/jZOIGAzuUUDoI1xbm2rGBXel589wjFmfGNd i8bwPCREuv35B35XkH7ufMkmPQ9WTdeQ9jjj2wnoA/xyq3f+QwZW61ffcuvNW5dsu9JL sZeGz9xVmihcIPFtF4SFsMX834A8aS6ljmP5UXxMI+P6t8CQialhwMumuzLl8nAzybRj QG6w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454149; x=1757058949; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=mQcUO3MMNiHKjyp0GXG4A4uvsTQgAsYSLBA8ucpISkE=; b=c0MepO2zuk32WlNy9OaWrezzL/BBBXS0OIuGgJzE/LE6Xu5CmI3zq/3Vj7SfP0bRDP gm/2kPP2vGc+Z44kqYCYOeBIUu5T14pMlnkFRYofeR3KTt8hXULPAXdVAooCPA5rdMsR 0b0lWQJS1kC7G8QTNK1yGRsg8DPmsmxF4BLyS69anVYIom+/mFwQULmdDuEB8Me9VQi/ Hfwblh/f40WpbeD3mgFf5+ur8iTPxpTGRS44v/HRfFR+yF5uyiPBJMN9uK+cYzXKzlTg IOlCndfD8feXRVo3loHKOyY04N1X28d62QTpq1ipl6Fnry650dBuVamur+wLdzGM80f0 54gw== X-Forwarded-Encrypted: i=1; AJvYcCUC96xhMssdMUmU3J+rHxyQtwzKxAY7L0kv+vxKs9JybCOX0x68C3+v+4ZGPSehoQCZwT+OEf+U@vger.kernel.org, AJvYcCUkIaXEiSBSDjo4lv5twD77phstJWd7CQGKVxfoOn+qWaA817dlVYjZNi+RWxOFSmTg83Nl0ZiVMJMszw==@vger.kernel.org, AJvYcCVBgeGkLBhXYA05N39LCXv307vE2ri5mne2QVNgpJ60cOkI68rnkgxckup9H3+/kvHRdPwl22nN4Fo0PeUB@vger.kernel.org, AJvYcCVMXSyr6D/RWDQaQ4UdcSM6AujCU3ouEBtN1MedSihIqs7cApu/6ttjC4YkwhKgC8m70CxLCWQypHiEwkg=@vger.kernel.org, AJvYcCVZRfTWOVBg6lIO4cJPsufnu9l9ugx8wCJ0XJqYufTofL13VtfB6Pf6GH4goCUviOIPs/NfO0eH3Ur3@vger.kernel.org, AJvYcCVeZ+ewrcd5moUVF9suB9J8KfaLpdBO0dyO//yi8yoXD+RooB6e00YcEJDieWZlRzd0OYPuujCPU3c3@vger.kernel.org, AJvYcCXGssv+qy3+boqIdZxqARk3ujZIs1bNQtndqyrorAJ7HQB83pBSekoc5/onq4ZpP/4VH5Z8mqHZZgW5zbo=@vger.kernel.org, AJvYcCXfs7TRVyOPDB65hplta4sYo+ta9s2UOtFH64jPlNb3H4/MNEhEvoZAkaM6FegIbULxDzA=@vger.kernel.org, AJvYcCXmmB76Rg+c+9ppoe2TLF/1KfCdKJzyaGHpkHhH1Bw7nVhKyX4ILxQZvbTy9Ee2qrvmZcfpmgahN7g=@vger.kernel.org X-Gm-Message-State: AOJu0YwCMAQmw5aqSDNvDujOu/TdjwPJzAK7yCc+5fyHemzann48Wzbt mFwGOKrsVD219zxcP2KROIQKee+lFqjcA8K73BUI37oUfq+XNl+HL67z X-Gm-Gg: ASbGncvij/WkXwcJct2nEOCd78fX5I6d86tD1oYJ9faqegNA38njj8YFmcm8rpC0bTp B2jKVgorqMCOi7htUiB69hicut01b8jn9B9y2ohOeKo7jxoUepj7m6HLzVPgLCnHUOmtUM1GQxv 2Q6h6kdN0Z61FxpOUDO/YTUFSKnN83VUE8sD44FiiHX15b4QkTjBdulpoGLn411OyUZngDYfrjn rgMCrRlfR+QrWol/Mg6PC1Mm0+zsMXwucVZMiJdsIz5knbfiPVGuCX4bvUc40LuZiYBeELGR3a7 mWZZMvATC+AWpdp11AxcVQ++ZA3PdJOy7vIXrdkptUOaPWfjtixcV4cOZPs4hC8MONb7oq5qPha VMHcKrnCvw7eShL2eE1G85rq9aaaWkiMimIX1 X-Google-Smtp-Source: AGHT+IHLqM32trOVVzh172ftn7E15FM6Ea2Jk4ybBnzNmcbOCkm5faJ3oUsml9NRpuaa5OiBwPVbig== X-Received: by 2002:a17:90b:4ccc:b0:327:7c5a:fe77 with SMTP id 98e67ed59e1d1-3277c5aff68mr10961209a91.30.1756454148623; Fri, 29 Aug 2025 00:55:48 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-327a22ec24dsm2591905a91.3.2025.08.29.00.55.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:43 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 3924545A3F85; Fri, 29 Aug 2025 14:55:29 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 13/14] nitro_enclaves: Use internal cross-reference for kernel docs links Date: Fri, 29 Aug 2025 14:55:23 +0700 Message-ID: <20250829075524.45635-14-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=1391; i=bagasdotme@gmail.com; h=from:subject; bh=evrdLEAoXKuQzTljW81Kh3KyWLApG8gUObVzJ2YlNgE=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY16J9usWFB1WvT+NSavLIanh+698vZJvp5Iqyn5cF Oeb1Xiho5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABPJ/8zI8C+tSSfleGvDlW33 Ss5v/Xrog5zFrjCmKzem/Vr2Ka6JL4WRod0y2uaV0GJBfuHrJzY9vTqdTVAvLqhtcdO5S89liyP teAA= X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Convert links to kernel docs pages from external link to internal cross-references. Signed-off-by: Bagas Sanjaya --- Documentation/virt/ne_overview.rst | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Documentation/virt/ne_overview.rst b/Documentation/virt/ne_ove= rview.rst index 74c2f5919c886e..572105eab452b2 100644 --- a/Documentation/virt/ne_overview.rst +++ b/Documentation/virt/ne_overview.rst @@ -91,10 +91,10 @@ running in the primary VM via a poll notification mecha= nism. Then the user space enclave process can exit. =20 [1] https://aws.amazon.com/ec2/nitro/nitro-enclaves/ -[2] https://www.kernel.org/doc/html/latest/admin-guide/mm/hugetlbpage.html +[2] Documentation/admin-guide/mm/hugetlbpage.rst [3] https://lwn.net/Articles/807108/ -[4] https://www.kernel.org/doc/html/latest/admin-guide/kernel-parameters.h= tml +[4] Documentation/admin-guide/kernel-parameters.rst [5] https://man7.org/linux/man-pages/man7/vsock.7.html -[6] https://www.kernel.org/doc/html/latest/x86/boot.html -[7] https://www.kernel.org/doc/html/latest/arm64/hugetlbpage.html -[8] https://www.kernel.org/doc/html/latest/arm64/booting.html +[6] Documentation/arch/x86/boot.rst +[7] Documentation/arch/arm64/hugetlbpage.rst +[8] Documentation/arch/arm64/booting.rst --=20 An old man doll... just what I always wanted! - Clara From nobody Fri Oct 3 14:34:19 2025 Received: from mail-pl1-f179.google.com (mail-pl1-f179.google.com [209.85.214.179]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 494382D877C; Fri, 29 Aug 2025 07:55:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.179 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454152; cv=none; b=ZffvImmuBkUTwkMq7gFZQvVX1z4Ggd75OedBISJFTDED9h1CwB9nvzQG5dhrVqsdPdETCDQfvBZus7R3jIglJBB4DQvPNgTOZBtlpQBrUYI4NrVkkTsaIvrv41gVDQy8bTQxVwlyXfVvUhlL/xIP2q4pWPIy8PCcmhYS5KxwO3E= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1756454152; c=relaxed/simple; bh=AEEIcDozNZ2ViJOgQ7eYtkvhWGKn1Ui1HTx+2X5l8VU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=F6FhRPk+gOlJR4eOTsZuuXB/xee/nwXGOBvEy9eaPKfe+p08REjGTjTzIDpP47HyEdO+Rwp8GE0ENj4S35xsttMc8fClpcMwbMXUHtxo3tOdQHVLqBntXnCt+IebzYqbJ3iWWUfUke88401PibSe6eSo1XcQUnU56xgIOYH5jC8= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=HJ6rPPys; arc=none smtp.client-ip=209.85.214.179 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="HJ6rPPys" Received: by mail-pl1-f179.google.com with SMTP id d9443c01a7336-248d5074ff7so11458355ad.0; Fri, 29 Aug 2025 00:55:50 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1756454149; x=1757058949; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=bIHnWA5aW4eHzLRZzSV0KZURxmNr5HDYBenIylAU+uQ=; b=HJ6rPPysNnFCZ8OQ9mxk2WforGaJqzCunApL96H9GrVnlI+cbffhyVafzUZMLR9XRx XgNry/IzbxlSL1bLxEiPE5wCgGuBtR82QUdSgl2zyQ7nCVmXsdRnS00T1KhTXw8mle+w V1UTix9rRiXqvEeszpVtp+4bTwG46iziKIWhdhEAhQVPnsZLLUEogo0YTuyFPRt0yYX+ xWLvVAScRjSwzbRuGrG7UX7n7sribzlO7Q2+gQrQD0uFPrLjyZaLV/TmjuGEu3RIpOrM /oF6UDuQpM/9NqhTIWzgyxeli81ysXyCifjp8NmvZTlxd4pK529FZ5jNP8cduRyAOQhS kmoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1756454149; x=1757058949; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=bIHnWA5aW4eHzLRZzSV0KZURxmNr5HDYBenIylAU+uQ=; b=YcZY0coB1YvDtHh64F0U5ydqSpntV2gNkm1Hk6MB/pL+3gFI06o4+9wbj7fD6S4ofj xitjzqDkhc8xRZKjgQ8tgSKyJgk29q1ZTXHVFB60fam/Jtk7lX2/TkjT1HhqziaefXHi CEZdXY2DyuBAN1ee3Ds57pQ3TLhjcBoQDDbcSQJDeYt2Xde+4jYOKboTD8Crj2DvI8xS tyTmiT8vrWn201zrGg02tqW9Arut4dYwenV94QhEzuQ7rD+qZ5fYOVt060K1a5oYhbiA UxIv+8pgKCByhna8GSuLEPHudPgY70lPjoNx+OzuqzxlyuTEbULYTWhzrTUYpDYge8Y2 iQwA== X-Forwarded-Encrypted: i=1; AJvYcCUVJQDCYYlbiw4yy9e55h5XMn/anMqVoX9RzF0rHgXgANrwKEvC3IPW4an3/Q76/EL23qdb7b8G@vger.kernel.org, AJvYcCUyxrHh1zERSBj4mEcmQ+zE6MX0DzbPS0ecp1UeD6JxkfSH/cuvRMroByQrzgrK4WC8/WI=@vger.kernel.org, AJvYcCUzuf3KazCw6p/QQnUFgaxRxQ10apASK5sOEVwSAMKXVtgEZ+77O7uwPel9ulL+x8U4h40564Ql7y1U@vger.kernel.org, AJvYcCVWFwMtWgvb9FafU2ggoYnTNg39sUwH3Q+OeWNfObmi4la/vJavpWmEHvfMJgpW0o6R897fexQ4jVoFBFve@vger.kernel.org, AJvYcCVXr+Ntry9iXAurrCj632oYLzvF09Tz5+feqYfHe4IuwsdPkJsFkKxJyOyPObM0WC3xNR0saM3V7uXeWMU=@vger.kernel.org, AJvYcCVtixwUG+h3JeS6LbG/A9wnCtGeBwUH1VTcragGePjN2TOyjl2EG8y15Vus9wv8yHPv2uW+kTg+8vkN/Lg=@vger.kernel.org, AJvYcCWKtOlcC6d3/XspLZ3dLhLiziFYsUHcAn/to7UxWVyyR9axi+ttmoUkGszqIwULNR7mlQhkFc3Quys=@vger.kernel.org, AJvYcCX5ueqY2ni+nycCBsT7wG0cffA4kADtHT6siCS6nckIryk1C36FuHSD2ijljdB2CQv4loK5S+HPu5qAyA==@vger.kernel.org, AJvYcCXNKIbnMusDdIstKLJrcH3O7O40+IXlT/48ozshoHV1BzPf85FqtUyhpTp7Tq7KEhCTxhUyOtpiQYGb@vger.kernel.org X-Gm-Message-State: AOJu0Yxxw5VlzwgUNetUnJGorMuaPcwi9rxQOxYW8s84qSD40ZMbxc15 7+ECeR33vdMjc7szTqTKzCZnG8zn6/V+yPEs2rHxdCclQFLStZV1nM6J X-Gm-Gg: ASbGncsMqhDFXMKKhC0yd7K4Zl9c82mRHc8+m1e5tqB61frKlgbCSA1AJVKetbQu2a+ 5H5Ozvh8Igi5M6FRNvPlHVenhsicTJGP7Bx0H6OLVeKfdwNw05kxdpr8AvJ7LWpeDAh4SbdCSz7 1UqeCGo+4GUkvckg838afg8dvrrpH5G1rDXzJXJC/f9kirDHGDhkywCaSK03L5HqkxmT8pSEdKz 3xLwJbXixdXKHO8aq29bnoxutzj507/NAOnTJ8CsHoyTVDL7z/raYi5OjnK3MxavwkMEiPUJbSK OKfghGR6m7D6n/g3R8eegggF2qbA1hzTHGdosqx6uQWw5s7sWXyxyzfjfkVoEk/VxEUzYxpcWQ6 Ufc+L5YPa6Ds+HUWyPngYGJhYVunhboIm1Huh X-Google-Smtp-Source: AGHT+IHRvna9njFmO3uwshAEffSoxmC7Hn2fu2lTjaQOpRwX+jw6mguEhMXL3nwf19KvKoiRBQoxHQ== X-Received: by 2002:a17:902:e88e:b0:234:8a4a:ad89 with SMTP id d9443c01a7336-248753a2359mr153379725ad.1.1756454149142; Fri, 29 Aug 2025 00:55:49 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-24903727e23sm16983345ad.45.2025.08.29.00.55.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 29 Aug 2025 00:55:43 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 4CCAD45A3F91; Fri, 29 Aug 2025 14:55:29 +0700 (WIB) From: Bagas Sanjaya To: Linux Kernel Mailing List , Linux Documentation , Linux DAMON , Linux Memory Management List , Linux Power Management , Linux Block Devices , Linux BPF , Linux Kernel Workflows , Linux KASAN , Linux Devicetree , Linux fsverity , Linux MTD , Linux DRI Development , Linux Kernel Build System , Linux Networking , Linux Sound Cc: Thomas Gleixner , Borislav Petkov , Peter Zijlstra , Josh Poimboeuf , Pawan Gupta , Jonathan Corbet , SeongJae Park , Andrew Morton , David Hildenbrand , Lorenzo Stoakes , "Liam R. Howlett" , Vlastimil Babka , Mike Rapoport , Suren Baghdasaryan , Michal Hocko , Huang Rui , "Gautham R. Shenoy" , Mario Limonciello , Perry Yuan , Jens Axboe , Alexei Starovoitov , Daniel Borkmann , Andrii Nakryiko , Martin KaFai Lau , Eduard Zingerman , Song Liu , Yonghong Song , John Fastabend , KP Singh , Stanislav Fomichev , Hao Luo , Jiri Olsa , Dwaipayan Ray , Lukas Bulwahn , Joe Perches , Andrey Ryabinin , Alexander Potapenko , Andrey Konovalov , Dmitry Vyukov , Vincenzo Frascino , Rob Herring , Krzysztof Kozlowski , Conor Dooley , Eric Biggers , tytso@mit.edu, Richard Weinberger , Zhihao Cheng , David Airlie , Simona Vetter , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , Nathan Chancellor , Nicolas Schier , Ingo Molnar , Will Deacon , Boqun Feng , Waiman Long , "David S. Miller" , Eric Dumazet , Jakub Kicinski , Paolo Abeni , Simon Horman , Shay Agroskin , Arthur Kiyanovski , David Arinzon , Saeed Bishara , Andrew Lunn , Liam Girdwood , Mark Brown , Jaroslav Kysela , Takashi Iwai , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada Subject: [PATCH 14/14] Documentation: checkpatch: Convert kernel docs references Date: Fri, 29 Aug 2025 14:55:24 +0700 Message-ID: <20250829075524.45635-15-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250829075524.45635-1-bagasdotme@gmail.com> References: <20250829075524.45635-1-bagasdotme@gmail.com> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-Developer-Signature: v=1; a=openpgp-sha256; l=24675; i=bagasdotme@gmail.com; h=from:subject; bh=AEEIcDozNZ2ViJOgQ7eYtkvhWGKn1Ui1HTx+2X5l8VU=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkbY171rt4ccP7Tje9zeU81XAvOsTe7ezTsb+JinaJHp 5+9eflMt6OUhUGMi0FWTJFlUiJf0+ldRiIX2tc6wsxhZQIZwsDFKQATyUhg+Kf4e/fZ6wLs3l4M LzYaa6U+LzrGluT0eNu0DWGXQ64tOy/DyPDctHCptcLMhPUK/Q7L82ewC/HE1fEmCs05/a/U6F+ JNRcA X-Developer-Key: i=bagasdotme@gmail.com; a=openpgp; fpr=701B806FDCA5D3A58FFB8F7D7C276C64A5E44A1D Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" checkpatch documentation has pointer references to various style-related docs. Convert them from external link to internal cross-references. For reference to docs sections, use section names and reference docs path as anchor text. Signed-off-by: Bagas Sanjaya --- Documentation/dev-tools/checkpatch.rst | 121 ++++++++++++------ .../bindings/submitting-patches.rst | 2 + .../driver-api/driver-model/device.rst | 2 + Documentation/filesystems/sysfs.rst | 2 + Documentation/kbuild/reproducible-builds.rst | 2 + Documentation/locking/lockdep-design.rst | 2 + Documentation/process/coding-style.rst | 15 +++ Documentation/process/deprecated.rst | 4 + Documentation/process/submitting-patches.rst | 4 + 9 files changed, 113 insertions(+), 41 deletions(-) diff --git a/Documentation/dev-tools/checkpatch.rst b/Documentation/dev-too= ls/checkpatch.rst index d5c47e560324fb..2ec288d845b81d 100644 --- a/Documentation/dev-tools/checkpatch.rst +++ b/Documentation/dev-tools/checkpatch.rst @@ -247,7 +247,7 @@ Allocation style number of elements. sizeof() as the first argument is generally wrong. =20 - See: https://www.kernel.org/doc/html/latest/core-api/memory-allocation= .html + See: Documentation/core-api/memory-allocation.rst =20 **ALLOC_SIZEOF_STRUCT** The allocation style is bad. In general for family of @@ -260,13 +260,14 @@ Allocation style =20 p =3D alloc(sizeof(*p), ...) =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= allocating-memory + See: :ref:`"Allocating memory" section on Documentation/process/coding= -style.rst + `. =20 **ALLOC_WITH_MULTIPLY** Prefer kmalloc_array/kcalloc over kmalloc/kzalloc with a sizeof multiply. =20 - See: https://www.kernel.org/doc/html/latest/core-api/memory-allocation= .html + See: Documentation/core-api/memory-allocation.rst =20 =20 API usage @@ -287,7 +288,8 @@ API usage Use WARN() and WARN_ON() instead, and handle the "impossible" error condition as gracefully as possible. =20 - See: https://www.kernel.org/doc/html/latest/process/deprecated.html#bu= g-and-bug-on + See: :ref:`"BUG() and BUG_ON()" section on + Documentation/process/deprecated.rst ` =20 **CONSIDER_KSTRTO** The simple_strtol(), simple_strtoll(), simple_strtoul(), and @@ -296,7 +298,9 @@ API usage kstrtoll(), kstrtoul(), and kstrtoull() functions tend to be the correct replacements. =20 - See: https://www.kernel.org/doc/html/latest/process/deprecated.html#si= mple-strtol-simple-strtoll-simple-strtoul-simple-strtoull + See: :ref:`"simple_strtol(), simple_strtoll(), simple_strtoul(), + simple_strtoull() section" on Documentation/process/deprecated.rst + ` =20 **CONSTANT_CONVERSION** Use of __constant_ form is discouraged for the following function= s:: @@ -340,7 +344,8 @@ API usage =20 The full list of available RCU APIs can be viewed from the kernel docs. =20 - See: https://www.kernel.org/doc/html/latest/RCU/whatisRCU.html#full-li= st-of-rcu-apis + See: :ref:`"Full list of RCU APIs" section on + Documentation/RCU/whatisRCU.rst <8_whatisRCU>` =20 **DEVICE_ATTR_FUNCTIONS** The function names used in DEVICE_ATTR is unusual. @@ -354,7 +359,8 @@ API usage =20 The function names should preferably follow the above pattern. =20 - See: https://www.kernel.org/doc/html/latest/driver-api/driver-model/de= vice.html#attributes + See: :ref:`"Attributes" section on + Documentation/driver-api/driver-model/device.rst ` =20 **DEVICE_ATTR_RO** The DEVICE_ATTR_RO(name) helper macro can be used instead of @@ -363,7 +369,8 @@ API usage Note that the macro automatically appends _show to the named attribute variable of the device for the show method. =20 - See: https://www.kernel.org/doc/html/latest/driver-api/driver-model/de= vice.html#attributes + See: :ref:`"Attributes" section on + Documentation/driver-api/driver-model/device.rst ` =20 **DEVICE_ATTR_RW** The DEVICE_ATTR_RW(name) helper macro can be used instead of @@ -372,7 +379,8 @@ API usage Note that the macro automatically appends _show and _store to the named attribute variable of the device for the show and store methods. =20 - See: https://www.kernel.org/doc/html/latest/driver-api/driver-model/de= vice.html#attributes + See: :ref:`"Attributes" section on + Documentation/driver-api/driver-model/device.rst ` =20 **DEVICE_ATTR_WO** The DEVICE_AATR_WO(name) helper macro can be used instead of @@ -381,7 +389,8 @@ API usage Note that the macro automatically appends _store to the named attribute variable of the device for the store method. =20 - See: https://www.kernel.org/doc/html/latest/driver-api/driver-model/de= vice.html#attributes + See: :ref:`"Attributes" section on + Documentation/driver-api/driver-model/device.rst ` =20 **DUPLICATED_SYSCTL_CONST** Commit d91bff3011cf ("proc/sysctl: add shared variables for range @@ -443,7 +452,8 @@ API usage lockdep_assert_held() annotations should be preferred over assertions based on spin_is_locked() =20 - See: https://www.kernel.org/doc/html/latest/locking/lockdep-design.htm= l#annotations + See: :ref:`"Annotations" section on + Documentation/locking/lockdep-design.rst ` =20 **UAPI_INCLUDE** No #include statements in include/uapi should use a uapi/ path. @@ -472,13 +482,15 @@ Comments * for files in net/ and drivers/net/ */ =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= commenting + See: :ref:`Commenting section on Documentation/process/coding-style.rst + ` =20 **C99_COMMENTS** C99 style single line comments (//) should not be used. Prefer the block comment style instead. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= commenting + See: :ref:`Commenting section on Documentation/process/coding-style.rst + ` =20 **DATA_RACE** Applications of data_race() should have a comment so as to document the @@ -512,7 +524,8 @@ Commit message The signed-off-by line does not fall in line with the standards specified by the community. =20 - See: https://www.kernel.org/doc/html/latest/process/submitting-patches= .html#developer-s-certificate-of-origin-1-1 + See: :ref:`Developer's Certificate of Origin 1.1 text on + Documentation/process/submitting-patches.rst ` =20 **BAD_STABLE_ADDRESS_STYLE** The email format for stable is incorrect. @@ -534,14 +547,16 @@ Commit message The patch is missing a commit description. A brief description of the changes made by the patch should be added. =20 - See: https://www.kernel.org/doc/html/latest/process/submitting-patches= .html#describe-your-changes + See: :ref:`"Describe your changes" section on + Documentation/process/submitting-patches.rst ` =20 **EMAIL_SUBJECT** Naming the tool that found the issue is not very useful in the subject line. A good subject line summarizes the change that the patch brings. =20 - See: https://www.kernel.org/doc/html/latest/process/submitting-patches= .html#describe-your-changes + See: :ref:`"Describe your changes" section on + Documentation/process/submitting-patches.rst ` =20 **FROM_SIGN_OFF_MISMATCH** The author's email does not match with that in the Signed-off-by: @@ -560,7 +575,8 @@ Commit message line should be added according to Developer's certificate of Origin. =20 - See: https://www.kernel.org/doc/html/latest/process/submitting-patches= .html#sign-your-work-the-developer-s-certificate-of-origin + See: :ref:`"Sign your work - the Developer's Certificate of Origin" + section on Documentation/process/submitting-patches.rst ` =20 **NO_AUTHOR_SIGN_OFF** The author of the patch has not signed off the patch. It is @@ -569,7 +585,8 @@ Commit message written it or otherwise has the rights to pass it on as an open source patch. =20 - See: https://www.kernel.org/doc/html/latest/process/submitting-patches= .html#sign-your-work-the-developer-s-certificate-of-origin + See: :ref:`"Sign your work - the Developer's Certificate of Origin" + section on Documentation/process/submitting-patches.rst ` =20 **DIFF_IN_COMMIT_MSG** Avoid having diff content in commit message. @@ -599,14 +616,16 @@ Commit message platform_set_drvdata(), but left the variable "dev" unused, delete it. =20 - See: https://www.kernel.org/doc/html/latest/process/submitting-patches= .html#describe-your-changes + See: :ref:`"Describe your changes" section on + Documentation/process/submitting-patches.rst ` =20 **BAD_FIXES_TAG** The Fixes: tag is malformed or does not follow the community conventio= ns. This can occur if the tag have been split into multiple lines (e.g., w= hen pasted in an email program with word wrapping enabled). =20 - See: https://www.kernel.org/doc/html/latest/process/submitting-patches= .html#describe-your-changes + See: :ref:`"Describe your changes" section on + Documentation/process/submitting-patches.rst ` =20 =20 Comparison style @@ -646,7 +665,8 @@ Indentation and Line Breaks Outside of comments, documentation and Kconfig, spaces are never used for indentation. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= indentation + See: :ref:`"Indentation" section on Documentation/process/coding-style= .rst + ` =20 **DEEP_INDENTATION** Indentation with 6 or more tabs usually indicate overly indented @@ -678,7 +698,8 @@ Indentation and Line Breaks break; } =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= indentation + See: :ref:`"Indentation" section on Documentation/process/coding-style= .rst + ` =20 **LONG_LINE** The line has exceeded the specified maximum length. @@ -690,21 +711,24 @@ Indentation and Line Breaks limit to 100 columns. This is not a hard limit either and it's preferable to stay within 80 columns whenever possible. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= breaking-long-lines-and-strings + See: :ref:`"Breaking long lines and strings" section on + Documentation/process/coding-style.rst ` =20 **LONG_LINE_STRING** A string starts before but extends beyond the maximum line length. To use a different maximum line length, the --max-line-length=3Dn opti= on may be added while invoking checkpatch. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= breaking-long-lines-and-strings + See: :ref:`"Breaking long lines and strings" section on + Documentation/process/coding-style.rst ` =20 **LONG_LINE_COMMENT** A comment starts before but extends beyond the maximum line length. To use a different maximum line length, the --max-line-length=3Dn opti= on may be added while invoking checkpatch. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= breaking-long-lines-and-strings + See: :ref:`"Breaking long lines and strings" section on + Documentation/process/coding-style.rst ` =20 **SPLIT_STRING** Quoted strings that appear as messages in userspace and can be @@ -803,7 +827,8 @@ Macros, Attributes and Symbols and enables warnings if they are used as they can lead to non-deterministic builds. =20 - See: https://www.kernel.org/doc/html/latest/kbuild/reproducible-builds= .html#timestamps + See: :ref:`"Timestamps" section on + Documentation/kbuild/reproducible-builds.rst ` =20 **DEFINE_ARCH_HAS** The ARCH_HAS_xyz and ARCH_HAVE_xyz patterns are wrong. @@ -868,7 +893,8 @@ Macros, Attributes and Symbols do_this(b, c); \ } while (0) =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= macros-enums-and-rtl + See: :ref:`"Macros, Enums and RTL" section on + Documentation/process/coding-style.rst ` =20 **PREFER_FALLTHROUGH** Use the `fallthrough;` pseudo keyword instead of @@ -907,7 +933,8 @@ Macros, Attributes and Symbols =20 WARNING: Argument 'a' is not used in function-like macro. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= macros-enums-and-rtl + See: :ref:`"Macros, Enums and RTL" section on + Documentation/process/coding-style.rst ` =20 **SINGLE_STATEMENT_DO_WHILE_MACRO** For the multi-statement macros, it is necessary to use the do-while @@ -931,7 +958,8 @@ Functions and Variables **CAMELCASE** Avoid CamelCase Identifiers. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= naming + See: :ref:`"Naming" section on Documentation/process/coding-style.rst + ` =20 **CONST_CONST** Using `const const *` is generally meant to be @@ -1018,7 +1046,8 @@ Permissions Typically only three permissions are used - 0644 (RW), 0444 (RO) and 0200 (WO). =20 - See: https://www.kernel.org/doc/html/latest/filesystems/sysfs.html#att= ributes + See: :ref:`"Attributes" section on Documentation/filesystems/sysfs.rst + ` =20 **EXECUTE_PERMISSIONS** There is no reason for source files to be executable. The executable @@ -1074,7 +1103,8 @@ Spacing and Brackets body of function } =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= placing-braces-and-spaces + See: :ref:`"Placing Braces and Spaces" section on + Documentation/process/coding-style.rst ` =20 **BRACKET_SPACE** Whitespace before opening bracket '[' is prohibited. @@ -1105,20 +1135,23 @@ Spacing and Brackets **ELSE_AFTER_BRACE** `else {` should follow the closing block `}` on the same line. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= placing-braces-and-spaces + See: :ref:`"Placing Braces and Spaces" section on + Documentation/process/coding-style.rst ` =20 **LINE_SPACING** Vertical space is wasted given the limited number of lines an editor window can display when multiple blank lines are used. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= spaces + See: :ref:`"Spaces" subsection on Documentation/process/coding-style.r= st + ` =20 **OPEN_BRACE** The opening brace should be following the function definitions on the next line. For any non-functional block it should be on the same line as the last construct. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= placing-braces-and-spaces + See: :ref:`"Placing Braces and Spaces" section on + Documentation/process/coding-style.rst ` =20 **POINTER_LOCATION** When using pointer data or a function that returns a pointer type, @@ -1130,19 +1163,22 @@ Spacing and Brackets unsigned long long memparse(char *ptr, char **retptr); char *match_strdup(substring_t *s); =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= spaces + See: :ref:`"Spaces" subsection on Documentation/process/coding-style.r= st + ` =20 **SPACING** Whitespace style used in the kernel sources is described in kernel doc= s. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= spaces + See: :ref:`"Spaces" subsection on Documentation/process/coding-style.r= st + ` =20 **TRAILING_WHITESPACE** Trailing whitespace should always be removed. Some editors highlight the trailing whitespace and cause visual distractions when editing files. =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= spaces + See: :ref:`"Spaces" subsection on Documentation/process/coding-style.r= st + ` =20 **UNNECESSARY_PARENTHESES** Parentheses are not required in the following cases: @@ -1182,7 +1218,8 @@ Spacing and Brackets ... } while(something); =20 - See: https://www.kernel.org/doc/html/latest/process/coding-style.html#= placing-braces-and-spaces + See: :ref:`"Placing Braces and Spaces" section on + Documentation/process/coding-style.rst ` =20 =20 Others @@ -1216,7 +1253,7 @@ Others DT bindings moved to a json-schema based format instead of freeform text. =20 - See: https://www.kernel.org/doc/html/latest/devicetree/bindings/writin= g-schema.html + See: Documentation/devicetree/bindings/writing-schema.rst =20 **DT_SPLIT_BINDING_PATCH** Devicetree bindings should be their own patch. This is because @@ -1225,7 +1262,9 @@ Others are applied via the same tree), and it makes for a cleaner history in = the DT only tree created with git-filter-branch. =20 - See: https://www.kernel.org/doc/html/latest/devicetree/bindings/submit= ting-patches.html#i-for-patch-submitters + See: :ref:`"For patch submitters" section on + Documentation/devicetree/bindings/submitting-patches.rst + ` =20 **EMBEDDED_FILENAME** Embedding the complete filename path inside the file isn't particularly @@ -1253,7 +1292,7 @@ Others The Linux kernel requires the precise SPDX identifier in all source fi= les, and it is thoroughly documented in the kernel docs. =20 - See: https://www.kernel.org/doc/html/latest/process/license-rules.html + See: Documentation/process/license-rules.rst =20 **TYPO_SPELLING** Some words may have been misspelled. Consider reviewing them. diff --git a/Documentation/devicetree/bindings/submitting-patches.rst b/Doc= umentation/devicetree/bindings/submitting-patches.rst index 46d0b036c97eb5..c90b5e6d8be4ef 100644 --- a/Documentation/devicetree/bindings/submitting-patches.rst +++ b/Documentation/devicetree/bindings/submitting-patches.rst @@ -4,6 +4,8 @@ Submitting Devicetree (DT) binding patches =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 =20 +.. _submitting-dt-patches: + I. For patch submitters =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D =20 diff --git a/Documentation/driver-api/driver-model/device.rst b/Documentati= on/driver-api/driver-model/device.rst index 0833be568b06ca..7762d11411c5a9 100644 --- a/Documentation/driver-api/driver-model/device.rst +++ b/Documentation/driver-api/driver-model/device.rst @@ -35,6 +35,8 @@ A driver can access the lock in the device structure usin= g:: void unlock_device(struct device * dev); =20 =20 +.. _device-attributes: + Attributes ~~~~~~~~~~ =20 diff --git a/Documentation/filesystems/sysfs.rst b/Documentation/filesystem= s/sysfs.rst index 624e4f51212e63..a893e67f7fb2bb 100644 --- a/Documentation/filesystems/sysfs.rst +++ b/Documentation/filesystems/sysfs.rst @@ -51,6 +51,8 @@ With the current sysfs implementation the kobject referen= ce count is only modified directly by the function sysfs_schedule_callback(). =20 =20 +.. _sysfs-attributes: + Attributes ~~~~~~~~~~ =20 diff --git a/Documentation/kbuild/reproducible-builds.rst b/Documentation/k= build/reproducible-builds.rst index f2dcc39044e66d..b0d273f871772a 100644 --- a/Documentation/kbuild/reproducible-builds.rst +++ b/Documentation/kbuild/reproducible-builds.rst @@ -13,6 +13,8 @@ The `Reproducible Builds project`_ has more information a= bout this general topic. This document covers the various reasons why building the kernel may be unreproducible, and how to avoid them. =20 +.. _kernel-timestamps: + Timestamps ---------- =20 diff --git a/Documentation/locking/lockdep-design.rst b/Documentation/locki= ng/lockdep-design.rst index 56b90eea27312e..c924dd4216c564 100644 --- a/Documentation/locking/lockdep-design.rst +++ b/Documentation/locking/lockdep-design.rst @@ -231,6 +231,8 @@ Note: When changing code to use the _nested() primitive= s, be careful and check really thoroughly that the hierarchy is correctly mapped; otherwise you can get false positives or false negatives. =20 +.. _lockdep-annotations: + Annotations ----------- =20 diff --git a/Documentation/process/coding-style.rst b/Documentation/process= /coding-style.rst index d1a8e5465ed956..4a17c60a9240c0 100644 --- a/Documentation/process/coding-style.rst +++ b/Documentation/process/coding-style.rst @@ -15,6 +15,8 @@ and NOT read it. Burn them, it's a great symbolic gestur= e. Anyway, here goes: =20 =20 +.. _indentation-style: + 1) Indentation -------------- =20 @@ -95,6 +97,8 @@ used for indentation, and the above example is deliberate= ly broken. Get a decent editor and don't leave whitespace at the end of lines. =20 =20 +.. _long-line-break: + 2) Breaking long lines and strings ---------------------------------- =20 @@ -117,6 +121,8 @@ However, never break user-visible strings such as print= k messages because that breaks the ability to grep for them. =20 =20 +.. _braces-placement: + 3) Placing Braces and Spaces ---------------------------- =20 @@ -231,6 +237,8 @@ Also, use braces when a loop contains more than a singl= e simple statement: do_something(); } =20 +.. _spaces-usage: + 3.1) Spaces *********** =20 @@ -303,6 +311,8 @@ of patches, this may make later patches in the series f= ail by changing their context lines. =20 =20 +.. _naming-convention: + 4) Naming --------- =20 @@ -594,6 +604,7 @@ fix for this is to split it up into two error labels ``= err_free_bar:`` and =20 Ideally you should simulate errors to test all exit paths. =20 +.. _comments-style: =20 8) Commenting ------------- @@ -792,6 +803,8 @@ Remember: if another thread can find your data structur= e, and you don't have a reference count on it, you almost certainly have a bug. =20 =20 +.. _macros-style: + 12) Macros, Enums and RTL ------------------------- =20 @@ -932,6 +945,8 @@ already inside a debug-related #ifdef section, printk(K= ERN_DEBUG ...) can be used. =20 =20 +.. _memory-allocation-style: + 14) Allocating memory --------------------- =20 diff --git a/Documentation/process/deprecated.rst b/Documentation/process/d= eprecated.rst index 1f7f3e6c9cda9f..8ab538034a29b9 100644 --- a/Documentation/process/deprecated.rst +++ b/Documentation/process/deprecated.rst @@ -29,6 +29,8 @@ a header file, it isn't the full solution. Such interface= s must either be fully removed from the kernel, or added to this file to discourage others from using them in the future. =20 +.. _bug-macros-deprecated: + BUG() and BUG_ON() ------------------ Use WARN() and WARN_ON() instead, and handle the "impossible" @@ -109,6 +111,8 @@ For more details, also see array3_size() and flex_array= _size(), as well as the related check_mul_overflow(), check_add_overflow(), check_sub_overflow(), and check_shl_overflow() family of functions. =20 +.. _simple-strtol-family-deprecated: + simple_strtol(), simple_strtoll(), simple_strtoul(), simple_strtoull() ---------------------------------------------------------------------- The simple_strtol(), simple_strtoll(), diff --git a/Documentation/process/submitting-patches.rst b/Documentation/p= rocess/submitting-patches.rst index cede4e7b29af46..34a6a7c8e6f49e 100644 --- a/Documentation/process/submitting-patches.rst +++ b/Documentation/process/submitting-patches.rst @@ -393,6 +393,8 @@ e-mail discussions. ``git send-email`` will do this for you automatically. =20 =20 +.. _dco-signoff: + Sign your work - the Developer's Certificate of Origin ------------------------------------------------------ =20 @@ -406,6 +408,8 @@ patch, which certifies that you wrote it or otherwise h= ave the right to pass it on as an open-source patch. The rules are pretty simple: if you can certify the below: =20 +.. _dco-text: + Developer's Certificate of Origin 1.1 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ =20 --=20 An old man doll... just what I always wanted! - Clara