From mboxrd@z Thu Jan 1 00:00:00 1970 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-pm@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: 8bit 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_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 `_ where any additional information needs a kernel patch. -To solve this problem, the `drgn -`_ tool is often used 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 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