From nobody Thu Oct 2 22:39:56 2025 Received: from mail-pg1-f182.google.com (mail-pg1-f182.google.com [209.85.215.182]) (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 70A30242D72; Wed, 10 Sep 2025 02:43:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.215.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472237; cv=none; b=eobN4N7zcyIzdTW8TVGB1QxArrbe7QGIOFHWlh5XwZKvYig3kmyJSSLCWR4ZlWZkBGy1joDIzWGzHidr/GgsOt/frguFO/QSdgPVARLKWEhUzOMEuRDyolj/NLzotpAGa+mGgQbOfNKsfLZb8TC30eW5Au5YHvwmYKuvo60o2gw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472237; c=relaxed/simple; bh=oQ/U51BIIgNGsRun+kwInz/tmig5xTqHruGeEvNRxQQ=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Bb6IxsHVVut96lWBeobQSowCpRqQJASXeUhxZjT0xs1ik5SFLijCQtv71WXCJUITXWgZuCqjYGovRFITuDeK49N6qkSHLqFQYo1cyboGZeHa515m6URpl7v1hhTqhm2gtn3xz44r+EXeY6hNk09Y3QHsYbY7fUhm1ufj3x2pi98= 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=W0avlSuG; arc=none smtp.client-ip=209.85.215.182 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="W0avlSuG" Received: by mail-pg1-f182.google.com with SMTP id 41be03b00d2f7-b475dfb4f42so3813146a12.0; Tue, 09 Sep 2025 19:43:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472235; x=1758077035; 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=W0avlSuGmXNWmy8RXo73USlU6xA6mh+VFlg6c7F6PgGsFVAMOmCaIvU5xoUZ2HtKeN otGYfG7g4jyEmfSge6bTWWMkjMHWoaU50WfY7Ua3zibELs/jvxOfpF21SdPqfltIVdad ONjGYDQaeopPlajAa6WLEpFrE9H3mgF7TpjFS1w1YIXrIPw2pKhXwkafkup/0u8bVdrh t4DSE/xFbcM+cSwtN1nTjdXUuu9LnU507G5iBNuJmLDaM/N28yGRWHfOhwwSCEwo3TPQ MI3tzlWU9t3ORcQHDS8h1F28nKvj1RmEHtnVp5nEk46ULSkYNHAFdLG7iXZlk4Su+0Xe WjHQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472235; x=1758077035; 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=F6mL51Y9x0suFrjKO6EF9vL4ZP5WMnxXlsssvS3RZU5kDllqSovH39Bu8mVpMYW4QT b6miPa5rBgIzmQssD1FOecmS1FRtQv1HrTi/TPXwCvKOUdSoWWgBjAG3Ub5V7TKkaNXs FOeoIAsBE+PWxovvV9jrI9RVWE9I4l6DpTF843TF/A1QRcxQG7qFucv5fBYPzeF+7Hys aDvc8hpebghjkkZZfBLbIZHSy28IoQRHDgPQBDIapgSRiNFhzj7s1LC6CctL1o73xrCm mS9UPV9HvICMgLsi9rsFnE0Q9+roPo4jNNKH3HLUCRiJJFfD7aCVSRX6H/bUpsq0plby mq5g== X-Forwarded-Encrypted: i=1; AJvYcCUBLMCb7pjaLesaGFRmiaWzswOB+pLrKemC/0RAfxnl+n4AmVRA0qjO1Z9ULepZQoAJmgEtsRVN0qg=@vger.kernel.org, AJvYcCV+jyIdfx3ChsMn6mNfv69zmEIvTZzgmsmOQ7Edtu3MqOE/HeVrW1pCWenSvHasVgthv8k=@vger.kernel.org, AJvYcCVGXGGN59QKFI8J7Zaus//fUslZpQJ1yKqpLOv95dsxJaBtyTWGcJJUjHrI6aUUa4+PISexGWRLO5j6@vger.kernel.org, AJvYcCVhTy/sGIB2ocE/LvtE+V8szp0oSru1kPhGRLZVW1B6k83/eXJsJjyNsrf7P4kkW9CNGekLD/km@vger.kernel.org, AJvYcCVwDTDEUUFocCk1y9PQT9SGDKDTaY6WtzwTclntfAjKHi19Q/VR8eUZTGuA24sPSj7Bmhs9FSYQJ6BgF8Y6@vger.kernel.org, AJvYcCW34gFwihjQQ255YWJ/AcDjd/iZCEvWWvtYrM2fTFCf4yxD7lbfxnHbfNUb46X+Wf7JZhEJV968tZPDwWA=@vger.kernel.org, AJvYcCWUe3ogvohVXZB6YXCg6Xvu97VrDjTmrJQOImZq2dI/3Bk7Bteaf6awwPJlZS3M/hvIL6uNjcpA3Clvkw==@vger.kernel.org, AJvYcCXF1Ejher28NGwoM58lW2AsAGIJmdtQdQZIdiobC+PQXJ4OEhYM4Mdn96HsJ8eH4dfjBszkmhwN2vdlcSY=@vger.kernel.org, AJvYcCXG6xPxS5jQNtgCXmQq+zlM9JBU30XAFtP8JCQUiCxrAB1pa+UkW7SDG7Yq6FbN44aOUUekUy9mdvEn@vger.kernel.org X-Gm-Message-State: AOJu0YyRU0I9/Rp/rjkDYuFhTpM7wnEK92zYrXRt5KcbdBBRGiXuCvSq 70Q3LKIdWz6pwFtsAGrTSb+xc4CEAxResuYdkmfNFMTKAC8vXbY5NgdC X-Gm-Gg: ASbGnctFSuj0oxiPm3v2Ya25R1vTSVIkJWw/BLJKF0X+3VmdssjxIF1H9Il+4dg22S1 SJ01njJTJEoTUQMNvq2UzJ439hJjT3pKXG6oc0NMFTbheKqp705FRUFaIUX0IEfulW/x5T57sNL XNfGt+FRILygBZlyho6UtjQHSfGvMcpHA9Z8BNkDIv55Gp7FIbmBGCGfhifF2uDNyaoMf+nBICP dBomR+4pSycLAmJxu/ev4BMV3FJ12H8wplboo3YLzSErffFED54brMvkV2w1cA8Y3DAAHHskS3B vYp2G4PjkJudM4eHA9FFfvf7y8y03xaX9pXlBVpmMwjKweY1waJdiGxFSawlP8sGIrUQPBgdVJb 1rXkpm3xhhCK0wwuEgLqqv6YhS7MH4wM/E9Ie X-Google-Smtp-Source: AGHT+IHbDjWZY3VztYJWV/FENnSrT7+pUTw9iPKJIW8vQLIXrlNVN5ahZX5GB9eL2BwlCwOB0bsRtA== X-Received: by 2002:a17:902:fc50:b0:24b:640:ab6d with SMTP id d9443c01a7336-25172b4b335mr233139385ad.49.1757472234639; Tue, 09 Sep 2025 19:43:54 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-25a27422ffdsm11441735ad.17.2025.09.09.19.43.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:43:53 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id E4226420A809; Wed, 10 Sep 2025 09:43:51 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 01/13] Documentation: hw-vuln: l1tf: Convert kernel docs external links Date: Wed, 10 Sep 2025 09:43:16 +0700 Message-ID: <20250910024328.17911-2-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnig6a/JZLY81M41OfrJ5W/1jtyyro8lZM99fCflwN Zg5yrW3o5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABOplmZkWLE7pDLv7RVG0Wlf H5ewasZymzr2NV7tNPkiErzi6eK/vxgZzoS7uJzLvPvRJPIa/z7RCs5jTcdeb3Q8EmZgt2n66RO ZTAA= 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 Thu Oct 2 22:39:56 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 19B4124DCFD; Wed, 10 Sep 2025 02:43:58 +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=1757472242; cv=none; b=CXzzd3aUCAFQKvwKYTQBdeOqkwt6+zla2sN8N9aU1lq6vACpk1Rb7bTu2vxUTExZzmMSOxt9NdNrUTebEoj3Chd3QYpLdoeRkitwqsN9UQgbRK0rIcyClKHbiAk5uy2eywi4KPv69EGAiDglb+0mcU+Xa3u+gOzjZupuNLJkaak= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472242; c=relaxed/simple; bh=TM7A3b/55JCgQfCA5kxK7YxN6xbvfSMV2ctBC+dU0+o=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=V4EJZJLN8EE+g/zXI6kzH7JNiNtQTSZF7+e/OhOAkQYcwaAVRcdZ0Plkm1motqAwwd88V0OhDw83Eb6usOhLkjdApUYFrcF5Y75RHoyYnTYiTavWoZYjEYQuXRY/WPo/yoHKm2f9bnQujYdjGwuaUNJE9xw93AktdDXkviIGFMQ= 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=jTmzurin; 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="jTmzurin" Received: by mail-pf1-f178.google.com with SMTP id d2e1a72fcca58-76e2ea933b7so149120b3a.1; Tue, 09 Sep 2025 19:43:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472238; x=1758077038; 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=NJdcHxX57XebbZj4zrMMfWynAEuJyyuoNM4CHXO3dik=; b=jTmzurinvs8fvmrim5MhOobZJhjRwNJvXVGPTYMGibQQMN1EaaNJr58OuXoYmnBkqo kmUsMFBPTzpaLKE2iPNTLMw030fajXZgnsgmOK5dVDPjuVzflHEwpMsptG4/bHJUKuN2 dY/e1DsHrFGarR/PoNC+P54lLii1US9Hz2gBBn/SBS1mJvFwWkDbTXjj0zeZJOJJM8OS 9LRhHkg5Tm4Us3JLkTIN6G+k092jGXnRTotlULEwxT5bg6e490CFrtEfUf+aFYVJXm/1 GXdv/b22zVGd5Cz1Ccc76FG2he4PZBkATDkKzCmcUHZAHTYADBlXNPXmf5Ry9Qiz6jXS rjIg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472238; x=1758077038; 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=NJdcHxX57XebbZj4zrMMfWynAEuJyyuoNM4CHXO3dik=; b=oPWZ6xK+kDUwbM6ZPB/1GULOhYp4fZPAJQgcv8ARfRqN/FNBLA90Jz/UOBvoT4yYkN jEoUymexbuHECC1FV9xFQ4bTuTbTvyjv+LRSclO9MfNus7rVTSjtEwq1qkvEHdN+Mq9R I6kLlYTCT5NOri254ac877haWsG3T8cKRkjFnzm9O3ijgV5zmApMFIw1aYjwnWDJih02 O4DFEH5Zsv952aWJxdN/3gkOYm2FmOqu3rYqS+4E4BCuSAv35uWe6LOON+gYsBqYem7/ fgEpp4yz2W0D8sD3MunvSXyYo20pqSROk5PnG/bt8UuDHIIeAQTzSDhA9xDudbqgH9vJ dPUA== X-Forwarded-Encrypted: i=1; AJvYcCU/HWXBMSztNOoObgr8z4Pyh+/BIEr0h2ysXByCbq8u2Fbzfsf7SXHg4MDIGHDiWgQhYgex7nBSCqn/zQ==@vger.kernel.org, AJvYcCUHN2xeOXElwViZEkICWZyh19uTcViJrd4W62hHWC2gr6TGuX+z6bf4iXgFSM1lUfoESuPxLWsL+r38@vger.kernel.org, AJvYcCUY69qPuoCQHXSpMgz7I8rn6nWUzdr1L+uupoe8QxMSs3cx4r45+uLr2/vJSvjywvChafU9VLtoROQy@vger.kernel.org, AJvYcCUtvRz2FTG05jcOxQUAeXjLNjEoI2C/r0vxL4+dfzgEPOvIeim0mAqttw3ynrdMcBmfSPRatXGSPNvcZdsP@vger.kernel.org, AJvYcCV2nZiZ2we/5xWlvkbEYEkjt8I/ovQjqwzpMpyZarMCq45UtEtoZshiHgp0D3Rl5Cc+Gh+ZB4S6@vger.kernel.org, AJvYcCVBYlli89M+4V3E1eOE8Ijyf9daFGkB/F9mLTf4ulGGI1D71G1Y5a6DY+mtlP5kPk3F6vL0uyl5KWolZe0=@vger.kernel.org, AJvYcCVRq9RMlHQJtezsRLChDXsz1z3OJ+1xjKBdfQ1m5o19pv5tlgwk6YJ3o0qsmlERPyGzXX6DvqAP5dU=@vger.kernel.org, AJvYcCVtZueZGMdJuDVr6mL/FK0VALL5LRCGr2nNQq+9J84Ow9CXA9XZj23ShD8B/afQHuwIeVTuGoGx/5x5plQ=@vger.kernel.org, AJvYcCWQmh2kBVjMR0JzKbH6za0UloPlyCvG6/FFacgEONokq5LGqBS6sQBfmJTmQ2im+p65iPc=@vger.kernel.org X-Gm-Message-State: AOJu0YwivPyLpzIJ05STqJRx+lXlFEfaoSm42qiKSnFQ7tHHLnecEfT3 A6mRPhud5c6A8J/3aqSfYcBidLFkjblHZdsCsn08xPbGcBFK3UHMSi0T X-Gm-Gg: ASbGnct2pNkM/bk9SZSxoG3Wk7Tt548U2bUdolMHIat1UnAPf/Qswt/XGv/WWPGSFS1 kxTOoUnchXQF2FL0Tw22XDPSYxL8cMhHDUx8Dmh5RcoYHhX/XBn5pujwl44RYipTNZpyCMjiopl 5Iu/+ZuncqEaztvJ3g+kQ89wDMBuC6cEPSgkR87E4I7bgjsvLRxRn5qycYTI9VtxWzeLHQFzV84 9GfHaLT47dpHPOEUpHx3Nxd+QIO+Vb8OzbWihZveKcO4bihDTd8ErCcasNle1NbNkF/hWOGYFrL C0K1FUL9URORllbfE1OjVrrphmnMtOrgLlymClmeS7AJB44P3A2SxEVWDQmX5Kvf7D56TsCt89X lM+SECJimHMiNicn0mJZ+GM96ZP6mXNU1gqDi X-Google-Smtp-Source: AGHT+IHlW2FYAtqZ1nBeuiJ0erIdKTHM8TZOiaskQC50mFORCZ7qHar4U4e6n8dIjJOSKpsMSsisCg== X-Received: by 2002:a05:6a00:945a:b0:770:4f37:bffb with SMTP id d2e1a72fcca58-7741bebe705mr21095803b3a.3.1757472238265; Tue, 09 Sep 2025 19:43:58 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-774662c73e0sm3425976b3a.73.2025.09.09.19.43.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:43:56 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 0C94B41FA3A4; Wed, 10 Sep 2025 09:43:51 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 02/13] Documentation: damon: reclaim: Convert "Free Page Reporting" citation link Date: Wed, 10 Sep 2025 09:43:17 +0700 Message-ID: <20250910024328.17911-3-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=883; i=bagasdotme@gmail.com; h=from:subject; bh=TM7A3b/55JCgQfCA5kxK7YxN6xbvfSMV2ctBC+dU0+o=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnih2mgVe6tXtn33sQOG2JKN6npsV2+KuvrWb+KLwo YbPrZOKHaUsDGJcDLJiiiyTEvmaTu8yErnQvtYRZg4rE8gQBi5OAZiIgi7D/1T1Zd+0q3NfXbSR WTM/c6Nt+dI0hVcvJi2QWSN+/Q/fJyVGhivi20SiX0RwBzyI4fPfm+rzyfPWB2YZV73+/5GK7JN 5GAE= 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. Reviewed-by: SeongJae Park Signed-off-by: Bagas Sanjaya --- 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 Thu Oct 2 22:39:56 2025 Received: from mail-pj1-f50.google.com (mail-pj1-f50.google.com [209.85.216.50]) (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 17B742609C5; Wed, 10 Sep 2025 02:44:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.50 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472246; cv=none; b=uJQ2s9LFlcOBwVuFQ47qFm/V4SDZ39mVZI55uJOWdYm1M8FQ2TKqQzbmLVPxvtfAQyzUZwrTAE+KefjB/WzCoI0IDgc/5msSz9m1hIM/XYjP4XI0UFb0bSmcCt2E7w52K7HS7ZsVzPUcTty/Q4JeT+yEFOzbsbYSO4B/HdOO9wc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472246; c=relaxed/simple; bh=OYt2QegR/+u0q3CRKm7Zg38q7SY9D/3L6tdzv43Jflg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Mk8LcgQSrLLgSowgDM+G0JCDwHYaKhQplPvvv72fh65P6GUsCvPAePGzRkOW5LUlER7jHceuuJxlv89eLCOzJGiD8rs0Nh73OtxlM1owC5DNf4el3lG/5oytf2eooxupYig20J8rtwNmmZERFNXWHjR3lv6vc9UZSt/X5mYV7f0= 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=kd2MZbNK; arc=none smtp.client-ip=209.85.216.50 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="kd2MZbNK" Received: by mail-pj1-f50.google.com with SMTP id 98e67ed59e1d1-32b60a9aa4cso4066907a91.0; Tue, 09 Sep 2025 19:44:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472243; x=1758077043; 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=kd2MZbNKcevNJfGoD7EhEBbiNEN4ymW821JUYKrgXm+h2BJU4caMZ02pbKpwvlFD3j Xz4iZWoHNkdy/BppudBAx0MOLjeORuF+/Tz7yX3XgjoBpEpz/ooxwPgbPN3w9ZkFxqSI mapuGxRKF7Mk7SDHQWl7GoYLTG1iRs36DwtzciiLGcpeaVHZUDSQSWkO6bRQMe35LQcP W0nEmRYrOErfZD4fB8ea8uECXUKCu6p+2TI0T2iiNXy2ZfuEXMGjIY9Voy0G9cLPhWbf dwU3MmOrBOiFkgPqozTN9x/gNTDpvk5MMBEj70A9my2ecvTrJJ8toNIFksGDCS+VY8oj v70Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472243; x=1758077043; 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=C8a2PE2SUCkPdTM0UFVdDClnxv2cUXBpUFYd2x+8xsAc1CBMCjTuvbcB1QZfBwvSjT wzcbhoJ2LCt9hrLd8dZEFzseYulS9X6ByOvWOo6OdbeLjZFFfnFTMPvHBj/pzrV8ZcG+ Pr5Rpd+r+lBl3i7eT63kXN6cUidlq0Fuq6zxpbrnXMBkWKY4vSPEZWwyt9SgyJqRBwXl F8q0d5XoYMkh+HgHpnIqEZxp+5v32iHNrqRc51K8rFcJLvoguUSGmdkG6C5yzdkAjGub KDwJtxUPOU1iQVkMLaoUb4HNfpHWFBM+TtvfL0Qzg80FubFoFhX9sJfnQZgOJ0jyod5x KO3A== X-Forwarded-Encrypted: i=1; AJvYcCU1BajZvc7ogxCAevAuz9VUdnqwNf9ZMFSBXzrTE0dwH4JT6ArCeXdF9C10Hyuu57wVna0xReB1tWyy@vger.kernel.org, AJvYcCVQfhEuJ1GhzMLBk1X/hvHsiqOtQIljBFutTnat2ONRHt7wsbNwBkVqLiwUAQYZOZHfytzARzJ8xBx3jTY=@vger.kernel.org, AJvYcCVafNqe6hbjp+zvarSm8pjBxLUtYVW70GZXu9sOkYpWYiEftkIuDePPLi5X7lNFRpyijPDYj3ujjP14+eE=@vger.kernel.org, AJvYcCVz/l5UTpmBbxWidS2BzPJpaSlVFpAYRR4i7E+HDrKYQdbz+NUjqVwrwg+VlliDUE/zh9jgA+epmP5k@vger.kernel.org, AJvYcCW9RoowqNbgZrIysDHMiDs1g15+HoMrNSvAhJbn5njhqlaTSIJRNVb/ZdoiQjg1i0EXAGLRG2x05K3T9w==@vger.kernel.org, AJvYcCWexjYjPz9ynBe6lGk/qyoqdF0RCFUWMzuxKTSaHcei0fXWohl3Z8Gr916F1UVF6eXbXnI=@vger.kernel.org, AJvYcCX9KvnI7vmtVKCjlfXf+7QpGSijFyyVR/HxK3O06QQzDJ6vPsnjwkst8CldHr/b8eN7GOVd9q/X@vger.kernel.org, AJvYcCXMw4BDanpuc9g4cCphsmIvk4l4N0ZcvM7U1Rbe1YIY11hZHfBTKTAptGpfprXsy9VbYvtg5iqfLPc=@vger.kernel.org, AJvYcCXyzJ4HcRQUFXV+VrNOWiS1s+5xmyZ9NQd+uhDQu3YmVqvdH4rrzrj9ypod7trtde0TVTwC5pGsbI4AAqhb@vger.kernel.org X-Gm-Message-State: AOJu0YzJcP6Iui5nhmYb+R/A2n8+QcjmTM7P8KWzanpJYB40bcuqzMnD NfPgaQB80wVlHydJy58htOhDmF8zT52+WaJV3W/5MF+j+e4IjTa7wAa5 X-Gm-Gg: ASbGncu/go+pJ9vKI7GoIbJu4cF28j6ZEMGSleV3afGAmZq4e8kYilwafeB3Awt4Ywt bYm/bc0r/+ecnECUtMORKHgzCZRg0xWu7zpc2JKs1q95urOws8abz4Gnlb9VbAAPfrW7QgHdXxq a7uT2lXBoajNYLYdGT+BOncrimV9FpKzOyNY8VKsjmTcC9M1iym77SIBwYIP6/RDbcmH0Hk7L5c s3UpHyGQHNhk1dcFmTy6psU+bcS/s6fOsNWjEdFPLVyFhY20iDKfqDyKG6MRBYtBaN1f5J3VT25 dYZl/RyvR0X2QPQ4NQAzm4BlZcdUMvGXc5mZoo5zPwFMmO9Rb1dU5i6TbTH+Oy2zjPMWvY73nCi 7eec8pZ/YMi07xE4YVvLBfpsR2yUGr7jTdv9/ X-Google-Smtp-Source: AGHT+IHze3NqUFgqDMM+sZM9Wi/Xmfyi7sD03WA5eGHes94PFV7I4KKOuKIIQBvLXj+TekGgIh8lMA== X-Received: by 2002:a17:90b:1e51:b0:32b:d089:5c14 with SMTP id 98e67ed59e1d1-32d440c5edfmr18323077a91.35.1757472243321; Tue, 09 Sep 2025 19:44:03 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-32dbc1c467csm201563a91.7.2025.09.09.19.43.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:43:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 3876D41FA3A5; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 03/13] Documentation: perf-security: Convert security credentials bibliography link Date: Wed, 10 Sep 2025 09:43:18 +0700 Message-ID: <20250910024328.17911-4-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnijWLH+uxHuD5TvzhcJo65MVRz8evf+ht/Kg8H3eu d3xR8redZSyMIhxMciKKbJMSuRrOr3LSORC+1pHmDmsTCBDGLg4BWAiXd8Y/pkdXvTh5u5HL7eU z3No81zweEv6gxSt+G/HWyxWsM1N7zjH8E/xHeNT5tNsutFpemIVy+M+5pasa5QSXynjZOFf2v3 OnBkA 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 Thu Oct 2 22:39:56 2025 Received: from mail-pl1-f169.google.com (mail-pl1-f169.google.com [209.85.214.169]) (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 573F12571D4 for ; Wed, 10 Sep 2025 02:44:01 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.169 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472244; cv=none; b=fEW4mSyQ0h0T5fj/z47lbq9aK4vcjexwbkTEaW50BJXQEFbL4G4/iQeFEbF+YcIv1KyJBromjuO4IcgoHKSugSGHNMM0++Ct6w4UFzAORA+aXbmZ/ScIv8sj+cfOHNqhm+1i8ZWMaaKisTYwHVqRd439/foWUDMTJdD/7Axiad0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472244; c=relaxed/simple; bh=Rg8Js/mQ+ji0aVDnd3uUR+wPkIV7f8cZoyAXSG+WzrA=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=NDVz2OY60vfHS/Jj63AUIlNO2Xp1WnlEl+RhZUkvoPPwtcm3fNgL+6CZOsSIp2ZdIc5jkjPc3GNd2cWWlr6STVbs824OahLYC3i0I3FRzLY2XVYcn+BsI3ZK5W2BTKdkswYstwBG0nch0A0vvChYCNoNU8ONbuevcJhvD9TGpdE= 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=jPiUSt8w; arc=none smtp.client-ip=209.85.214.169 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="jPiUSt8w" Received: by mail-pl1-f169.google.com with SMTP id d9443c01a7336-24b1622788dso44081405ad.2 for ; Tue, 09 Sep 2025 19:44:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472241; x=1758077041; 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=isRfEajvq74JD8Gx5JZkbk62qSgMtw6IJwcPrIolSGc=; b=jPiUSt8wy1/2nQYp/FRhwxqK1rWZfidNyJ4L8qmqHdtSLMOzXPFWw61l1zO78zVHI+ WTJd670C84pHe/CqyT1J15ltYbZP3/l5A9ykgpOs4JBkfiGlfSnnlOS6Lh4zkWgF8CMn IjK7ZaYpvMWH2R/cMln5ljNTWxtMxhJUiYmdZdBbFHfnwwxQ8ws7kbVslr/R5KJ3gyTE fYz4rQhOy5lLOeHIaDKbARlZY5u+4gF8rO1cGA3ipzLELmAsesgJwSkzD6BOwh3OK2Vf L167t3wXFmS4ub49iuqNAtXKIbfuEMR8gzoXONHlhfdE4Eh6jzBmn9Pti6w25bI+550T mWoA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472241; x=1758077041; 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=isRfEajvq74JD8Gx5JZkbk62qSgMtw6IJwcPrIolSGc=; b=sogeTbXr05vLCl6PjJM7cEdyiXim9anzjvmEtdnSZyfoMvMZXAVM6xhBA65J7DxOBU tZ+dxadzdQhNJf/Aef53j5pFahW1m3N0lvEWFK1Dw29TFyl2ZaLgutDnoNecLUj9fZnJ KnhztIw8+BHG5oDT3aN2Q7kslNVTq+t1FoNuKeyk1kAWJoUzdYgivhcWM7X3rRWAMfyx D5DCMP+KHX2sqx0xlLq89qBfhtDi0H//+Fxav40IjybuaLbJbFCzqoczLvjGLdJaME5J GMx6JDflogZtaZp4naUKr4D7bfTp5fgaiTIdc/UGJOn9rlRQgqipUJku0oZ2D9izMatB da2A== X-Gm-Message-State: AOJu0YxgdDvOMFB47oWoxT7ucmGASyTQVrfebd/M0isOZPmQSQDjGazK 1UNfKDWSjBjpe5JDJ8V86zkMQt0vW+7oEUDS/pl0+yULCOXsxHxyfA3k X-Gm-Gg: ASbGncvdJLa40se3itY2CcCFg2r2lFkL2VljhntyFEd0Uj3/0Sw5O6NoS44+NDRt5OY w42pxXlqNEO4cchFijqJY7HI9k2IEpb9M1QgBEWgyDFWKagDrXez+HxEMj7wRTDu8g7R01c5m06 3dM0pG79vMYTfKB7bxEc9AYKuZNn2ZlLvYeiTRRZcmcNCr56YriZ8q+NQGGn6b1ID1JXxDW75sC 2Xw60xHpiZIAhUosUdyOzqg2FovbiiTtMRC63Amtgm+LAY3P7lIwmsRbSDYTsl55XQJ25/wurdT iiBB7enL5JbMZZ0pfNPWFcfEztW0B+XEyQzPGoXNZRJdvxn1fBN8IFzCf2xPfeaQznZ5z+t0Jee bx9ppfgTQODEj2gdHCmYHXLvQCA== X-Google-Smtp-Source: AGHT+IFrrGtrsp5QApHqrAEsH4Lf99kNe3GTHl7qChWDynb5tQqdU4zGL9zb4NWW/Nh5w4cYNQSmBA== X-Received: by 2002:a17:902:c943:b0:24e:8118:cc2f with SMTP id d9443c01a7336-251734f2edcmr195946635ad.59.1757472240373; Tue, 09 Sep 2025 19:44:00 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-25a2ac085d8sm10840225ad.118.2025.09.09.19.43.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:43:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 4B76441F3D85; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula , "Mario Limonciello (AMD)" Subject: [PATCH v2 04/13] Documentation: amd-pstate: Use internal link to kselftest Date: Wed, 10 Sep 2025 09:43:19 +0700 Message-ID: <20250910024328.17911-5-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=945; i=bagasdotme@gmail.com; h=from:subject; bh=Rg8Js/mQ+ji0aVDnd3uUR+wPkIV7f8cZoyAXSG+WzrA=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnihuCjbtUDpafXJnbOHtXRdvzJjhG/D0b9KEh6svl Jx1Ocjf0VHKwiDGxSArpsgyKZGv6fQuI5EL7WsdYeawMoEMYeDiFICJSHcx/FNfPsFU6huDt7vJ kh1V1uZRLxRT1SOqp3E8VV6+6XDdK15GhiW/r34XtloUdOCT982MLd7bz2VGXmhWZatxbn38c0u qDSMA 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. Acked-by: Mario Limonciello (AMD) Signed-off-by: Bagas Sanjaya --- 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 Thu Oct 2 22:39:56 2025 Received: from mail-pf1-f182.google.com (mail-pf1-f182.google.com [209.85.210.182]) (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 B58582561A7; Wed, 10 Sep 2025 02:44:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472242; cv=none; b=iDTtACKHIrA9ZHxFfOdwH8VyBtnZfSD9IUsHE5pDSnYmpHmBhITHmeXNBZx2hMYrGr7CFBpRmtX1LsjHkLUqPwvBa71DCeYe59/CM5ElNWooIE1EWymP6KDof85CzCHR9lvGs+U6pS4GdiuCt0MK8+FFTRUYQc6DdOX55Kf5LH4= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472242; c=relaxed/simple; bh=7QXrNRuCbHeHgCYdGUN3dSXlo+bJ6ZwXyeTt5Kf+8Ys=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=Vd3nIjt4plooO10H+xx8sxtz5vS6AEt8eOACgfwtwMCjfU6VFJVpfTAKsTNRvYWuvorfi6jV45XUw3j6bFLXQgsYQO/LePieUE47RllaxyrG2o1VQomyCrLvYjXYxDaUsiGfw3tYIVhVgXtTmcE6+KFexO3srZZqQOhqNwIqnAg= 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=Ldw5SZ4g; arc=none smtp.client-ip=209.85.210.182 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="Ldw5SZ4g" Received: by mail-pf1-f182.google.com with SMTP id d2e1a72fcca58-77269d19280so5796887b3a.3; Tue, 09 Sep 2025 19:44:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472240; x=1758077040; 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=Ldw5SZ4gXJFn2g6UfqJc6MBkftXHELR76cugzw8BHgaiet5kOrpGMIYSIbpTEG1GMA om5CjFT1Mrha/JUemSERtLuCa1SguTjuhuxktK5y8To0TZ2EyLSaYdehk5T4rcFclfm5 jNaMpHuzRbodbvUumV5YSqQMoYRTA3vIPS3VloLXGorx1zfCKqECGcHd/aRr+KXP8ZqF mOxZa1rwR5+pgRp9NrtG7Mq49K07n9Dt0vUgCbSWQdcOg40RwmM8fhID4EgmLwJYNarz buNE/tdv1+yrs/G/Oj289gD034V6vkIaTJpxgYRihvPOk+12rD8I5+g1hL3kDM4s74O+ Umew== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472240; x=1758077040; 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=KYY1cILgbodxKeWc9Am8SHtWDdGrRUNxsig7H9fnxJZL5gYchN1bigkLCKmKjqgXyt i2DVg8t5uCw3wIif/Xg+darGBgEGWkXRvpq6ZKAx10TssJqsPnbiAr9mZtbFxhSdTxMn BsbGHn0QM6HFt5pZ/B1m+9N991v6sh/5HSwGV+rEJkLBJF1KWy1ATsvPh13s19JodyQS N+RrESXJ24Z+4CGxHVLefiSL61+vNGC0vR9CP5Xv8oI2boQBu2ouf2rSSzTns/QEvJfK LjfzxUfTUfd50j+0KkWkCkAiSlK8QF18g33n6dzecsKKottxxhHSqrcoUnlCi63h2J6C yA6A== X-Forwarded-Encrypted: i=1; AJvYcCU1i+jp4SjAtR76GVmzIiK+V7dVgnp51V94qJO3H5s9UZ7EIckDu/gBymHnI3XA7k2Z9sofNOAh7Sjk@vger.kernel.org, AJvYcCU8l1RmIRbR0qsjuM5DZEphvB6rvwgAT11U7syJksCC2Aq/1j76ABji3B1zUtEHUIbeob/YLrKofXM=@vger.kernel.org, AJvYcCWCGvqvHKKmd/bm5FxMWicAjQMzLdh6XS+yIUwJTJ6CocFI9pCtKIbqxpaPb+3T2/9ZORWIFQ5vt8seBto=@vger.kernel.org, AJvYcCWj2tHQMrbcVTRL2EeNGF2JZTigy2i4Ct5GWPZxDRXXEam+u38/1Or0rX2Wk3tb6wHEwb0=@vger.kernel.org, AJvYcCWvTLUiBpN+Urlh9w/ub/vaOjIjT5q+pbbUFaQPgRvsF4N6iRx7YcTnfJxiSfPaWhYBgresAFLAdZ81i+Y=@vger.kernel.org, AJvYcCWw753DhYr0pVRlS+nRgYxBjbYeTatA7bJRwXxOexHA2NUyOZdGU56tRhZI2BWPSoYED9Az/Gj6kWjO@vger.kernel.org, AJvYcCXjflWXr5KYxoAfOfu9/vkaznnSDDK7sa4QO69ZwKHhV4F9tesZAduaRD/WxqWjmqf0HSCbi92FTWsN2Q==@vger.kernel.org, AJvYcCXoqx6SuVDFwPNHFc9XNanDnQNu52D9vjl2SgfULYYpC9i4i0V8tAEnoYdFtIytTj33kytaFisD6dRqKmQZ@vger.kernel.org, AJvYcCXxHJcCcphDtKMasklSdmIqXHw2kIDnQASikfotI3ChdTnD5w6iNUkg25nh4P7DVEjkzs4m2r4q@vger.kernel.org X-Gm-Message-State: AOJu0YxyGp+rkuaNbF+WU9eyQHneBaDqV8SlXZGRXtjpdJy2j/UMOCXA 7E29+59jdCKJBedhMqMG08yXvcL5Jkv5oZi1TSYHhQi/mBe3Bh1fdthe X-Gm-Gg: ASbGncsrBQ7Wdplb2LTNNIYnDRge4bGapAK+oUcPmFHiNWgcJKjJvZ7gvA1EVGOwkBh 7SMbnYUeuo3BKHmJWH8bBxXpQvdo7GpGhZTNJTsHPMdzSxpqHl44+xY2k80z2lZJu8SNTzgKF8O QqzsyYnIxyjMjFVoQFzbMedQvqCflMuvQK1ul8Mjb2x1nfzYta50dU+Rh2s3qfiRaXwzIsAMtc8 CLuXsU67PzEiQ93OF+a8+bOPGuikPTzkAEY5HuLPwEcYt/AuBwJDzT8m2IrPrT73HLGEa6E3oqs +T/qH4Zg5OWDmDIk3qM6m1lBCa279XNcwuwFQTSjG+ISzB2OzI6jDv/yO/WW966JslM2ktgSE9D 012AGcl3IhbYjQ44a+L8Z2D09TyZCtBUmfXKn9AITnKQeByo= X-Google-Smtp-Source: AGHT+IF4N06fuW1A2YnqT9YeYfBmdnDVAaiP1zDRDWLaUsyjpra5p/f/1OQFfNYpt7LKVATNwvRwQw== X-Received: by 2002:a05:6a21:33a6:b0:252:fbd4:630c with SMTP id adf61e73a8af0-253466f83c8mr21797369637.52.1757472239935; Tue, 09 Sep 2025 19:43:59 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b548a602e14sm1057772a12.21.2025.09.09.19.43.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:43:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 614CF41F3D7B; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 05/13] Documentation: blk-mq: Convert block layer docs external links Date: Wed, 10 Sep 2025 09:43:20 +0700 Message-ID: <20250910024328.17911-6-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnijp3TFftH6q+kyOiIzsCLYVR/ZOd/GUnnS+Yu6/k 6t6/fl6OkpZGMS4GGTFFFkmJfI1nd5lJHKhfa0jzBxWJpAhDFycAjCRydwM/yu/ZhfqF9YvP7NL t0p2f917xpei8yqP3w+TKtx3xMg27gbDX5mQVefmZ+9qe6G15Ils7rRL855MXJGSeHOCjN6Gx61 PyrkA 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 Thu Oct 2 22:39:56 2025 Received: from mail-pj1-f47.google.com (mail-pj1-f47.google.com [209.85.216.47]) (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 1BC762609EE; Wed, 10 Sep 2025 02:44:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.47 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472247; cv=none; b=fwFjO/Oux1bmZaPDdrzOEwmQf/sIOF9E4zwNRGY91DvKfwW54143A0Ot0Ljj0w/oOwcVjol4YI9sOJoPXCXWRoVbH6tGDtX4MIiNnWUSx4TH8g+nHbvlduzzY2DDP+VlFKYqMEFbYddYenVu2ipR16ubdRynuYnYiZl7qsGouXs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472247; c=relaxed/simple; bh=IiAjp2UiG4E4i0m+2wynqH3PCAcCcaK0of1KdBtx1KU=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=aYDVn1yNXbIjimoIeK1n/dQDxfW3VgGrT0KWlOh11D8RmFBwK/Ssrebf1i9JW0rn0RSt6DHuTarUqNl2ZvAWYSDPhJ2Hgr00q61Ms3NsFE8rrJ1Ty49mwx7vKNarjcTXOunJk+F1rUxEQvEvFW0UQf62drHjXK7ZLWLwT4+/cqk= 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=fjRb/rop; arc=none smtp.client-ip=209.85.216.47 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="fjRb/rop" Received: by mail-pj1-f47.google.com with SMTP id 98e67ed59e1d1-32b70820360so5044417a91.2; Tue, 09 Sep 2025 19:44:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472243; x=1758077043; 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=fjRb/ropM3WHR5cxotAWOhOThqD3PFuqFzcwo8rilKaDjBnSHXwTOCBepBAzu79HtB bvSUQa7itHTklkQnkv+F/s6y8OqIT/MRGYzfSTo82T6iUOnhNNk2UVZS/83k6wPd1BDx d8S815gCUyq94KHN6JCHxj919XInCtDep6e+iiMmqh9PvTPtT13r6ypYGZf5bo6kTaZH Dgfrq80jIvvSlsCESnDcXAsIUI9+oFDMOJfhJwsMK42rGeBp7NHqONGbIh+20L8lYLKP rgY4dZhxKRuwdqw+vq2pDXKTRJBWeP5yv5Fwt7MVstWAdNocXFBEzL9ZYzHJQmNy0MMA 4gRg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472243; x=1758077043; 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=GbVavtoHprEipFDFvyghmhMFaYQ+Q2hKWoVmaEyq6FXwkPZXWecejDDERP2pt8H4HC tlOsZuzzkJ+oBelJ4WpffgNFQ8W8vnbbYc0C/mKER9ybiq2bTLkGj7XK7ZTA8FwlnJTw p3e9JwN5IUcOOALnpbaV5/+jy/Zv2pD0gQBcJgyvRbkdGYuaVAIVLaQgdXF8xUcMmMN/ FG6dVSH/kWteTA9YOVXAFRsKO87iomXB2wICIzn4fuJbMkLEXKgBc+Oiwe+ZWLMYRXBm 4IwB3Rmfe1bqbLVsZG0+xLds494k3nP+Z2emmmnCWGBoLNQLo6fCGifaRROwmfsUS2VW +GXQ== X-Forwarded-Encrypted: i=1; AJvYcCUmApZpVGKcDlcCFq20CUrYE9DaGKz9k6pyFFiYMQGi29h3QGH83k1L32nROewhIb/4wKsZNKIk3waQnAw=@vger.kernel.org, AJvYcCVoq3d6GPvMWQa1YFO5bSRA631mQoRdSHaj0/4i1L9wtbFQCEl2aIj4h2I/2swHgY3L4iqC/+M1hcI=@vger.kernel.org, AJvYcCVyFD0yWk+Iur5EJ+6gDqWYbnAoEhAetPRj6PDNQ4P4zJ1ZqXEqBS1QO5RFVQEwyO9W+gXTAv7y@vger.kernel.org, AJvYcCWGmS5dREHBEZ379gyY739aCT6UU1cmaWhIIFkRVpi254grO6d8ojEVHhOrHXJw0rptD7Y=@vger.kernel.org, AJvYcCWHewRbFekBfbEPDJHKcWjfZrqNOpCiju95P2sKxWs0cE0posjjTRpXvm5Q0XUM6jseQXRms07/cI2dt2Q=@vger.kernel.org, AJvYcCWNxrTuCmuue68kozBlm12ywJ4jTcOR4efXW/ygFG0or2ha3xYa+//lbcraFLjOyS0IjnV93whdsaPw@vger.kernel.org, AJvYcCXZyR6ECJlxIOW8waj7DN4POJaVq+4QtB7cD6yH69WHRhuzAO+PNC78Zq7fcYPtgoKwlksUBY5HWEEN@vger.kernel.org, AJvYcCXp2lHL8JmcRip5usFp4x+IJ+E1b+k8chjfo16B69k0xonACDVdr8marKC6w4qk5h/fky2caI29pteSbg==@vger.kernel.org, AJvYcCXwWDhP5JAwZX/qJr+B1khCZoHSmhu8m/9YOFt8lbPHNQgfg06RCwXFzSgcJwdoMdsi841w1UzkzDaQQ+HH@vger.kernel.org X-Gm-Message-State: AOJu0YwwZHFvCukwbhcs0JePfYW2oDXs6wlKn6PsQSJ64dF1Rdm3sI5s fATsds6JZ9l/zHh/Sh37flU2Q0iMXNTnLEWm0q/UfDr24xg/stJrWWOA X-Gm-Gg: ASbGnct2D366jS39Kz8tcEvtP5Ekbe6+uho2JRKoplvY3d9DzmGejd3MVVo1DnVj2Xu JCyC31eOQY2I6wF6GoK0n+8mAIZ+MrtYKRTCYNLCsDhvzF5SXjZhWRP7UwHruc4jVbYWksf08F0 01f+yNmPbNCJuK1PR9+gJArWmR9b1ymqVCwKS5hmLGV39vfYT5G/Ze0BOszb1jENM1uqm3x/Pjj zga+3WufYMzrMdTfk9b/9NRN6NA97zLCMZ4ytumD9sIuuQukNTBWMb61cPLNHANag722ciEkfvx kTEwVpFCpwPn5uKS3i7yBwwNdYZEVuYFJkmmsp6PZtvrKZFtOvdLOEZ10w2lFduPzahPaosCfRF UJIhGk2zN97p0AgrcL3sbQYtTTKMSz8bNASktXe8pGf/nAFM= X-Google-Smtp-Source: AGHT+IHufov4+itUSgW37fW7I5+vYPKYGEYLT2O7M4oMOCb3e767p9iSPZEDIcWxDU07PyMVD30Hjg== X-Received: by 2002:a17:90b:48cc:b0:32b:5ea2:a4f6 with SMTP id 98e67ed59e1d1-32d43ef0806mr17274237a91.6.1757472243216; Tue, 09 Sep 2025 19:44:03 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-32daac59f19sm1672020a91.1.2025.09.09.19.43.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:43:58 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 7D27041BEA9C; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 06/13] Documentation: bpf: Convert external kernel docs link Date: Wed, 10 Sep 2025 09:43:21 +0700 Message-ID: <20250910024328.17911-7-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnii1Whs7TnrT1LggM0BOd5LEqfAiXtc37zS3e5gl8 vnwGP7sKGVhEONikBVTZJmUyNd0epeRyIX2tY4wc1iZQIYwcHEKwERe5TH8D8jY+cG0Uf3udDP5 nmfVwtmWi5mup+fF7AiUlLjK8OXNJ4Z/BmfN3s08dUKM70wua9O148mfqhVc3wuvO6WtdrV4s/k pLgA= 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 Thu Oct 2 22:39:56 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 9EFBB242D9E; Wed, 10 Sep 2025 02:44:08 +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=1757472250; cv=none; b=bWIMQZiMROTpCrnbrZukrIaD8g6K80+HgRovOnh/rW8z2J+OmBd6D1M7t1pUIyH8G0yRklUy8c5Pm2aiuQHuIiqNaJnDz6f2ASVb7Nw1t2HFvSggwgmO95GL2gtdwooANfxeGfne8j8UlopAq0APFGkw3fz2mxJUnhcPK0DQF3A= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472250; c=relaxed/simple; bh=yEY9P3BA6E4kqaGTHyjuJlgmOOGj2m2ZOET4fPd8xcs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=uV9gUjmFLquFHh9Y8seSNiPh8GFChmpuTYy+KSmmHGRVdo+5mbjVzAXQaz3Bo/eCeKUX7u0IntSpVQXyDRLtXfsbFIRy9hA0W+AUCVFZqpP7nMLAHRF2Jqtsw2WA8Pff3qiUUxqp9Dw9RxjhEiq6DZcI3/keelMyivOleerljYI= 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=Q4RdcytB; 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="Q4RdcytB" Received: by mail-pf1-f175.google.com with SMTP id d2e1a72fcca58-77246079bc9so7425193b3a.3; Tue, 09 Sep 2025 19:44:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472248; x=1758077048; 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=Q4RdcytBALx9wkhV8FDjmO13KRWACRKyAUvvAU1PqGIXsDeqJUAgJ4RtJHGKnYIQNu 56cmyBN7/daYDql1WeONtVLheU9wVIZdKCLvc+1BMB8LypUExVMxsaiLPpl785FGTFLs B27nyumweixg14lmby2jUbG1jzMoJfBkXvhNb10VNxU+tCbDTHW2nXDf5Lj0yxeoMdU2 NdgtVmmu7chBWWcI/KR86f039Y1hvcL5ZqyydTlbAuoCc+XZbGZljPTQQav/E6dX2BjI 1hkXcrElnFQBkp0HQ7f906tolja9K3GzZiALPdr8oHB9ksqFIoJW3Lq/x6nQomY5fGYY NhFQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472248; x=1758077048; 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=H+kd6Y/RyqCGvYDSgkhKRaC8F6Ehn7fSDgeSQH6NHogeCDfKLQ7rviFtq1frpVIuAl ZXZtX+HFGFUCVNYa2iZKB/EgkU7HP/0cHMMBj5vXVkzlr40WJKNDqEl5SAj0WUdnEp1u GkCh5N4+eMJ/oGnmFZzEAiHEkwUuA8k9vNDsP6CLKhSqfbwayQGhuQezjmBisXamqdUX 0XQN4qisqFsGZL4AnWHiTlkHyFGIGoXKGrcjM7K+ZIwBiCmSUR0ekWUNzziL5Mgcn8MW pjsNvglt+/HOSpoZROHV4KJB3fPQRY3t+by1upPJnc6T+L6b2UzpBTPGcIGlJkxZFpL3 neaA== X-Forwarded-Encrypted: i=1; AJvYcCUupHCak0Jf3jK2zLWhTc1F79Ip3if+WWo0JRxZ5LhcOZljjb4W3Rzq9Z9HguvF+6jC55eEzJA/3tE=@vger.kernel.org, AJvYcCV20oFS+dewyNnQBAaq5eVZcxyje9cA0AkDFjqz0J14INTLU0qiRAK9sdUlagiPODROy5E=@vger.kernel.org, AJvYcCViQKku3ko1esT0FFXXJvM8nY4VLDRxrJCC3Eg63P/YyhL7tnEDgOXvAFV5Wxc+ofrP7JN+/R6UPy3613dy@vger.kernel.org, AJvYcCVnty+Kvl5PPY3d3Jv4ge+Ki7yZBCu/vKbieglViG+VHoiqVoczYTH1pBIF5AfMU+RhJZZeiNVfoA0rl/g=@vger.kernel.org, AJvYcCWMwJubpqqx3AqWCI4u/Sfr4+oWAkr/Kh5Cl8qhiH7GsdMXZG9nZ3PxpHCWWQ19wTpBEnGxboeW@vger.kernel.org, AJvYcCX1sa+zMPhSFNSXXwtem+4hBJczdPqtwwx8q4APTrT/+Ub5DR0gmAfYr33diS5MwGyfOSCSKUytAzLS@vger.kernel.org, AJvYcCXSD3LRoVEr+8S3/6FTO+tyltSv4wbADSas3XDbIQpKdy7mqgHi2sjWiJVoQUiTqY5/IEUt70GhKeRDog==@vger.kernel.org, AJvYcCXsZ5C2R2ZzrsgnY7vQVYDbAQx+fZjMxboX+z62IzO5KnVMHV0SfXfF9sdJbdo7VAvSllZx17dNsdCL3MU=@vger.kernel.org, AJvYcCXsgsndhLLtWpmBmHgUMMc9wEFI6BmZ3KLaf84nr1v4V1B7D1xgRyH3DGDc3X/JiKcJayy91DY/8hjn@vger.kernel.org X-Gm-Message-State: AOJu0YzFz0WmpQxUQcnuopEGsLm7ZlU9jLyRpGXtmFw5IDlbY+Vpfy3n OzK07k43SpLBzXU4t4fYb5ZHdDF1qC3jYR5HVndPKKDa1xo1a45XRc0a X-Gm-Gg: ASbGncspkCW6c8PoVAjrU+82nS53900ObC1afAGYe352AxUrCdjFC8qJgC3eGY/oTPd 0H+6zDpC7T0kOZ1vZe3A17aK4OX1cp6P87RsJhGw6FXaO9TcB4VbhgW4ZrnX3hWX/cE2Pm+v03y h++9fuQahBCV2Hj5Egr9sIO2SqlYQdt8anjS2Dx7VyH+Vhb+sn+H7eK/9nVTM8tHN64cGXdhNF9 yi+fpZseF8/dMZLMyTdkcg1RFyXrn5mdnI7bRdwxRtpq0UGuBoNn0Li10MeNlUaYrofxhGT+z2M xkm2CwoT5V6wmqLCJRXLu7kqMXGfoSZAeJ8SpzsrbaqheMRBeDLZIt1U0LZdgceL2VMM7L/H77T bks30ZcMtzxbGI9wPXOGXFRaOAQ== X-Google-Smtp-Source: AGHT+IEyED1mSm10/nBWu/PDugDe2kHeGr2B1Dlm/0Mxg3VMmmsn8EtrKKBRn8Kt1DMp+jVk5SErrA== X-Received: by 2002:a05:6a21:998d:b0:24e:e270:2f5d with SMTP id adf61e73a8af0-2534547a6fbmr21436774637.43.1757472247740; Tue, 09 Sep 2025 19:44:07 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-b548a6bbc9fsm1061117a12.43.2025.09.09.19.44.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:44:03 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 999D241BEA9D; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 07/13] Documentation: kasan: Use internal link to kunit Date: Wed, 10 Sep 2025 09:43:22 +0700 Message-ID: <20250910024328.17911-8-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnihdUeC/XH99x9zD0/p/z/9z+OvEiwfuXjriUbHJw 5Al4fDvwo5SFgYxLgZZMUWWSYl8Tad3GYlcaF/rCDOHlQlkCAMXpwBMpGYSI8Phu5uLfVhjJryT C+XOkO/82KnH+HRZtlehgA+3hxWLXwPDX5ny7U3LZzLMPNBzWixMoIP59nkt/0fGhV4ZjM5rXH1 d+AA= 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 Reviewed-by: Alexander Potapenko --- 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 Thu Oct 2 22:39:56 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 63E60274B34; Wed, 10 Sep 2025 02:44:08 +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=1757472250; cv=none; b=qxAMBqlGkR/ARmcAbU0FnpmRLyXkRRfnz+VIEAaGk7aRJMfmzh6opQEM/RI8RQV42yFWhs/71n3rE0JQICJQHWkPY5gH4wZp7sdi+leKj8VgXY6hbEhLz027IOszi3FaDXKK/HL51To48uT1z0I2nXUIcq+UURt0WO8Pd5cClHk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472250; c=relaxed/simple; bh=WOOeaeuC9/RH4phIV+H+QiLxF/prahARBSHjeoa181M=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=DxyDmWlCfJZxdFCBJrglJ1Rcsp6L1kjR8UuOkkR/1Xs5UWydBQ1LmKSRAX2uWoCZLwmdeHwO4g8T/vEeIxOuDQrTxr9i9z1Xg01AuhqVsdbhHtNDTtN3g6YIM90xqgb6XwXNOm+SythJlGrvjnv5ZkgVc1gXMlunTpNQBeUzrew= 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=K+WYWbUG; 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="K+WYWbUG" Received: by mail-pl1-f176.google.com with SMTP id d9443c01a7336-244580523a0so68087305ad.1; Tue, 09 Sep 2025 19:44:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472248; x=1758077048; 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=BATnrPttTGOeKRCCT0K3V4HzIU9KTE8stAVBRczt2LY=; b=K+WYWbUGhlj2W3an94pU5lZl8o7WsvuLzprhkkn4j+fVFKMBXQqPiTJ+nkNShP9YGG /n6mb7CDRwN/7xkHk9D8x/gYC4tfhTUzuL1nWnNdQyfrgm7J1Hx7pdLCtBdN00g7NzFO 5IuLS83RZItaJwmLm3E2mFHegDSR+dSvYsN0vsWxkenkNPyf49jCcOTHbC4LIKxMLwC1 qirHeI2Ju6H4OflpsNwl+Ueh6a+DTSZ171ofPNDJA10qb/nkz+Z/iotAvfVcTeIdUGvr /wS62e8qnG+ZDlw1q1RaKIQMVa45IKvuaD/oMR3hjSlZLYWI0WEj+H2vGfxooEkchS37 voXA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472248; x=1758077048; 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=BATnrPttTGOeKRCCT0K3V4HzIU9KTE8stAVBRczt2LY=; b=Q30IS/jEQV6YuUEFHfyz629BK2DA0r9SoOGQqjCJyBJd2+WWiImhc+kp+ieMqygTF2 fMqougnQOHl8NMJRQv2cfYnuG7YBjy1itBvpvSZW0aPr0v+/qruw1l7lf6tD1y+QNbT8 zzxr9KuKTS3RTBtCKe+LTeG04NLM+PEjDC6sjk8JDOlvL5e6rsikhXdqwVPIS9+wB1KS p433RZVH0lnHDuPsGF3acwFusy7eMpQmKDdhsPVZN9Yxe1jAo+BZhAOf1sEhzEO/bCnc tHLk5nx5kuon5ueLoVBd6/uZlIAL81UlKLCx0AmfFWBAn0jZ6tJWgEzoFcJN/aqDCRdk rRBA== X-Forwarded-Encrypted: i=1; AJvYcCUBOP2qfcObTZSGA608xN3ipkKbWBx7Uoti+yAdLn1Fk3YLXNLuhaHR/jp52jwYqxkyn7/WaxoUQJM=@vger.kernel.org, AJvYcCUhCddqQirwngublyEZuthSc3MJ1Q48EMqs2G/N4KPvysjaFOxgSyxyfo6JVDWMKQvvBRtGndUeiQEXxQ==@vger.kernel.org, AJvYcCUzzlLVGKIrJ5LxpjfVGcaUgAQt3jqwdToNMKUKI3yDB1cwR4/ew2SCjNshdtM3t9mygAWN7x8IZ3PrkM4=@vger.kernel.org, AJvYcCVHu4OSeGqQLEMOedXCnrC9zKA+ke6P/rHLHVjERn6x47iM2DrHGDtvdLc5eKYvodhhQtXiFrz3@vger.kernel.org, AJvYcCVKbzW+pq6Si6a+/iTwGQFdrPKbpLlwkRbg8PW8EJjrkTp+TRDIMlR2EfMeRXSZIKLjqdEDbzsdZZF5A1U=@vger.kernel.org, AJvYcCVXTspUW9EuhnqoZvdkWCewBn3nRert27R7d8i2NXfvBdQGVCkxyKHqEH4Qu0idp5VI8Xgk/KD3HMxZzbg0@vger.kernel.org, AJvYcCVsHROg7f2XsggHujyQZPc99IoevfFKgEM7pxfGh5WK6h8MNZQJyOFltbRp/e6CZNhiUSNYtgKAtO+n@vger.kernel.org, AJvYcCVuxA7a9hwDN6CdrH9aRZR94/RaB+qfzXrQZylQm3jpyRD5m8FQj7sMQ0zwjQ1wmz8z68E=@vger.kernel.org, AJvYcCXaffH/8vG5UDEB6THR3/W6aZACjqLgKhgoAVqtVlxvjuQQ4EgNE7/Q36SilbIANX0/AGzQNXxW9e7N@vger.kernel.org X-Gm-Message-State: AOJu0Yzlma7uhHEBuSaC+hJ5wL1rHiwlmp1Z8EEmqgqOVoIkFy1gzoRi FrOZQWMBKtL0NKZKB/UVW6d1Eiohr9S1D99uHnZj0sLOfa6pxVgTCk+v X-Gm-Gg: ASbGncvgptlXC2+qdTqqbT6+Olfw9CZuLVh3jEBWXv1wS1gW3Qh15IwA/ukD7rq2HhD sPP5Ulbg4yOlS4R5VIfXaZQhZI3dSXkNYM2CaKcSDLG5nPnmFch0kHFkiuf+R2yPJPbA5SGgeGG PZIpwyq4GJCv5ZM8Z8SXg83SGCqar12lF/AXNkDG2Pg9nsUsLO/9ZnKKOsRTwSEjuHw/mt6ShcD ZM1elWKcmLfosUN5Ig+SpWYXgxfcLl8q4NlHXTLRPW/03/WW7O/SFcWAN4iyI2uPWRAFIutoG1y Js7UeRiorwSIwQib2Ru65QpTVNO/otmeZPQ0/r/K5vi5LsklbFuIPcRXaWZH28hrAy+uOlxpt7f LEiZiiKUnZ2dKBN/f5A70zz6Z/HRF4ZBYKkho X-Google-Smtp-Source: AGHT+IFT6YbUc/m0qKUsx2gIlS1cyHwFE/YTWi5ShK7yx8zu8toS/bxgvdpLpOBm2BAA4mGAvmnSyA== X-Received: by 2002:a17:902:d501:b0:24e:3cf2:2457 with SMTP id d9443c01a7336-2516e69aee6mr211563725ad.24.1757472247632; Tue, 09 Sep 2025 19:44:07 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-774662ef781sm3491871b3a.90.2025.09.09.19.44.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:44:03 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id AD39841BEA9E; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 08/13] Documentation: gpu: Use internal link to kunit Date: Wed, 10 Sep 2025 09:43:23 +0700 Message-ID: <20250910024328.17911-9-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=1173; i=bagasdotme@gmail.com; h=from:subject; bh=WOOeaeuC9/RH4phIV+H+QiLxF/prahARBSHjeoa181M=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnijZrvnhN9eJ1+LvAp2zslcUft9O2uC6e1HKcd4J/ rFLDLiudJSyMIhxMciKKbJMSuRrOr3LSORC+1pHmDmsTCBDGLg4BWAiyg8Y/lmtiNJu8EtVbugK fub0kTH31Gy3pLdrgoTZz7qUXricksHI8GebzZaeM9lhFZ8KFVTdJ9stibqczP1vypfAmIZda2d 1MwIA 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. Acked-by: Thomas Zimmermann Signed-off-by: Bagas Sanjaya --- 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 Thu Oct 2 22:39:56 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 BC41626B777; Wed, 10 Sep 2025 02:44:08 +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=1757472250; cv=none; b=arkI6b0inuc4+JPtd3GRXc9Z0uiuO3anopRkulz0Eyck1eaVgJ+uMitA2oQdG7XXDvtoOSW4cHSkTj1vdzlgl5xrJFgDbQZWkgW4BVXNJlFRRdgvtBj6MKLQGPAAoBatJwhko7qrlkup+EQ0F6X4RYw/f1eolbLFJHop373Flfg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472250; c=relaxed/simple; bh=Ip9RCWVx3N2eFboDnh1dVntKjUKs5RT6sbpEBdmz23c=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=QDeJwJmNOJcEQAK90FIwD0Vaf6dcPUW53IMpOzukazU4R1dQPiET5gg1GA8lzeuzilp3gvZP67o9vtnNB+1TM1g+8m3XnWedtEwSLNHQ+M14l+uer0UIOgTuiy2Zlqz+hJvdY26u0ubm8OkMfCqv5TAooG9zdHYhgHSakJlk9II= 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=i+B1Wj/s; 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="i+B1Wj/s" Received: by mail-pf1-f175.google.com with SMTP id d2e1a72fcca58-772301f8a4cso8828956b3a.3; Tue, 09 Sep 2025 19:44:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472248; x=1758077048; 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=i+B1Wj/sgOM1uepG0eHhRbdRM0tuMPxTyyN4Z4eo7xlKvlzkc/pCL2xrLqWx7AsChz N4T4EOYhpz0V5jkUFoswTXZOAfhGSsE8CJHcU7oMbVdpX6jpXmRr+Gy1lG2FMqEz2ZWQ jK/1Uj3TDx3JIRsQSPHOWEW1e+4spOBhAuBKMDeM9OPevyPYYQ4U1Nr+04TvqXEsfY8F JTt94UYYpGAA+zrRF4DLMg7ND9iUnt1tcgvwcVgCUF5NYf/PDpbU5N3ukYEuxgHabwd3 JpBz9dOUOpm1v1131h2ortq2xtKSQgS20I0fktKceub5eLRbfia0CXe2Na9/8g4XbPTO CzWw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472248; x=1758077048; 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=C2Ty0Se6CIaFbDJSoYghvDXQcwc3CUgqCeiKYB7BCH1kAZx9syAgBiqxoW+IcPwQVb JQuhIMgL3ricNVokTytaWLcexY4M7sTdz/uA55m/4YEdumIXjLKnKnlc1+doF8w+rWTW 8e8Ru2lBo1u0dY4puB0pF4FH3TXP0yvg6US72ZdHpkK00CznAlXXJJ9bCanl9cL8MRVh S+cmW02857H5DyU1kDbCgR1LkZdlGsEFbbxcuSe2mtrlazsKyiqO7YomHPMKE+rKhwo9 UgdiIqh29u1Hz7LTaRNUEjqZztLtdlHlvvX/Rerraof0lo6ruck3xfOgjWGsKzzjiHSE vnjw== X-Forwarded-Encrypted: i=1; AJvYcCUjWtmC64vi8xwCCQenuuyAOG/7Kl39y8qA6o9WAEOYHMyupWJrP4jVnBBuFYKsZYmy1Rr4WW4H@vger.kernel.org, AJvYcCVUfAvPrdbB1lIQM4lNwNsyM5wEqr8im3JCpmnmrNLi1gNnnLMM3DZU7N6Euo94whTCpRs=@vger.kernel.org, AJvYcCVsTErE0hogwilAdJhytGYrWURtYsfRtjUKCcnsU2SrVVWZwKaHNKWGMG/VUUl8iPMS/9icnm486CM52w==@vger.kernel.org, AJvYcCVtwfOdTGlXouetPHQJYPlkAIf38PsHIUos1eQesNeq4T5Q1W328zQH8NUBA2OuzC60njVkI77NVjqy5XM=@vger.kernel.org, AJvYcCW2A9N/d7+0vOjUatztFaJE7yp59D62n6egAxSoKfMdlr56hCkZHhqHIu5YTfJ7InVVt8Ub+uTdry2T4eI=@vger.kernel.org, AJvYcCWGYaNMMDd1lTvRxrG1oNLwVKGMUKjKU2nFWMERptMAF3AB1/v/Yq7YYRPB2xnP9jd+df6dtzqJrQGd@vger.kernel.org, AJvYcCWfrB3n5nm+ncxsfOXRX1oYp5eJThCNZkIlKK/x5Vxgpjeu1BCZTxLe91GTUus5vAN4EN5mQm/NdUw=@vger.kernel.org, AJvYcCXFUzaqAw8ovKNkFStxMCEwyEyhmmIQlPv6XY3myyRvJUvPjL2kQNltxO4LFpOJJAlubELGzm6cHnQL@vger.kernel.org, AJvYcCXtRBLF+pUp3oOnJ9HAnL7tocH43sOOR3jxkGcifeSukxtj6wLp1A3nfn2TW3ITgIHZNZ6Sr7FDKC4Uhzdj@vger.kernel.org X-Gm-Message-State: AOJu0Yy0VBr5fvR/QEQ2cWJZYi2kOYqGOgQZYgy3yTi/0Gt4HBHctigz MCFbM9gGQ6myt7/AiExZ+2IBqjqb57hb7nj54XxYytxql2X/p6sIimfF X-Gm-Gg: ASbGncuIiqFf5V2tesP4kVUxuPNiqch4Sn0pxSBS9emNvaeNhiB1VUur3Z9Z5zL2fk2 SlmqVJr3+xs4pCRcuqLCmCDDMMmGgokiVQoFlmZRQEiHiG0lSfFSANjinz1/p8KRyuRdit7Orxo h/REQo/6MvoerpKXQdupSNgjHvyRHR0nzaJnLUye0hP1NTP2BcEDXQkYc3cOYDciyO4RhnI0N4Q QVhs1kTxUyEycN3Ll7McmgaQzeDIP65zfkZmOdkJdrvdNQsOeu1LzJMBzVGc2PvUzABa8lXEhiK O57f2ke5n/PzzeuxAPsJ4z4o1d9OPS/B8v+RyzfMDrulzQHcdonKF2ub8D4w/m3RutnS+J/YwV3 /ldSAfK1TvLFIVBSyaTwp6XXoEQ== X-Google-Smtp-Source: AGHT+IHubWrsefo+d87orOab1DSwsve/ArB2W06/xMLWCSAZ2PZ8eNr96v1SI6ir/qnxEBjX+/LG4w== X-Received: by 2002:a05:6a00:2d16:b0:76b:f0ac:e7b2 with SMTP id d2e1a72fcca58-7742ddadd68mr16640975b3a.13.1757472247852; Tue, 09 Sep 2025 19:44:07 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-77466290d84sm3499051b3a.65.2025.09.09.19.44.01 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:44:03 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id C367141BEA9F; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 09/13] Documentation: filesystems: Fix stale reference to device-mapper docs Date: Wed, 10 Sep 2025 09:43:24 +0700 Message-ID: <20250910024328.17911-10-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHniixbj++M2M+e9AK28XZP75VaZfxL/rvM//ttckLa 3oE7/o/6yhlYRDjYpAVU2SZlMjXdHqXkciF9rWOMHNYmUCGMHBxCsBNZmb4p1i8uPKB8ZP13wum BPvKxR5SWdltK/h88a0CIW7J/3IPcxkZtk3KCLwZnfbq4QUbicP9bC8vlyYEbns3a5pPVM71i2f ecgIA 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 Thu Oct 2 22:39:56 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 038FB18E1F; Wed, 10 Sep 2025 02:51:54 +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=1757472716; cv=none; b=WparGZMHHMYkzm05ot/r/O4ODrIByuyFqx65TRZ+mDxm5ifAwAkcqdHHQtUdJCPOT3uBIRKCL4Y1AlG5wa74oewwnFbQai5DF6XAJaCYgj2ojG7sZZtu96dnmGDDWlsSIwT3ZflhX7JNeMBfFxD8JFyIS+bbR/Ynt0W47FKvofY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472716; c=relaxed/simple; bh=tVZea1ikNA4Sssls4g09ZchJ08JhUaFOY8Mmt8T2Tzg=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=XqFo+3vq33886BF8G+1q/bhCohFKDgRs8vQqOdp7M0NwBFztrjI9dgffRgicgg8xYQZyR0wAnqtrXAMo0spGAKcw2MmOiyW70VclhXHRdaOptL649oZHeI1xru25b5mAYZK90ThvCXHXrniKAbzHbna8uE/Fg+qP+9C7cFZxx7A= 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=ePK0tLeI; 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="ePK0tLeI" Received: by mail-pg1-f171.google.com with SMTP id 41be03b00d2f7-b4d5886f825so5462206a12.0; Tue, 09 Sep 2025 19:51:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472714; x=1758077514; 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=ePK0tLeIfyWg+w0tLYe5RzjkEOk984O6vaQj2Ogl3s1fnaCFWmOZVpy4MynXp79iAj gosiW6phrYFA+hBtBdgUDb3rYKwGk+jDEUDGJxAAsBWSrMd32RTlxZpLE1i9vu2qc9W8 y8v+84AzSf1UuoBRE5be1fviiK2ZD80xB8pLnafZxOzVRGrq37Xn7lQPphWWW8dtSk7r pTAvy6ovBvyA7241Q2ZnSYE3N2FJBm4+CC2APF/oCguXjPnHwgf04Aca2N2gC8cR4s1j gUU43wPKdlnArDdbHXTT4/YZJQiex4o0gs6bW9ESvcCWEjhturFVJfvVnzZ9YToq/ATW Ihug== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472714; x=1758077514; 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=mDtQ6woxrrcYglMdqWscYXKNxq1MrTOMahxAHsi4UaDdS4FVWJwq+8fNEorwslaoy6 qEGD1Ys40woVtfzRNIxQI/tHLZVlLEomO5AG5Xt0cHuoR5AgI5QBUaJcuDdXAYzvnYx3 S6akgbWCdrujCFq2nC/hEZXde358lWB4C+X31uQd28x1DC+ok0rYdxJbCk/XUsFWohuF 6BQpQhAdKqCp0mzhgjJWdD2AZpLfTBfXvvnwNZJf+psFLtvHNiGCj3xtcOA2Gw/vgqTG izB+T8KQ4c414n5exOYGS4UR4jXAboHSJdYOwz53RrHpe4Z6FNkarH86SBiYceQukEyn vqtA== X-Forwarded-Encrypted: i=1; AJvYcCU17hUZ0A8eugphDdkkC9Ryrw9bbPpA6rAtkC0tKUAVrWz4udthjC8dVHpV00bNCE7L7qY4VRfo8zYA@vger.kernel.org, AJvYcCUAmugSV/EWnMr9U2BL038PmZJndLj896lU9erGwIiaE6z5hfzjqmGdi9PJiKG+q/M9wSM=@vger.kernel.org, AJvYcCUg9vW6DDBFJ4TftRcplYHAVet7mkSxSfwOxd0S/h6F2LHHikNGXKKaogy0QKNQZsvAzRgAuOCc@vger.kernel.org, AJvYcCVUPMxDtTnPZnsNsMqtL4or8JrlzpPNyK+zg6RYvT2Y6EdD4LJdQR3tEZ4dejMDmLGoMY8h2Gt/IJRKvkBN@vger.kernel.org, AJvYcCVdCkwyGjpuosk2SNvvJUxxPB3y7tSxLnbByI5A2nIN9itYXfOP54v/3orSHX+nvm0Q1oUOCLPolzlx@vger.kernel.org, AJvYcCVn8r3E+5mD53woC23XmzjbmOqhrO3s6SNNsmyxJQa2KRhwKxvRBK3OA928sbXQ6iVJTIyLR3nbjQu4JQ==@vger.kernel.org, AJvYcCWk1VtxEnMwH72Gd8RwRArqZHgiDMbeRXfXjuqR8iQ37Mz33klXWGkFFWan9McOXZdhYka85AiNqnjop4M=@vger.kernel.org, AJvYcCXB0VoWrh72hEF9mrd7cgEmd37a8FMBetRGVnKFE5GILEv1VxC+QeJMASg3W6drqJ1KN0tdX4Xr4Lk=@vger.kernel.org, AJvYcCXabhnYkSifO1fOAxES4W5PH3C2+AsF9zEOxQKEjjrCSyDSe6u4lB2vn3xXO2tLNyHJwZQl7IUAA9qSRkw=@vger.kernel.org X-Gm-Message-State: AOJu0YzB6CY0ueUo71Letzc1QwSFSYwVUvwS+XTdjGc4anPX4o8oOxm8 ii1aRBT53sOa2p1vDGnJtpfoBCkOIgcRx8hK28+VEC4QEqBQX59sMcy1 X-Gm-Gg: ASbGncuENZ1fbTmv5iYpxolWk6ayl4gxAIfR2DQp7UDcnUbdWNcG/5NNnZYop0mCCGD mMUTVtmx8ER0R9KygyJ0kgqUSjbLKbTUBH2C0G0Nx7GXGk66c0X2nVvDdKFgpJED5oNX4vqCuZW eMn7NjI5+hgbDrpBBGmnwML75wAv2TKCoFoqdEBehQ/igXfajEtXpkrTgESNGXxlO+7OX/UN9B1 B6H2H4iLAlAy/hEwIKLPIy6xSu8q5wKhJ+AA6E5c9xrkNgpHzlwqSnirtWXtOFQCruGsopf8+GW 7I3t2lApGYTHdx7KTvnMLx7k3AUjrOsMomS+yeQKHFrKm40Ihz7o+XkCuyP2gJQO0c5xAYv+c3y d4Podsl3JygGdEn5l10Xk57tlpg== X-Google-Smtp-Source: AGHT+IEB/m099LrAl5yQVt4L0Nzl0jupOns8XwrHabjqcwIBBCUNyigNNYELdZPt4mBJxRKyTxzUaA== X-Received: by 2002:a17:902:da82:b0:24b:2b07:5f6d with SMTP id d9443c01a7336-2516d818031mr154485025ad.9.1757472714167; Tue, 09 Sep 2025 19:51:54 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-32dbb032dc6sm679647a91.0.2025.09.09.19.51.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:51:53 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id DC0B441BEAA1; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 10/13] Documentation: smb: smbdirect: Convert KSMBD docs link Date: Wed, 10 Sep 2025 09:43:25 +0700 Message-ID: <20250910024328.17911-11-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHnihVZXUEfpV/XXVSre/C87lNIRyCV5IjnItu7ShZU PiphvtYRykLgxgXg6yYIsukRL6m07uMRC60r3WEmcPKBDKEgYtTACZych0jw9MiYfOuPx0mkkFP UiIWTa/TFphmY/DisofsPrHQd/6Zwgx/paxTd1xaG72+5ivH8bnS+nm3e6W3try5uGL6W3UVsUu 32QA= 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 Thu Oct 2 22:39:56 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 863BC1DFD8F; Wed, 10 Sep 2025 02:51:55 +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=1757472717; cv=none; b=iZ4t2BnS6r2sKO2VzSri9VS0fRgtA8HgBIcueePvajMnxCOUXCAkkrqo82632Lu7t2g28AoCN9HBgeFELUgxl6xpN1V/nKXIKvTp0+u7kxLzKMbLXklpU9/6pB1Cp5KsiZGaDcqSTnPO4rvHEQxziz05c2W4hgEolTm5Hi824BU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472717; c=relaxed/simple; bh=3KTOccWMzr8DxZPfBNk641Us82FbHT4BEw3lrJOsNTs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=KAfXIW8Z4+vbcr4MpkSF+NXEhFi2G+ctVBn9VDNrSX5Ods06yL0oJRKp9zrYQnh3KBu6NN9iXuTV9x9lClq6cif7NpoquZszIXpbcnIb8ioAbN5RL2yFXFBYsczgoMv2vca44CDC7+DOOt9RSeQPrIP+ljY54McV6VQCepqeExc= 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=OdsvlRB5; 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="OdsvlRB5" Received: by mail-pf1-f180.google.com with SMTP id d2e1a72fcca58-76e2ea933b7so152237b3a.1; Tue, 09 Sep 2025 19:51:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472715; x=1758077515; 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=e2TiZwTLryn0Z2XdO8OaBNvuenSuTUZNT9oHE0TAuq4=; b=OdsvlRB5HOQOkeknasjsr2yiiVvTu2iRfA/by2SOvpU2cGvvx1Pl0lr+xgm6zNEZnW q2v+cOh2Qk2rhQ5umxIzQ19I86OqkXpTJeLb905nKp4+VWSC6PbW8OkeaIHJtse+Rplu pzORfpg81ajsy/wou4Ntj+fVVPKMDUCYVtFJSd8skWkx/sBI5A+e3U5kbgl2M7Ch2JUn kLKzpeqOMcuC5CrUA8OsA+hoBCaou8tFy5Lw66fFY29C6R8P1mySS8setxcUoQQ1tjpA xbF3ZJacTsiqL0Gjcrk3/G6kpJBD+GFWu6wzJyiSVdamg89bxeLLEDVR7jVH7sXuWOPR P/2A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472715; x=1758077515; 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=e2TiZwTLryn0Z2XdO8OaBNvuenSuTUZNT9oHE0TAuq4=; b=NyG0zRqzn5Wm3wJ2b+5GizEN7XCXB6x/sahPk3W4cD8F7uxkOYT6BbNr0DH7EhptBO QLftOlnVXt+B6GFUqrGdticvQD2Ll5zorn2hu31ghJVN2op/6v5NqLEAQQWQEn27rZCX qqq6q1rW9vV0WPfJbxsk31a8uzZFlROAbgXZjMce9qECs5otNxWdEwI5k27vV12bzk+x gQYX9noonEZcOIbCAKtjijqnPBZuHO1kGbxRcuf+ZjsdF5hZtnU4BBkLvX4TvawvyHZp SfsJLjQ7b6qcuUB5sJeIwxn0qglaT5HiVdBG6SnXue6doX00RlmOSWRGqsmrn7zcmrUg ov2Q== X-Forwarded-Encrypted: i=1; AJvYcCUIrWvx+UPqYe7SsXQIfsbIt4LQ2BrGv1xX3sBDcmYludFzeyG3i6rjuFk+SGNjLb144tBcEhSg96oL@vger.kernel.org, AJvYcCUkmVMzYYcgcCug/zJ2iF9yiETGuRLIOCSEwpUCBC5BgJCc+8HGPhhPntulCZaTaiO8YKLVn2UoJeQ=@vger.kernel.org, AJvYcCV6XFLBieh/v2nG2cbeReaxKuEff/NPPxHWCHqAV0MKs5NzVD8CB8Ab77oWKruO6PHaDB+rozF2L3hjpVc=@vger.kernel.org, AJvYcCVbEVq3eiqq5/Xe0xMNQaOgIrFdEJFm2IMPGYydd8wdH2gegEBhBRiGZtq+8rbTnW5crL/fWvNbJdcoz/co@vger.kernel.org, AJvYcCVnasjWXdxqdHMEcnXz6XmVR9hajXeDbhvHVmEkMvTt2rUpqtj7vesN0t2cBDVtAQgaPjx+0zAl@vger.kernel.org, AJvYcCVpitWN7tS40avVubwTnlL+s+hehfQ5ydrI8amSQ5fNf8PVc39COYmyIo37gIojnIJFkrw=@vger.kernel.org, AJvYcCW0VLTac3ELBXEBio4RauJ/WwHRtgWqphh3xV+IP8CXTGTb2KOkJ1H4pfHWzqZk8MMyx6+Yt5BiyrV2ghE=@vger.kernel.org, AJvYcCWgR3DcXl7aSs/mqCKb3yo5d9EM72TyNYo2BKjpZwlohy8OSL7GyiPSuOAiu0imeGyPozDWb3x4l0zJ@vger.kernel.org, AJvYcCXmSeCGS0mbDbHfA8TX56c3Y48PIw/3KPXee3SKL0g2//g+YyZnP6yWGdK/0PBGwJlJS+vbS6+PjXZ68Q==@vger.kernel.org X-Gm-Message-State: AOJu0YwEP5GU5fz8M7ignn53vwvMAajpehQrlkdueM04+13h4N+VEG/r g76rE/68jUHxLA5IrdXGmdkBmF24Ao2GVEelVB1SOhRNXlwUQXDsR3pY X-Gm-Gg: ASbGncuGVdVl3Ih6nBRXgfkxp5IstmIMhAE9lY5JNQ5JQji10fq2OSGHfcCMChe8MFT OM8uEn8S0xvyeFiKSalnt3Dj3xusDnUuiNGKPiOxWdPoOtyodGR3Z7fZlhhjTFaIF4Y9muG2P4y GPzty9mwHPbyVYnVYMvwbCXrvbeISv1eN27Uc3HGs9AUB/eERobPWYmv0/ovGv+6bmgjyACLngj GRoD9RVywOi+PlstH/cu6GnQ18eSbGtzdqapfWnfqz/sZjWoaEl0tqQOMPL+5tV5Nq/lG19NW3b zDqtYg8kIlhmwPq4q9UOgxcQhhWD7oFLemqoqHjW+P7Sn/JBesoCLUk1e5LWkOUAu9bcC2DtS8E pdaf1F1QJok2Uq/acL7MpLnkak+sloBpH9GZy X-Google-Smtp-Source: AGHT+IFTyhfnUg3CqVtgOKW3+2pEfzFWWNjw1TnoTWF2WDPCy8Lg+0w3QYglyJRg7NnUo5SJL/6TsA== X-Received: by 2002:a05:6a00:882:b0:770:4753:b984 with SMTP id d2e1a72fcca58-7742e4bf142mr18186197b3a.16.1757472714666; Tue, 09 Sep 2025 19:51:54 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id d2e1a72fcca58-77466293757sm3470498b3a.63.2025.09.09.19.51.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:51:53 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id F395041BDD47; Wed, 10 Sep 2025 09:43:52 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 11/13] Documentation: net: Convert external kernel networking docs Date: Wed, 10 Sep 2025 09:43:26 +0700 Message-ID: <20250910024328.17911-12-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=4165; i=bagasdotme@gmail.com; h=from:subject; bh=3KTOccWMzr8DxZPfBNk641Us82FbHT4BEw3lrJOsNTs=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHniglPN1/l+G0b3W08+an+40OlbWa5hi83XTh+GX/4 C8C1xeFdZSyMIhxMciKKbJMSuRrOr3LSORC+1pHmDmsTCBDGLg4BWAiBZEM/4u927OPq/vretv+ eb/f6YB5Kk/Laj31K1IKboVhiko7uxj+pxYZGDy7rZrM+OWh+Y5vk3hP+ti0xKVJLGg67/x7TvV +PgA= 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. Reviewed-by: Arthur Kiyanovski # ena driver Signed-off-by: Bagas Sanjaya --- .../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 Thu Oct 2 22:39:56 2025 Received: from mail-pj1-f46.google.com (mail-pj1-f46.google.com [209.85.216.46]) (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 88E8F211A28; Wed, 10 Sep 2025 02:51:55 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.216.46 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472717; cv=none; b=eMb+dy8RFsB7AHCFp+vpBRr42MmRGdYLOXTw52J2cTUYxde0oHOs4BZkZ1fAtr7+ed0Kxlf+zAwq1mb7NIcWTDe20KEfxvoUfwCRzkvDxbzoHVXxQ06deDzvvvG+p1QTBXCWt3cQ8eL7DyMIc6SFfbV6PH2yXJjdBWASGL3D89k= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472717; c=relaxed/simple; bh=evrdLEAoXKuQzTljW81Kh3KyWLApG8gUObVzJ2YlNgE=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=lQ+6pmBfdmvQ+kBJEIu7MNAtWfjwBYucoYGIsoUZmfye1yCax1et32KYWyqXLm1Xbfj6sm3NWtFAlJXHvVryxiJc9br6dydjNe0ffTMwnGfl2rmHavXR3OOhUZD7MOiykb+HWjLhwEVzy7IriDwPoHxOXBlrvPT3l51+6bHXoT4= 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=kdJpaAiP; arc=none smtp.client-ip=209.85.216.46 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="kdJpaAiP" Received: by mail-pj1-f46.google.com with SMTP id 98e67ed59e1d1-323266cdf64so5476763a91.0; Tue, 09 Sep 2025 19:51:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472715; x=1758077515; 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=kdJpaAiPROWhYOkySJUXyPnMg3ALshgV9TVcGtiw+Ltr3oT2i/piKXtosp35L5TgT8 KiRiXC56wyrj+MtmCsLQ7oJ8ACYaZ3rJ76Ffcjt9j7n8tqjp/SzCpGb7e8X+3OxTLqi2 VR0YBtsBpPTqUMGz9H7SEHnxFmxpdvNbI6WF/xxqPkXwb2JoX5GYRbHZVHpTVuep4KFI vZZegZtaeQ+k7QM/Wl31v/rFlX6+HToo2JNzqHBJklFDXfnsY7AADhGD3ca8YjqB3OMw MoLBpRfUN3yuZlQ0U9ylmq3k/V+JFG82aplaebUege4YnFf2KS7ejUvlXAzSeJ3NaqHM 8sUQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472715; x=1758077515; 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=SezoKR/86e/3HIlIVhG8nNa71Ic5gVxevzOhRbLvFP1mOxlG+aLFa2KCmVlyjjssaZ cK7klyMk3N2LKOW+3soU8Q/m9QFToq+LZoUsdBqsaSbDHgBv1fI0m4QdzfBB1h5CBqAJ q2d63RDZb0WlnbGZPC4gSPQCSQEMARZrdSWybERqlBwkrHM0RGTGi9aSeJYvYCmzAyVe M2GiVMoGlP8s0AuMv728eelO6VwB3OI9KCQGZgGQIkNDQZ3eEJNSfm3m9UOExyrQkHeD 9OUUJOcrZzvRKqF3L53jAKLkWAK99AFAxkzVW/pS9Jhe2pUffy8bxNvN60KqnRg8Wz9s QYng== X-Forwarded-Encrypted: i=1; AJvYcCUVVZogjeP1AAIvfggrwV71fodHhTTbQ70GzRxCiN9V8aWnzJ/tpin0QSMn3v3gZkZO3IUH1j9C@vger.kernel.org, AJvYcCUWgOfi8hJvd+5ywPmHDYDVk04FqKww3ulduGaa9nFB0Te9Dw8oGQRmuC7NhTEuDrGX7Z/biv2Qu9eMe44=@vger.kernel.org, AJvYcCVJx7OIzc6LKzOp8IDzc3nJ3zAjp8DIXYfFO6EDZbYkZa+x2t7+I5tpxWivw+up4Y/GpAcGa+JVEWRN@vger.kernel.org, AJvYcCVSjyQ0N5SeKLqsyNg/c40PdL2xYW5wHEpyIK83fZA2B4yUCc4NFVTgVAA1OFMqg7+o/qCYYT1WyTj/bZsO@vger.kernel.org, AJvYcCVW3AEncqy19XzH1caBvcYIjikHPfN6yTREcFxqkjyvhG89MjbAnauEVyksFwxfEdh0jLa46gtejqbQ@vger.kernel.org, AJvYcCWMnO5uGB06d3eyWjPmHVQjLX+Ft839eVD7DQp+DbS9TPvcFOXrMaraSApIeZAZQm2nGo6cxE7z0nY=@vger.kernel.org, AJvYcCWpJOI7SIoXA93c10dIkCakmlddM26GXd3Y+W80qeri5bNil3MgpJ9UsbkdIbUOhXRlaYOmwSPEHV4BpGg=@vger.kernel.org, AJvYcCWxAGa4nay8ler64LQHe7HS7+fECvaHBufPlYgVnTOsVCSj5mwTrDInoBHe6SqCSbxioIw=@vger.kernel.org, AJvYcCXGQUqyyfQiFzL5usUN76Tm4gtWsG6M10BYh+kSweY8qXEPd1ynRpiCySJzgqFYOcsfdc8O26Nk5ac06Q==@vger.kernel.org X-Gm-Message-State: AOJu0Yw3JT0X48y8E0QN31N7LgLhmBLQ+5+KGLyjmRtcaFN8h8Fa2kBE P0DR5VGcnyhsjzaJStLaVt6TYAsQwVAwlRWb5Z/Re/iM9ngq4ah01Z73 X-Gm-Gg: ASbGnct0vVG6awdMmKZdCMl7AYIlu7XXV/B9duAOw6LIUheF29ZHuZs4ViCzA+66MTB w26TdWQ97zeeMluCWqFq+KK/N/oISNTly3Mlf7EDhaakAOcNj69M2XyzA1jy1kpvK+ZXLNnsxlc sj3Lf/6hsnFRHmQsXIr+iZos3LYrtEmkepZ4TnkzGHLh62Rf/4Hvr4k2QLAU5oSkZXliZAVvntw t+vXxOmbfda+HFMjaZ1lMR6IeN0TogUwkHGO8To4MlPWTAdOEhcVdiBxGdJcpIuwout39Gax/GI GnBloMt4dIuXCRyo1n0chWKpqhDwW1+9SDnkvYt7cNlVxhzSDW6LZprsbvCaIRq2lYA0X5bvs/L mIofpvo7hQXLw80+WkgAxDDhybdEPiB1FIj6w X-Google-Smtp-Source: AGHT+IHumoKCl0BwECrl0jFgQDm+a5TPs08x2B/wSLqiGEG+ifiNXW+7jwodpJ99kFpH7Ms7vygGwQ== X-Received: by 2002:a17:90b:2b43:b0:32b:5195:d119 with SMTP id 98e67ed59e1d1-32d43f04fc5mr19535835a91.12.1757472714800; Tue, 09 Sep 2025 19:51:54 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-32dbb313dbasm659049a91.5.2025.09.09.19.51.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:51:53 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 158E941BDD48; Wed, 10 Sep 2025 09:43:53 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 12/13] nitro_enclaves: Use internal cross-reference for kernel docs links Date: Wed, 10 Sep 2025 09:43:27 +0700 Message-ID: <20250910024328.17911-13-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHniiL9usWFB1WvT+NSavLIanh+698vZJvp5Iqyn5cF Oeb1Xiho5SFQYyLQVZMkWVSIl/T6V1GIhfa1zrCzGFlAhnCwMUpABN50cHwvzL4D8eTgyE89fse HlBVStE02WjOOvl23fZ49/PHUnNONTP8FYh3YzzAeWbK5vj6FqvtSXp3M3+Vxhz3fMrXXv7oQq4 HPwA= 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 Thu Oct 2 22:39:56 2025 Received: from mail-pf1-f172.google.com (mail-pf1-f172.google.com [209.85.210.172]) (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 EAA44298CB7; Wed, 10 Sep 2025 02:44:11 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.172 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472256; cv=none; b=LhN3NfHNLUQ6OGbCa/NpVuC4Nsefz5DMVXfCAVZ2aaKVxZT5K2l9oYyrlF4u+di7//D7XqgZX1w2O4qYVlHRT8p5xVWRxdg59cVNbl1FJVuUch9BwXZGl4fUQVv+yy3f0qViEk5NnAjLw8FfFJ7+Duj1RTLp57gPQ4INu4Oy/2Q= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757472256; c=relaxed/simple; bh=MXABwK0i0SCp2hQDcOsmX0P1tGCerPOJp0g33o7MdJc=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=bq6e6O3jH1giXLbYphIctLPs8k4ogHFpyuJCS0Wsj0rUf4Votvo406TsHodL9D0tDjrMThSUTyfZR7hEJnBuhdxJGqHlc+d+V0th1E9X1CVtQGhVZSuxelpHdROwtPBP3qDAWAf+9avYZ8Hy9uOrByhXGwy62WGvINOrKDjqaNU= 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=GnGKh6Pc; arc=none smtp.client-ip=209.85.210.172 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="GnGKh6Pc" Received: by mail-pf1-f172.google.com with SMTP id d2e1a72fcca58-7725de6b57dso7269321b3a.0; Tue, 09 Sep 2025 19:44:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1757472251; x=1758077051; 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=dgdemV9KYgQVQ+LAF8Hf9jr2yRR4WgfpLkTtMfHQpEY=; b=GnGKh6PcANrvlTyaOM9akT60RB18CS1zKKdBz2HumU+NTN8iYE854k5afNDP3ih0xD f7iIJfEj1Ycfl+vcpJMBLVPSJF8xPBe+mfauenjIJLfJdV7xqk/u/hPCBWJfYn1S1LcQ BKoaf7LxFTtdfzN91CTLyCUnwmzWArtAEzwUqhnxwDrsxrbQXQgrgGT2kur4Lylny8Mc ipoD6NGfU+LJZyBp3sdQUmSokWzEhBAD11Tc6dwqYUNj38ED6XeQFzyqQo2Um8CyE+61 TFDDiu8MbBK+DzPUw6G5Lbe/dPj5khNav0L1cDuGDT7WdteqAX6Kr/CV0IWhCzOVz9tm /CkA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757472251; x=1758077051; 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=dgdemV9KYgQVQ+LAF8Hf9jr2yRR4WgfpLkTtMfHQpEY=; b=Sm0eqMgLksLnUxqGfRWH/D2U+NsEbrQyLBw5se9hrONG4FlO6C8q1IKMUx6n2u8I1X OdFfL2Rh461kipJCpRQWcjCloMo6PZop56bMP8yHm3CSZDk4UvUCSyoLxZ4ATRFXRG1c whSPfAeW6Tj8KWRqbbXRziQrteYYi+WU1yrdDE+Pu8+1iLbC4jJDqtD8TNUZtiirVmVb hNKqxKYONL2fuEXQrPsV68OBmOUT9Yq5cUoV6n8/XBHo0m09VCXGozyeMjeFHNgZaLdp UfY/G3OZuf++Bq6pJnJStnO5mfWfFD5bu3P/3kU01tJrwPgrYCr7AU3qJhOuhVcXjxmY BRNQ== X-Forwarded-Encrypted: i=1; AJvYcCUtNSm0DVx5TQdpoP9+VNAbbqQIX9xYbSAq8dGmBo6qZww2nM0DiQUYAz1ozVG6keql5nwEtspUFY/hiHg=@vger.kernel.org, AJvYcCUtdsnw9FVd0QSMwZr2eGYdLuJ1obpRKAKY4D8iGPOYP7H4PZ9vsODkMF2idP2MRcNgXH8RGZsM8V+ZLw==@vger.kernel.org, AJvYcCUu32syl6xKEYcenlRCYl7kUoTVC910+gDKu82CQ4h2Isdnl3HlWc6zdtsf5x+oDNwWfm7zVkWI5U5m@vger.kernel.org, AJvYcCVudV87hmU6+WGpAy299fXfsFbI5r/Pb5DNZNPe+/kNa6ko62bI+9FJ6kcVM2fzLAZ5oTDYZ31xbno=@vger.kernel.org, AJvYcCX+xVNs7eJOkuWT6fLbHg9Plo5Wr6hJAqTQxU7t6iqVxaCZahIypH76p/k0cdCDnjE4lXn32lHDk6eGcJpk@vger.kernel.org, AJvYcCX8TICgp0kYLEkIicF1ClM6qfxQCjnADIOYXZKuZtCqPTppK8BDb816Wfm5yF8ylPsEfJ3rREGhbWqZ@vger.kernel.org, AJvYcCXSdo0Wdciv80TmwB2PO5BQkshbiqfTyxcf5KeQnJ9CZNrpS4bu0GeCj/pc1cbr5dpR9ZfPt4Lv@vger.kernel.org, AJvYcCXTnIv2IGh2MyNW6DD4hGSN0NfLlgCsvcpzbCk4GqlJICvJUdM12O73ArbKq701N5uOf4k=@vger.kernel.org, AJvYcCXoHID4dpIOPRC+V+F0gjwj3l6FpTf8FAj+hI6IUf4pfk9UMtJ/aCCJ5N8dgfjz9kHZv4mND604OQBdHQI=@vger.kernel.org X-Gm-Message-State: AOJu0YznCE/TEnZtMs6oqvf60s8GEUg31VsB4JQQK7jrlsQszEl8yiUc YDu3jDqng6bxbbc5xsD0lutGcZ8QXnYHxjrU26L53qy8Z6TwnI93spDR X-Gm-Gg: ASbGncu4bUAgv0mZ4v3FXqzVxeo+WV8yh2KIu+tTNEaltnXy3BFpF1PV2mT8HDyCHgZ GqU44GuRs6gJLSqOd5BB6N6DVwNzpl7QHt7Z0Dzxdk8CIG43Iwqj8Q81L7zxk6LwnFlIf5kXFEU /ewQkwigalRAIYC8LFDpwKyJyWqAvMI4w3gN0M6PzPUvmocxOmycvpyVIGiJxbyR61dpCLFmoXO 1JbF+kaWFz+RrM6PyASor72/h2bZaVvkkNX4bEH86txtgpnpRF3rpLe9Fqr3lQN9ninRj48QS2+ T5JUXkW1YK8GdSNY8Fl30dhK5PT/gM6lKapapEwwlvTgsBN2rqf1184DheF2fe6XApIyQ68SQgA RsUhhwvXe04Zf4pWxhL1R0L4IYg== X-Google-Smtp-Source: AGHT+IH5CpmOeMZST4hHHyRGqFzL6C/Mu38vAk4mOqjEouYqk2tCEvsj6RsoOVbJEKBP/4bQCgHfYQ== X-Received: by 2002:a05:6a20:1585:b0:24b:954e:388a with SMTP id adf61e73a8af0-2534557a4eemr19004415637.39.1757472250651; Tue, 09 Sep 2025 19:44:10 -0700 (PDT) Received: from archie.me ([103.124.138.155]) by smtp.gmail.com with ESMTPSA id 98e67ed59e1d1-32dbb47113esm638776a91.24.2025.09.09.19.44.04 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Sep 2025 19:44:08 -0700 (PDT) Received: by archie.me (Postfix, from userid 1000) id 2E07E41BDD49; Wed, 10 Sep 2025 09:43:53 +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 , Maarten Lankhorst , Maxime Ripard , Thomas Zimmermann , David Airlie , Simona Vetter , 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 , Alexandru Ciobotaru , The AWS Nitro Enclaves Team , Jesper Dangaard Brouer , Bagas Sanjaya , Laurent Pinchart , Ranganath V N , Steve French , Meetakshi Setiya , Greg Kroah-Hartman , "Martin K. Petersen" , Bart Van Assche , =?UTF-8?q?Thomas=20Wei=C3=9Fschuh?= , Masahiro Yamada , Mauro Carvalho Chehab , Jani Nikula Subject: [PATCH v2 13/13] Documentation: checkpatch: Convert kernel docs references Date: Wed, 10 Sep 2025 09:43:28 +0700 Message-ID: <20250910024328.17911-14-bagasdotme@gmail.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com> References: <20250910024328.17911-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=MXABwK0i0SCp2hQDcOsmX0P1tGCerPOJp0g33o7MdJc=; b=owGbwMvMwCX2bWenZ2ig32LG02pJDBkHniifDTt+7KfV93lzj9/UmiHX46Vxep/YR+33Z39t3 TVtwyU2xo5SFgYxLgZZMUWWSYl8Tad3GYlcaF/rCDOHlQlkCAMXpwBMpIiR4Z9BbEfFppPy21Mr IpLu9zjPf3w1I1814cCLmzM05Rd27U9kZFhjOT/T7nby9gV/jrG7CvuWxxwx6nisFREuV/JNWc0 4kg8A 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 191085b0d5e8ea..7de63c5ce58fbf 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 5778cb9701e14b..387ccb760e1ff8 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