From: Bagas Sanjaya <bagasdotme@gmail.com>
To: Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
Linux Documentation <linux-doc@vger.kernel.org>,
Linux DAMON <damon@lists.linux.dev>,
Linux Memory Management List <linux-mm@kvack.org>,
Linux Power Management <linux-pm@vger.kernel.org>,
Linux Block Devices <linux-block@vger.kernel.org>,
Linux BPF <bpf@vger.kernel.org>,
Linux Kernel Workflows <workflows@vger.kernel.org>,
Linux KASAN <kasan-dev@googlegroups.com>,
Linux Devicetree <devicetree@vger.kernel.org>,
Linux fsverity <fsverity@lists.linux.dev>,
Linux MTD <linux-mtd@lists.infradead.org>,
Linux DRI Development <dri-devel@lists.freedesktop.org>,
Linux Kernel Build System <linux-kbuild@vger.kernel.org>,
Linux Networking <netdev@vger.kernel.org>,
Linux Sound <linux-sound@vger.kernel.org>
Cc: "Thomas Gleixner" <tglx@linutronix.de>,
"Borislav Petkov" <bp@alien8.de>,
"Peter Zijlstra" <peterz@infradead.org>,
"Josh Poimboeuf" <jpoimboe@kernel.org>,
"Pawan Gupta" <pawan.kumar.gupta@linux.intel.com>,
"Jonathan Corbet" <corbet@lwn.net>,
"SeongJae Park" <sj@kernel.org>,
"Andrew Morton" <akpm@linux-foundation.org>,
"David Hildenbrand" <david@redhat.com>,
"Lorenzo Stoakes" <lorenzo.stoakes@oracle.com>,
"Liam R. Howlett" <Liam.Howlett@oracle.com>,
"Vlastimil Babka" <vbabka@suse.cz>,
"Mike Rapoport" <rppt@kernel.org>,
"Suren Baghdasaryan" <surenb@google.com>,
"Michal Hocko" <mhocko@suse.com>, "Huang Rui" <ray.huang@amd.com>,
"Gautham R. Shenoy" <gautham.shenoy@amd.com>,
"Mario Limonciello" <mario.limonciello@amd.com>,
"Perry Yuan" <perry.yuan@amd.com>, "Jens Axboe" <axboe@kernel.dk>,
"Alexei Starovoitov" <ast@kernel.org>,
"Daniel Borkmann" <daniel@iogearbox.net>,
"Andrii Nakryiko" <andrii@kernel.org>,
"Martin KaFai Lau" <martin.lau@linux.dev>,
"Eduard Zingerman" <eddyz87@gmail.com>,
"Song Liu" <song@kernel.org>,
"Yonghong Song" <yonghong.song@linux.dev>,
"John Fastabend" <john.fastabend@gmail.com>,
"KP Singh" <kpsingh@kernel.org>,
"Stanislav Fomichev" <sdf@fomichev.me>,
"Hao Luo" <haoluo@google.com>, "Jiri Olsa" <jolsa@kernel.org>,
"Dwaipayan Ray" <dwaipayanray1@gmail.com>,
"Lukas Bulwahn" <lukas.bulwahn@gmail.com>,
"Joe Perches" <joe@perches.com>,
"Andrey Ryabinin" <ryabinin.a.a@gmail.com>,
"Alexander Potapenko" <glider@google.com>,
"Andrey Konovalov" <andreyknvl@gmail.com>,
"Dmitry Vyukov" <dvyukov@google.com>,
"Vincenzo Frascino" <vincenzo.frascino@arm.com>,
"Rob Herring" <robh@kernel.org>,
"Krzysztof Kozlowski" <krzk+dt@kernel.org>,
"Conor Dooley" <conor+dt@kernel.org>,
"Eric Biggers" <ebiggers@kernel.org>,
tytso@mit.edu, "Richard Weinberger" <richard@nod.at>,
"Zhihao Cheng" <chengzhihao1@huawei.com>,
"Maarten Lankhorst" <maarten.lankhorst@linux.intel.com>,
"Maxime Ripard" <mripard@kernel.org>,
"Thomas Zimmermann" <tzimmermann@suse.de>,
"David Airlie" <airlied@gmail.com>,
"Simona Vetter" <simona@ffwll.ch>,
"Nathan Chancellor" <nathan@kernel.org>,
"Nicolas Schier" <nicolas.schier@linux.dev>,
"Ingo Molnar" <mingo@redhat.com>, "Will Deacon" <will@kernel.org>,
"Boqun Feng" <boqun.feng@gmail.com>,
"Waiman Long" <longman@redhat.com>,
"David S. Miller" <davem@davemloft.net>,
"Eric Dumazet" <edumazet@google.com>,
"Jakub Kicinski" <kuba@kernel.org>,
"Paolo Abeni" <pabeni@redhat.com>,
"Simon Horman" <horms@kernel.org>,
"Shay Agroskin" <shayagr@amazon.com>,
"Arthur Kiyanovski" <akiyano@amazon.com>,
"David Arinzon" <darinzon@amazon.com>,
"Saeed Bishara" <saeedb@amazon.com>,
"Andrew Lunn" <andrew@lunn.ch>,
"Alexandru Ciobotaru" <alcioa@amazon.com>,
"The AWS Nitro Enclaves Team"
<aws-nitro-enclaves-devel@amazon.com>,
"Jesper Dangaard Brouer" <hawk@kernel.org>,
"Bagas Sanjaya" <bagasdotme@gmail.com>,
"Laurent Pinchart" <laurent.pinchart@ideasonboard.com>,
"Ranganath V N" <vnranganath.20@gmail.com>,
"Steve French" <stfrench@microsoft.com>,
"Meetakshi Setiya" <msetiya@microsoft.com>,
"Greg Kroah-Hartman" <gregkh@linuxfoundation.org>,
"Martin K. Petersen" <martin.petersen@oracle.com>,
"Bart Van Assche" <bvanassche@acm.org>,
"Thomas Weißschuh" <linux@weissschuh.net>,
"Masahiro Yamada" <masahiroy@kernel.org>,
"Mauro Carvalho Chehab" <mchehab+huawei@kernel.org>,
"Jani Nikula" <jani.nikula@intel.com>
Subject: [PATCH v2 06/13] Documentation: bpf: Convert external kernel docs link
Date: Wed, 10 Sep 2025 09:43:21 +0700 [thread overview]
Message-ID: <20250910024328.17911-7-bagasdotme@gmail.com> (raw)
In-Reply-To: <20250910024328.17911-1-bagasdotme@gmail.com>
Convert links to other docs pages that use external links into
internal cross-references.
Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
---
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_iterators.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 <https://man7.org/linux/man-pages/man8/ss.8.html>`_ where any
additional information needs a kernel patch.
-To solve this problem, the `drgn
-<https://www.kernel.org/doc/html/latest/bpf/drgn.html>`_ tool is often used to
+To solve this problem, the :doc:`drgn <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 if the
diff --git a/Documentation/bpf/map_xskmap.rst b/Documentation/bpf/map_xskmap.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
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 type of
address family in the kernel that allows redirection of frames from a driver to
user space without having to traverse the full network stack. An AF_XDP socket
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`_ directory in the `libxdp`_ rep
For a detailed explanation of the AF_XDP interface please see:
- `libxdp-readme`_.
-- `AF_XDP`_ kernel documentation.
+- Documentation/networking/af_xdp.rst.
.. note::
The most comprehensive resource for using XSKMAPs and AF_XDP is `libxdp`_.
.. _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/lib/libxdp#using-af_xdp-sockets
--
An old man doll... just what I always wanted! - Clara
next prev parent reply other threads:[~2025-09-10 2:44 UTC|newest]
Thread overview: 16+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-09-10 2:43 [PATCH v2 00/13] Internalize www.kernel.org/doc cross-references Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 01/13] Documentation: hw-vuln: l1tf: Convert kernel docs external links Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 02/13] Documentation: damon: reclaim: Convert "Free Page Reporting" citation link Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 03/13] Documentation: perf-security: Convert security credentials bibliography link Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 04/13] Documentation: amd-pstate: Use internal link to kselftest Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 05/13] Documentation: blk-mq: Convert block layer docs external links Bagas Sanjaya
2025-09-10 2:43 ` Bagas Sanjaya [this message]
2025-09-10 2:43 ` [PATCH v2 07/13] Documentation: kasan: Use internal link to kunit Bagas Sanjaya
2025-09-11 9:17 ` Alexander Potapenko
2025-09-10 2:43 ` [PATCH v2 08/13] Documentation: gpu: " Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 09/13] Documentation: filesystems: Fix stale reference to device-mapper docs Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 10/13] Documentation: smb: smbdirect: Convert KSMBD docs link Bagas Sanjaya
2025-09-11 9:26 ` [EXTERNAL] " Meetakshi Setiya
2025-09-10 2:43 ` [PATCH v2 11/13] Documentation: net: Convert external kernel networking docs Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 12/13] nitro_enclaves: Use internal cross-reference for kernel docs links Bagas Sanjaya
2025-09-10 2:43 ` [PATCH v2 13/13] Documentation: checkpatch: Convert kernel docs references Bagas Sanjaya
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20250910024328.17911-7-bagasdotme@gmail.com \
--to=bagasdotme@gmail.com \
--cc=Liam.Howlett@oracle.com \
--cc=airlied@gmail.com \
--cc=akiyano@amazon.com \
--cc=akpm@linux-foundation.org \
--cc=alcioa@amazon.com \
--cc=andrew@lunn.ch \
--cc=andreyknvl@gmail.com \
--cc=andrii@kernel.org \
--cc=ast@kernel.org \
--cc=aws-nitro-enclaves-devel@amazon.com \
--cc=axboe@kernel.dk \
--cc=boqun.feng@gmail.com \
--cc=bp@alien8.de \
--cc=bpf@vger.kernel.org \
--cc=bvanassche@acm.org \
--cc=chengzhihao1@huawei.com \
--cc=conor+dt@kernel.org \
--cc=corbet@lwn.net \
--cc=damon@lists.linux.dev \
--cc=daniel@iogearbox.net \
--cc=darinzon@amazon.com \
--cc=davem@davemloft.net \
--cc=david@redhat.com \
--cc=devicetree@vger.kernel.org \
--cc=dri-devel@lists.freedesktop.org \
--cc=dvyukov@google.com \
--cc=dwaipayanray1@gmail.com \
--cc=ebiggers@kernel.org \
--cc=eddyz87@gmail.com \
--cc=edumazet@google.com \
--cc=fsverity@lists.linux.dev \
--cc=gautham.shenoy@amd.com \
--cc=glider@google.com \
--cc=gregkh@linuxfoundation.org \
--cc=haoluo@google.com \
--cc=hawk@kernel.org \
--cc=horms@kernel.org \
--cc=jani.nikula@intel.com \
--cc=joe@perches.com \
--cc=john.fastabend@gmail.com \
--cc=jolsa@kernel.org \
--cc=jpoimboe@kernel.org \
--cc=kasan-dev@googlegroups.com \
--cc=kpsingh@kernel.org \
--cc=krzk+dt@kernel.org \
--cc=kuba@kernel.org \
--cc=laurent.pinchart@ideasonboard.com \
--cc=linux-block@vger.kernel.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kbuild@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-mm@kvack.org \
--cc=linux-mtd@lists.infradead.org \
--cc=linux-pm@vger.kernel.org \
--cc=linux-sound@vger.kernel.org \
--cc=linux@weissschuh.net \
--cc=longman@redhat.com \
--cc=lorenzo.stoakes@oracle.com \
--cc=lukas.bulwahn@gmail.com \
--cc=maarten.lankhorst@linux.intel.com \
--cc=mario.limonciello@amd.com \
--cc=martin.lau@linux.dev \
--cc=martin.petersen@oracle.com \
--cc=masahiroy@kernel.org \
--cc=mchehab+huawei@kernel.org \
--cc=mhocko@suse.com \
--cc=mingo@redhat.com \
--cc=mripard@kernel.org \
--cc=msetiya@microsoft.com \
--cc=nathan@kernel.org \
--cc=netdev@vger.kernel.org \
--cc=nicolas.schier@linux.dev \
--cc=pabeni@redhat.com \
--cc=pawan.kumar.gupta@linux.intel.com \
--cc=perry.yuan@amd.com \
--cc=peterz@infradead.org \
--cc=ray.huang@amd.com \
--cc=richard@nod.at \
--cc=robh@kernel.org \
--cc=rppt@kernel.org \
--cc=ryabinin.a.a@gmail.com \
--cc=saeedb@amazon.com \
--cc=sdf@fomichev.me \
--cc=shayagr@amazon.com \
--cc=simona@ffwll.ch \
--cc=sj@kernel.org \
--cc=song@kernel.org \
--cc=stfrench@microsoft.com \
--cc=surenb@google.com \
--cc=tglx@linutronix.de \
--cc=tytso@mit.edu \
--cc=tzimmermann@suse.de \
--cc=vbabka@suse.cz \
--cc=vincenzo.frascino@arm.com \
--cc=vnranganath.20@gmail.com \
--cc=will@kernel.org \
--cc=workflows@vger.kernel.org \
--cc=yonghong.song@linux.dev \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox