From patchwork Tue Nov 12 19:33:41 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Marchand X-Patchwork-Id: 62908 X-Patchwork-Delegate: david.marchand@redhat.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 4CF78A0353; Tue, 12 Nov 2019 20:34:05 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A47D92C30; Tue, 12 Nov 2019 20:34:04 +0100 (CET) Received: from us-smtp-delivery-1.mimecast.com (us-smtp-2.mimecast.com [205.139.110.61]) by dpdk.org (Postfix) with ESMTP id 41A032C15 for ; Tue, 12 Nov 2019 20:34:03 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1573587242; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=ifn91WTcCkJIE3pNcjCIE7KMkw0QrW6y8AG/Uzk1mG8=; b=FrLSEp27zfWAsKcNM156evOWjkKIG1mmVlvAQDJzzQ0VXG8k6HW7Mu57oLsik5TeOSYGo/ L5HTBWYraskjcznkrirwivt2WqHCXHHtnUK9FwjyeASgbxWEFgeQOhx6xKC0ZVJ8p2OZtZ ArHJEVcK7fIkqF9ygOrMD28MfrO8QlY= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-256-HR6lr4QfOmWt09D8LnXMeg-1; Tue, 12 Nov 2019 14:33:59 -0500 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id A834D805C26; Tue, 12 Nov 2019 19:33:55 +0000 (UTC) Received: from dmarchan.remote.csb (unknown [10.40.205.213]) by smtp.corp.redhat.com (Postfix) with ESMTP id 5668660174; Tue, 12 Nov 2019 19:33:47 +0000 (UTC) From: David Marchand To: dev@dpdk.org Cc: John McNamara , Marko Kovacevic , Pablo de Lara , Qi Zhang , Xiao Wang , Nicolas Chautru , Anatoly Burakov , Jiayu Hu , Ferruh Yigit , Konstantin Ananyev , Adrien Mazarguil , Akhil Goyal , Declan Doherty , Ori Kam , Bruce Richardson , Radu Nicolau , Tomasz Kantecki , Sunil Kumar Kori , Pavan Nikhilesh , Xiaoyun Li , Jingjing Wu , Harry van Haaren , Wenzhuo Lu , Bernard Iremonger , Maryam Tahhan , Reshma Pattan Date: Tue, 12 Nov 2019 20:33:41 +0100 Message-Id: <1573587221-25158-1-git-send-email-david.marchand@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-MC-Unique: HR6lr4QfOmWt09D8LnXMeg-1 X-Mimecast-Spam-Score: 0 Subject: [dpdk-dev] [PATCH] doc/guides: clean repeated words X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Shoot repeated words in all our guides. Signed-off-by: David Marchand Acked-by: Kevin Traynor --- doc/guides/contributing/coding_style.rst | 8 ++++---- doc/guides/cryptodevs/zuc.rst | 2 +- doc/guides/linux_gsg/nic_perf_intel_platform.rst | 2 +- doc/guides/nics/fm10k.rst | 2 +- doc/guides/prog_guide/bbdev.rst | 2 +- doc/guides/prog_guide/cryptodev_lib.rst | 4 ++-- doc/guides/prog_guide/env_abstraction_layer.rst | 2 +- doc/guides/prog_guide/generic_segmentation_offload_lib.rst | 2 +- doc/guides/prog_guide/kernel_nic_interface.rst | 2 +- doc/guides/prog_guide/packet_classif_access_ctrl.rst | 4 ++-- doc/guides/prog_guide/rte_flow.rst | 2 +- doc/guides/prog_guide/rte_security.rst | 4 ++-- doc/guides/rel_notes/release_17_11.rst | 2 +- doc/guides/rel_notes/release_18_02.rst | 2 +- doc/guides/rel_notes/release_19_02.rst | 4 ++-- doc/guides/rel_notes/release_19_11.rst | 2 +- doc/guides/sample_app_ug/ethtool.rst | 2 +- doc/guides/sample_app_ug/ipsec_secgw.rst | 2 +- doc/guides/sample_app_ug/ntb.rst | 2 +- doc/guides/sample_app_ug/performance_thread.rst | 2 +- doc/guides/testpmd_app_ug/testpmd_funcs.rst | 4 ++-- doc/guides/tools/proc_info.rst | 2 +- 22 files changed, 30 insertions(+), 30 deletions(-) diff --git a/doc/guides/contributing/coding_style.rst b/doc/guides/contributing/coding_style.rst index e95a1a2..a6843de 100644 --- a/doc/guides/contributing/coding_style.rst +++ b/doc/guides/contributing/coding_style.rst @@ -631,10 +631,10 @@ In the DPDK environment, use the logging interface provided: /* log in debug level */ rte_log_set_global_level(RTE_LOG_DEBUG); - RTE_LOG(DEBUG, my_logtype1, "this is is a debug level message\n"); - RTE_LOG(INFO, my_logtype1, "this is is a info level message\n"); - RTE_LOG(WARNING, my_logtype1, "this is is a warning level message\n"); - RTE_LOG(WARNING, my_logtype2, "this is is a debug level message (not displayed)\n"); + RTE_LOG(DEBUG, my_logtype1, "this is a debug level message\n"); + RTE_LOG(INFO, my_logtype1, "this is a info level message\n"); + RTE_LOG(WARNING, my_logtype1, "this is a warning level message\n"); + RTE_LOG(WARNING, my_logtype2, "this is a debug level message (not displayed)\n"); /* log in info level */ rte_log_set_global_level(RTE_LOG_INFO); diff --git a/doc/guides/cryptodevs/zuc.rst b/doc/guides/cryptodevs/zuc.rst index 69a5218..002e986 100644 --- a/doc/guides/cryptodevs/zuc.rst +++ b/doc/guides/cryptodevs/zuc.rst @@ -28,7 +28,7 @@ Limitations * ZUC (EIA3) supported only if hash offset field is byte-aligned. * ZUC (EEA3) supported only if cipher length, cipher offset fields are byte-aligned. * ZUC PMD cannot be built as a shared library, due to limitations in - in the underlying library. + the underlying library. Installation diff --git a/doc/guides/linux_gsg/nic_perf_intel_platform.rst b/doc/guides/linux_gsg/nic_perf_intel_platform.rst index 0c25ec0..c554c21 100644 --- a/doc/guides/linux_gsg/nic_perf_intel_platform.rst +++ b/doc/guides/linux_gsg/nic_perf_intel_platform.rst @@ -150,7 +150,7 @@ Configurations before running DPDK # Mount to the specific folder. mount -t hugetlbfs nodev /mnt/huge -2. Check the CPU layout using using the DPDK ``cpu_layout`` utility: +2. Check the CPU layout using the DPDK ``cpu_layout`` utility: .. code-block:: console diff --git a/doc/guides/nics/fm10k.rst b/doc/guides/nics/fm10k.rst index 20a1cde..4e178c2 100644 --- a/doc/guides/nics/fm10k.rst +++ b/doc/guides/nics/fm10k.rst @@ -119,7 +119,7 @@ Switch manager The Intel FM10000 family of NICs integrate a hardware switch and multiple host interfaces. The FM10000 PMD driver only manages host interfaces. For the -switch component another switch driver has to be loaded prior to to the +switch component another switch driver has to be loaded prior to the FM10000 PMD driver. The switch driver can be acquired from Intel support. Only Testpoint is validated with DPDK, the latest version that has been validated with DPDK is 4.1.6. diff --git a/doc/guides/prog_guide/bbdev.rst b/doc/guides/prog_guide/bbdev.rst index d491849..d39167a 100644 --- a/doc/guides/prog_guide/bbdev.rst +++ b/doc/guides/prog_guide/bbdev.rst @@ -1069,7 +1069,7 @@ The mbuf ``length`` is inclusive of CRC24A/B where present and is equal the code block size ``K``. The first CB Virtual Circular Buffer (VCB) index is given by ``r`` but the -the number of the remaining CB VCBs is calculated automatically by BBDEV +number of the remaining CB VCBs is calculated automatically by BBDEV and passed down to the driver. The number of remaining CB VCBs should not be confused with ``c``, the diff --git a/doc/guides/prog_guide/cryptodev_lib.rst b/doc/guides/prog_guide/cryptodev_lib.rst index bf0ee79..ac16437 100644 --- a/doc/guides/prog_guide/cryptodev_lib.rst +++ b/doc/guides/prog_guide/cryptodev_lib.rst @@ -498,7 +498,7 @@ to specify the details of the Crypto operation. For chaining of symmetric operations such as cipher encrypt and authentication generate, the next pointer allows transform to be chained together. Crypto devices which support chaining must publish the chaining of symmetric Crypto operations feature flag. Allocation of the -xform structure is in the the application domain. To allow future API extensions in a +xform structure is in the application domain. To allow future API extensions in a backwardly compatible manner, e.g. addition of a new parameter, the application should zero the full xform struct before populating it. @@ -893,7 +893,7 @@ Asymmetric Crypto transforms (``rte_crypto_asym_xform``) are the mechanism used to specify the details of the asymmetric Crypto operation. Next pointer within xform allows transform to be chained together. Also it is important to note that the order in which the transforms are passed indicates the order of the chaining. Allocation -of the xform structure is in the the application domain. To allow future API extensions in a +of the xform structure is in the application domain. To allow future API extensions in a backwardly compatible manner, e.g. addition of a new parameter, the application should zero the full xform struct before populating it. diff --git a/doc/guides/prog_guide/env_abstraction_layer.rst b/doc/guides/prog_guide/env_abstraction_layer.rst index 6e59fae..cd8e300 100644 --- a/doc/guides/prog_guide/env_abstraction_layer.rst +++ b/doc/guides/prog_guide/env_abstraction_layer.rst @@ -249,7 +249,7 @@ manual memory management. + Using heap API's for externally allocated memory -Using using a set of malloc heap API's is the recommended way to use externally +Using a set of malloc heap API's is the recommended way to use externally allocated memory in DPDK. In this way, support for externally allocated memory is implemented through overloading the socket ID - externally allocated heaps will have socket ID's that would be considered invalid under normal diff --git a/doc/guides/prog_guide/generic_segmentation_offload_lib.rst b/doc/guides/prog_guide/generic_segmentation_offload_lib.rst index 0cfc119..73e7687 100644 --- a/doc/guides/prog_guide/generic_segmentation_offload_lib.rst +++ b/doc/guides/prog_guide/generic_segmentation_offload_lib.rst @@ -206,7 +206,7 @@ To segment an outgoing packet, an application must: 2. Set the appropriate ol_flags in the mbuf. - The GSO library use the value of an mbuf's ``ol_flags`` attribute to - to determine how a packet should be segmented. It is the application's + determine how a packet should be segmented. It is the application's responsibility to ensure that these flags are set. - For example, in order to segment TCP/IPv4 packets, the application should diff --git a/doc/guides/prog_guide/kernel_nic_interface.rst b/doc/guides/prog_guide/kernel_nic_interface.rst index 2fd58e1..e12634d 100644 --- a/doc/guides/prog_guide/kernel_nic_interface.rst +++ b/doc/guides/prog_guide/kernel_nic_interface.rst @@ -254,7 +254,7 @@ to create a separate thread or secondary process to periodically call The KNI interfaces can be deleted by a DPDK application with ``rte_kni_release()``. All KNI interfaces not explicitly deleted will be -deleted when the the ``/dev/kni`` device is closed, either explicitly with +deleted when the ``/dev/kni`` device is closed, either explicitly with ``rte_kni_close()`` or when the DPDK application is closed. DPDK mbuf Flow diff --git a/doc/guides/prog_guide/packet_classif_access_ctrl.rst b/doc/guides/prog_guide/packet_classif_access_ctrl.rst index c16b11a..2945eac 100644 --- a/doc/guides/prog_guide/packet_classif_access_ctrl.rst +++ b/doc/guides/prog_guide/packet_classif_access_ctrl.rst @@ -154,7 +154,7 @@ To define classification for the IPv6 2-tuple: o .. code-block:: c - struct struct rte_ipv6_hdr { + struct rte_ipv6_hdr { uint32_t vtc_flow; /* IP version, traffic class & flow label. */ uint16_t payload_len; /* IP packet length - includes sizeof(ip_header). */ uint8_t proto; /* Protocol, next header. */ @@ -167,7 +167,7 @@ The following array of field definitions can be used: .. code-block:: c - struct struct rte_acl_field_def ipv6_2tuple_defs[5] = { + struct rte_acl_field_def ipv6_2tuple_defs[5] = { { .type = RTE_ACL_FIELD_TYPE_BITMASK, .size = sizeof (uint8_t), diff --git a/doc/guides/prog_guide/rte_flow.rst b/doc/guides/prog_guide/rte_flow.rst index ac0020e..a254c81 100644 --- a/doc/guides/prog_guide/rte_flow.rst +++ b/doc/guides/prog_guide/rte_flow.rst @@ -1650,7 +1650,7 @@ Counters can be retrieved and reset through ``rte_flow_query()``, see The shared flag indicates whether the counter is unique to the flow rule the action is specified with, or whether it is a shared counter. -For a count action with the shared flag set, then then a global device +For a count action with the shared flag set, then a global device namespace is assumed for the counter id, so that any matched flow rules using a count action with the same counter id on the same port will contribute to that counter. diff --git a/doc/guides/prog_guide/rte_security.rst b/doc/guides/prog_guide/rte_security.rst index 7d0734a..f77fb89 100644 --- a/doc/guides/prog_guide/rte_security.rst +++ b/doc/guides/prog_guide/rte_security.rst @@ -51,7 +51,7 @@ however all security protocol related headers are still attached to the packet. e.g. In case of IPsec, the IPsec tunnel headers (if any), ESP/AH headers will remain in the packet but the received packet contains the decrypted data where the encrypted data was when the packet -arrived. The driver Rx path check the descriptors and and based on the +arrived. The driver Rx path check the descriptors and based on the crypto status sets additional flags in the rte_mbuf.ol_flags field. .. note:: @@ -65,7 +65,7 @@ Egress Data path - The software prepares the egress packet by adding relevant security protocol headers. Only the data will not be encrypted by the software. The driver will accordingly configure the tx descriptors. The hardware device will encrypt the data before sending the -the packet out. +packet out. .. note:: diff --git a/doc/guides/rel_notes/release_17_11.rst b/doc/guides/rel_notes/release_17_11.rst index 6448b6c..1f3b45e 100644 --- a/doc/guides/rel_notes/release_17_11.rst +++ b/doc/guides/rel_notes/release_17_11.rst @@ -475,7 +475,7 @@ API Changes * **Added mbuf flags PKT_RX_VLAN and PKT_RX_QINQ.** Two ``mbuf`` flags have been added to indicate that the VLAN - identifier has been saved in in the ``mbuf`` structure. For instance: + identifier has been saved in the ``mbuf`` structure. For instance: - If VLAN is not stripped and TCI is saved: ``PKT_RX_VLAN`` - If VLAN is stripped and TCI is saved: ``PKT_RX_VLAN | PKT_RX_VLAN_STRIPPED`` diff --git a/doc/guides/rel_notes/release_18_02.rst b/doc/guides/rel_notes/release_18_02.rst index 8e40311..3523ea7 100644 --- a/doc/guides/rel_notes/release_18_02.rst +++ b/doc/guides/rel_notes/release_18_02.rst @@ -210,7 +210,7 @@ New Features A set of northbound APIs have been defined which encompass a generic set of operations by allowing applications to interact with device using opaque structures/buffers. Also, southbound APIs provide a means of integrating devices - either as as part of a physical bus (PCI, FSLMC etc) or through ``vdev``. + either as part of a physical bus (PCI, FSLMC etc) or through ``vdev``. See the :doc:`../prog_guide/rawdev` programmer's guide for more details. diff --git a/doc/guides/rel_notes/release_19_02.rst b/doc/guides/rel_notes/release_19_02.rst index b353620..ace1534 100644 --- a/doc/guides/rel_notes/release_19_02.rst +++ b/doc/guides/rel_notes/release_19_02.rst @@ -265,11 +265,11 @@ ABI Changes * mbuf: The format of the sched field of ``rte_mbuf`` has been changed to include the following fields: ``queue ID``, ``traffic class``, ``color``. -* cryptodev: as shown in the the 18.11 deprecation notice, the structure +* cryptodev: as shown in the 18.11 deprecation notice, the structure ``rte_cryptodev_qp_conf`` has added two parameters for symmetric session mempool and symmetric session private data mempool. -* cryptodev: as shown in the the 18.11 deprecation notice, the structure +* cryptodev: as shown in the 18.11 deprecation notice, the structure ``rte_cryptodev_sym_session`` has been updated to contain more information to ensure safely accessing the session and session private data. diff --git a/doc/guides/rel_notes/release_19_11.rst b/doc/guides/rel_notes/release_19_11.rst index 682c1bd..c0045a9 100644 --- a/doc/guides/rel_notes/release_19_11.rst +++ b/doc/guides/rel_notes/release_19_11.rst @@ -97,7 +97,7 @@ New Features * **Added ethdev API to set supported packet types** * Added new API ``rte_eth_dev_set_ptypes`` that allows an application to - inform PMD about about reduced range of packet types to handle. + inform PMD about reduced range of packet types to handle. * This scheme will allow PMDs to avoid lookup to internal ptype table on Rx and thereby improve Rx performance if application wishes do so. diff --git a/doc/guides/sample_app_ug/ethtool.rst b/doc/guides/sample_app_ug/ethtool.rst index 47e09f6..8f7fc6c 100644 --- a/doc/guides/sample_app_ug/ethtool.rst +++ b/doc/guides/sample_app_ug/ethtool.rst @@ -40,7 +40,7 @@ The application is console-driven using the cmdline DPDK interface: EthApp> From this interface the available commands and descriptions of what -they do as as follows: +they do as follows: * ``drvinfo``: Print driver info * ``eeprom``: Dump EEPROM to file diff --git a/doc/guides/sample_app_ug/ipsec_secgw.rst b/doc/guides/sample_app_ug/ipsec_secgw.rst index ae8cce2..d6d8d44 100644 --- a/doc/guides/sample_app_ug/ipsec_secgw.rst +++ b/doc/guides/sample_app_ug/ipsec_secgw.rst @@ -158,7 +158,7 @@ Where: If packet is not reassembled within this time, received fragments will be discarded. Fragment lifetime should be decreased when there is a high fragmented traffic loss in high bandwidth networks. - Should be lower for for low number of reassembly buckets. + Should be lower for low number of reassembly buckets. Valid values: from 1 ns to 10 s. Default value: 10000000 (10 s). * ``--reassemble NUM``: max number of entries in reassemble fragment table. diff --git a/doc/guides/sample_app_ug/ntb.rst b/doc/guides/sample_app_ug/ntb.rst index df16af8..93fb752 100644 --- a/doc/guides/sample_app_ug/ntb.rst +++ b/doc/guides/sample_app_ug/ntb.rst @@ -82,7 +82,7 @@ The application is console-driven using the cmdline DPDK interface: ntb> From this interface the available commands and descriptions of what -they do as as follows: +they do as follows: * ``send [filepath]``: Send file to the peer host. Need to be in file-trans forwarding mode first. diff --git a/doc/guides/sample_app_ug/performance_thread.rst b/doc/guides/sample_app_ug/performance_thread.rst index ac6ee8a..5fed464 100644 --- a/doc/guides/sample_app_ug/performance_thread.rst +++ b/doc/guides/sample_app_ug/performance_thread.rst @@ -280,7 +280,7 @@ functionality into different threads, and the pairs of RX and TX threads are interconnected via software rings. On initialization an L-thread scheduler is started on every EAL thread. On all -but the master EAL thread only a a dummy L-thread is initially started. +but the master EAL thread only a dummy L-thread is initially started. The L-thread started on the master EAL thread then spawns other L-threads on different L-thread schedulers according the command line parameters. diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst index 48473d8..6779822 100644 --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst @@ -33,7 +33,7 @@ If you type a partial command and hit ```` you get a list of the available .. note:: - Some examples in this document are too long to fit on one line are are shown wrapped at `"\\"` for display purposes:: + Some examples in this document are too long to fit on one line are shown wrapped at `"\\"` for display purposes:: testpmd> set flow_ctrl rx (on|off) tx (on|off) (high_water) (low_water) \ (pause_time) (send_xon) (port_id) @@ -2760,7 +2760,7 @@ Traffic Management ------------------ The following section shows functions for configuring traffic management on -on the ethernet device through the use of generic TM API. +the ethernet device through the use of generic TM API. show port traffic management capability ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ diff --git a/doc/guides/tools/proc_info.rst b/doc/guides/tools/proc_info.rst index 2ea1b59..0390b9c 100644 --- a/doc/guides/tools/proc_info.rst +++ b/doc/guides/tools/proc_info.rst @@ -63,7 +63,7 @@ ring. For invalid or no ring name, whole list is dump. **--show-mempool[=name]** The show-mempool parameter display current allocation of all mempool debug information. Specifying the name allows to display details for specific -specific mempool. For invalid or no mempool name, whole list is dump. +mempool. For invalid or no mempool name, whole list is dump. **--iter-mempool=name** The iter-mempool parameter iterates and displays mempool elements specified