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. Environment Abstraction Layer
  • 3.1. EAL in a Linux-userland Execution Environment
    • 3.1.1. Initialization and Core Launching
    • 3.1.2. Shutdown and Cleanup
    • 3.1.3. Multi-process Support
    • 3.1.4. Memory Mapping Discovery and Memory Reservation
    • 3.1.5. Support for Externally Allocated Memory
    • 3.1.6. Per-lcore and Shared Variables
    • 3.1.7. Logs
    • 3.1.8. CPU Feature Identification
    • 3.1.9. User Space Interrupt Event
    • 3.1.10. Block list
    • 3.1.11. Misc Functions
    • 3.1.12. IOVA Mode Detection
    • 3.1.13. IOVA Mode Configuration
    • 3.1.14. Max SIMD bitwidth
  • 3.2. Memory Segments and Memory Zones (memzone)
  • 3.3. Multiple pthread
    • 3.3.1. EAL pthread and lcore Affinity
    • 3.3.2. non-EAL pthread support
    • 3.3.3. Public Thread API
    • 3.3.4. Control Thread API
    • 3.3.5. Known Issues
    • 3.3.6. cgroup control
  • 3.4. Malloc
    • 3.4.1. Alignment and NUMA Constraints
    • 3.4.2. Use Cases
    • 3.4.3. Internal Implementation
• 4. Service Cores
  • 4.1. Service Core Initialization
  • 4.2. Enabling Services on Cores
  • 4.3. Service Core Statistics
• 5. Trace Library
  • 5.1. Overview
  • 5.2. DPDK tracing library features
  • 5.3. How to add a tracepoint?
    • 5.3.1. Create the tracepoint header file
    • 5.3.2. Register the tracepoint
  • 5.4. Fast path tracepoint
  • 5.5. Event record mode
  • 5.6. Trace file location
  • 5.7. View and analyze the recorded events
    • 5.7.1. Use the babeltrace command-line tool
    • 5.7.2. Use the tracecompass GUI tool
  • 5.8. Quick start
  • 5.9. Implementation details
    • 5.9.1. Trace metadata creation
    • 5.9.2. Trace memory
    • 5.9.3. Trace memory layout
• 6. RCU Library
  • 6.1. What is Quiescent State
  • 6.2. Factors affecting the RCU mechanism
  • 6.3. RCU in DPDK
  • 6.4. How to use this library
  • 6.5. Resource reclamation framework for DPDK
• 7. Ring Library
  • 7.1. References for Ring Implementation in FreeBSD*
  • 7.2. Lockless Ring Buffer in Linux*
  • 7.3. Additional Features
    • 7.3.1. Name
  • 7.4. Use Cases
  • 7.5. Anatomy of a Ring Buffer
    • 7.5.1. Single Producer Enqueue
    • 7.5.2. Single Consumer Dequeue
    • 7.5.3. Multiple Producers Enqueue
    • 7.5.4. Modulo 32-bit Indexes
  • 7.6. Producer/consumer synchronization modes
    • 7.6.1. MP/MC (default one)
    • 7.6.2. SP/SC
    • 7.6.3. MP_RTS/MC_RTS
    • 7.6.4. MP_HTS/MC_HTS
  • 7.7. Ring Peek API
  • 7.8. Ring Peek Zero Copy API
  • 7.9. References
• 8. Stack Library
  • 8.1. Implementation
    • 8.1.1. Lock-based Stack
    • 8.1.2. Lock-free Stack
• 9. Mempool Library
  • 9.1. Cookies
  • 9.2. Stats
  • 9.3. Memory Alignment Constraints on x86 architecture
  • 9.4. Local Cache
  • 9.5. Mempool Handlers
  • 9.6. Use Cases
• 10. Mbuf Library
  • 10.1. Design of Packet Buffers
  • 10.2. Buffers Stored in Memory Pools
  • 10.3. Constructors
  • 10.4. Allocating and Freeing mbufs
  • 10.5. Manipulating mbufs
  • 10.6. Meta Information
    • 10.6.1. Dynamic fields and flags
  • 10.7. Direct and Indirect Buffers
  • 10.8. Debug
  • 10.9. Use Cases
• 11. Poll Mode Driver
  • 11.1. Requirements and Assumptions
  • 11.2. Design Principles
  • 11.3. Logical Cores, Memory and NIC Queues Relationships
  • 11.4. Device Identification, Ownership and Configuration
    • 11.4.1. Device Identification
    • 11.4.2. Port Ownership
    • 11.4.3. Device Configuration
    • 11.4.4. On-the-Fly Configuration
    • 11.4.5. Configuration of Transmit Queues
    • 11.4.6. Free Tx mbuf on Demand
    • 11.4.7. Hardware Offload
  • 11.5. Poll Mode Driver API
    • 11.5.1. Generalities
    • 11.5.2. Generic Packet Representation
    • 11.5.3. Ethernet Device API
    • 11.5.4. Ethernet Device Standard Device Arguments
    • 11.5.5. Extended Statistics API
    • 11.5.6. NIC Reset API
• 12. Generic flow API (rte_flow)
  • 12.1. Overview
  • 12.2. Flow rule
    • 12.2.1. Description
    • 12.2.2. Attributes
    • 12.2.3. Pattern item
    • 12.2.4. Matching pattern
    • 12.2.5. Meta item types
    • 12.2.6. Data matching item types
    • 12.2.7. Actions
    • 12.2.8. Action types
    • 12.2.9. Negative types
    • 12.2.10. Planned types
  • 12.3. Rules management
    • 12.3.1. Validation
    • 12.3.2. Creation
    • 12.3.3. Destruction
    • 12.3.4. Flush
    • 12.3.5. Query
  • 12.4. Flow isolated mode
  • 12.5. Verbose error reporting
  • 12.6. Helpers
    • 12.6.1. Error initializer
    • 12.6.2. Object conversion
    • 12.6.3. Tunneled traffic offload
  • 12.7. Caveats
  • 12.8. PMD interface
  • 12.9. Device compatibility
    • 12.9.1. Global bit-masks
    • 12.9.2. Unsupported layer types
    • 12.9.3. ANY pattern item
    • 12.9.4. Unsupported actions
    • 12.9.5. Flow rules priority
  • 12.10. Future evolutions
• 13. Switch Representation within DPDK Applications
  • 13.1. Introduction
  • 13.2. Port Representors
  • 13.3. Basic SR-IOV
  • 13.4. Controlled SR-IOV
    • 13.4.1. Initialization
    • 13.4.2. VF Representors
    • 13.4.3. Traffic Steering
  • 13.5. Flow API (rte_flow)
    • 13.5.1. Extensions
    • 13.5.2. Traffic Direction
    • 13.5.3. Transferring Traffic
    • 13.5.4. Pattern Items And Actions
    • 13.5.5. Actions Order and Repetition
  • 13.6. Switching Examples
    • 13.6.1. Associating VF 1 with Physical Port 0
    • 13.6.2. Sharing Broadcasts
    • 13.6.3. Encapsulating VF 2 Traffic in VXLAN
• 14. Traffic Metering and Policing API
  • 14.1. Overview
  • 14.2. Configuration steps
  • 14.3. Run-time processing
• 15. Traffic Management API
  • 15.1. Overview
  • 15.2. Capability API
  • 15.3. Scheduling Algorithms
  • 15.4. Traffic Shaping
  • 15.5. Congestion Management
  • 15.6. Packet Marking
  • 15.7. Steps to Setup the Hierarchy
    • 15.7.1. Initial Hierarchy Specification
    • 15.7.2. Hierarchy Commit
    • 15.7.3. Run-Time Hierarchy Updates
• 16. Wireless Baseband Device Library
  • 16.1. Design Principles
  • 16.2. Device Management
    • 16.2.1. Device Creation
    • 16.2.2. Device Identification
    • 16.2.3. Device Configuration
    • 16.2.4. Queues Configuration
    • 16.2.5. Device & Queues Management
    • 16.2.6. Logical Cores, Memory and Queues Relationships
  • 16.3. Device Operation Capabilities
    • 16.3.1. Capabilities Discovery
  • 16.4. Operation Processing
    • 16.4.1. Enqueue / Dequeue Burst APIs
    • 16.4.2. Operation Representation
    • 16.4.3. Operation Management and Allocation
    • 16.4.4. BBDEV Inbound/Outbound Memory
    • 16.4.5. BBDEV Turbo Encode Operation
    • 16.4.6. BBDEV Turbo Decode Operation
    • 16.4.7. BBDEV LDPC Encode Operation
    • 16.4.8. BBDEV LDPC Decode Operation
  • 16.5. Sample code
    • 16.5.1. BBDEV Device API
• 17. Cryptography 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. Configuration of Queue Pairs
    • 17.2.5. Logical Cores, Memory and Queues Pair Relationships
  • 17.3. Device Features and Capabilities
    • 17.3.1. Device Features
    • 17.3.2. Device Operation Capabilities
    • 17.3.3. Capabilities Discovery
  • 17.4. Operation Processing
    • 17.4.1. Private data
    • 17.4.2. Enqueue / Dequeue Burst APIs
    • 17.4.3. Operation Representation
    • 17.4.4. Operation Management and Allocation
  • 17.5. Symmetric Cryptography Support
    • 17.5.1. Session and Session Management
    • 17.5.2. Transforms and Transform Chaining
    • 17.5.3. Symmetric Operations
  • 17.6. Synchronous mode
    • 17.6.1. Cryptodev Raw Data-path APIs
  • 17.7. Sample code
  • 17.8. Asymmetric Cryptography
    • 17.8.1. Session and Session Management
    • 17.8.2. Asymmetric Sessionless Support
    • 17.8.3. Transforms and Transform Chaining
    • 17.8.4. Asymmetric Operations
  • 17.9. Asymmetric crypto Sample code
    • 17.9.1. Asymmetric Crypto Device API
• 18. Compression Device Library
  • 18.1. Device Management
    • 18.1.1. Device Creation
    • 18.1.2. Device Identification
    • 18.1.3. Device Configuration
    • 18.1.4. Configuration of Queue Pairs
    • 18.1.5. Logical Cores, Memory and Queue Pair Relationships
  • 18.2. Device Features and Capabilities
    • 18.2.1. Capabilities
    • 18.2.2. Capabilities Discovery
  • 18.3. Compression Operation
    • 18.3.1. Operation Representation
    • 18.3.2. Operation Management and Allocation
    • 18.3.3. Passing source data as mbuf-chain
    • 18.3.4. Operation Status
    • 18.3.5. Operation status after enqueue / dequeue
    • 18.3.6. Produced, Consumed And Operation Status
  • 18.4. Transforms
  • 18.5. Compression API Hash support
  • 18.6. Compression API Stateless operation
    • 18.6.1. priv_xform in Stateless operation
    • 18.6.2. Stateless and OUT_OF_SPACE
    • 18.6.3. Hash in Stateless
    • 18.6.4. Checksum in Stateless
  • 18.7. Compression API Stateful operation
    • 18.7.1. Stream in Stateful operation
    • 18.7.2. Stateful and OUT_OF_SPACE
    • 18.7.3. Hash in Stateful
    • 18.7.4. Checksum in Stateful
  • 18.8. Burst in compression API
    • 18.8.1. Enqueue / Dequeue Burst APIs
  • 18.9. Sample code
    • 18.9.1. Compression Device API
• 19. RegEx Device Library
  • 19.1. Design Principles
  • 19.2. Device Management
    • 19.2.1. Device Creation
    • 19.2.2. Device Identification
    • 19.2.3. Device Configuration
    • 19.2.4. Configuration of Rules Database
    • 19.2.5. Configuration of Queue Pairs
    • 19.2.6. Logical Cores, Memory and Queues Pair Relationships
  • 19.3. Device Features and Capabilities
    • 19.3.1. Enqueue / Dequeue Burst APIs
• 20. Security Library
  • 20.1. Design Principles
    • 20.1.1. Inline Crypto
    • 20.1.2. Inline protocol offload
    • 20.1.3. Lookaside protocol offload
    • 20.1.4. PDCP Flow Diagram
    • 20.1.5. DOCSIS Protocol
  • 20.2. Device Features and Capabilities
    • 20.2.1. Device Capabilities For Security Operations
    • 20.2.2. Capabilities Discovery
    • 20.2.3. Security Session Create/Free
    • 20.2.4. Security session configuration
    • 20.2.5. Security API
    • 20.2.6. Flow based Security Session
• 21. Rawdevice Library
  • 21.1. Introduction
  • 21.2. Design
    • 21.2.1. Device Identification
• 22. Link Bonding Poll Mode Driver Library
  • 22.1. Link Bonding Modes Overview
  • 22.2. Implementation Details
    • 22.2.1. Link Status Change Interrupts / Polling
    • 22.2.2. Requirements / Limitations
    • 22.2.3. Configuration
  • 22.3. Using Link Bonding Devices
    • 22.3.1. Using the Poll Mode Driver from an Application
    • 22.3.2. Using Link Bonding Devices from the EAL Command Line
• 23. Timer Library
  • 23.1. Implementation Details
  • 23.2. Use Cases
  • 23.3. References
• 24. Hash Library
  • 24.1. Hash API Overview
  • 24.2. Multi-process support
  • 24.3. Multi-thread support
  • 24.4. Extendable Bucket Functionality support
  • 24.5. Implementation Details (non Extendable Bucket Case)
  • 24.6. Implementation Details (with Extendable Bucket)
  • 24.7. Entry distribution in hash table
  • 24.8. Use Case: Flow Classification
  • 24.9. References
• 25. Elastic Flow Distributor Library
  • 25.1. Introduction
  • 25.2. Flow Based Distribution
    • 25.2.1. Computation Based Schemes
    • 25.2.2. Flow-Table Based Schemes
    • 25.2.3. EFD Based Scheme
  • 25.3. Example of EFD Library Usage
  • 25.4. Library API Overview
    • 25.4.1. EFD Table Create
    • 25.4.2. EFD Insert and Update
    • 25.4.3. EFD Lookup
    • 25.4.4. EFD Delete
  • 25.5. Library Internals
    • 25.5.1. Insert Function Internals
    • 25.5.2. Lookup Function Internals
    • 25.5.3. Group Rebalancing Function Internals
  • 25.6. References
• 26. Membership Library
  • 26.1. Introduction
  • 26.2. Vector of Bloom Filters
  • 26.3. Hash-Table based Set-Summaries
    • 26.3.1. Set-Summaries with False Negative Probability
  • 26.4. Library API Overview
    • 26.4.1. Set-summary Create
    • 26.4.2. Set-summary Element Insertion
    • 26.4.3. Set-summary Element Lookup
    • 26.4.4. Set-summary Element Delete
  • 26.5. References
• 27. LPM Library
  • 27.1. LPM API Overview
  • 27.2. Implementation Details
    • 27.2.1. Addition
    • 27.2.2. Deletion
    • 27.2.3. Lookup
    • 27.2.4. Limitations in the Number of Rules
    • 27.2.5. Use Case: IPv4 Forwarding
    • 27.2.6. References
• 28. LPM6 Library
  • 28.1. LPM6 API Overview
    • 28.1.1. Implementation Details
    • 28.1.2. Addition
    • 28.1.3. Lookup
    • 28.1.4. Limitations in the Number of Rules
  • 28.2. Use Case: IPv6 Forwarding
• 29. Flow Classification Library
  • 29.1. Overview
    • 29.1.1. Classifier creation
    • 29.1.2. Adding a table to the Classifier
    • 29.1.3. Flow Parsing
    • 29.1.4. Adding Flow Rules
    • 29.1.5. Deleting Flow Rules
    • 29.1.6. Packet Matching
• 30. Packet Distributor Library
  • 30.1. Distributor Core Operation
  • 30.2. Worker Operation
• 31. Reorder Library
  • 31.1. Operation
  • 31.2. Implementation Details
  • 31.3. Use Case: Packet Distributor
• 32. IP Fragmentation and Reassembly Library
  • 32.1. Packet fragmentation
  • 32.2. Packet reassembly
    • 32.2.1. IP Fragment Table
    • 32.2.2. Packet Reassembly
    • 32.2.3. Debug logging and Statistics Collection
• 33. Generic Receive Offload Library
  • 33.1. Overview
  • 33.2. Two Sets of API
    • 33.2.1. Lightweight Mode API
    • 33.2.2. Heavyweight Mode API
  • 33.3. Reassembly Algorithm
    • 33.3.1. Challenges
    • 33.3.2. Key-based Reassembly Algorithm
  • 33.4. TCP/IPv4 GRO
  • 33.5. VxLAN GRO
  • 33.6. GRO Library Limitations
• 34. Generic Segmentation Offload Library
  • 34.1. Overview
  • 34.2. Limitations
  • 34.3. Packet Segmentation
    • 34.3.1. GSO Output Segment Format
  • 34.4. Supported GSO Packet Types
    • 34.4.1. TCP/IPv4 GSO
    • 34.4.2. UDP/IPv4 GSO
    • 34.4.3. VxLAN GSO
    • 34.4.4. GRE GSO
  • 34.5. How to Segment a Packet
• 35. The librte_pdump Library
  • 35.1. Operation
  • 35.2. Implementation Details
  • 35.3. Use Case: Packet Capturing
• 36. Multi-process Support
  • 36.1. Memory Sharing
  • 36.2. Deployment Models
    • 36.2.1. Symmetric/Peer Processes
    • 36.2.2. Asymmetric/Non-Peer Processes
    • 36.2.3. Running Multiple Independent DPDK Applications
    • 36.2.4. Running Multiple Independent Groups of DPDK Applications
  • 36.3. Multi-process Limitations
  • 36.4. Communication between multiple processes
    • 36.4.1. Registering for incoming messages
    • 36.4.2. Sending messages
    • 36.4.3. Sending requests
    • 36.4.4. Receiving and responding to messages
    • 36.4.5. Misc considerations
• 37. Kernel NIC Interface
  • 37.1. The DPDK KNI Kernel Module
    • 37.1.1. Loopback Mode
    • 37.1.2. Kernel Thread Mode
    • 37.1.3. Default Carrier State
    • 37.1.4. Bifurcated Device Support
  • 37.2. KNI Creation and Deletion
  • 37.3. DPDK mbuf Flow
  • 37.4. Use Case: Ingress
  • 37.5. Use Case: Egress
  • 37.6. IOVA = VA: Support
  • 37.7. Ethtool
• 38. Thread Safety of DPDK Functions
  • 38.1. Fast-Path APIs
  • 38.2. Performance Insensitive API
  • 38.3. Library Initialization
  • 38.4. Interrupt Thread
• 39. Event Device Library
  • 39.1. Event struct
    • 39.1.1. Event Metadata
    • 39.1.2. Event Payload
    • 39.1.3. Queues
    • 39.1.4. Ports
  • 39.2. API Walk-through
    • 39.2.1. Init and Config
    • 39.2.2. Setting up Queues
    • 39.2.3. Setting up Ports
    • 39.2.4. Linking Queues and Ports
    • 39.2.5. Starting the EventDev
    • 39.2.6. Ingress of New Events
    • 39.2.7. Forwarding of Events
    • 39.2.8. Egress of Events
  • 39.3. Summary
• 40. Event Ethernet Rx Adapter Library
  • 40.1. API Walk-through
    • 40.1.1. Creating an Adapter Instance
    • 40.1.2. Adding Rx Queues to the Adapter Instance
    • 40.1.3. Querying Adapter Capabilities
    • 40.1.4. Configuring the Service Function
    • 40.1.5. Starting the Adapter Instance
    • 40.1.6. Getting Adapter Statistics
    • 40.1.7. Interrupt Based Rx Queues
    • 40.1.8. Rx Callback for SW Rx Adapter
• 41. Event Ethernet Tx Adapter Library
  • 41.1. API Walk-through
    • 41.1.1. Creating an Adapter Instance
    • 41.1.2. Adding Tx Queues to the Adapter Instance
    • 41.1.3. Querying Adapter Capabilities
    • 41.1.4. Linking a Queue to the Adapter’s Event Port
    • 41.1.5. Configuring the Service Function
    • 41.1.6. Starting the Adapter Instance
    • 41.1.7. Enqueuing Packets to the Adapter
    • 41.1.8. Getting Adapter Statistics
• 42. Event Timer Adapter Library
  • 42.1. Event Timer struct
    • 42.1.1. Timer Expiry Event
    • 42.1.2. Timeout Ticks
    • 42.1.3. State
    • 42.1.4. User Metadata
  • 42.2. API Overview
    • 42.2.1. Create and Configure an Adapter Instance
    • 42.2.2. Retrieve Event Timer Adapter Contextual Information
    • 42.2.3. Configuring the Service Component
    • 42.2.4. Starting the Adapter Instance
    • 42.2.5. Arming Event Timers
    • 42.2.6. Canceling Event Timers
  • 42.3. Processing Timer Expiry Events
  • 42.4. Summary
• 43. Event Crypto Adapter Library
  • 43.1. Adapter Mode
    • 43.1.1. RTE_EVENT_CRYPTO_ADAPTER_OP_NEW mode
    • 43.1.2. RTE_EVENT_CRYPTO_ADAPTER_OP_FORWARD mode
  • 43.2. API Overview
    • 43.2.1. Create an adapter instance
    • 43.2.2. Querying adapter capabilities
    • 43.2.3. Adding queue pair to the adapter instance
    • 43.2.4. Configure the service function
    • 43.2.5. Set event request/response information
    • 43.2.6. Start the adapter instance
    • 43.2.7. Get adapter statistics
• 44. Quality of Service (QoS) Framework
  • 44.1. Packet Pipeline with QoS Support
  • 44.2. Hierarchical Scheduler
    • 44.2.1. Overview
    • 44.2.2. Scheduling Hierarchy
    • 44.2.3. Application Programming Interface (API)
    • 44.2.4. Implementation
    • 44.2.5. Worst Case Scenarios for Performance
  • 44.3. Dropper
    • 44.3.1. Configuration
    • 44.3.2. Enqueue Operation
    • 44.3.3. Queue Empty Operation
    • 44.3.4. Source Files Location
    • 44.3.5. Integration with the DPDK QoS Scheduler
    • 44.3.6. Integration with the DPDK QoS Scheduler Sample Application
    • 44.3.7. Application Programming Interface (API)
  • 44.4. Traffic Metering
    • 44.4.1. Functional Overview
    • 44.4.2. Implementation Overview
• 45. Power Management
  • 45.1. CPU Frequency Scaling
  • 45.2. Core-load Throttling through C-States
  • 45.3. Per-core Turbo Boost
  • 45.4. Use of Power Library in a Hyper-Threaded Environment
  • 45.5. API Overview of the Power Library
  • 45.6. User Cases
  • 45.7. Empty Poll API
    • 45.7.1. Abstract
    • 45.7.2. Proposed Solution
    • 45.7.3. API Overview for Empty Poll Power Management
  • 45.8. User Cases
  • 45.9. References
• 46. Packet Classification and Access Control
  • 46.1. Overview
    • 46.1.1. Rule definition
    • 46.1.2. RT memory size limit
    • 46.1.3. Classification methods
  • 46.2. Application Programming Interface (API) Usage
    • 46.2.1. Classify with Multiple Categories
• 47. Packet Framework
  • 47.1. Design Objectives
  • 47.2. Overview
  • 47.3. Port Library Design
    • 47.3.1. Port Types
    • 47.3.2. Port Interface
  • 47.4. Table Library Design
    • 47.4.1. Table Types
    • 47.4.2. Table Interface
    • 47.4.3. Hash Table Design
  • 47.5. Pipeline Library Design
    • 47.5.1. Connectivity of Ports and Tables
    • 47.5.2. Port Actions
    • 47.5.3. Table Actions
  • 47.6. Multicore Scaling
    • 47.6.1. Shared Data Structures
  • 47.7. Interfacing with Accelerators
  • 47.8. The Software Switch (SWX) Pipeline
• 48. Vhost Library
  • 48.1. Vhost API Overview
  • 48.2. Vhost-user Implementations
  • 48.3. Guest memory requirement
  • 48.4. Vhost supported vSwitch reference
  • 48.5. Vhost data path acceleration (vDPA)
• 49. Metrics Library
  • 49.1. Initializing the library
  • 49.2. Registering metrics
  • 49.3. Updating metric values
  • 49.4. Querying metrics
  • 49.5. Deinitialising the library
  • 49.6. Bit-rate statistics library
    • 49.6.1. Initialization
    • 49.6.2. Controlling the sampling rate
  • 49.7. Latency statistics library
    • 49.7.1. Initialization
    • 49.7.2. Triggering statistic updates
    • 49.7.3. Library shutdown
    • 49.7.4. Timestamp and latency calculation
• 50. Telemetry Library
  • 50.1. Creating Callback Functions
    • 50.1.1. Function Type
    • 50.1.2. Formatting Data
  • 50.2. Registering Commands
  • 50.3. Using Commands
• 51. Berkeley Packet Filter Library
  • 51.1. Packet data load instructions
  • 51.2. Not currently supported eBPF features
• 52. IPsec Packet Processing Library
  • 52.1. SA level API
    • 52.1.1. RTE_SECURITY_ACTION_TYPE_NONE
    • 52.1.2. RTE_SECURITY_ACTION_TYPE_CPU_CRYPTO
    • 52.1.3. RTE_SECURITY_ACTION_TYPE_INLINE_CRYPTO
    • 52.1.4. RTE_SECURITY_ACTION_TYPE_INLINE_PROTOCOL
    • 52.1.5. RTE_SECURITY_ACTION_TYPE_LOOKASIDE_PROTOCOL
  • 52.2. SA database API
    • 52.2.1. Create/destroy
    • 52.2.2. Add/delete rules
    • 52.2.3. Lookup
  • 52.3. Supported features
  • 52.4. Limitations
• 53. Graph Library and Inbuilt Nodes
  • 53.1. Features
  • 53.2. Advantages of Graph architecture
  • 53.3. Performance tuning parameters
  • 53.4. Programming model
    • 53.4.1. Anatomy of Node:
    • 53.4.2. Node creation and registration
    • 53.4.3. Link the Nodes to create the graph topology
    • 53.4.4. Create the graph object
    • 53.4.5. Multicore graph processing
    • 53.4.6. In fast path
    • 53.4.7. Context update when graph walk in action
    • 53.4.8. Get the node statistics using graph cluster
    • 53.4.9. Node writing guidelines
    • 53.4.10. Static nodes
    • 53.4.11. Intermediate nodes
  • 53.5. Graph object memory layout
  • 53.6. Inbuilt Nodes
    • 53.6.1. ethdev_rx
    • 53.6.2. ethdev_tx
    • 53.6.3. pkt_drop
    • 53.6.4. ip4_lookup
    • 53.6.5. ip4_rewrite
    • 53.6.6. null
• 54. Source Organization
  • 54.1. Libraries
  • 54.2. Drivers
  • 54.3. Applications
• 55. Installing DPDK Using the meson build system
  • 55.1. Summary
  • 55.2. Getting the Tools
  • 55.3. Configuring the Build
  • 55.4. Performing the Build
  • 55.5. Installing the Compiled Files
  • 55.6. Cross Compiling DPDK
  • 55.7. Using the DPDK within an Application
• 56. Running DPDK Unit Tests with Meson
  • 56.1. Grouping of test cases
  • 56.2. Dealing with skipped test cases
• 57. Building Your Own Application
  • 57.1. Compiling a Sample Application in the Development Kit Directory
  • 57.2. Build Your Own Application Outside the Development Kit
  • 57.3. Customizing Makefiles
    • 57.3.1. Application Makefile
• 58. Performance Optimization Guidelines
  • 58.1. Introduction
• 59. Writing Efficient Code
  • 59.1. Memory
    • 59.1.1. Memory Copy: Do not Use libc in the Data Plane
    • 59.1.2. Memory Allocation
    • 59.1.3. Concurrent Access to the Same Memory Area
    • 59.1.4. NUMA
    • 59.1.5. Distribution Across Memory Channels
    • 59.1.6. Locking memory pages
  • 59.2. Communication Between lcores
  • 59.3. PMD
    • 59.3.1. Lower Packet Latency
  • 59.4. Locks and Atomic Operations
    • 59.4.1. Locks
    • 59.4.2. Atomic Operations: Use C11 Atomic Builtins
  • 59.5. Coding Considerations
    • 59.5.1. Inline Functions
    • 59.5.2. Branch Prediction
  • 59.6. Setting the Target CPU Type
• 60. Link Time Optimization
• 61. Profile Your Application
  • 61.1. Profiling on x86
    • 61.1.1. Profiling with VTune
  • 61.2. Profiling on ARM64
    • 61.2.1. Using Linux perf
    • 61.2.2. Low-resolution generic counter
    • 61.2.3. High-resolution cycle counter
• 62. Glossary