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. Log Library
  • 5.1. Log Levels
    • 5.1.1. Setting Global Log Level
    • 5.1.2. Setting Log Level for a Component
  • 5.2. Using Logging APIs to Generate Log Messages
• 6. Argparse Library
  • 6.1. Features and Capabilities
  • 6.2. Usage Guide
    • 6.2.1. User Input Requirements
    • 6.2.2. Parsing by autosave way
    • 6.2.3. Parsing by callback way
    • 6.2.4. Multiple times argument
• 7. Command-line Library
  • 7.1. Library Features
  • 7.2. Adding Command-line to an Application
    • 7.2.1. Creating a Command List File
    • 7.2.2. Running the Generator Script
    • 7.2.3. Providing the Function Callbacks
    • 7.2.4. Integrating with the Application
    • 7.2.5. Limitations of the Script Approach
  • 7.3. Worked Example of Adding Command-line to an Application
    • 7.3.1. Defining Command Result Structure
    • 7.3.2. Providing Field Initializers
    • 7.3.3. Defining Callback Function
    • 7.3.4. Associating Callback and Command
    • 7.3.5. Adding Command to Command-line Context
    • 7.3.6. Creating a Command-line Instance
    • 7.3.7. Multiplexing Multiple Commands to a Single Function
  • 7.4. Examples of Command-line Use in DPDK
• 8. Service Cores
  • 8.1. Service Core Initialization
  • 8.2. Enabling Services on Cores
  • 8.3. Service Core Statistics
  • 8.4. Service Core Tracing
• 9. Trace Library
  • 9.1. Overview
  • 9.2. DPDK tracing library features
  • 9.3. How to add a tracepoint?
    • 9.3.1. Create the tracepoint header file
    • 9.3.2. Register the tracepoint
  • 9.4. Fast path tracepoint
  • 9.5. Event record mode
  • 9.6. Trace file location
  • 9.7. View and analyze the recorded events
    • 9.7.1. Use the babeltrace command-line tool
    • 9.7.2. Use the tracecompass GUI tool
  • 9.8. Quick start
  • 9.9. Implementation details
    • 9.9.1. Trace metadata creation
    • 9.9.2. Trace memory
    • 9.9.3. Trace memory layout
  • 9.10. Limitations
• 10. RCU Library
  • 10.1. What is Quiescent State
  • 10.2. Factors affecting the RCU mechanism
  • 10.3. RCU in DPDK
  • 10.4. How to use this library
  • 10.5. Resource reclamation framework for DPDK
• 11. Ring Library
  • 11.1. References for Ring Implementation in FreeBSD*
  • 11.2. Lockless Ring Buffer in Linux*
  • 11.3. Additional Features
    • 11.3.1. Name
  • 11.4. Use Cases
  • 11.5. Anatomy of a Ring Buffer
    • 11.5.1. Single Producer Enqueue
    • 11.5.2. Single Consumer Dequeue
    • 11.5.3. Multiple Producers Enqueue
    • 11.5.4. Modulo 32-bit Indexes
  • 11.6. Producer/consumer synchronization modes
    • 11.6.1. MP/MC (default one)
    • 11.6.2. SP/SC
    • 11.6.3. MP_RTS/MC_RTS
    • 11.6.4. MP_HTS/MC_HTS
  • 11.7. Ring Peek API
  • 11.8. Ring Peek Zero Copy API
  • 11.9. References
• 12. Stack Library
  • 12.1. Implementation
    • 12.1.1. Lock-based Stack
    • 12.1.2. Lock-free Stack
• 13. Mempool Library
  • 13.1. Cookies
  • 13.2. Stats
  • 13.3. Memory Alignment Constraints on x86 architecture
  • 13.4. Local Cache
  • 13.5. Mempool Handlers
  • 13.6. Use Cases
• 14. Mbuf Library
  • 14.1. Design of Packet Buffers
  • 14.2. Buffers Stored in Memory Pools
  • 14.3. Constructors
  • 14.4. Allocating and Freeing mbufs
  • 14.5. Manipulating mbufs
  • 14.6. Meta Information
    • 14.6.1. Dynamic fields and flags
  • 14.7. Direct and Indirect Buffers
  • 14.8. Debug
  • 14.9. Use Cases
• 15. Poll Mode Driver
  • 15.1. Requirements and Assumptions
  • 15.2. Design Principles
  • 15.3. Logical Cores, Memory and NIC Queues Relationships
  • 15.4. Device Identification, Ownership and Configuration
    • 15.4.1. Device Identification
    • 15.4.2. Port Ownership
    • 15.4.3. Device Configuration
    • 15.4.4. On-the-Fly Configuration
    • 15.4.5. Configuration of Transmit Queues
    • 15.4.6. Free Tx mbuf on Demand
    • 15.4.7. Hardware Offload
  • 15.5. Poll Mode Driver API
    • 15.5.1. Generalities
    • 15.5.2. Generic Packet Representation
    • 15.5.3. Ethernet Device API
    • 15.5.4. Ethernet Device Standard Device Arguments
    • 15.5.5. Extended Statistics API
    • 15.5.6. NIC Reset API
    • 15.5.7. Proactive Error Handling Mode
• 16. Generic flow API (rte_flow)
  • 16.1. Overview
  • 16.2. Flow rule
    • 16.2.1. Description
    • 16.2.2. Attributes
    • 16.2.3. Pattern item
    • 16.2.4. Matching pattern
    • 16.2.5. Meta item types
    • 16.2.6. Data matching item types
    • 16.2.7. Actions
    • 16.2.8. Action types
    • 16.2.9. Negative types
  • 16.3. Rules management
    • 16.3.1. Validation
    • 16.3.2. Creation
    • 16.3.3. Destruction
    • 16.3.4. Update
    • 16.3.5. Flush
    • 16.3.6. Query
  • 16.4. Flow engine configuration
    • 16.4.1. Configuration
    • 16.4.2. Group Miss Actions
    • 16.4.3. Flow templates
  • 16.5. Asynchronous operations
    • 16.5.1. Enqueue creation operation
    • 16.5.2. Enqueue creation by index operation
    • 16.5.3. Enqueue destruction operation
    • 16.5.4. Enqueue update operation
    • 16.5.5. Enqueue indirect action creation operation
    • 16.5.6. Enqueue indirect action destruction operation
    • 16.5.7. Enqueue indirect action update operation
    • 16.5.8. Enqueue indirect action query operation
    • 16.5.9. Push enqueued operations
    • 16.5.10. Pull enqueued operations
    • 16.5.11. Calculate hash
    • 16.5.12. Calculate encapsulation hash
  • 16.6. Flow isolated mode
  • 16.7. Verbose error reporting
  • 16.8. Helpers
    • 16.8.1. Error initializer
    • 16.8.2. Object conversion
    • 16.8.3. Tunneled traffic offload
  • 16.9. Caveats
  • 16.10. PMD interface
  • 16.11. Device compatibility
    • 16.11.1. Global bit-masks
    • 16.11.2. Unsupported layer types
    • 16.11.3. ANY pattern item
    • 16.11.4. Unsupported actions
    • 16.11.5. Flow rules priority
• 17. Switch Representation within DPDK Applications
  • 17.1. Introduction
  • 17.2. Sub Function
  • 17.3. Port Representors
  • 17.4. Basic SR-IOV
  • 17.5. Controlled SR-IOV
    • 17.5.1. Initialization
    • 17.5.2. VF Representors
    • 17.5.3. Traffic Steering
  • 17.6. Flow API (rte_flow)
    • 17.6.1. Extensions
    • 17.6.2. Traffic Direction
    • 17.6.3. Transferring Traffic
    • 17.6.4. Pattern Items And Actions
    • 17.6.5. Actions Order and Repetition
  • 17.7. Switching Examples
    • 17.7.1. Associating VF 1 with Physical Port 0
    • 17.7.2. Sharing Broadcasts
    • 17.7.3. Encapsulating VF 2 Traffic in VXLAN
• 18. Traffic Metering and Policing API
  • 18.1. Overview
  • 18.2. Configuration steps
  • 18.3. Run-time processing
  • 18.4. API walk-through
  • 18.5. Protocol based input color selection
• 19. Traffic Management API
  • 19.1. Overview
  • 19.2. Capability API
  • 19.3. Scheduling Algorithms
  • 19.4. Traffic Shaping
  • 19.5. Congestion Management
  • 19.6. Packet Marking
  • 19.7. Steps to Setup the Hierarchy
    • 19.7.1. Initial Hierarchy Specification
    • 19.7.2. Hierarchy Commit
    • 19.7.3. Run-Time Hierarchy Updates
• 20. Wireless Baseband 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. Queues Configuration
    • 20.2.5. Device & Queues Management
    • 20.2.6. Logical Cores, Memory and Queues Relationships
  • 20.3. Device Operation Capabilities
    • 20.3.1. Capabilities Discovery
    • 20.3.2. Capabilities details for LDPC Decoder
    • 20.3.3. Capabilities details for FFT function
    • 20.3.4. Other optional capabilities exposed during device discovery
  • 20.4. Operation Processing
    • 20.4.1. Enqueue / Dequeue Burst APIs
    • 20.4.2. Operation Representation
    • 20.4.3. Operation Management and Allocation
    • 20.4.4. BBDEV Inbound/Outbound Memory
    • 20.4.5. BBDEV Turbo Encode Operation
    • 20.4.6. BBDEV Turbo Decode Operation
    • 20.4.7. BBDEV LDPC Encode Operation
    • 20.4.8. BBDEV LDPC Decode Operation
    • 20.4.9. BBDEV FFT Operation
    • 20.4.10. BBDEV MLD-TS Operation
  • 20.5. Sample code
    • 20.5.1. BBDEV Device API
• 21. Cryptography Device Library
  • 21.1. Design Principles
  • 21.2. Device Management
    • 21.2.1. Device Creation
    • 21.2.2. Device Identification
    • 21.2.3. Device Configuration
    • 21.2.4. Configuration of Queue Pairs
    • 21.2.5. Logical Cores, Memory and Queues Pair Relationships
  • 21.3. Device Features and Capabilities
    • 21.3.1. Device Features
    • 21.3.2. Device Operation Capabilities
    • 21.3.3. Capabilities Discovery
  • 21.4. Operation Processing
    • 21.4.1. Private data
    • 21.4.2. User callback APIs
    • 21.4.3. Enqueue / Dequeue Burst APIs
    • 21.4.4. Operation Representation
    • 21.4.5. Operation Management and Allocation
  • 21.5. Symmetric Cryptography Support
    • 21.5.1. Session and Session Management
    • 21.5.2. Transforms and Transform Chaining
    • 21.5.3. Symmetric Operations
  • 21.6. Synchronous mode
    • 21.6.1. Cryptodev Raw Data-path APIs
  • 21.7. Sample code
  • 21.8. Asymmetric Cryptography
    • 21.8.1. Session and Session Management
    • 21.8.2. Asymmetric Sessionless Support
    • 21.8.3. Transforms and Transform Chaining
    • 21.8.4. Asymmetric Operations
    • 21.8.5. Private user data
  • 21.9. Asymmetric crypto Sample code
    • 21.9.1. Asymmetric Crypto Device API
  • 21.10. Device Statistics
• 22. Compression Device Library
  • 22.1. Device Management
    • 22.1.1. Device Creation
    • 22.1.2. Device Identification
    • 22.1.3. Device Configuration
    • 22.1.4. Configuration of Queue Pairs
    • 22.1.5. Logical Cores, Memory and Queue Pair Relationships
  • 22.2. Device Features and Capabilities
    • 22.2.1. Capabilities
    • 22.2.2. Capabilities Discovery
  • 22.3. Compression Operation
    • 22.3.1. Operation Representation
    • 22.3.2. Operation Management and Allocation
    • 22.3.3. Passing source data as mbuf-chain
    • 22.3.4. Operation Status
    • 22.3.5. Operation status after enqueue / dequeue
    • 22.3.6. Produced, Consumed And Operation Status
  • 22.4. Transforms
  • 22.5. Compression API Hash support
  • 22.6. Compression API Stateless operation
    • 22.6.1. priv_xform in Stateless operation
    • 22.6.2. Stateless and OUT_OF_SPACE
    • 22.6.3. Hash in Stateless
    • 22.6.4. Checksum in Stateless
  • 22.7. Compression API Stateful operation
    • 22.7.1. Stream in Stateful operation
    • 22.7.2. Stateful and OUT_OF_SPACE
    • 22.7.3. Hash in Stateful
    • 22.7.4. Checksum in Stateful
  • 22.8. Burst in compression API
    • 22.8.1. Enqueue / Dequeue Burst APIs
  • 22.9. Sample code
    • 22.9.1. Compression Device API
• 23. RegEx Device Library
  • 23.1. Design Principles
  • 23.2. Device Management
    • 23.2.1. Device Creation
    • 23.2.2. Device Identification
    • 23.2.3. Device Configuration
    • 23.2.4. Configuration of Rules Database
    • 23.2.5. Configuration of Queue Pairs
    • 23.2.6. Logical Cores, Memory and Queues Pair Relationships
  • 23.3. Device Features and Capabilities
    • 23.3.1. Enqueue / Dequeue Burst APIs
• 24. Machine Learning Device Library
  • 24.1. Design Principles
  • 24.2. Device Operations
    • 24.2.1. Device Creation
    • 24.2.2. Device Identification
    • 24.2.3. Device Features and Capabilities
    • 24.2.4. Device Configuration
    • 24.2.5. Configuration of Queue Pairs
    • 24.2.6. Logical Cores, Memory and Queues Pair Relationships
    • 24.2.7. Configuration of Machine Learning models
    • 24.2.8. Enqueue / Dequeue
    • 24.2.9. Quantize and Dequantize
• 25. DMA Device Library
  • 25.1. Design Principles
  • 25.2. Device Management
    • 25.2.1. Device Creation
    • 25.2.2. Device Identification
  • 25.3. Device Features and Capabilities
    • 25.3.1. Enqueue / Dequeue APIs
    • 25.3.2. Querying Device Statistics
• 26. General-Purpose Graphics Processing Unit Library
  • 26.1. Features
  • 26.2. API Overview
    • 26.2.1. Child Device
    • 26.2.2. Memory Allocation
    • 26.2.3. Memory Registration
    • 26.2.4. CPU mapping
    • 26.2.5. Memory Barrier
    • 26.2.6. Communication Flag
    • 26.2.7. Communication list
  • 26.3. CUDA Example
• 27. Security Library
  • 27.1. Design Principles
    • 27.1.1. Inline Crypto
    • 27.1.2. Inline protocol offload
    • 27.1.3. Lookaside protocol offload
    • 27.1.4. PDCP Flow Diagram
    • 27.1.5. DOCSIS Protocol
    • 27.1.6. MACSEC Protocol
    • 27.1.7. TLS-Record Protocol
  • 27.2. Device Features and Capabilities
    • 27.2.1. Device Capabilities For Security Operations
    • 27.2.2. Capabilities Discovery
    • 27.2.3. Security Session Create/Free
    • 27.2.4. Security session configuration
    • 27.2.5. Security API
    • 27.2.6. Flow based Security Session
  • 27.3. Telemetry support
• 28. Rawdevice Library
  • 28.1. Introduction
  • 28.2. Design
    • 28.2.1. Device Identification
• 29. Link Bonding Poll Mode Driver Library
  • 29.1. Link Bonding Modes Overview
  • 29.2. Implementation Details
    • 29.2.1. Link Status Change Interrupts / Polling
    • 29.2.2. Requirements / Limitations
    • 29.2.3. Configuration
  • 29.3. Using Link Bonding Devices
    • 29.3.1. Using the Poll Mode Driver from an Application
    • 29.3.2. Using Link Bonding Devices from the EAL Command Line
  • 29.4. Testpmd driver specific commands
    • 29.4.1. create bonding device
    • 29.4.2. add bonding member
    • 29.4.3. remove bonding member
    • 29.4.4. set bonding mode
    • 29.4.5. set bonding primary
    • 29.4.6. set bonding mac
    • 29.4.7. set bonding balance_xmit_policy
    • 29.4.8. set bonding mon_period
    • 29.4.9. set bonding lacp dedicated_queue
    • 29.4.10. set bonding agg_mode
    • 29.4.11. show bonding config
• 30. Timer Library
  • 30.1. Implementation Details
  • 30.2. Use Cases
  • 30.3. References
• 31. Hash Library
  • 31.1. Hash API Overview
  • 31.2. Multi-process support
  • 31.3. Multi-thread support
  • 31.4. Extendable Bucket Functionality support
  • 31.5. Implementation Details (non Extendable Bucket Case)
  • 31.6. Implementation Details (with Extendable Bucket)
  • 31.7. Entry distribution in hash table
  • 31.8. Use Case: Flow Classification
  • 31.9. References
• 32. Toeplitz Hash Library
  • 32.1. Toeplitz hash function API
  • 32.2. Predictable RSS
    • 32.2.1. Thash context
    • 32.2.2. Thash helper
    • 32.2.3. Calculation of the complementary bits to adjust the subtuple
    • 32.2.4. Adjust tuple API
  • 32.3. Use case example
• 33. Elastic Flow Distributor Library
  • 33.1. Introduction
  • 33.2. Flow Based Distribution
    • 33.2.1. Computation Based Schemes
    • 33.2.2. Flow-Table Based Schemes
    • 33.2.3. EFD Based Scheme
  • 33.3. Example of EFD Library Usage
  • 33.4. Library API Overview
    • 33.4.1. EFD Table Create
    • 33.4.2. EFD Insert and Update
    • 33.4.3. EFD Lookup
    • 33.4.4. EFD Delete
  • 33.5. Library Internals
    • 33.5.1. Insert Function Internals
    • 33.5.2. Lookup Function Internals
    • 33.5.3. Group Rebalancing Function Internals
  • 33.6. References
• 34. Membership Library
  • 34.1. Introduction
  • 34.2. Vector of Bloom Filters
  • 34.3. Hash-Table based Set-Summaries
    • 34.3.1. Set-Summaries with False Negative Probability
  • 34.4. Library API Overview
    • 34.4.1. Set-summary Create
    • 34.4.2. Set-summary Element Insertion
    • 34.4.3. Set-summary Element Lookup
    • 34.4.4. Set-summary Element Delete
  • 34.5. References
• 35. LPM Library
  • 35.1. LPM API Overview
  • 35.2. Implementation Details
    • 35.2.1. Addition
    • 35.2.2. Deletion
    • 35.2.3. Lookup
    • 35.2.4. Limitations in the Number of Rules
    • 35.2.5. Use Case: IPv4 Forwarding
    • 35.2.6. References
• 36. LPM6 Library
  • 36.1. LPM6 API Overview
    • 36.1.1. Implementation Details
    • 36.1.2. Addition
    • 36.1.3. Lookup
    • 36.1.4. Limitations in the Number of Rules
  • 36.2. Use Case: IPv6 Forwarding
• 37. FIB Library
  • 37.1. FIB API Overview
  • 37.2. Implementation details
  • 37.3. Dataplane Algorithms
    • 37.3.1. Dummy
    • 37.3.2. DIR-24-8
  • 37.4. Use cases
• 38. RIB Library
  • 38.1. Implementation details
  • 38.2. RIB API Overview
  • 38.3. Extensions usage example
• 39. Packet Distributor Library
  • 39.1. Distributor Core Operation
  • 39.2. Worker Operation
• 40. Reorder Library
  • 40.1. Operation
  • 40.2. Implementation Details
  • 40.3. Use Case: Packet Distributor
• 41. IP Fragmentation and Reassembly Library
  • 41.1. Packet fragmentation
  • 41.2. Packet reassembly
    • 41.2.1. IP Fragment Table
    • 41.2.2. Packet Reassembly
    • 41.2.3. Debug logging and Statistics Collection
• 42. Generic Receive Offload Library
  • 42.1. Overview
  • 42.2. Two Sets of API
    • 42.2.1. Lightweight Mode API
    • 42.2.2. Heavyweight Mode API
  • 42.3. Reassembly Algorithm
    • 42.3.1. Challenges
    • 42.3.2. Key-based Reassembly Algorithm
  • 42.4. TCP-IPv4/IPv6 GRO
  • 42.5. VxLAN GRO
  • 42.6. GRO Library Limitations
• 43. Generic Segmentation Offload Library
  • 43.1. Overview
  • 43.2. Limitations
  • 43.3. Packet Segmentation
    • 43.3.1. GSO Output Segment Format
  • 43.4. Supported GSO Packet Types
    • 43.4.1. TCP/IPv4 GSO
    • 43.4.2. UDP/IPv4 GSO
    • 43.4.3. VXLAN IPv4 GSO
    • 43.4.4. GRE TCP/IPv4 GSO
  • 43.5. How to Segment a Packet
• 44. IPsec Packet Processing Library
  • 44.1. SA level API
    • 44.1.1. RTE_SECURITY_ACTION_TYPE_NONE
    • 44.1.2. RTE_SECURITY_ACTION_TYPE_CPU_CRYPTO
    • 44.1.3. RTE_SECURITY_ACTION_TYPE_INLINE_CRYPTO
    • 44.1.4. RTE_SECURITY_ACTION_TYPE_INLINE_PROTOCOL
    • 44.1.5. RTE_SECURITY_ACTION_TYPE_LOOKASIDE_PROTOCOL
  • 44.2. SA database API
    • 44.2.1. Create/destroy
    • 44.2.2. Add/delete rules
    • 44.2.3. Lookup
  • 44.3. Supported features
  • 44.4. Telemetry support
  • 44.5. Limitations
• 45. PDCP Protocol Processing Library
  • 45.1. PDCP entity API
  • 45.2. PDCP PDU (Protocol Data Unit) API
    • 45.2.1. PDCP packet processing API for control PDU
    • 45.2.2. PDCP packet processing API for data PDU
  • 45.3. Supported features
    • 45.3.1. Supported ciphering algorithms
    • 45.3.2. Supported integrity protection algorithms
  • 45.4. Timers
  • 45.5. Sample API usage
• 46. Packet Capture Next Generation Library
  • 46.1. Usage
• 47. Packet Capture Library
  • 47.1. Operation
  • 47.2. Implementation Details
  • 47.3. Use Case: Packet Capturing
• 48. Multi-process Support
  • 48.1. Memory Sharing
  • 48.2. Deployment Models
    • 48.2.1. Symmetric/Peer Processes
    • 48.2.2. Asymmetric/Non-Peer Processes
    • 48.2.3. Running Multiple Independent DPDK Applications
    • 48.2.4. Running Multiple Independent Groups of DPDK Applications
  • 48.3. Multi-process Limitations
  • 48.4. Communication between multiple processes
    • 48.4.1. Registering for incoming messages
    • 48.4.2. Sending messages
    • 48.4.3. Sending requests
    • 48.4.4. Receiving and responding to messages
    • 48.4.5. Misc considerations
• 49. Thread Safety of DPDK Functions
  • 49.1. Fast-Path APIs
  • 49.2. Performance Insensitive API
  • 49.3. Library Initialization
  • 49.4. Interrupt Thread
• 50. Event Device Library
  • 50.1. Event struct
    • 50.1.1. Event Metadata
    • 50.1.2. Event Payload
    • 50.1.3. Event Vector
    • 50.1.4. Queues
    • 50.1.5. Ports
  • 50.2. API Walk-through
    • 50.2.1. Init and Config
    • 50.2.2. Setting up Queues
    • 50.2.3. Setting up Ports
    • 50.2.4. Linking Queues and Ports
    • 50.2.5. Linking Queues to Ports with link profiles
    • 50.2.6. Starting the EventDev
    • 50.2.7. Ingress of New Events
    • 50.2.8. Forwarding of Events
    • 50.2.9. Egress of Events
    • 50.2.10. Quiescing Event Ports
    • 50.2.11. Stopping the EventDev
  • 50.3. Summary
• 51. Event Ethernet Rx 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 Rx Queues to the Adapter Instance
    • 51.1.4. Querying Adapter Capabilities
    • 51.1.5. Configuring the Service Function
    • 51.1.6. Starting the Adapter Instance
    • 51.1.7. Getting Adapter Statistics
    • 51.1.8. Getting Adapter queue config
    • 51.1.9. Set/Get adapter runtime configuration parameters
    • 51.1.10. Getting and resetting Adapter queue stats
    • 51.1.11. Getting Adapter Instance ID
    • 51.1.12. Interrupt Based Rx Queues
    • 51.1.13. Rx Callback for SW Rx Adapter
    • 51.1.14. Rx event vectorization
    • 51.1.15. Rx event vectorization for SW Rx adapter
• 52. Event Ethernet Tx Adapter Library
  • 52.1. API Walk-through
    • 52.1.1. Creating an Adapter Instance
    • 52.1.2. Event device configuration for service based adapter
    • 52.1.3. Adding Tx Queues to the Adapter Instance
    • 52.1.4. Querying Adapter Capabilities
    • 52.1.5. Linking a Queue to the Adapter’s Event Port
    • 52.1.6. Configuring the Service Function
    • 52.1.7. Starting the Adapter Instance
    • 52.1.8. Enqueuing Packets to the Adapter
    • 52.1.9. Getting Adapter Statistics
    • 52.1.10. Getting Adapter Instance ID
    • 52.1.11. Tx event vectorization
    • 52.1.12. Queue start/stop
    • 52.1.13. Set/Get adapter runtime configuration parameters
• 53. Event Timer Adapter Library
  • 53.1. Event Timer struct
    • 53.1.1. Timer Expiry Event
    • 53.1.2. Timeout Ticks
    • 53.1.3. State
    • 53.1.4. User Metadata
  • 53.2. API Overview
    • 53.2.1. Create and Configure an Adapter Instance
    • 53.2.2. Retrieve Event Timer Adapter Contextual Information
    • 53.2.3. Configuring the Service Component
    • 53.2.4. Starting the Adapter Instance
    • 53.2.5. Arming Event Timers
    • 53.2.6. Canceling Event Timers
  • 53.3. Processing Timer Expiry Events
  • 53.4. Summary
• 54. Event Crypto Adapter Library
  • 54.1. Adapter Mode
    • 54.1.1. RTE_EVENT_CRYPTO_ADAPTER_OP_NEW mode
    • 54.1.2. RTE_EVENT_CRYPTO_ADAPTER_OP_FORWARD mode
  • 54.2. API Overview
    • 54.2.1. Create an adapter instance
    • 54.2.2. Event device configuration for service based adapter
    • 54.2.3. Querying adapter capabilities
    • 54.2.4. Adding queue pair to the adapter instance
    • 54.2.5. Configure the service function
    • 54.2.6. Set event request/response information
    • 54.2.7. Enable event vectorization
    • 54.2.8. Start the adapter instance
    • 54.2.9. Get adapter statistics
    • 54.2.10. Set/Get adapter runtime configuration parameters
• 55. Event DMA Adapter Library
  • 55.1. Adapter Modes
    • 55.1.1. RTE_EVENT_DMA_ADAPTER_OP_NEW mode
    • 55.1.2. RTE_EVENT_DMA_ADAPTER_OP_FORWARD mode
  • 55.2. API Overview
    • 55.2.1. Create an adapter instance
    • 55.2.2. Event device configuration for service based adapter
    • 55.2.3. Querying adapter capabilities
    • 55.2.4. Adding vchan to the adapter instance
    • 55.2.5. Configuring service function
    • 55.2.6. Set event response information
    • 55.2.7. Start the adapter instance
    • 55.2.8. Get adapter statistics
    • 55.2.9. Set/Get adapter runtime configuration parameters
• 56. Dispatcher Library
  • 56.1. Overview
  • 56.2. Dispatcher Creation
  • 56.3. Event Port Binding
  • 56.4. Event Handlers
    • 56.4.1. Handler Registration
    • 56.4.2. Event Matching
    • 56.4.3. Event Delivery
    • 56.4.4. Event Clustering
  • 56.5. Finalize
  • 56.6. Service
    • 56.6.1. Multi Service Dispatcher Lcores
• 57. Quality of Service (QoS) Framework
  • 57.1. Packet Pipeline with QoS Support
  • 57.2. Hierarchical Scheduler
    • 57.2.1. Overview
    • 57.2.2. Scheduling Hierarchy
    • 57.2.3. Application Programming Interface (API)
    • 57.2.4. Implementation
    • 57.2.5. Worst Case Scenarios for Performance
  • 57.3. Droppers
    • 57.3.1. Configuration
    • 57.3.2. Enqueue Operation
    • 57.3.3. Queue Empty Operation
    • 57.3.4. Source Files Location
    • 57.3.5. Integration with the DPDK QoS Scheduler
    • 57.3.6. Integration with the DPDK QoS Scheduler Sample Application
    • 57.3.7. Application Programming Interface (API)
  • 57.4. Traffic Metering
    • 57.4.1. Functional Overview
    • 57.4.2. Implementation Overview
• 58. Power Management
  • 58.1. CPU Frequency Scaling
  • 58.2. Core-load Throttling through C-States
  • 58.3. Per-core Turbo Boost
  • 58.4. Use of Power Library in a Hyper-Threaded Environment
  • 58.5. API Overview of the Power Library
  • 58.6. User Cases
  • 58.7. Ethernet PMD Power Management API
    • 58.7.1. Abstract
    • 58.7.2. API Overview for Ethernet PMD Power Management
  • 58.8. Intel Uncore API
    • 58.8.1. Abstract
    • 58.8.2. API Overview for Intel Uncore
  • 58.9. References
• 59. Packet Classification and Access Control
  • 59.1. Overview
    • 59.1.1. Rule definition
    • 59.1.2. RT memory size limit
    • 59.1.3. Classification methods
  • 59.2. Application Programming Interface (API) Usage
    • 59.2.1. Classify with Multiple Categories
• 60. Packet Framework
  • 60.1. Design Objectives
  • 60.2. Overview
  • 60.3. Port Library Design
    • 60.3.1. Port Types
    • 60.3.2. Port Interface
  • 60.4. Table Library Design
    • 60.4.1. Table Types
    • 60.4.2. Table Interface
    • 60.4.3. Hash Table Design
  • 60.5. Pipeline Library Design
    • 60.5.1. Connectivity of Ports and Tables
    • 60.5.2. Port Actions
    • 60.5.3. Table Actions
  • 60.6. Multicore Scaling
    • 60.6.1. Shared Data Structures
  • 60.7. Interfacing with Accelerators
  • 60.8. The Software Switch (SWX) Pipeline
• 61. Vhost Library
  • 61.1. Vhost API Overview
  • 61.2. Vhost-user Implementations
  • 61.3. Guest memory requirement
  • 61.4. Vhost supported vSwitch reference
  • 61.5. Vhost data path acceleration (vDPA)
  • 61.6. Vhost asynchronous data path
• 62. Metrics Library
  • 62.1. Initializing the library
  • 62.2. Registering metrics
  • 62.3. Updating metric values
  • 62.4. Querying metrics
  • 62.5. Deinitialising the library
  • 62.6. Bit-rate statistics library
    • 62.6.1. Initialization
    • 62.6.2. Controlling the sampling rate
  • 62.7. Latency statistics library
    • 62.7.1. Initialization
    • 62.7.2. Triggering statistic updates
    • 62.7.3. Library shutdown
    • 62.7.4. Timestamp and latency calculation
• 63. Telemetry Library
  • 63.1. Creating Callback Functions
    • 63.1.1. Function Type
    • 63.1.2. Formatting Data
  • 63.2. Registering Commands
  • 63.3. Using Commands
• 64. Berkeley Packet Filter Library
  • 64.1. Packet data load instructions
  • 64.2. Not currently supported eBPF features
• 65. Graph Library and Inbuilt Nodes
  • 65.1. Features
  • 65.2. Advantages of Graph architecture
  • 65.3. Performance tuning parameters
  • 65.4. Programming model
    • 65.4.1. Anatomy of Node:
    • 65.4.2. Node creation and registration
    • 65.4.3. Link the Nodes to create the graph topology
    • 65.4.4. Create the graph object
    • 65.4.5. Graph models
    • 65.4.6. In fast path
    • 65.4.7. Context update when graph walk in action
    • 65.4.8. Get the node statistics using graph cluster
    • 65.4.9. Node writing guidelines
    • 65.4.10. Static nodes
    • 65.4.11. Intermediate nodes
  • 65.5. Graph object memory layout
  • 65.6. Inbuilt Nodes
    • 65.6.1. ethdev_rx
    • 65.6.2. ethdev_tx
    • 65.6.3. pkt_drop
    • 65.6.4. ip4_lookup
    • 65.6.5. ip4_rewrite
    • 65.6.6. ip4_reassembly
    • 65.6.7. ip6_lookup
    • 65.6.8. ip6_rewrite
    • 65.6.9. null
    • 65.6.10. kernel_tx
    • 65.6.11. kernel_rx
    • 65.6.12. ip4_local
    • 65.6.13. udp4_input
• 66. Installing DPDK Using the meson build system
  • 66.1. Summary
  • 66.2. Getting the Tools
  • 66.3. Configuring the Build
  • 66.4. Performing the Build
  • 66.5. Installing the Compiled Files
  • 66.6. Cross Compiling DPDK
  • 66.7. Using the DPDK within an Application
• 67. Running DPDK Unit Tests with Meson
  • 67.1. Grouping of test cases
  • 67.2. Dealing with skipped test cases
• 68. Building Your Own Application
  • 68.1. Compiling a Sample Application in the Development Kit Directory
  • 68.2. Build Your Own Application Outside the Development Kit
  • 68.3. Customizing Makefiles
    • 68.3.1. Application Makefile
• 69. Performance Optimization Guidelines
  • 69.1. Introduction
• 70. Writing Efficient Code
  • 70.1. Memory
    • 70.1.1. Memory Copy: Do not Use libc in the Data Plane
    • 70.1.2. Memory Allocation
    • 70.1.3. Concurrent Access to the Same Memory Area
    • 70.1.4. NUMA
    • 70.1.5. Distribution Across Memory Channels
    • 70.1.6. Locking memory pages
  • 70.2. Communication Between lcores
  • 70.3. PMD
    • 70.3.1. Lower Packet Latency
  • 70.4. Locks and Atomic Operations
    • 70.4.1. Locks
    • 70.4.2. Atomic Operations: Use C11 Atomic Builtins
  • 70.5. Coding Considerations
    • 70.5.1. Inline Functions
    • 70.5.2. Branch Prediction
  • 70.6. Setting the Target CPU Type
• 71. Link Time Optimization
• 72. Profile Your Application
  • 72.1. Profiling on x86
    • 72.1.1. Profiling with VTune
  • 72.2. Profiling on ARM64
    • 72.2.1. Using Linux perf
    • 72.2.2. Low-resolution generic counter
    • 72.2.3. High-resolution cycle counter
• 73. Running AddressSanitizer
  • 73.1. Example heap-buffer-overflow error
  • 73.2. Example use-after-free error
• 74. Glossary