Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
From:   Song Liu <songliubraving@fb.com>
To:     Pu Lehui <pulehui@huawei.com>
CC:     bpf <bpf@vger.kernel.org>, Networking <netdev@vger.kernel.org>,
        lkml <linux-kernel@vger.kernel.org>,
        "linux-doc@vger.kernel.org" <linux-doc@vger.kernel.org>,
        Alexei Starovoitov <ast@kernel.org>,
        Daniel Borkmann <daniel@iogearbox.net>,
        Andrii Nakryiko <andrii@kernel.org>,
        Jonathan Corbet <corbet@lwn.net>, Martin Lau <kafai@fb.com>,
        Yonghong Song <yhs@fb.com>,
        John Fastabend <john.fastabend@gmail.com>,
        KP Singh <kpsingh@kernel.org>,
        Grant Seltzer <grantseltzer@gmail.com>,
        Randy Dunlap <rdunlap@infradead.org>
Subject: Re: [PATCH bpf-next] bpf, docs: Remove deprecated xsk libbpf APIs
 description
Thread-Topic: [PATCH bpf-next] bpf, docs: Remove deprecated xsk libbpf APIs
 description
Thread-Index: AQHYkn7L5T9/GFx4wUCdtbVyKv6cWK1z6r8A
Date:   Fri, 8 Jul 2022 05:02:07 +0000
Message-ID: <EC892D6C-2638-4C13-A725-536428582D63@fb.com>
References: <20220708042736.669132-1-pulehui@huawei.com>
In-Reply-To: <20220708042736.669132-1-pulehui@huawei.com>
Accept-Language: en-US
Content-Language: en-US
x-ms-exchange-antispam-messagedata-chunkcount: 1
x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?xMQM7O7/yBFHY9WZNKi8SC9+jHdofZInbrVkX0H4wcKiOczy2KxpJJfAaj+s?=
 =?us-ascii?Q?/ot2eZGboHnPbKDOnzRHc24Ic7SH0DWs+AzlHHdebcNX559i8n6SABLCBs7Y?=
 =?us-ascii?Q?QBtSTqN+VjYam4gBmz68/t0eAtqWUrsUIEHl4mcebDK6C1dn1dlJV/4OIfUs?=
 =?us-ascii?Q?Ai5sF33/axy3zr6uDZ5HqD9wfJFY2gaSowb1CV0ySHB+oJqS1Kca0Dy58pmB?=
 =?us-ascii?Q?W+JH+n3D5Cy3aLTfO01nZZXyOZNV/vVIzyBF1LgEP4fsIEbuGXzoGBMAoMvX?=
 =?us-ascii?Q?I2cBAlfDmYgLeNVYYBk3FDomAsGs56Q6MiyTlfzOcWVEgLpiGGuodn4CQ1tS?=
 =?us-ascii?Q?WoRxjhDYWQukbyIfQCP2blyHaCG0aEMMCGw3poXMKw2mbFRfnyMgB6sg5QRu?=
 =?us-ascii?Q?dPsTxZhTLNJiRqJb3Yr7IkVmRUjjDLyIBsRZojCpube28QFzXWHdUbiIRI5N?=
 =?us-ascii?Q?H/6ZaCfwcyHdsBPx1SIUJpkjXTKtTuz6cDtOqjDGPrCSmDezfKMUDwfHOgAP?=
 =?us-ascii?Q?H1Wqg4SsD3K1qW/6Ch9uji6tzWFUy5bV5HTjDitU79sYKC3cmdjnGNvTQcmR?=
 =?us-ascii?Q?M2kT4JXW48GQPGskPuhE9W1trE1LNQ720cXbIUdtvaQyfHgiNkb8a6P7JPg7?=
 =?us-ascii?Q?b85bAFJxE80DNh7jaga6Ogw4IaI4QJvKwr0cPHKvgYQL+92k3IX4bJehMfhT?=
 =?us-ascii?Q?NsMp8GCEHxSb037ukhAytD5Vnw5J24sJrPHuM3+uFgpQJPYX8szOcG9YuH02?=
 =?us-ascii?Q?52jn3ic1FDzrIpqH1I6RldUmxeEUXlaXpVRnCrJUKCABbEsoNyujPvQqyXYi?=
 =?us-ascii?Q?Db1g3IfHbY8qyVl/13UzAdkS58PMUhWz+j4+g6HMH7FHTGA2ci81i0i7vjGu?=
 =?us-ascii?Q?L6Ojfn+ZraszJFUAJvSrMTI6Bpn0AC9TPoDCE26OijZBT5bdtiJiqOoUEoIT?=
 =?us-ascii?Q?1CG4XQUli2CrzeGtnRA/3+hP8vCnAx4yrK7pglFimRhIUfeP8NclKipvbVxB?=
 =?us-ascii?Q?VGn8alISMD/rf7DVgbdoXcf/OFIhTLpmhRIstvrj1tYNo7uifs3BbGyRgZm7?=
 =?us-ascii?Q?mEUZqgHvMxjq1JUfriZHpM3Y7wRpe4VCHP3z7jBDH1MMll+/+lzwUhaQ+7/K?=
 =?us-ascii?Q?eSvC/4X0lWHELdM8PnhGAa++fuwaATbO8UZ39N3IMNEHU9NHkgJJ5YCQ4TI9?=
 =?us-ascii?Q?6AblANX8y2ngWN0gHsNA4isqcrSztG8KbGnfLwe8Cw58bj4AaX8+mnZj9Ikc?=
 =?us-ascii?Q?TOTpXZ5rbT1buVqs5DHCEqzROI6D6Tl+Vm1+5MBlaNtYFI4NbYnWgPnGHtS4?=
 =?us-ascii?Q?qAxJ5pquksX+bzQGT9O8HIj073ju3vv013LGCsC+PizOF72OBWr1bfWYWj3s?=
 =?us-ascii?Q?zein3GPwU0XRGgOyHC9AH4w967Ya/zJC0g8wSJXArKeSy427nWxAZG3jAFoo?=
 =?us-ascii?Q?SXIfP+PQQJ8QWPIqRb7i1FRpeVkXfiYfmCs4qVwHF3LGB1oRIevoC3Mcq17/?=
 =?us-ascii?Q?IQg0gDFgRwHIRfC0yrt4DSPAZ8z9XfrL5HNs4O0Wy7z6Lda09DdUW47tRGzk?=
 =?us-ascii?Q?BEU/DSZVB53Zk+QPvQobfL4OVd/Eg28243ZPJXc4d9LtROfH37pvMdZLQzCu?=
 =?us-ascii?Q?pLpjSFVBx60gOl9ZGlB4cVo=3D?=
Content-Type: text/plain; charset="us-ascii"
Content-ID: <6ABB0645F046F94285238B9049E111C9@namprd15.prod.outlook.com>
MIME-Version: 1.0
X-OriginatorOrg: fb.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: SA1PR15MB5109.namprd15.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: f3fa2332-081e-4e92-3b32-08da609f01b9
X-MS-Exchange-CrossTenant-originalarrivaltime: 08 Jul 2022 05:02:07.1329
 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 8ae927fe-1255-47a7-a2af-5f3a069daaa2
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: ZmfY8DKk78OTOaJVEXmJuyJvCggf63DfjydjP5OXjWFx2CKhYlWGn2vbeKayCVmNzcoQMhADEwT23l2W/e1Hpg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW3PR15MB3993
X-Proofpoint-ORIG-GUID: iSvopBeSlCusNr6v-zD7mYINuwcJvGNP
X-Proofpoint-GUID: iSvopBeSlCusNr6v-zD7mYINuwcJvGNP
X-Proofpoint-Virus-Version: vendor=baseguard
 engine=ICAP:2.0.205,Aquarius:18.0.883,Hydra:6.0.517,FMLib:17.11.122.1
 definitions=2022-07-08_04,2022-06-28_01,2022-06-22_01
X-Spam-Status: No, score=-2.8 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,
        DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,
        RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE,
        T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
        lindbergh.monkeyblade.net
Precedence: bulk
List-ID: <linux-kernel.vger.kernel.org>
X-Mailing-List: linux-kernel@vger.kernel.org


> On Jul 7, 2022, at 9:27 PM, Pu Lehui <pulehui@huawei.com> wrote:
> 
> Since xsk APIs has been removed from libbpf, let's clean
> up the bpf docs simutaneously.
> 
> Signed-off-by: Pu Lehui <pulehui@huawei.com>

Acked-by: Song Liu <song@kernel.org>

> ---
> .../bpf/libbpf/libbpf_naming_convention.rst         | 13 ++-----------
> 1 file changed, 2 insertions(+), 11 deletions(-)
> 
> diff --git a/Documentation/bpf/libbpf/libbpf_naming_convention.rst b/Documentation/bpf/libbpf/libbpf_naming_convention.rst
> index f86360f734a8..c5ac97f3d4c4 100644
> --- a/Documentation/bpf/libbpf/libbpf_naming_convention.rst
> +++ b/Documentation/bpf/libbpf/libbpf_naming_convention.rst
> @@ -9,8 +9,8 @@ described here. It's recommended to follow these conventions whenever a
> new function or type is added to keep libbpf API clean and consistent.
> 
> All types and functions provided by libbpf API should have one of the
> -following prefixes: ``bpf_``, ``btf_``, ``libbpf_``, ``xsk_``,
> -``btf_dump_``, ``ring_buffer_``, ``perf_buffer_``.
> +following prefixes: ``bpf_``, ``btf_``, ``libbpf_``, ``btf_dump_``,
> +``ring_buffer_``, ``perf_buffer_``.
> 
> System call wrappers
> --------------------
> @@ -59,15 +59,6 @@ Auxiliary functions and types that don't fit well in any of categories
> described above should have ``libbpf_`` prefix, e.g.
> ``libbpf_get_error`` or ``libbpf_prog_type_by_name``.
> 
> -AF_XDP functions
> --------------------
> -
> -AF_XDP functions should have an ``xsk_`` prefix, e.g.
> -``xsk_umem__get_data`` or ``xsk_umem__create``. The interface consists
> -of both low-level ring access functions and high-level configuration
> -functions. These can be mixed and matched. Note that these functions
> -are not reentrant for performance reasons.
> -
> ABI
> ---
> 
> -- 
> 2.25.1
>