Programmer’s Guide

• 1. Introduction
  • 1.1. Documentation Roadmap
  • 1.2. Related Publications
• 2. Overview
  • 2.1. Development Environment
  • 2.2. Environment Abstraction Layer
  • 2.3. Core Components
    • 2.3.1. Ring Manager (librte_ring)
    • 2.3.2. Memory Pool Manager (librte_mempool)
    • 2.3.3. Network Packet Buffer Management (librte_mbuf)
    • 2.3.4. Timer Manager (librte_timer)
  • 2.4. Ethernet* Poll Mode Driver Architecture
  • 2.5. Packet Forwarding Algorithm Support
  • 2.6. librte_net
• 3. Source Organization
  • 3.1. Libraries
  • 3.2. Drivers
  • 3.3. Applications
• 4. Environment Abstraction Layer
  • 4.1. EAL in a Linux-userland Execution Environment
    • 4.1.1. Initialization and Core Launching
    • 4.1.2. Shutdown and Cleanup
    • 4.1.3. Multi-process Support
    • 4.1.4. Memory Mapping Discovery and Memory Reservation
    • 4.1.5. Support for Externally Allocated Memory
    • 4.1.6. Per-lcore and Shared Variables
    • 4.1.7. Logs
    • 4.1.8. CPU Feature Identification
    • 4.1.9. User Space Interrupt Event
    • 4.1.10. Block list
    • 4.1.11. Misc Functions
    • 4.1.12. Lock annotations
    • 4.1.13. IOVA Mode Detection
    • 4.1.14. IOVA Mode Configuration
    • 4.1.15. Max SIMD bitwidth
  • 4.2. Memory Segments and Memory Zones (memzone)
  • 4.3. Multiple pthread
    • 4.3.1. EAL pthread and lcore Affinity
    • 4.3.2. non-EAL pthread support
    • 4.3.3. Public Thread API
    • 4.3.4. Control Thread API
    • 4.3.5. Known Issues
    • 4.3.6. Signal Safety
    • 4.3.7. cgroup control
  • 4.4. Malloc
    • 4.4.1. Alignment and NUMA Constraints
    • 4.4.2. Use Cases
    • 4.4.3. Internal Implementation
• 5. Service Cores
  • 5.1. Service Core Initialization
  • 5.2. Enabling Services on Cores
  • 5.3. Service Core Statistics
  • 5.4. Service Core Tracing
• 6. Trace Library
  • 6.1. Overview
  • 6.2. DPDK tracing library features
  • 6.3. How to add a tracepoint?
    • 6.3.1. Create the tracepoint header file
    • 6.3.2. Register the tracepoint
  • 6.4. Fast path tracepoint
  • 6.5. Event record mode
  • 6.6. Trace file location
  • 6.7. View and analyze the recorded events
    • 6.7.1. Use the babeltrace command-line tool
    • 6.7.2. Use the tracecompass GUI tool
  • 6.8. Quick start
  • 6.9. Implementation details
    • 6.9.1. Trace metadata creation
    • 6.9.2. Trace memory
    • 6.9.3. Trace memory layout
  • 6.10. Limitations
• 7. RCU Library
  • 7.1. What is Quiescent State
  • 7.2. Factors affecting the RCU mechanism
  • 7.3. RCU in DPDK
  • 7.4. How to use this library
  • 7.5. Resource reclamation framework for DPDK
• 8. Ring Library
  • 8.1. References for Ring Implementation in FreeBSD*
  • 8.2. Lockless Ring Buffer in Linux*
  • 8.3. Additional Features
    • 8.3.1. Name
  • 8.4. Use Cases
  • 8.5. Anatomy of a Ring Buffer
    • 8.5.1. Single Producer Enqueue
    • 8.5.2. Single Consumer Dequeue
    • 8.5.3. Multiple Producers Enqueue
    • 8.5.4. Modulo 32-bit Indexes
  • 8.6. Producer/consumer synchronization modes
    • 8.6.1. MP/MC (default one)
    • 8.6.2. SP/SC
    • 8.6.3. MP_RTS/MC_RTS
    • 8.6.4. MP_HTS/MC_HTS
  • 8.7. Ring Peek API
  • 8.8. Ring Peek Zero Copy API
  • 8.9. References
• 9. Stack Library
  • 9.1. Implementation
    • 9.1.1. Lock-based Stack
    • 9.1.2. Lock-free Stack
• 10. Mempool Library
  • 10.1. Cookies
  • 10.2. Stats
  • 10.3. Memory Alignment Constraints on x86 architecture
  • 10.4. Local Cache
  • 10.5. Mempool Handlers
  • 10.6. Use Cases
• 11. Mbuf Library
  • 11.1. Design of Packet Buffers
  • 11.2. Buffers Stored in Memory Pools
  • 11.3. Constructors
  • 11.4. Allocating and Freeing mbufs
  • 11.5. Manipulating mbufs
  • 11.6. Meta Information
    • 11.6.1. Dynamic fields and flags
  • 11.7. Direct and Indirect Buffers
  • 11.8. Debug
  • 11.9. Use Cases
• 12. Poll Mode Driver
  • 12.1. Requirements and Assumptions
  • 12.2. Design Principles
  • 12.3. Logical Cores, Memory and NIC Queues Relationships
  • 12.4. Device Identification, Ownership and Configuration
    • 12.4.1. Device Identification
    • 12.4.2. Port Ownership
    • 12.4.3. Device Configuration
    • 12.4.4. On-the-Fly Configuration
    • 12.4.5. Configuration of Transmit Queues
    • 12.4.6. Free Tx mbuf on Demand
    • 12.4.7. Hardware Offload
  • 12.5. Poll Mode Driver API
    • 12.5.1. Generalities
    • 12.5.2. Generic Packet Representation
    • 12.5.3. Ethernet Device API
    • 12.5.4. Ethernet Device Standard Device Arguments
    • 12.5.5. Extended Statistics API
    • 12.5.6. NIC Reset API
    • 12.5.7. Proactive Error Handling Mode
• 13. Generic flow API (rte_flow)
  • 13.1. Overview
  • 13.2. Flow rule
    • 13.2.1. Description
    • 13.2.2. Attributes
    • 13.2.3. Pattern item
    • 13.2.4. Matching pattern
    • 13.2.5. Meta item types
    • 13.2.6. Data matching item types
    • 13.2.7. Actions
    • 13.2.8. Action types
    • 13.2.9. Negative types
  • 13.3. Rules management
    • 13.3.1. Validation
    • 13.3.2. Creation
    • 13.3.3. Destruction
    • 13.3.4. Update
    • 13.3.5. Flush
    • 13.3.6. Query
  • 13.4. Flow engine configuration
    • 13.4.1. Configuration
    • 13.4.2. Flow templates
  • 13.5. Asynchronous operations
    • 13.5.1. Enqueue creation operation
    • 13.5.2. Enqueue creation by index operation
    • 13.5.3. Enqueue destruction operation
    • 13.5.4. Enqueue update operation
    • 13.5.5. Enqueue indirect action creation operation
    • 13.5.6. Enqueue indirect action destruction operation
    • 13.5.7. Enqueue indirect action update operation
    • 13.5.8. Enqueue indirect action query operation
    • 13.5.9. Push enqueued operations
    • 13.5.10. Pull enqueued operations
  • 13.6. Flow isolated mode
  • 13.7. Verbose error reporting
  • 13.8. Helpers
    • 13.8.1. Error initializer
    • 13.8.2. Object conversion
    • 13.8.3. Tunneled traffic offload
  • 13.9. Caveats
  • 13.10. PMD interface
  • 13.11. Device compatibility
    • 13.11.1. Global bit-masks
    • 13.11.2. Unsupported layer types
    • 13.11.3. ANY pattern item
    • 13.11.4. Unsupported actions
    • 13.11.5. Flow rules priority
• 14. Switch Representation within DPDK Applications
  • 14.1. Introduction
  • 14.2. Sub Function
  • 14.3. Port Representors
  • 14.4. Basic SR-IOV
  • 14.5. Controlled SR-IOV
    • 14.5.1. Initialization
    • 14.5.2. VF Representors
    • 14.5.3. Traffic Steering
  • 14.6. Flow API (rte_flow)
    • 14.6.1. Extensions
    • 14.6.2. Traffic Direction
    • 14.6.3. Transferring Traffic
    • 14.6.4. Pattern Items And Actions
    • 14.6.5. Actions Order and Repetition
  • 14.7. Switching Examples
    • 14.7.1. Associating VF 1 with Physical Port 0
    • 14.7.2. Sharing Broadcasts
    • 14.7.3. Encapsulating VF 2 Traffic in VXLAN
• 15. Traffic Metering and Policing API
  • 15.1. Overview
  • 15.2. Configuration steps
  • 15.3. Run-time processing
  • 15.4. API walk-through
  • 15.5. Protocol based input color selection
• 16. Traffic Management API
  • 16.1. Overview
  • 16.2. Capability API
  • 16.3. Scheduling Algorithms
  • 16.4. Traffic Shaping
  • 16.5. Congestion Management
  • 16.6. Packet Marking
  • 16.7. Steps to Setup the Hierarchy
    • 16.7.1. Initial Hierarchy Specification
    • 16.7.2. Hierarchy Commit
    • 16.7.3. Run-Time Hierarchy Updates
• 17. Wireless Baseband Device Library
  • 17.1. Design Principles
  • 17.2. Device Management
    • 17.2.1. Device Creation
    • 17.2.2. Device Identification
    • 17.2.3. Device Configuration
    • 17.2.4. Queues Configuration
    • 17.2.5. Device & Queues Management
    • 17.2.6. Logical Cores, Memory and Queues Relationships
  • 17.3. Device Operation Capabilities
    • 17.3.1. Capabilities Discovery
  • 17.4. Operation Processing
    • 17.4.1. Enqueue / Dequeue Burst APIs
    • 17.4.2. Operation Representation
    • 17.4.3. Operation Management and Allocation
    • 17.4.4. BBDEV Inbound/Outbound Memory
    • 17.4.5. BBDEV Turbo Encode Operation
    • 17.4.6. BBDEV Turbo Decode Operation
    • 17.4.7. BBDEV LDPC Encode Operation
    • 17.4.8. BBDEV LDPC Decode Operation
    • 17.4.9. BBDEV FFT Operation
  • 17.5. Sample code
    • 17.5.1. BBDEV Device API
• 18. Cryptography Device Library
  • 18.1. Design Principles
  • 18.2. Device Management
    • 18.2.1. Device Creation
    • 18.2.2. Device Identification
    • 18.2.3. Device Configuration
    • 18.2.4. Configuration of Queue Pairs
    • 18.2.5. Logical Cores, Memory and Queues Pair Relationships
  • 18.3. Device Features and Capabilities
    • 18.3.1. Device Features
    • 18.3.2. Device Operation Capabilities
    • 18.3.3. Capabilities Discovery
  • 18.4. Operation Processing
    • 18.4.1. Private data
    • 18.4.2. User callback APIs
    • 18.4.3. Enqueue / Dequeue Burst APIs
    • 18.4.4. Operation Representation
    • 18.4.5. Operation Management and Allocation
  • 18.5. Symmetric Cryptography Support
    • 18.5.1. Session and Session Management
    • 18.5.2. Transforms and Transform Chaining
    • 18.5.3. Symmetric Operations
  • 18.6. Synchronous mode
    • 18.6.1. Cryptodev Raw Data-path APIs
  • 18.7. Sample code
  • 18.8. Asymmetric Cryptography
    • 18.8.1. Session and Session Management
    • 18.8.2. Asymmetric Sessionless Support
    • 18.8.3. Transforms and Transform Chaining
    • 18.8.4. Asymmetric Operations
    • 18.8.5. Private user data
  • 18.9. Asymmetric crypto Sample code
    • 18.9.1. Asymmetric Crypto Device API
  • 18.10. Device Statistics
• 19. Compression Device Library
  • 19.1. Device Management
    • 19.1.1. Device Creation
    • 19.1.2. Device Identification
    • 19.1.3. Device Configuration
    • 19.1.4. Configuration of Queue Pairs
    • 19.1.5. Logical Cores, Memory and Queue Pair Relationships
  • 19.2. Device Features and Capabilities
    • 19.2.1. Capabilities
    • 19.2.2. Capabilities Discovery
  • 19.3. Compression Operation
    • 19.3.1. Operation Representation
    • 19.3.2. Operation Management and Allocation
    • 19.3.3. Passing source data as mbuf-chain
    • 19.3.4. Operation Status
    • 19.3.5. Operation status after enqueue / dequeue
    • 19.3.6. Produced, Consumed And Operation Status
  • 19.4. Transforms
  • 19.5. Compression API Hash support
  • 19.6. Compression API Stateless operation
    • 19.6.1. priv_xform in Stateless operation
    • 19.6.2. Stateless and OUT_OF_SPACE
    • 19.6.3. Hash in Stateless
    • 19.6.4. Checksum in Stateless
  • 19.7. Compression API Stateful operation
    • 19.7.1. Stream in Stateful operation
    • 19.7.2. Stateful and OUT_OF_SPACE
    • 19.7.3. Hash in Stateful
    • 19.7.4. Checksum in Stateful
  • 19.8. Burst in compression API
    • 19.8.1. Enqueue / Dequeue Burst APIs
  • 19.9. Sample code
    • 19.9.1. Compression Device API
• 20. RegEx Device Library
  • 20.1. Design Principles
  • 20.2. Device Management
    • 20.2.1. Device Creation
    • 20.2.2. Device Identification
    • 20.2.3. Device Configuration
    • 20.2.4. Configuration of Rules Database
    • 20.2.5. Configuration of Queue Pairs
    • 20.2.6. Logical Cores, Memory and Queues Pair Relationships
  • 20.3. Device Features and Capabilities
    • 20.3.1. Enqueue / Dequeue Burst APIs
• 21. Machine Learning Device Library
  • 21.1. Design Principles
  • 21.2. Device Operations
    • 21.2.1. Device Creation
    • 21.2.2. Device Identification
    • 21.2.3. Device Features and Capabilities
    • 21.2.4. Device Configuration
    • 21.2.5. Configuration of Queue Pairs
    • 21.2.6. Logical Cores, Memory and Queues Pair Relationships
    • 21.2.7. Configuration of Machine Learning models
    • 21.2.8. Enqueue / Dequeue
    • 21.2.9. Quantize and Dequantize
• 22. DMA Device Library
  • 22.1. Design Principles
  • 22.2. Device Management
    • 22.2.1. Device Creation
    • 22.2.2. Device Identification
  • 22.3. Device Features and Capabilities
    • 22.3.1. Enqueue / Dequeue APIs
    • 22.3.2. Querying Device Statistics
• 23. General-Purpose Graphics Processing Unit Library
  • 23.1. Features
  • 23.2. API Overview
    • 23.2.1. Child Device
    • 23.2.2. Memory Allocation
    • 23.2.3. Memory Registration
    • 23.2.4. CPU mapping
    • 23.2.5. Memory Barrier
    • 23.2.6. Communication Flag
    • 23.2.7. Communication list
  • 23.3. CUDA Example
• 24. Security Library
  • 24.1. Design Principles
    • 24.1.1. Inline Crypto
    • 24.1.2. Inline protocol offload
    • 24.1.3. Lookaside protocol offload
    • 24.1.4. PDCP Flow Diagram
    • 24.1.5. DOCSIS Protocol
    • 24.1.6. MACSEC Protocol
  • 24.2. Device Features and Capabilities
    • 24.2.1. Device Capabilities For Security Operations
    • 24.2.2. Capabilities Discovery
    • 24.2.3. Security Session Create/Free
    • 24.2.4. Security session configuration
    • 24.2.5. Security API
    • 24.2.6. Flow based Security Session
  • 24.3. Telemetry support
• 25. Rawdevice Library
  • 25.1. Introduction
  • 25.2. Design
    • 25.2.1. Device Identification
• 26. Link Bonding Poll Mode Driver Library
  • 26.1. Link Bonding Modes Overview
  • 26.2. Implementation Details
    • 26.2.1. Link Status Change Interrupts / Polling
    • 26.2.2. Requirements / Limitations
    • 26.2.3. Configuration
  • 26.3. Using Link Bonding Devices
    • 26.3.1. Using the Poll Mode Driver from an Application
    • 26.3.2. Using Link Bonding Devices from the EAL Command Line
  • 26.4. Testpmd driver specific commands
    • 26.4.1. create bonded device
    • 26.4.2. add bonding slave
    • 26.4.3. remove bonding slave
    • 26.4.4. set bonding mode
    • 26.4.5. set bonding primary
    • 26.4.6. set bonding mac
    • 26.4.7. set bonding balance_xmit_policy
    • 26.4.8. set bonding mon_period
    • 26.4.9. set bonding lacp dedicated_queue
    • 26.4.10. set bonding agg_mode
    • 26.4.11. show bonding config
• 27. Timer Library
  • 27.1. Implementation Details
  • 27.2. Use Cases
  • 27.3. References
• 28. Hash Library
  • 28.1. Hash API Overview
  • 28.2. Multi-process support
  • 28.3. Multi-thread support
  • 28.4. Extendable Bucket Functionality support
  • 28.5. Implementation Details (non Extendable Bucket Case)
  • 28.6. Implementation Details (with Extendable Bucket)
  • 28.7. Entry distribution in hash table
  • 28.8. Use Case: Flow Classification
  • 28.9. References
• 29. Toeplitz Hash Library
  • 29.1. Toeplitz hash function API
  • 29.2. Predictable RSS
    • 29.2.1. Thash context
    • 29.2.2. Thash helper
    • 29.2.3. Calculation of the complementary bits to adjust the subtuple
    • 29.2.4. Adjust tuple API
  • 29.3. Use case example
• 30. Elastic Flow Distributor Library
  • 30.1. Introduction
  • 30.2. Flow Based Distribution
    • 30.2.1. Computation Based Schemes
    • 30.2.2. Flow-Table Based Schemes
    • 30.2.3. EFD Based Scheme
  • 30.3. Example of EFD Library Usage
  • 30.4. Library API Overview
    • 30.4.1. EFD Table Create
    • 30.4.2. EFD Insert and Update
    • 30.4.3. EFD Lookup
    • 30.4.4. EFD Delete
  • 30.5. Library Internals
    • 30.5.1. Insert Function Internals
    • 30.5.2. Lookup Function Internals
    • 30.5.3. Group Rebalancing Function Internals
  • 30.6. References
• 31. Membership Library
  • 31.1. Introduction
  • 31.2. Vector of Bloom Filters
  • 31.3. Hash-Table based Set-Summaries
    • 31.3.1. Set-Summaries with False Negative Probability
  • 31.4. Library API Overview
    • 31.4.1. Set-summary Create
    • 31.4.2. Set-summary Element Insertion
    • 31.4.3. Set-summary Element Lookup
    • 31.4.4. Set-summary Element Delete
  • 31.5. References
• 32. LPM Library
  • 32.1. LPM API Overview
  • 32.2. Implementation Details
    • 32.2.1. Addition
    • 32.2.2. Deletion
    • 32.2.3. Lookup
    • 32.2.4. Limitations in the Number of Rules
    • 32.2.5. Use Case: IPv4 Forwarding
    • 32.2.6. References
• 33. LPM6 Library
  • 33.1. LPM6 API Overview
    • 33.1.1. Implementation Details
    • 33.1.2. Addition
    • 33.1.3. Lookup
    • 33.1.4. Limitations in the Number of Rules
  • 33.2. Use Case: IPv6 Forwarding
• 34. FIB Library
  • 34.1. FIB API Overview
  • 34.2. Implementation details
  • 34.3. Dataplane Algorithms
    • 34.3.1. Dummy
    • 34.3.2. DIR-24-8
  • 34.4. Use cases
• 35. RIB Library
  • 35.1. Implementation details
  • 35.2. RIB API Overview
  • 35.3. Extensions usage example
• 36. Flow Classification Library
  • 36.1. Overview
    • 36.1.1. Classifier creation
    • 36.1.2. Adding a table to the Classifier
    • 36.1.3. Flow Parsing
    • 36.1.4. Adding Flow Rules
    • 36.1.5. Deleting Flow Rules
    • 36.1.6. Packet Matching
• 37. Packet Distributor Library
  • 37.1. Distributor Core Operation
  • 37.2. Worker Operation
• 38. Reorder Library
  • 38.1. Operation
  • 38.2. Implementation Details
  • 38.3. Use Case: Packet Distributor
• 39. IP Fragmentation and Reassembly Library
  • 39.1. Packet fragmentation
  • 39.2. Packet reassembly
    • 39.2.1. IP Fragment Table
    • 39.2.2. Packet Reassembly
    • 39.2.3. Debug logging and Statistics Collection
• 40. Generic Receive Offload Library
  • 40.1. Overview
  • 40.2. Two Sets of API
    • 40.2.1. Lightweight Mode API
    • 40.2.2. Heavyweight Mode API
  • 40.3. Reassembly Algorithm
    • 40.3.1. Challenges
    • 40.3.2. Key-based Reassembly Algorithm
  • 40.4. TCP-IPv4/IPv6 GRO
  • 40.5. VxLAN GRO
  • 40.6. GRO Library Limitations
• 41. Generic Segmentation Offload Library
  • 41.1. Overview
  • 41.2. Limitations
  • 41.3. Packet Segmentation
    • 41.3.1. GSO Output Segment Format
  • 41.4. Supported GSO Packet Types
    • 41.4.1. TCP/IPv4 GSO
    • 41.4.2. UDP/IPv4 GSO
    • 41.4.3. VXLAN IPv4 GSO
    • 41.4.4. GRE TCP/IPv4 GSO
  • 41.5. How to Segment a Packet
• 42. IPsec Packet Processing Library
  • 42.1. SA level API
    • 42.1.1. RTE_SECURITY_ACTION_TYPE_NONE
    • 42.1.2. RTE_SECURITY_ACTION_TYPE_CPU_CRYPTO
    • 42.1.3. RTE_SECURITY_ACTION_TYPE_INLINE_CRYPTO
    • 42.1.4. RTE_SECURITY_ACTION_TYPE_INLINE_PROTOCOL
    • 42.1.5. RTE_SECURITY_ACTION_TYPE_LOOKASIDE_PROTOCOL
  • 42.2. SA database API
    • 42.2.1. Create/destroy
    • 42.2.2. Add/delete rules
    • 42.2.3. Lookup
  • 42.3. Supported features
  • 42.4. Telemetry support
  • 42.5. Limitations
• 43. PDCP Protocol Processing Library
  • 43.1. PDCP entity API
  • 43.2. PDCP PDU (Protocol Data Unit) API
    • 43.2.1. PDCP packet processing API for control PDU
    • 43.2.2. PDCP packet processing API for data PDU
  • 43.3. Supported features
    • 43.3.1. Supported ciphering algorithms
    • 43.3.2. Supported integrity protection algorithms
  • 43.4. Timers
  • 43.5. Sample API usage
• 44. Packet Capture Next Generation Library
  • 44.1. Usage
• 45. Packet Capture Library
  • 45.1. Operation
  • 45.2. Implementation Details
  • 45.3. Use Case: Packet Capturing
• 46. Multi-process Support
  • 46.1. Memory Sharing
  • 46.2. Deployment Models
    • 46.2.1. Symmetric/Peer Processes
    • 46.2.2. Asymmetric/Non-Peer Processes
    • 46.2.3. Running Multiple Independent DPDK Applications
    • 46.2.4. Running Multiple Independent Groups of DPDK Applications
  • 46.3. Multi-process Limitations
  • 46.4. Communication between multiple processes
    • 46.4.1. Registering for incoming messages
    • 46.4.2. Sending messages
    • 46.4.3. Sending requests
    • 46.4.4. Receiving and responding to messages
    • 46.4.5. Misc considerations
• 47. Kernel NIC Interface
  • 47.1. The DPDK KNI Kernel Module
    • 47.1.1. Loopback Mode
    • 47.1.2. Kernel Thread Mode
    • 47.1.3. Default Carrier State
    • 47.1.4. Bifurcated Device Support
    • 47.1.5. KNI Kthread Scheduling
  • 47.2. KNI Creation and Deletion
  • 47.3. DPDK mbuf Flow
  • 47.4. Use Case: Ingress
  • 47.5. Use Case: Egress
  • 47.6. IOVA = VA: Support
  • 47.7. Ethtool
• 48. Thread Safety of DPDK Functions
  • 48.1. Fast-Path APIs
  • 48.2. Performance Insensitive API
  • 48.3. Library Initialization
  • 48.4. Interrupt Thread
• 49. Event Device Library
  • 49.1. Event struct
    • 49.1.1. Event Metadata
    • 49.1.2. Event Payload
    • 49.1.3. Event Vector
    • 49.1.4. Queues
    • 49.1.5. Ports
  • 49.2. API Walk-through
    • 49.2.1. Init and Config
    • 49.2.2. Setting up Queues
    • 49.2.3. Setting up Ports
    • 49.2.4. Linking Queues and Ports
    • 49.2.5. Starting the EventDev
    • 49.2.6. Ingress of New Events
    • 49.2.7. Forwarding of Events
    • 49.2.8. Egress of Events
    • 49.2.9. Quiescing Event Ports
    • 49.2.10. Stopping the EventDev
  • 49.3. Summary
• 50. Event Ethernet Rx Adapter Library
  • 50.1. API Walk-through
    • 50.1.1. Creating an Adapter Instance
    • 50.1.2. Event device configuration for service based adapter
    • 50.1.3. Adding Rx Queues to the Adapter Instance
    • 50.1.4. Querying Adapter Capabilities
    • 50.1.5. Configuring the Service Function
    • 50.1.6. Starting the Adapter Instance
    • 50.1.7. Getting Adapter Statistics
    • 50.1.8. Getting Adapter queue config
    • 50.1.9. Set/Get adapter runtime configuration parameters
    • 50.1.10. Getting and resetting Adapter queue stats
    • 50.1.11. Getting Adapter Instance ID
    • 50.1.12. Interrupt Based Rx Queues
    • 50.1.13. Rx Callback for SW Rx Adapter
    • 50.1.14. Rx event vectorization
    • 50.1.15. Rx event vectorization for SW Rx adapter
• 51. Event Ethernet Tx Adapter Library
  • 51.1. API Walk-through
    • 51.1.1. Creating an Adapter Instance
    • 51.1.2. Event device configuration for service based adapter
    • 51.1.3. Adding Tx Queues to the Adapter Instance
    • 51.1.4. Querying Adapter Capabilities
    • 51.1.5. Linking a Queue to the Adapter’s Event Port
    • 51.1.6. Configuring the Service Function
    • 51.1.7. Starting the Adapter Instance
    • 51.1.8. Enqueuing Packets to the Adapter
    • 51.1.9. Getting Adapter Statistics
    • 51.1.10. Getting Adapter Instance ID
    • 51.1.11. Tx event vectorization
    • 51.1.12. Queue start/stop
    • 51.1.13. Set/Get adapter runtime configuration parameters
• 52. Event Timer Adapter Library
  • 52.1. Event Timer struct
    • 52.1.1. Timer Expiry Event
    • 52.1.2. Timeout Ticks
    • 52.1.3. State
    • 52.1.4. User Metadata
  • 52.2. API Overview
    • 52.2.1. Create and Configure an Adapter Instance
    • 52.2.2. Retrieve Event Timer Adapter Contextual Information
    • 52.2.3. Configuring the Service Component
    • 52.2.4. Starting the Adapter Instance
    • 52.2.5. Arming Event Timers
    • 52.2.6. Canceling Event Timers
  • 52.3. Processing Timer Expiry Events
  • 52.4. Summary
• 53. Event Crypto Adapter Library
  • 53.1. Adapter Mode
    • 53.1.1. RTE_EVENT_CRYPTO_ADAPTER_OP_NEW mode
    • 53.1.2. RTE_EVENT_CRYPTO_ADAPTER_OP_FORWARD mode
  • 53.2. API Overview
    • 53.2.1. Create an adapter instance
    • 53.2.2. Event device configuration for service based adapter
    • 53.2.3. Querying adapter capabilities
    • 53.2.4. Adding queue pair to the adapter instance
    • 53.2.5. Configure the service function
    • 53.2.6. Set event request/response information
    • 53.2.7. Enable event vectorization
    • 53.2.8. Start the adapter instance
    • 53.2.9. Get adapter statistics
    • 53.2.10. Set/Get adapter runtime configuration parameters
• 54. Quality of Service (QoS) Framework
  • 54.1. Packet Pipeline with QoS Support
  • 54.2. Hierarchical Scheduler
    • 54.2.1. Overview
    • 54.2.2. Scheduling Hierarchy
    • 54.2.3. Application Programming Interface (API)
    • 54.2.4. Implementation
    • 54.2.5. Worst Case Scenarios for Performance
  • 54.3. Droppers
    • 54.3.1. Configuration
    • 54.3.2. Enqueue Operation
    • 54.3.3. Queue Empty Operation
    • 54.3.4. Source Files Location
    • 54.3.5. Integration with the DPDK QoS Scheduler
    • 54.3.6. Integration with the DPDK QoS Scheduler Sample Application
    • 54.3.7. Application Programming Interface (API)
  • 54.4. Traffic Metering
    • 54.4.1. Functional Overview
    • 54.4.2. Implementation Overview
• 55. Power Management
  • 55.1. CPU Frequency Scaling
  • 55.2. Core-load Throttling through C-States
  • 55.3. Per-core Turbo Boost
  • 55.4. Use of Power Library in a Hyper-Threaded Environment
  • 55.5. API Overview of the Power Library
  • 55.6. User Cases
  • 55.7. Ethernet PMD Power Management API
    • 55.7.1. Abstract
    • 55.7.2. API Overview for Ethernet PMD Power Management
  • 55.8. Intel Uncore API
    • 55.8.1. Abstract
    • 55.8.2. API Overview for Intel Uncore
  • 55.9. References
• 56. Packet Classification and Access Control
  • 56.1. Overview
    • 56.1.1. Rule definition
    • 56.1.2. RT memory size limit
    • 56.1.3. Classification methods
  • 56.2. Application Programming Interface (API) Usage
    • 56.2.1. Classify with Multiple Categories
• 57. Packet Framework
  • 57.1. Design Objectives
  • 57.2. Overview
  • 57.3. Port Library Design
    • 57.3.1. Port Types
    • 57.3.2. Port Interface
  • 57.4. Table Library Design
    • 57.4.1. Table Types
    • 57.4.2. Table Interface
    • 57.4.3. Hash Table Design
  • 57.5. Pipeline Library Design
    • 57.5.1. Connectivity of Ports and Tables
    • 57.5.2. Port Actions
    • 57.5.3. Table Actions
  • 57.6. Multicore Scaling
    • 57.6.1. Shared Data Structures
  • 57.7. Interfacing with Accelerators
  • 57.8. The Software Switch (SWX) Pipeline
• 58. Vhost Library
  • 58.1. Vhost API Overview
  • 58.2. Vhost-user Implementations
  • 58.3. Guest memory requirement
  • 58.4. Vhost supported vSwitch reference
  • 58.5. Vhost data path acceleration (vDPA)
  • 58.6. Vhost asynchronous data path
• 59. Metrics Library
  • 59.1. Initializing the library
  • 59.2. Registering metrics
  • 59.3. Updating metric values
  • 59.4. Querying metrics
  • 59.5. Deinitialising the library
  • 59.6. Bit-rate statistics library
    • 59.6.1. Initialization
    • 59.6.2. Controlling the sampling rate
  • 59.7. Latency statistics library
    • 59.7.1. Initialization
    • 59.7.2. Triggering statistic updates
    • 59.7.3. Library shutdown
    • 59.7.4. Timestamp and latency calculation
• 60. Telemetry Library
  • 60.1. Creating Callback Functions
    • 60.1.1. Function Type
    • 60.1.2. Formatting Data
  • 60.2. Registering Commands
  • 60.3. Using Commands
• 61. Berkeley Packet Filter Library
  • 61.1. Packet data load instructions
  • 61.2. Not currently supported eBPF features
• 62. Graph Library and Inbuilt Nodes
  • 62.1. Features
  • 62.2. Advantages of Graph architecture
  • 62.3. Performance tuning parameters
  • 62.4. Programming model
    • 62.4.1. Anatomy of Node:
    • 62.4.2. Node creation and registration
    • 62.4.3. Link the Nodes to create the graph topology
    • 62.4.4. Create the graph object
    • 62.4.5. Graph models
    • 62.4.6. In fast path
    • 62.4.7. Context update when graph walk in action
    • 62.4.8. Get the node statistics using graph cluster
    • 62.4.9. Node writing guidelines
    • 62.4.10. Static nodes
    • 62.4.11. Intermediate nodes
  • 62.5. Graph object memory layout
  • 62.6. Inbuilt Nodes
    • 62.6.1. ethdev_rx
    • 62.6.2. ethdev_tx
    • 62.6.3. pkt_drop
    • 62.6.4. ip4_lookup
    • 62.6.5. ip4_rewrite
    • 62.6.6. ip6_lookup
    • 62.6.7. ip6_rewrite
    • 62.6.8. null
    • 62.6.9. kernel_tx
    • 62.6.10. kernel_rx
• 63. Installing DPDK Using the meson build system
  • 63.1. Summary
  • 63.2. Getting the Tools
  • 63.3. Configuring the Build
  • 63.4. Performing the Build
  • 63.5. Installing the Compiled Files
  • 63.6. Cross Compiling DPDK
  • 63.7. Using the DPDK within an Application
• 64. Running DPDK Unit Tests with Meson
  • 64.1. Grouping of test cases
  • 64.2. Dealing with skipped test cases
• 65. Building Your Own Application
  • 65.1. Compiling a Sample Application in the Development Kit Directory
  • 65.2. Build Your Own Application Outside the Development Kit
  • 65.3. Customizing Makefiles
    • 65.3.1. Application Makefile
• 66. Performance Optimization Guidelines
  • 66.1. Introduction
• 67. Writing Efficient Code
  • 67.1. Memory
    • 67.1.1. Memory Copy: Do not Use libc in the Data Plane
    • 67.1.2. Memory Allocation
    • 67.1.3. Concurrent Access to the Same Memory Area
    • 67.1.4. NUMA
    • 67.1.5. Distribution Across Memory Channels
    • 67.1.6. Locking memory pages
  • 67.2. Communication Between lcores
  • 67.3. PMD
    • 67.3.1. Lower Packet Latency
  • 67.4. Locks and Atomic Operations
    • 67.4.1. Locks
    • 67.4.2. Atomic Operations: Use C11 Atomic Builtins
  • 67.5. Coding Considerations
    • 67.5.1. Inline Functions
    • 67.5.2. Branch Prediction
  • 67.6. Setting the Target CPU Type
• 68. Link Time Optimization
• 69. Profile Your Application
  • 69.1. Profiling on x86
    • 69.1.1. Profiling with VTune
  • 69.2. Profiling on ARM64
    • 69.2.1. Using Linux perf
    • 69.2.2. Low-resolution generic counter
    • 69.2.3. High-resolution cycle counter
• 70. Running AddressSanitizer
  • 70.1. Example heap-buffer-overflow error
  • 70.2. Example use-after-free error
• 71. Glossary