X-Git-Url: http://git.droids-corp.org/?a=blobdiff_plain;f=doc%2Fguides%2Fprog_guide%2Findex.rst;h=692409af82310606211d4425ca20af22aaef7b97;hb=637af850902c19057e2fb57d9e79817ae5f44821;hp=de69682eb83d316a9a965959213e56d81adb36ae;hpb=34287c690ca3a25213b79345924f45ae5e7e1398;p=dpdk.git diff --git a/doc/guides/prog_guide/index.rst b/doc/guides/prog_guide/index.rst index de69682eb8..692409af82 100644 --- a/doc/guides/prog_guide/index.rst +++ b/doc/guides/prog_guide/index.rst @@ -1,41 +1,9 @@ -.. BSD LICENSE - Copyright(c) 2010-2014 Intel Corporation. All rights reserved. - All rights reserved. - - Redistribution and use in source and binary forms, with or without - modification, are permitted provided that the following conditions - are met: - - * Redistributions of source code must retain the above copyright - notice, this list of conditions and the following disclaimer. - * Redistributions in binary form must reproduce the above copyright - notice, this list of conditions and the following disclaimer in - the documentation and/or other materials provided with the - distribution. - * Neither the name of Intel Corporation nor the names of its - contributors may be used to endorse or promote products derived - from this software without specific prior written permission. - - THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS - "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT - LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR - A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT - OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, - SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT - LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, - DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY - THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT - (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE - OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(c) 2010-2017 Intel Corporation. Programmer's Guide ================== -|today| - - -**Contents** - .. toctree:: :maxdepth: 3 :numbered: @@ -43,194 +11,59 @@ Programmer's Guide intro overview env_abstraction_layer - malloc_lib + service_cores + rcu_lib ring_lib + stack_lib mempool_lib mbuf_lib poll_mode_drv - i40e_ixgbe_igb_virt_func_drv - driver_vm_emul_dev - ivshmem_lib - poll_mode_drv_emulated_virtio_nic - poll_mode_drv_paravirtual_vmxnets_nic - intel_dpdk_xen_based_packet_switch_sol - libpcap_ring_based_poll_mode_drv + rte_flow + switch_representation + traffic_metering_and_policing + traffic_management + bbdev + cryptodev_lib + compressdev + rte_security + rawdev link_bonding_poll_mode_drv_lib timer_lib hash_lib + efd_lib + member_lib lpm_lib lpm6_lib + flow_classify_lib packet_distrib_lib reorder_lib ip_fragment_reassembly_lib + generic_receive_offload_lib + generic_segmentation_offload_lib + pdump_lib multi_proc_support kernel_nic_interface - thread_safety_intel_dpdk_functions + thread_safety_dpdk_functions + eventdev + event_ethernet_rx_adapter + event_ethernet_tx_adapter + event_timer_adapter + event_crypto_adapter qos_framework power_man packet_classif_access_ctrl packet_framework vhost_lib + metrics_lib + bpf_lib + ipsec_lib source_org dev_kit_build_system dev_kit_root_make_help - extend_intel_dpdk + extend_dpdk build_app ext_app_lib_make_help perf_opt_guidelines writing_efficient_code profile_app glossary - - -**Figures** - -:ref:`Figure 1. Core Components Architecture ` - -:ref:`Figure 2. EAL Initialization in a Linux Application Environment ` - -:ref:`Figure 3. Example of a malloc heap and malloc elements within the malloc library ` - -:ref:`Figure 4. Ring Structure ` - -:ref:`Figure 5. Two Channels and Quad-ranked DIMM Example ` - -:ref:`Figure 6. Three Channels and Two Dual-ranked DIMM Example ` - -:ref:`Figure 7. A mempool in Memory with its Associated Ring ` - -:ref:`Figure 8. An mbuf with One Segment ` - -:ref:`Figure 9. An mbuf with Three Segments ` - -:ref:`Figure 10. Virtualization for a Single Port NIC in SR-IOV Mode ` - -:ref:`Figure 11. Performance Benchmark Setup ` - -:ref:`Figure 12. Fast Host-based Packet Processing ` - -:ref:`Figure 13. Inter-VM Communication ` - -:ref:`Figure 14. Host2VM Communication Example Using kni vhost Back End ` - -:ref:`Figure 15. Host2VM Communication Example Using qemu vhost Back End ` - -:ref:`Figure 16. Memory Sharing inthe Intel® DPDK Multi-process Sample Application ` - -:ref:`Figure 17. Components of an Intel® DPDK KNI Application ` - -:ref:`Figure 18. Packet Flow via mbufs in the Intel DPDK® KNI ` - -:ref:`Figure 19. vHost-net Architecture Overview ` - -:ref:`Figure 20. KNI Traffic Flow ` - -:ref:`Figure 21. Complex Packet Processing Pipeline with QoS Support ` - -:ref:`Figure 22. Hierarchical Scheduler Block Internal Diagram ` - -:ref:`Figure 23. Scheduling Hierarchy per Port ` - -:ref:`Figure 24. Internal Data Structures per Port ` - -:ref:`Figure 25. Prefetch Pipeline for the Hierarchical Scheduler Enqueue Operation ` - -:ref:`Figure 26. Pipe Prefetch State Machine for the Hierarchical Scheduler Dequeue Operation ` - -:ref:`Figure 27. High-level Block Diagram of the Intel® DPDK Dropper ` - -:ref:`Figure 28. Flow Through the Dropper ` - -:ref:`Figure 29. Example Data Flow Through Dropper ` - -:ref:`Figure 30. Packet Drop Probability for a Given RED Configuration ` - -:ref:`Figure 31. Initial Drop Probability (pb), Actual Drop probability (pa) Computed Using a Factor 1 (Blue Curve) and a Factor 2 (Red Curve) ` - -:ref:`Figure 32. Example of packet processing pipeline. The input ports 0 and 1 are connected with the output ports 0, 1 and 2 through tables 0 and 1. ` - -:ref:`Figure 33. Sequence of steps for hash table operations in packet processing context ` - -:ref:`Figure 34. Data structures for configurable key size hash tables ` - -:ref:`Figure 35. Bucket search pipeline for key lookup operation (configurable key size hash tables) ` - -:ref:`Figure 36. Pseudo-code for match, match_many and match_pos ` - -:ref:`Figure 37. Data structures for 8-byte key hash tables ` - -:ref:`Figure 38. Data structures for 16-byte key hash tables ` - -:ref:`Figure 39. Bucket search pipeline for key lookup operation (single key size hash tables) ` - -**Tables** - -:ref:`Table 1. Packet Processing Pipeline Implementing QoS ` - -:ref:`Table 2. Infrastructure Blocks Used by the Packet Processing Pipeline ` - -:ref:`Table 3. Port Scheduling Hierarchy ` - -:ref:`Table 4. Scheduler Internal Data Structures per Port ` - -:ref:`Table 5. Ethernet Frame Overhead Fields ` - -:ref:`Table 6. Token Bucket Generic Operations ` - -:ref:`Table 7. Token Bucket Generic Parameters ` - -:ref:`Table 8. Token Bucket Persistent Data Structure ` - -:ref:`Table 9. Token Bucket Operations ` - -:ref:`Table 10. Subport/Pipe Traffic Class Upper Limit Enforcement Persistent Data Structure ` - -:ref:`Table 11. Subport/Pipe Traffic Class Upper Limit Enforcement Operations ` - -:ref:`Table 12. Weighted Round Robin (WRR) ` - -:ref:`Table 13. Subport Traffic Class Oversubscription ` - -:ref:`Table 14. Watermark Propagation from Subport Level to Member Pipes at the Beginning of Each Traffic Class Upper Limit Enforcement Period ` - -:ref:`Table 15. Watermark Calculation ` - -:ref:`Table 16. RED Configuration Parameters ` - -:ref:`Table 17. Relative Performance of Alternative Approaches ` - -:ref:`Table 18. RED Configuration Corresponding to RED Configuration File ` - -:ref:`Table 19. Port types ` - -:ref:`Table 20. Port abstract interface ` - -:ref:`Table 21. Table types ` - -:ref:`Table 29. Table Abstract Interface ` - -:ref:`Table 22. Configuration parameters common for all hash table types ` - -:ref:`Table 23. Configuration parameters specific to extendible bucket hash table ` - -:ref:`Table 24. Configuration parameters specific to pre-computed key signature hash table ` - -:ref:`Table 25. The main large data structures (arrays) used for configurable key size hash tables ` - -:ref:`Table 26. Field description for bucket array entry (configurable key size hash tables) ` - -:ref:`Table 27. Description of the bucket search pipeline stages (configurable key size hash tables) ` - -:ref:`Table 28. Lookup tables for match, match_many, match_pos ` - -:ref:`Table 29. Collapsed lookup tables for match, match_many and match_pos ` - -:ref:`Table 30. The main large data structures (arrays) used for 8-byte and 16-byte key size hash tables ` - -:ref:`Table 31. Field description for bucket array entry (8-byte and 16-byte key hash tables) ` - -:ref:`Table 32. Description of the bucket search pipeline stages (8-byte and 16-byte key hash tables) ` - -:ref:`Table 33. Next hop actions (reserved) ` - -:ref:`Table 34. User action examples `