From patchwork Sun Sep 19 06:24:31 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arowa Suliman X-Patchwork-Id: 1529798 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@ozlabs.org Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; secure) header.d=lists.infradead.org header.i=@lists.infradead.org header.a=rsa-sha256 header.s=bombadil.20210309 header.b=noFg7Qmx; dkim=fail reason="signature verification failed" (1024-bit key; unprotected) header.d=chromium.org header.i=@chromium.org header.a=rsa-sha256 header.s=google header.b=lgcl9j2E; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=none (no SPF record) smtp.mailfrom=lists.infradead.org (client-ip=198.137.202.133; helo=bombadil.infradead.org; envelope-from=hostap-bounces+incoming=patchwork.ozlabs.org@lists.infradead.org; receiver=) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4HByPt03Vcz9sR4 for ; Sun, 19 Sep 2021 16:26:25 +1000 (AEST) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:MIME-Version:References:In-Reply-To: Message-Id:Date:Subject:Cc:To:From:Reply-To:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: List-Owner; bh=TV0kc4qEPEB3u/uA3LDPCZUF5flnMBSNMatBatS/lsw=; b=noFg7QmxXStnQ8 f64vSTrnLu++2F+bflBd5B9yBcVnmwtGFzshpoEPzVSsAuBjeEpJxd8qG3jluG7ydCAWlsutPiVms +UzE4QYe/CH13bFtElUPjJzghmFoLayVucoUqstLIQaWzzgw1BN3vUVm4UJFjTnKRPgEiUcxr0ROR vCW6AdoMqftR9bQJvnnQv5W24qWazSlaWaIrnL8LCTgY/kPilR7MVtXMGZjqqYSGECsCwCYh9AIn1 pBEdyolm+FA8zi+h2LlR2BIMubUCk7KWgjuS/Pkvu6BttyiB7IyDtbpOoNXZWKzOBLc+zY4guV/h2 w/+O6AjbsalFiV3iisXQ==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1mRqGj-00GoJG-G6; Sun, 19 Sep 2021 06:25:41 +0000 Received: from mail-pg1-x534.google.com ([2607:f8b0:4864:20::534]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1mRqFr-00Go4h-28 for hostap@lists.infradead.org; Sun, 19 Sep 2021 06:24:49 +0000 Received: by mail-pg1-x534.google.com with SMTP id e7so14143042pgk.2 for ; Sat, 18 Sep 2021 23:24:46 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=chromium.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=D/Y6waracrFWkixussrIYHMsghGr3TvZrx9iAagPYlA=; b=lgcl9j2EphmPPzm1xOi7Wu3Og1BqYQUj5q4f2gWwHx4/QfotKNG1VgQ/Z5/n+eU8yJ i4q5Pzsbt91x2QtgEO7mw2lQvrbrMUShUZfx6B8yGAjc4qo/r8EWI62YixBnHVjNx81J xwNDh6faq0M1WhFaY0f0AQvDYfN67JzdQliQs= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=D/Y6waracrFWkixussrIYHMsghGr3TvZrx9iAagPYlA=; b=XvMDywnZPBgqjSYNUkR/yfhDgo9X9tAO19VaFCWqxu/LbfXQbFLVZ7efSOaVdOH71K arRGgbpzKPpjU9ErfI92159GC/bS+Qu9r+bPtt49jN9fMWAAu61XEKcobLJosdUlBslA o2KnMvhKclAHoRoSkfwMEkKnX16NWFxiw709/j6NBDJQ80MyAVArXNBEsyhBZyUXfWyQ r+JifTL2hnvWNMFKdiMw0tKwhb7HMg8NYVUF9pVHziTM1vKzPYnTteuKh/2OTa7XfzXk xmADse5YAB3Xc5u9+6kfrqWjsPRjs1AFGZqmWXIKggtqDEeKtiw7U2oIT8yNtm8vm6+2 RSbQ== X-Gm-Message-State: AOAM532bhb8ajPNVSbBzgVlUptHQOrALae/rxBQN0us7txLYofzxhXya ss+5G6tpZ7wB+olBDFm5IQ9J5ThUvqLr7A== X-Google-Smtp-Source: ABdhPJwYSXoxaNeFO5Hon33Vlah6tFr7Gm7tRMjmCQOBWv/6wGgQ00t2YE3PWLkLGYWILV3aiLVzfw== X-Received: by 2002:a63:8c42:: with SMTP id q2mr5374425pgn.325.1632032686034; Sat, 18 Sep 2021 23:24:46 -0700 (PDT) Received: from arowa.mtv.corp.google.com ([2620:15c:202:201:67d7:d152:2d9c:5797]) by smtp.gmail.com with ESMTPSA id r22sm14561831pjp.7.2021.09.18.23.24.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 18 Sep 2021 23:24:45 -0700 (PDT) From: Arowa Suliman X-Google-Original-From: Arowa Suliman To: hostap@lists.infradead.org Cc: Arowa Suliman , Arowa Suliman Subject: [PATCH v7 6/7] wpa_supplicant: doc: Replace Native Part 1. Date: Sat, 18 Sep 2021 23:24:31 -0700 Message-Id: <20210919062432.431077-7-arowa@google.com> X-Mailer: git-send-email 2.33.0.464.g1972c5931b-goog In-Reply-To: <20210919062432.431077-1-arowa@google.com> References: <20210919062432.431077-1-arowa@google.com> MIME-Version: 1.0 X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210918_232447_152075_778F22A0 X-CRM114-Status: GOOD ( 21.05 ) X-Spam-Score: -0.4 (/) X-Spam-Report: Spam detection software, running on the system "bombadil.infradead.org", has NOT identified this incoming email as spam. The original message has been attached to this so you can view it or label similar future email. If you have any questions, see the administrator of that system for details. Content preview: Replaced the word Native with more inclusive words such as built-in. Signed-off-by: Arowa Suliman --- doc/code_structure.doxygen | 2 +- doc/driver_wrapper.doxygen | 8 ++++---- doc/p2p.doxygen | 4 ++-- doc/porting.doxygen | 3 ++- wpa_supplicant/Chan [...] Content analysis details: (-0.4 points, 5.0 required) pts rule name description ---- ---------------------- -------------------------------------------------- -0.0 RCVD_IN_DNSWL_NONE RBL: Sender listed at https://www.dnswl.org/, no trust [2607:f8b0:4864:20:0:0:0:534 listed in] [list.dnswl.org] -0.0 SPF_PASS SPF: sender matches SPF record 0.0 SPF_HELO_NONE SPF: HELO does not publish an SPF Record -0.1 DKIM_VALID_AU Message has a valid DKIM or DK signature from author's domain -0.1 DKIM_VALID Message has at least one valid DKIM or DK signature 0.1 DKIM_SIGNED Message has a DKIM or DK signature, not necessarily valid -0.1 DKIM_VALID_EF Message has a valid DKIM or DK signature from envelope-from domain -0.2 DKIMWL_WL_HIGH DKIMwl.org - High trust sender X-BeenThere: hostap@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: "Hostap" Errors-To: hostap-bounces+incoming=patchwork.ozlabs.org@lists.infradead.org Replaced the word Native with more inclusive words such as built-in. Signed-off-by: Arowa Suliman --- doc/code_structure.doxygen | 2 +- doc/driver_wrapper.doxygen | 8 ++++---- doc/p2p.doxygen | 4 ++-- doc/porting.doxygen | 3 ++- wpa_supplicant/ChangeLog | 2 +- 5 files changed, 10 insertions(+), 9 deletions(-) diff --git a/doc/code_structure.doxygen b/doc/code_structure.doxygen index 3a3b21b72..927ea4e85 100644 --- a/doc/code_structure.doxygen +++ b/doc/code_structure.doxygen @@ -62,7 +62,7 @@ with with hostapd. The following C files are currently used: Definitions shared by multiple files \ref l2_packet.h, \ref l2_packet_linux.c, and \ref l2_packet_pcap.c - Layer 2 (link) access wrapper (includes native Linux implementation + Layer 2 (link) access wrapper (includes Linux packet socket and wrappers for libdnet/libpcap). A new l2_packet implementation may need to be added when porting to new operating systems that are not supported by libdnet/libpcap. Makefile can be used to select which diff --git a/doc/driver_wrapper.doxygen b/doc/driver_wrapper.doxygen index 66211b3ab..37e39de90 100644 --- a/doc/driver_wrapper.doxygen +++ b/doc/driver_wrapper.doxygen @@ -27,10 +27,10 @@ documented in \ref driver.h. In addition, a pointer to the 'struct \ref wpa_driver_ops' needs to be registered in \ref drivers.c file. When porting to other operating systems, the driver wrapper should be -modified to use the native interface of the target OS. It is possible -that some extra requirements for the interface between the driver -wrapper and generic wpa_supplicant code are discovered during porting -to a new operating system. These will be addressed on case by case +modified to use the direct interface of the target OS (No extra adoption +layer). It is possible that some extra requirements for the interface between +the driver wrapper and generic wpa_supplicant code are discovered during +porting to a new operating system. These will be addressed on case by case basis by modifying the interface and updating the other driver wrappers for this. The goal is to avoid changing this interface without very good reasons in order to limit the number of changes diff --git a/doc/p2p.doxygen b/doc/p2p.doxygen index d4d86e3ed..6ab6e9e05 100644 --- a/doc/p2p.doxygen +++ b/doc/p2p.doxygen @@ -274,8 +274,8 @@ for removing the group interface for the failed group. P2P protocol includes service discovery functionality that can be used to discover which services are provided by the peers before forming a group. This leverages the Generic Advertisement Service (GAS) protocol -from IEEE 802.11u and P2P vendor-specific contents inside the Native -GAS messages. +from IEEE 802.11u and P2P vendor-specific contents inside the GAS +messages. The P2P module takes care of GAS encapsulation, fragmentation, and actual transmission and reception of the Action frames needed for diff --git a/doc/porting.doxygen b/doc/porting.doxygen index b4b78ef05..a302dbf1a 100644 --- a/doc/porting.doxygen +++ b/doc/porting.doxygen @@ -21,7 +21,8 @@ most targets. However, couple of additional functions that are common on modern UNIX systems are used. Number of these are listed with prototypes in \ref common.h (the \verbatim #ifdef CONFIG_ANSI_C_EXTRA \endverbatim block). These functions may need to be implemented or at least defined -as macros to native functions in the target OS or C library. +as macros to direct functions in the target OS (No extra adoption layer) or C +library. Many of the common ANSI C functions are used through a wrapper definitions in \ref os.h to allow these to be replaced easily with a diff --git a/wpa_supplicant/ChangeLog b/wpa_supplicant/ChangeLog index a06a93b22..39f3a7478 100644 --- a/wpa_supplicant/ChangeLog +++ b/wpa_supplicant/ChangeLog @@ -1864,7 +1864,7 @@ ChangeLog for wpa_supplicant generate, e.g., man pages * l2_packet_linux: use socket type SOCK_DGRAM instead of SOCK_RAW for PF_PACKET in order to prepare for network devices that do not use - Ethernet headers (e.g., network stack with native IEEE 802.11 frames) + Ethernet headers (e.g., network stack that includes IEEE 802.11 headers) * use receipt of EAPOL-Key frame as a lower layer success indication for EAP state machine to allow recovery from dropped EAP-Success frame