Programmer’s Guide

• 1. Common Libraries
  • 1.1. Introduction
  • 1.2. Libraries Details
    • 1.2.1. DAO Logger
    • 1.2.2. DAO Utilities
    • 1.2.3. DAO DMA
    • 1.2.4. DAO Bitmap Helper
    • 1.2.5. DAO Assert Helper
• 2. Conntrack Library
  • 2.1. Introduction
  • 2.2. What it does
  • 2.3. How to use it
    • 2.3.1. Initialization
    • 2.3.2. Packet Processing
    • 2.3.3. Connection Cleanup
    • 2.3.4. Shutdown
    • 2.3.5. Debugging & Monitoring
• 3. Conntrack API Example Guide
  • 3.1. Conntrack Functional Test
  • 3.2. Conntrack Core Scalability Test
  • 3.3. Conntrack Connection Per Second (CPS) Test
• 4. DMA Library
  • 4.1. Initialization
  • 4.2. Packet Processing
• 5. Ethernet Transport Library
  • 5.1. Architecture Overview
  • 5.2. API Usage
  • 5.3. Transport Protocol
    • 5.3.1. TRS header format
    • 5.3.2. TRS packet format
  • 5.4. Usage Restrictions
• 6. Flow Library
  • 6.1. Introduction
  • 6.2. Flow Rule
  • 6.3. Programming Model
    • 6.3.1. Initialization
    • 6.3.2. Flow Creation
    • 6.3.3. Flow Lookup
    • 6.3.4. Flow Destruction
    • 6.3.5. Flow Query
    • 6.3.6. Flow Flush
    • 6.3.7. Flow Information
    • 6.3.8. Installing flow directly into hardware
    • 6.3.9. Removing a flow from hardware
• 7. Liquid Crypto Library
  • 7.1. Architecture Overview
  • 7.2. Features
    • 7.2.1. Asymmetric Cryptography
    • 7.2.2. Symmetric Cryptography
      • 7.2.2.1. Ciphering Algorithms
      • 7.2.2.2. Authentication Algorithms
      • 7.2.2.3. AEAD Algorithms
      • 7.2.2.4. Chained Cipher Auth Algorithms
      • 7.2.2.5. Random Number Generation (RNG)
      • 7.2.2.6. AES Key Wrap (KW) and AES Key Wrap with Padding (KWP) Algorithms
  • 7.3. Control Plane
    • 7.3.1. Setup Device and Queues
    • 7.3.2. Device Teardown
    • 7.3.3. Command Queue
  • 7.4. Data Plane
    • 7.4.1. Enqueue API - Asymmetric Crypto
    • 7.4.2. Enqueue API - Symmetric Crypto
    • 7.4.3. Enqueue API - Random Number Generation
      • 7.4.3.1. Buffer Usage
    • 7.4.4. Dequeue API
  • 7.5. Known Limitations
• 8. Netlink Library
  • 8.1. Introduction
  • 8.2. Native netlink registration
    • 8.2.1. Netlink protocols
      • 8.2.1.1. Netlink Object
    • 8.2.2. Native parse callbacks
    • 8.2.3. Netlink multicast groups
    • 8.2.4. Notifier Object
      • 8.2.4.1. Application specific ops
      • 8.2.4.2. Application specific cookie
      • 8.2.4.3. Get notifier object for a given parse_cb
  • 8.3. High level netlink registration
    • 8.3.1. NETLINK_ROUTE
    • 8.3.2. NETLINK_XFRM
  • 8.4. Programming model
    • 8.4.1. Initialization
    • 8.4.2. Periodic Netlink polling
      • 8.4.2.1. dao_netlink_poll()
      • 8.4.2.2. dao_netlink_poll_complete()
      • 8.4.2.3. Pseudo-code
    • 8.4.3. Netlink Cleanup
• 9. PEM Library
  • 9.1. Prerequisites:
  • 9.2. Device Identification
  • 9.3. Device Initialization
  • 9.4. Memory regions registration for polling
  • 9.5. Get VF specific bar region info
• 10. Port Group Library
  • 10.1. Introduction
  • 10.2. Programming model
    • 10.2.1. Initializing Port group library
    • 10.2.2. Creating a Port Group
    • 10.2.3. Adding port to a Port Group
    • 10.2.4. Number of ports in Port group
    • 10.2.5. Port group lookup by name
    • 10.2.6. Iterating over Port group
    • 10.2.7. Deleting port from Port group
    • 10.2.8. Destroying a Port group
• 11. Port Queue Group Library
  • 11.1. Introduction
  • 11.2. Programming model
    • 11.2.1. Initializing Port queue group library
    • 11.2.2. Creating a Port queue group
    • 11.2.3. Assigning [port, queue] to a core within Port queue group
    • 11.2.4. Number of [port, queue] in Port queue group
    • 11.2.5. Port queue group lookup by name
    • 11.2.6. Iterating over Port queue group on fast path core
    • 11.2.7. Deleting port from Port queue group
    • 11.2.8. Destroying a Port queue group
• 12. VFIO Library
  • 12.1. Prerequisites for Platform Devices:
  • 12.2. Prerequisites for PCIe Devices:
  • 12.3. DAO VFIO device initialization
  • 12.4. DAO VFIO device cleanup
• 13. VirtIO Library
  • 13.1. VirtIO Device initialization
  • 13.2. Features
• 14. VirtIO Crypto Library
  • 14.1. Features
    • 14.1.1. VirtIO Common Feature Bits:
    • 14.1.2. VirtIO-crypto Feature Bits:
    • 14.1.3. VirtIO-crypto Services:
  • 14.2. VirtIO-crypto device identification
  • 14.3. Device initialization
  • 14.4. User callback APIs
  • 14.5. VirtIO Crypto Queue Overview
  • 14.6. Queue count
  • 14.7. VirtIO Descriptors Management API
  • 14.8. Host receive API
  • 14.9. Host transmit API
• 15. VirtIO Net Library
  • 15.1. Features
    • 15.1.1. VirtIO Common Feature Bits:
    • 15.1.2. VirtIO-net Feature Bits:
  • 15.2. Platform Support
  • 15.3. VirtIO Emulation Architecture Overview
  • 15.4. VirtIO-net device identification
  • 15.5. Device initialization
  • 15.6. User callback APIs
  • 15.7. Queue count
  • 15.8. Link status update
  • 15.9. VirtIO descriptors Management API
  • 15.10. Enqueue Burst API
  • 15.11. Dequeue Burst API
• 16. VirtIO Block Library
  • 16.1. Features
    • 16.1.1. VirtIO Common Feature Bits
    • 16.1.2. VirtIO Block Feature Bits
    • 16.1.3. Notes on Supported Features
  • 16.2. VirtIO Emulation Architecture Overview
  • 16.3. VirtIO Block Device Usage
    • 16.3.1. VirtIO Block Device Identification
    • 16.3.2. VirtIO Block Device Initialization
    • 16.3.3. VirtIO Queues
    • 16.3.4. VirtIO Block Data Path
    • 16.3.5. Request Dequeue
    • 16.3.6. Request Completion Marking
    • 16.3.7. VirtIO Descriptors Management
• 17. Block Device Library
  • 17.1. Features
  • 17.2. Library APIs
    • 17.2.1. Control Path API
    • 17.2.2. Data Path API