From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 23CB045D7A; Fri, 22 Nov 2024 03:40:35 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 0F26B43252; Fri, 22 Nov 2024 03:40:35 +0100 (CET) Received: from mail-ot1-f54.google.com (mail-ot1-f54.google.com [209.85.210.54]) by mails.dpdk.org (Postfix) with ESMTP id 6FFC842FA3 for ; Fri, 22 Nov 2024 03:40:33 +0100 (CET) Received: by mail-ot1-f54.google.com with SMTP id 46e09a7af769-71811707775so919692a34.3 for ; Thu, 21 Nov 2024 18:40:33 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1732243232; x=1732848032; darn=dpdk.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:from:to:cc:subject:date:message-id :reply-to; bh=8PDpQ9GWq+mb2ntUg+Zqr97+I+H0rcVq5IXZF4HcxMY=; b=CCy9lz9ONdMJNOTZmt2IEm5pqaHO/VxVKr32FQCL6dEIhduL1l1GlGeJ4I5CWMyra5 nQj38UYhh56MBgohgufV8YGcTzOupjsEEIvxg8kYyrxAAXRtoJv0VOzK6QXNgfa0H+J/ z1imaJv3wOpDMZOOUPe6fwShv2Bjnp0yxNXkTi9SgJtZzPY2gjJzTiHHNyAcEDSC65tR gGLLAMMvnFYzADipHjvS7S4Q8Qc1u9/cVxzliwDjY4P3795aaACAtq6524y5HFZY7/Ls Shbi3tIvhbW5z4Sqvd0kgFRZFW9Yt5dAXl58ryFJNZ/A3OPGEdW9IRfbbC0nUof1kk8q k7Dw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1732243232; x=1732848032; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=8PDpQ9GWq+mb2ntUg+Zqr97+I+H0rcVq5IXZF4HcxMY=; b=DYdssdC0Gws9hsTalDNbf+1wBclaicTkDLRIzvIMDMVR9dGVlL9Zt5EesxakEjuJE1 Q1EqyucyDVr21X+MnCJ9c0UoA6HWV9hLdGRbi3nsY4BHLjjJqg/pTPheQUe8tjlEkzbe UlzYXNO+0tPVk33ldkItYTAgC8hRh+WBmUCnwQimq4QXMU/pwN7qVkkjlkP4jcn2ixPi idDwGSR0tpP36ItmBrjS/L0g1anRxwYvqbI/5JEa5Ls+cdePmOOaRy9bR2dJz9+5I2wY 4VzUqKazwK9XQM9qYQPjiOY1KS+TfnTveIPvDKT0tm0hAuJ99dO3W2NTy241wo0LwjPs sNPQ== X-Gm-Message-State: AOJu0Yzz0MONsl1DpVJW0Ln/MNxEE9sIWwskljbQp1q/Z4xlABnn/fFE mbgRtqKkhlq7I64AJu0wdBv/QAZUuY7/5w9LOUobs72SCwT1g2z17Vwy7g== X-Gm-Gg: ASbGncu3B95HuHuggZ5CXojLiKK26DBIfQK0tUoZ7VnKk+YkoAs1RiHcozvPdpDlITq lEP+dyMJD+WPeTG5M6nioJ9MQTaPGW7YcDr2qHLGogl/6c7TFKoie0QoYpVA8jGlYaXOYMmplbY VRNpyfajPhpk7vYUy1//w8l9MauZVdpMTvEcrfitvQW2HE+QCsWugfWqLC/QMzFXO5kXFrUpRNK R6kDiWzpe6oG3X8drxhcGcHMP5kl5nOcjbwNY2ffZ6iPAcwPsg/osL8P0Blodcu3X6YpNWfrOHx DwsTtaMY0rIEPBVycUIU5lgaMKOuD4oiYd9bjE8ic6r6oDSM X-Google-Smtp-Source: AGHT+IEZXBKrzHd93l7WTbHMck9UMWhdYvkOu2LNa2/rfQOHN7a7m8ZUGjAOuAEkrUQyQk5lVxEFAQ== X-Received: by 2002:a05:6830:390c:b0:718:65f3:6b3e with SMTP id 46e09a7af769-71c04ba3090mr1343868a34.15.1732243232083; Thu, 21 Nov 2024 18:40:32 -0800 (PST) Received: from localhost.localdomain (syn-076-032-089-124.res.spectrum.com. [76.32.89.124]) by smtp.gmail.com with ESMTPSA id 41be03b00d2f7-7fbcc3de284sm506703a12.55.2024.11.21.18.40.31 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 21 Nov 2024 18:40:31 -0800 (PST) From: Nandini Persad To: dev@dpdk.org Subject: [PATCH v2] doc: reword glossary Date: Thu, 21 Nov 2024 18:40:23 -0800 Message-Id: <20241122024023.31914-1-nandinipersad361@gmail.com> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20241122022645.31480-1-nandinipersad361@gmail.com> References: <20241122022645.31480-1-nandinipersad361@gmail.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org I added additional reference links and definitions to many of the terms in the glossary. Please feel free to provide feedback to ensure my definitions suit the proper context in the DPDK community. Signed-off-by: Nandini Persad --- doc/guides/prog_guide/glossary.rst | 101 ++++++++++++++++++++++------- 1 file changed, 78 insertions(+), 23 deletions(-) diff --git a/doc/guides/prog_guide/glossary.rst b/doc/guides/prog_guide/glossary.rst index 8d6349701e..9f85e46437 100644 --- a/doc/guides/prog_guide/glossary.rst +++ b/doc/guides/prog_guide/glossary.rst @@ -6,70 +6,92 @@ Glossary ACL - Access Control List + An access control list (ACL) is a set of rules that define who can access a resource and what actions they can perform. + `ACL Link `_ API Application Programming Interface ASLR Linux* kernel Address-Space Layout Randomization + A computer security technique that protects against buffer overflow attacks by randomizing the location of executables in memory in Linux. + `ASLR Link `_ BSD - Berkeley Software Distribution + Berkeley Software Distribution is a Unix-like operating system. Clr Clear CIDR Classless Inter-Domain Routing + A method of assigning IP address that improves data routing efficiency on the internet and is used in IPv4 and IPv6. + `RFC Link `_ Control Plane - The control plane is concerned with the routing of packets and with - providing a start or end point. + A Control Plane is a key concept in networking that refers to the part of a network system + responsible for managing and making decisions about where and how data packets are forwarded within a network. Core - A core may include several lcores or threads if the processor supports - hyperthreading. + A core may include several lcores or threads if the processor supports simultaneous multithreading (SMT). + `Simultaneous Multithreading `_ Core Components - A set of libraries provided by the DPDK, including eal, ring, mempool, - mbuf, timers, and so on. + A set of libraries provided by DPDK which are used by nearly all applications and + upon which other DPDK libraries and drivers depend. For example, eal, ring, mempool and mbuf. CPU Central Processing Unit CRC Cyclic Redundancy Check + An algorithm that detects errors in data transmission and storage. Data Plane - In contrast to the control plane, the data plane in a network architecture - are the layers involved when forwarding packets. These layers must be - highly optimized to achieve good performance. + In contrast to the control plane, which is responsible for setting up and managing data connections, + the data plane in a network architecture includes the layers involved when processing and forwarding + data packets between communicating endpoints. These layers must be highly optimized to achieve good performance. DIMM Dual In-line Memory Module + A module containing one or several Random Access Memory (RAM) or Dynamic RAM (DRAM) chips on a printed + circuit board that connect it directly to the computer motherboard. Doxygen A documentation generator used in the DPDK to generate the API reference. + `Doxygen Link `_ DPDK Data Plane Development Kit DRAM Dynamic Random Access Memory + A type of random access memory (RAM) that is used in computers to temporarily store information. + `Link `_ EAL - The Environment Abstraction Layer (EAL) provides a generic interface that - hides the environment specifics from the applications and libraries. The - services expected from the EAL are: development kit loading and launching, - core affinity/ assignment procedures, system memory allocation/description, - PCI bus access, inter-partition communication. + The Environment Abstraction Layer (EAL) is a DPDK core library that provides a generic interface + that hides the environment specifics from the applications and libraries. The services expected + from the EAL are: development kit loading and launching, core affinity/ assignment procedures, system + memory allocation/description, PCI bus access, inter-partition communication. + `Link `_ + +EAL Thread + An EAL thread is typically a thread that runs packet processing tasks. These threads are often + pinned to logical cores (lcores), which helps to ensure that packet processing tasks are executed with + minimal interruption and maximal performance by utilizing specific CPU resources dedicated to those tasks. + EAL threads can also handle other tasks like managing buffers, queues, and I/O operations. FIFO First In First Out + A method for organizing the manipulation of a data structure where the oldest (first) entry, or + "head" of the queue, is processed first. + `Link `_ FPGA Field Programmable Gate Array + An integrated circuit with a programmable hardware fabric that can be reconfigured to suit different purposes. + `Link `_ GbE Gigabit Ethernet @@ -81,11 +103,20 @@ HPET High Precision Event Timer; a hardware timer that provides a precise time reference on x86 platforms. +Huge Pages + Memory page sizes, larger than the default page size, which are supported by the host CPU. + These pages are generally megabytes or even a gigabytes in size, depending on platform, + compared to the default page size on most platforms which is measured in kilobytes, e.g. 4k. + Where the operating system provides access to hugepage memory, DPDK will take advantage of + those hugepages for increased performance. + `Link `_ + ID Identifier IOCTL Input/Output Control + A system call that allows applications to communicate with device drivers to perform specific input/output operations. I/O Input/Output @@ -100,30 +131,39 @@ IPv6 Internet Protocol version 6 lcore - A logical execution unit of the processor, sometimes called a *hardware - thread*. + A logical execution unit of the processor, sometimes called a hardware thread or EAL thread; + Also known as logical core. L1 Layer 1 + The Physical layer of the network responsible for sending and receiving signals to transmit data. L2 Layer 2 L3 Layer 3 + Also known as the network layer, Layer 3 is responsible for packet forwarding including routing through intermediate routers + Example protocols include IP v4 and IP v6. + `Network Layer `_ L4 Layer 4 + Examples include UDP and TCP. + `Transport Layer `_ LAN Local Area Network LPM Longest Prefix Match + A table lookup algorithm where the entry selected is that which matches the longest initial part (or prefix) + of the lookup key, rather than requiring an exact match on the full key. + `Reference Link `_ main lcore - The execution unit that executes the main() function and that launches - other lcores. + The logical core or thread that executes the main function and that launches tasks on other logical + cores used by the application. master lcore Deprecated name for *main lcore*. No longer used. @@ -134,20 +174,21 @@ mbuf concepts of packet buffers or mbuf, refer to *TCP/IP Illustrated, Volume 2: The Implementation*. -MESI - Modified Exclusive Shared Invalid (CPU cache coherency protocol) - MTU Maximum Transfer Unit + The size of the largest protocol data unit (PDU) that can be communicated in a single network layer transaction. NIC Network Interface Card + A hardware component, usually a circuit board or chip, installed on a computer so it can connect to a network. OOO Out Of Order (execution of instructions within the CPU pipeline) NUMA Non-uniform Memory Access + A computer memory design that allows processors to access memory faster when it's located closer to them. + `Reference Link `_ PCI Peripheral Connect Interface @@ -163,12 +204,16 @@ pktmbuf PMD Poll Mode Driver + A program that continuously polls a network interface card (NIC) for new packets, + instead of waiting for the NIC to interrupt the CPU. PMDs are used to quickly receive, + process, and deliver packets in a user's application and use APIs to configure devices and queues. QoS Quality of Service RCU Read-Copy-Update algorithm, an alternative to simple rwlocks. + A synchronization mechanism that allows multiple threads to read and update shared data structures without using locks. Rd Read @@ -198,6 +243,7 @@ SLA srTCM Single Rate Three Color Marking + A policer meters an IP packet stream and marks its packets either green, yellow, or red. SRTD Scheduler Round Trip Delay @@ -218,12 +264,18 @@ TC TLB Translation Lookaside Buffer + A memory cache that stores the recent translations of virtual memory to physical memory to enable faster retrieval. TLS Thread Local Storage + A memory management method that uses static or global memory local to a thread. + `Reference Link `_ trTCM Two Rate Three Color Marking + A component that meters an IP traffic stream, marks it as one of three color category + sand assists in traffic congestion-control. + `RFC Link `_ TSC Time Stamp Counter @@ -245,6 +297,9 @@ Worker lcore WRED Weighted Random Early Detection + A queueing discipline that allows the router to drop random packets to prevent tail drop. + This is helpful for TCP/IP connections. WRR Weighted Round Robin + A scheduling algorithm used to distribute workloads across multiple resources based on assigned weights. -- 2.34.1