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 DD97F45D79; Fri, 22 Nov 2024 03:26:56 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id C446243252; Fri, 22 Nov 2024 03:26:56 +0100 (CET) Received: from mail-pl1-f175.google.com (mail-pl1-f175.google.com [209.85.214.175]) by mails.dpdk.org (Postfix) with ESMTP id D91CB42FA3 for ; Fri, 22 Nov 2024 03:26:55 +0100 (CET) Received: by mail-pl1-f175.google.com with SMTP id d9443c01a7336-21260cfc918so12577325ad.0 for ; Thu, 21 Nov 2024 18:26:55 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1732242414; x=1732847214; darn=dpdk.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=GkfsHWBqAnM/f5fzjpQy2/BaN9NE1SyZ0MUnaRU7Zzw=; b=Pq2oDPOndiLVal675cHJmt5T+SFvZN8mBGONqLTCKvBbuhgftaxAoCysjWCGbWbI/Q F+spdug8LWG10sV6RwYUQjAuFZCLwiyKybbcSQ7ABKlEqbpzzb/iv0cnizWG/iRdCL/D 1Q80yuPkqsRgQ33sT2Gr4EFTaSMlvUcYztIzKxvIyaOxuXxka9jFy+cBfGd4aEx+lkTD UgP9/1bJCqA+5JPlPk3Ymp0TSLJcqOl3GZX2OojnYfQTZ5dnqnZimpnuqHkkSZkbGFpu S6QSgRLdZhpcgqTNxb24ClnurcfABLY/f9KpAXMPh7AhhwzVKBw97ZBzOG+cr3v5SY8C x/Ug== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1732242414; x=1732847214; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=GkfsHWBqAnM/f5fzjpQy2/BaN9NE1SyZ0MUnaRU7Zzw=; b=fjUq59mLwVqcABE3JFLKxPG32Uw4ZIyXVaakcui3VHgh6Y2Ifzd98lg3pL5xUmD9u/ SLyv5puZ3k9JBzERMIibgEtRq1m+So4QhFLJbpexLdd4jfJRql1w9EMMl49+6fMzcH4p RIFAeHEJlw85TfymN0v1p6P2iEySuQfkjsAMUj1mvN9oXcA7pA0u1/xzdldwWPeG1x76 sUTZsMyPbIu6Vlk+pQFoyeIc0CgcWrvkaOEc4KqqRZZe+45EnGVQ4MDKfFjH2+73JiIU Yu/Jlx/yQUg6nq+9DUIUSPGrE1C3rA7DrnvdM4EAFZhzD8Y307SlT6lVkucURBrOb71F 8HtA== X-Gm-Message-State: AOJu0Yy/8lmxvrBfzFKJlcb6wl24qEa2TO1/F6MJTUL4og18gwdb1L7a YEnDpczNNGifkmrHzX/tlDIJ3x36TzN6HDwbXMSCOPA8F5+BIEr6HtXlfA== X-Gm-Gg: ASbGnctr0gfeIyOJlysDPWHUCZdWDDoOnge++2Xc8OXNcpqUYPXD+miilGVg5/uw079 +rzxEyKeDu8mhFwm3Abrotfo7kYu02VE/MJucgjdtveEgg3tbhntUqutiSZjuSSbOTjje0j7ewV FbFo1b7NqLss6hT4eN6nTSL5i42kp8tWVorkKMCisx48E1TfoJZz18etNsFa0jZPXbmhQ2SHGkj JAhIE7fNAryJozbma6j9BDBkV0oYPpoETA58awwCknIuqtOahTByJMhhW8FyWrV+yOQovZwaKQy HnBuTzcxo1+UDllRwnyO4/PZKw76sxzsJZeaJW14hfucIrWH X-Google-Smtp-Source: AGHT+IFqvE6XiteO3iH7zpUiLm/n+gYhKslF+Z0lTIJdZJezxTmuHiGP52ABzLeaYcwEYMLmvNpdqg== X-Received: by 2002:a17:902:db03:b0:20c:8f98:5dbe with SMTP id d9443c01a7336-2129f7c3b81mr14491055ad.33.1732242414292; Thu, 21 Nov 2024 18:26:54 -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 d9443c01a7336-2129db8c8e3sm5201805ad.56.2024.11.21.18.26.53 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 21 Nov 2024 18:26:53 -0800 (PST) From: Nandini Persad To: Cc: dev@dpdk.org Subject: [PATCH] doc: reword glossary Date: Thu, 21 Nov 2024 18:26:45 -0800 Message-Id: <20241122022645.31480-1-nandinipersad361@gmail.com> X-Mailer: git-send-email 2.34.1 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 | 107 ++++++++++++++++++++++------- 1 file changed, 81 insertions(+), 26 deletions(-) diff --git a/doc/guides/prog_guide/glossary.rst b/doc/guides/prog_guide/glossary.rst index 8d6349701e..fc79e9656f 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 @@ -80,12 +102,21 @@ HW 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 categorie + 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