From patchwork Fri Jan 27 06:39:34 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 13118197 X-Patchwork-Delegate: bpf@iogearbox.net Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 4C553C61DA3 for ; Fri, 27 Jan 2023 06:40:21 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231811AbjA0GkT (ORCPT ); Fri, 27 Jan 2023 01:40:19 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39064 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229871AbjA0GkQ (ORCPT ); Fri, 27 Jan 2023 01:40:16 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id DF82F69B07; Thu, 26 Jan 2023 22:40:12 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=qAnULDD1Vs1l03vDvUPK8RqKC6ytHJz1xxwBhM6tUO4=; b=0ZUQU5LIvCy39LLL5XeAlXIm0F Dvbaq23/vB+7gEYFQevqFXt33fqiTWGIQ/AKWV88URjF9ar6z7F/OoxMv0Pw3cdwvcrhdKr+tIemn DT2uW3jnvw1wrtyBBwI5aeCOUCcyMieT/9ge/uh7d6gh5vyr6DbihhCZirRa5RtV3RU2thefc8Dzy s5f4E3/GGb+mnCjaCxMVrSSbRIqnYFAit+z1PyhnHBjWZ7tbnjVshLVA9LWf9eiMlKw2mLNye2AHU 5Isj8DVvjzE2KmhhcpRVMS8bkitntxJzbfGwxYFSmTRMulbOb3Q6k4ZCSw80tINkH4GTk8wtkJD9G nORumjLA==; Received: from [2601:1c2:d80:3110::9307] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pLIPD-00DM0u-Ea; Fri, 27 Jan 2023 06:40:11 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Andrii Nakryiko , Alexei Starovoitov , Daniel Borkmann , bpf@vger.kernel.org, Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 04/35] Documentation: bpf: correct spelling Date: Thu, 26 Jan 2023 22:39:34 -0800 Message-Id: <20230127064005.1558-5-rdunlap@infradead.org> X-Mailer: git-send-email 2.39.1 In-Reply-To: <20230127064005.1558-1-rdunlap@infradead.org> References: <20230127064005.1558-1-rdunlap@infradead.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: bpf@vger.kernel.org X-Patchwork-Delegate: bpf@iogearbox.net Correct spelling problems for Documentation/bpf/ as reported by codespell. Signed-off-by: Randy Dunlap Cc: Andrii Nakryiko Cc: Alexei Starovoitov Cc: Daniel Borkmann Cc: bpf@vger.kernel.org Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org Reviewed-by: Bagas Sanjaya --- Documentation/bpf/libbpf/libbpf_naming_convention.rst | 6 +++--- Documentation/bpf/map_xskmap.rst | 2 +- Documentation/bpf/ringbuf.rst | 4 ++-- Documentation/bpf/verifier.rst | 2 +- 4 files changed, 7 insertions(+), 7 deletions(-) diff -- a/Documentation/bpf/libbpf/libbpf_naming_convention.rst b/Documentation/bpf/libbpf/libbpf_naming_convention.rst --- a/Documentation/bpf/libbpf/libbpf_naming_convention.rst +++ b/Documentation/bpf/libbpf/libbpf_naming_convention.rst @@ -83,8 +83,8 @@ This prevents from accidentally exportin to be a part of ABI what, in turn, improves both libbpf developer- and user-experiences. -ABI versionning ---------------- +ABI versioning +-------------- To make future ABI extensions possible libbpf ABI is versioned. Versioning is implemented by ``libbpf.map`` version script that is @@ -148,7 +148,7 @@ API documentation convention The libbpf API is documented via comments above definitions in header files. These comments can be rendered by doxygen and sphinx for well organized html output. This section describes the -convention in which these comments should be formated. +convention in which these comments should be formatted. Here is an example from btf.h: diff -- a/Documentation/bpf/map_xskmap.rst b/Documentation/bpf/map_xskmap.rst --- a/Documentation/bpf/map_xskmap.rst +++ b/Documentation/bpf/map_xskmap.rst @@ -178,7 +178,7 @@ The following code snippet shows how to For an example on how create AF_XDP sockets, please see the AF_XDP-example and AF_XDP-forwarding programs in the `bpf-examples`_ directory in the `libxdp`_ repository. -For a detailed explaination of the AF_XDP interface please see: +For a detailed explanation of the AF_XDP interface please see: - `libxdp-readme`_. - `AF_XDP`_ kernel documentation. diff -- a/Documentation/bpf/ringbuf.rst b/Documentation/bpf/ringbuf.rst --- a/Documentation/bpf/ringbuf.rst +++ b/Documentation/bpf/ringbuf.rst @@ -124,7 +124,7 @@ buffer. Currently 4 are supported: - ``BPF_RB_AVAIL_DATA`` returns amount of unconsumed data in ring buffer; - ``BPF_RB_RING_SIZE`` returns the size of ring buffer; -- ``BPF_RB_CONS_POS``/``BPF_RB_PROD_POS`` returns current logical possition +- ``BPF_RB_CONS_POS``/``BPF_RB_PROD_POS`` returns current logical position of consumer/producer, respectively. Returned values are momentarily snapshots of ring buffer state and could be @@ -146,7 +146,7 @@ Design and Implementation This reserve/commit schema allows a natural way for multiple producers, either on different CPUs or even on the same CPU/in the same BPF program, to reserve independent records and work with them without blocking other producers. This -means that if BPF program was interruped by another BPF program sharing the +means that if BPF program was interrupted by another BPF program sharing the same ring buffer, they will both get a record reserved (provided there is enough space left) and can work with it and submit it independently. This applies to NMI context as well, except that due to using a spinlock during diff -- a/Documentation/bpf/verifier.rst b/Documentation/bpf/verifier.rst --- a/Documentation/bpf/verifier.rst +++ b/Documentation/bpf/verifier.rst @@ -192,7 +192,7 @@ checked and found to be non-NULL, all co As well as range-checking, the tracked information is also used for enforcing alignment of pointer accesses. For instance, on most systems the packet pointer is 2 bytes after a 4-byte alignment. If a program adds 14 bytes to that to jump -over the Ethernet header, then reads IHL and addes (IHL * 4), the resulting +over the Ethernet header, then reads IHL and adds (IHL * 4), the resulting pointer will have a variable offset known to be 4n+2 for some n, so adding the 2 bytes (NET_IP_ALIGN) gives a 4-byte alignment and so word-sized accesses through that pointer are safe. From patchwork Fri Jan 27 06:39:35 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 13118185 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 054E5C61DB3 for ; Fri, 27 Jan 2023 06:40:27 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231934AbjA0GkY (ORCPT ); Fri, 27 Jan 2023 01:40:24 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39086 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231795AbjA0GkS (ORCPT ); Fri, 27 Jan 2023 01:40:18 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B8A966A302; Thu, 26 Jan 2023 22:40:13 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=qlUJ3CMMUxoxYqDl8JIHZ9anTd1fSJcrpcu8FtmDAao=; b=BIx0ATmWfrFZDlC/MziOy4jRkb FDNiawwI+Awc7ZFj7lXnT9GZ4iSBRQumccLjJKEuSBQVTU4s5eAtJKyh86WD7pSXg+vaOcvN0i7U+ kBFcyMc8E+XmcAHDC0ijljCS6pXLKAkBM0PdkxqUicckxX7ZxtrGduirPksWcHDPW1d3JCjGlHDJP L6gNh/lsrGyLFJmKrzwJRAC/ByISF2X02Xnsr53Pjo46lKCXDWXu8LC9oafwrpmHFWbIL+1GSXidO U7GgoyyqwSVlnkCS/pOo4Ocq8pzwnAitMKlX/lBEC0nDX/1P0S/8W3qPBgd++H2sEP+IB6s66wCo/ 4/GkDRmg==; Received: from [2601:1c2:d80:3110::9307] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pLIPD-00DM0u-SQ; Fri, 27 Jan 2023 06:40:11 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Vladimir Oltean , netdev@vger.kernel.org, Steffen Klassert , Daniel Jordan , linux-crypto@vger.kernel.org, Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 05/35] Documentation: core-api: correct spelling Date: Thu, 26 Jan 2023 22:39:35 -0800 Message-Id: <20230127064005.1558-6-rdunlap@infradead.org> X-Mailer: git-send-email 2.39.1 In-Reply-To: <20230127064005.1558-1-rdunlap@infradead.org> References: <20230127064005.1558-1-rdunlap@infradead.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Correct spelling problems for Documentation/core-api/ as reported by codespell. Signed-off-by: Randy Dunlap Cc: Vladimir Oltean Cc: netdev@vger.kernel.org Cc: Steffen Klassert Cc: Daniel Jordan Cc: linux-crypto@vger.kernel.org Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org Reviewed-by: Mukesh Ojha --- Documentation/core-api/packing.rst | 2 +- Documentation/core-api/padata.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff -- a/Documentation/core-api/packing.rst b/Documentation/core-api/packing.rst --- a/Documentation/core-api/packing.rst +++ b/Documentation/core-api/packing.rst @@ -161,6 +161,6 @@ xxx_packing() that calls it using the pr The packing() function returns an int-encoded error code, which protects the programmer against incorrect API use. The errors are not expected to occur -durring runtime, therefore it is reasonable for xxx_packing() to return void +during runtime, therefore it is reasonable for xxx_packing() to return void and simply swallow those errors. Optionally it can dump stack or print the error description. diff -- a/Documentation/core-api/padata.rst b/Documentation/core-api/padata.rst --- a/Documentation/core-api/padata.rst +++ b/Documentation/core-api/padata.rst @@ -42,7 +42,7 @@ padata_shells associated with it, each a Modifying cpumasks ------------------ -The CPUs used to run jobs can be changed in two ways, programatically with +The CPUs used to run jobs can be changed in two ways, programmatically with padata_set_cpumask() or via sysfs. The former is defined:: int padata_set_cpumask(struct padata_instance *pinst, int cpumask_type, From patchwork Fri Jan 27 06:39:43 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 13118184 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id 7AB80C636D0 for ; Fri, 27 Jan 2023 06:40:24 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231899AbjA0GkW (ORCPT ); Fri, 27 Jan 2023 01:40:22 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:39106 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231829AbjA0GkT (ORCPT ); Fri, 27 Jan 2023 01:40:19 -0500 Received: from bombadil.infradead.org (bombadil.infradead.org [IPv6:2607:7c80:54:3::133]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 776D769500; Thu, 26 Jan 2023 22:40:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=swjGj2JGsgoS6As86ky5T5gStqDz1F5YkyPVKyHV0jk=; b=5G839/UAJb/cuL47f1MLvz5JiM JIzzclpfAngAmHt5ChGlBIj7wmO0SU4osdMpJi/cug7/TJCYGP+tYqcuC898uzyxYzUPMPpoeY7F7 HdPi+AoYtMLni2toasm47FvEx6UsgYS6ji6Ad1zSuwWbJRaCoNdjnRGI7OsjHP9365FTBJPoRXsh6 vllXt38/QU13Ex98G+dEBarT/ZrmKRw2SXmtjrhqJdIBDftl7sBJM0K11i/I16QiUKK64EuhpmOOd mIlrjxb5GDbCpKMh26zZEJcnSB4ZvAEXAgAArtG/Io4jZVK8NyGjgauoZKv1Oqz8qIQ94thEJ8L5V JAqPrxZA==; Received: from [2601:1c2:d80:3110::9307] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.94.2 #2 (Red Hat Linux)) id 1pLIPH-00DM0u-VN; Fri, 27 Jan 2023 06:40:16 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Karsten Keil , isdn4linux@listserv.isdn4linux.de, netdev@vger.kernel.org, Jonathan Corbet , linux-doc@vger.kernel.org Subject: [PATCH 13/35] Documentation: isdn: correct spelling Date: Thu, 26 Jan 2023 22:39:43 -0800 Message-Id: <20230127064005.1558-14-rdunlap@infradead.org> X-Mailer: git-send-email 2.39.1 In-Reply-To: <20230127064005.1558-1-rdunlap@infradead.org> References: <20230127064005.1558-1-rdunlap@infradead.org> MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: netdev@vger.kernel.org Correct spelling problems for Documentation/isdn/ as reported by codespell. Signed-off-by: Randy Dunlap Cc: Karsten Keil Cc: isdn4linux@listserv.isdn4linux.de Cc: netdev@vger.kernel.org Cc: Jonathan Corbet Cc: linux-doc@vger.kernel.org Acked-by: Jakub Kicinski --- Documentation/isdn/interface_capi.rst | 2 +- Documentation/isdn/m_isdn.rst | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff -- a/Documentation/isdn/interface_capi.rst b/Documentation/isdn/interface_capi.rst --- a/Documentation/isdn/interface_capi.rst +++ b/Documentation/isdn/interface_capi.rst @@ -323,7 +323,7 @@ If the lowest bit of showcapimsgs is set application up and down events. In addition, every registered CAPI controller has an associated traceflag -parameter controlling how CAPI messages sent from and to tha controller are +parameter controlling how CAPI messages sent from and to the controller are logged. The traceflag parameter is initialized with the value of the showcapimsgs parameter when the controller is registered, but can later be changed via the MANUFACTURER_REQ command KCAPI_CMD_TRACE. diff -- a/Documentation/isdn/m_isdn.rst b/Documentation/isdn/m_isdn.rst --- a/Documentation/isdn/m_isdn.rst +++ b/Documentation/isdn/m_isdn.rst @@ -3,7 +3,7 @@ mISDN Driver ============ mISDN is a new modular ISDN driver, in the long term it should replace -the old I4L driver architecture for passiv ISDN cards. +the old I4L driver architecture for passive ISDN cards. It was designed to allow a broad range of applications and interfaces but only have the basic function in kernel, the interface to the user space is based on sockets with a own address family AF_ISDN.