xref: /dpdk/doc/guides/sample_app_ug/index.rst (revision 4a3ef59a10c89adf1040eb308939317fcbc06962)
1d0dff9baSBernard Iremonger..  BSD LICENSE
21443da3bSJohn McNamara    Copyright(c) 2010-2015 Intel Corporation. All rights reserved.
3d0dff9baSBernard Iremonger    All rights reserved.
4d0dff9baSBernard Iremonger
5d0dff9baSBernard Iremonger    Redistribution and use in source and binary forms, with or without
6d0dff9baSBernard Iremonger    modification, are permitted provided that the following conditions
7d0dff9baSBernard Iremonger    are met:
8d0dff9baSBernard Iremonger
9d0dff9baSBernard Iremonger    * Redistributions of source code must retain the above copyright
10d0dff9baSBernard Iremonger    notice, this list of conditions and the following disclaimer.
11d0dff9baSBernard Iremonger    * Redistributions in binary form must reproduce the above copyright
12d0dff9baSBernard Iremonger    notice, this list of conditions and the following disclaimer in
13d0dff9baSBernard Iremonger    the documentation and/or other materials provided with the
14d0dff9baSBernard Iremonger    distribution.
15d0dff9baSBernard Iremonger    * Neither the name of Intel Corporation nor the names of its
16d0dff9baSBernard Iremonger    contributors may be used to endorse or promote products derived
17d0dff9baSBernard Iremonger    from this software without specific prior written permission.
18d0dff9baSBernard Iremonger
19d0dff9baSBernard Iremonger    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20d0dff9baSBernard Iremonger    "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21d0dff9baSBernard Iremonger    LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
22d0dff9baSBernard Iremonger    A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
23d0dff9baSBernard Iremonger    OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
24d0dff9baSBernard Iremonger    SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
25d0dff9baSBernard Iremonger    LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
26d0dff9baSBernard Iremonger    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
27d0dff9baSBernard Iremonger    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
28d0dff9baSBernard Iremonger    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29d0dff9baSBernard Iremonger    OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
30d0dff9baSBernard Iremonger
318ccc9279SJohn McNamaraSample Applications User Guides
328ccc9279SJohn McNamara===============================
33d0dff9baSBernard Iremonger
34d0dff9baSBernard Iremonger.. toctree::
35d0dff9baSBernard Iremonger    :maxdepth: 2
36d0dff9baSBernard Iremonger    :numbered:
37d0dff9baSBernard Iremonger
38d0dff9baSBernard Iremonger    intro
397cacb056SHerakliusz Lipiec    compiling
40d0dff9baSBernard Iremonger    cmd_line
41bda68ab9SRemy Horton    ethtool
42d0dff9baSBernard Iremonger    exception_path
43d0dff9baSBernard Iremonger    hello_world
441443da3bSJohn McNamara    skeleton
450d8d3df6SJohn McNamara    rxtx_callbacks
46*4a3ef59aSOri Kam    flow_filtering
47d0dff9baSBernard Iremonger    ip_frag
48d0dff9baSBernard Iremonger    ipv4_multicast
49d0dff9baSBernard Iremonger    ip_reassembly
50d0dff9baSBernard Iremonger    kernel_nic_interface
51e64833f2SRemy Horton    keep_alive
52ba7b86b1SPablo de Lara    l2_forward_crypto
53ccefe752SPawel Wodkowski    l2_forward_job_stats
54d0dff9baSBernard Iremonger    l2_forward_real_virtual
55f6baccbcSWojciech Andralojc    l2_forward_cat
56d0dff9baSBernard Iremonger    l3_forward
57d0dff9baSBernard Iremonger    l3_forward_power_man
58d0dff9baSBernard Iremonger    l3_forward_access_ctrl
59d0dff9baSBernard Iremonger    l3_forward_virtual
60d0dff9baSBernard Iremonger    link_status_intr
61d0dff9baSBernard Iremonger    load_balancer
62ed2a80fdSPablo de Lara    server_node_efd
63cbdd3420SHarry van Haaren    service_cores
64d0dff9baSBernard Iremonger    multi_process
65d0dff9baSBernard Iremonger    qos_metering
66d0dff9baSBernard Iremonger    qos_scheduler
67d0dff9baSBernard Iremonger    quota_watermark
68d0dff9baSBernard Iremonger    timer
691b2038b0SSergio Gonzalez Monroy    packet_ordering
70d0dff9baSBernard Iremonger    vmdq_dcb_forwarding
71d0dff9baSBernard Iremonger    vhost
72db75c7afSChangpeng Liu    vhost_scsi
73d0dff9baSBernard Iremonger    netmap_compatibility
74f1e779ecSCristian Dumitrescu    ip_pipeline
75d0dff9baSBernard Iremonger    test_pipeline
761094ca96SHarry van Haaren    eventdev_pipeline_sw_pmd
7760643134SSiobhan Butler    dist_app
78c75f4e6aSPablo de Lara    vm_power_management
79181654b7SJijiang Liu    tep_termination
802d123257SDaniel Mrzyglod    ptpclient
814d1a771bSIan Betts    performance_thread
82d299106eSSergio Gonzalez Monroy    ipsec_secgw
83d0dff9baSBernard Iremonger
84d0dff9baSBernard Iremonger**Figures**
85d0dff9baSBernard Iremonger
864a22e6eeSJohn McNamara:numref:`figure_exception_path_example` :ref:`figure_exception_path_example`
87d0dff9baSBernard Iremonger
884a22e6eeSJohn McNamara:numref:`figure_kernel_nic` :ref:`figure_kernel_nic`
89d0dff9baSBernard Iremonger
904a22e6eeSJohn McNamara:numref:`figure_l2_fwd_benchmark_setup_jobstats` :ref:`figure_l2_fwd_benchmark_setup_jobstats`
91d0dff9baSBernard Iremonger
924a22e6eeSJohn McNamara:numref:`figure_l2_fwd_virtenv_benchmark_setup_jobstats` :ref:`figure_l2_fwd_virtenv_benchmark_setup_jobstats`
93d0dff9baSBernard Iremonger
944a22e6eeSJohn McNamara:numref:`figure_l2_fwd_benchmark_setup` :ref:`figure_l2_fwd_benchmark_setup`
95d0dff9baSBernard Iremonger
964a22e6eeSJohn McNamara:numref:`figure_l2_fwd_virtenv_benchmark_setup` :ref:`figure_l2_fwd_virtenv_benchmark_setup`
97d0dff9baSBernard Iremonger
98ba7b86b1SPablo de Lara:numref:`figure_l2_fwd_encrypt_flow` :ref:`figure_l2_fwd_encrypt_flow`
99ba7b86b1SPablo de Lara
1004a22e6eeSJohn McNamara:numref:`figure_ipv4_acl_rule` :ref:`figure_ipv4_acl_rule`
101d0dff9baSBernard Iremonger
1024a22e6eeSJohn McNamara:numref:`figure_example_rules` :ref:`figure_example_rules`
103d0dff9baSBernard Iremonger
1044a22e6eeSJohn McNamara:numref:`figure_load_bal_app_arch` :ref:`figure_load_bal_app_arch`
105d0dff9baSBernard Iremonger
1064a22e6eeSJohn McNamara:numref:`figure_sym_multi_proc_app` :ref:`figure_sym_multi_proc_app`
107d0dff9baSBernard Iremonger
1084a22e6eeSJohn McNamara:numref:`figure_client_svr_sym_multi_proc_app` :ref:`figure_client_svr_sym_multi_proc_app`
109d0dff9baSBernard Iremonger
1104a22e6eeSJohn McNamara:numref:`figure_master_slave_proc` :ref:`figure_master_slave_proc`
111d0dff9baSBernard Iremonger
1124a22e6eeSJohn McNamara:numref:`figure_slave_proc_recov` :ref:`figure_slave_proc_recov`
113d0dff9baSBernard Iremonger
1144a22e6eeSJohn McNamara:numref:`figure_qos_sched_app_arch` :ref:`figure_qos_sched_app_arch`
115d0dff9baSBernard Iremonger
1164a22e6eeSJohn McNamara:numref:`figure_pipeline_overview` :ref:`figure_pipeline_overview`
117d0dff9baSBernard Iremonger
1184a22e6eeSJohn McNamara:numref:`figure_ring_pipeline_perf_setup` :ref:`figure_ring_pipeline_perf_setup`
119d0dff9baSBernard Iremonger
1204a22e6eeSJohn McNamara:numref:`figure_threads_pipelines` :ref:`figure_threads_pipelines`
121d0dff9baSBernard Iremonger
1224a22e6eeSJohn McNamara:numref:`figure_vmdq_dcb_example` :ref:`figure_vmdq_dcb_example`
123d0dff9baSBernard Iremonger
1244a22e6eeSJohn McNamara:numref:`figure_test_pipeline_app` :ref:`figure_test_pipeline_app`
125c75f4e6aSPablo de Lara
1264a22e6eeSJohn McNamara:numref:`figure_dist_perf` :ref:`figure_dist_perf`
1274a22e6eeSJohn McNamara
1284a22e6eeSJohn McNamara:numref:`figure_dist_app` :ref:`figure_dist_app`
1294a22e6eeSJohn McNamara
1304a22e6eeSJohn McNamara:numref:`figure_vm_power_mgr_highlevel` :ref:`figure_vm_power_mgr_highlevel`
1314a22e6eeSJohn McNamara
1324a22e6eeSJohn McNamara:numref:`figure_vm_power_mgr_vm_request_seq` :ref:`figure_vm_power_mgr_vm_request_seq`
133181654b7SJijiang Liu:numref:`figure_overlay_networking` :ref:`figure_overlay_networking`
134181654b7SJijiang Liu:numref:`figure_tep_termination_arch` :ref:`figure_tep_termination_arch`
135c75f4e6aSPablo de Lara
1362d123257SDaniel Mrzyglod:numref:`figure_ptpclient_highlevel` :ref:`figure_ptpclient_highlevel`
1372d123257SDaniel Mrzyglod
138ed2a80fdSPablo de Lara:numref:`figure_efd_sample_app_overview` :ref:`figure_efd_sample_app_overview`
139ed2a80fdSPablo de Lara
140d0dff9baSBernard Iremonger**Tables**
141d0dff9baSBernard Iremonger
1428c9a3374SJohn McNamara:numref:`table_qos_metering_1` :ref:`table_qos_metering_1`
143d0dff9baSBernard Iremonger
1448c9a3374SJohn McNamara:numref:`table_qos_scheduler_1` :ref:`table_qos_scheduler_1`
145d0dff9baSBernard Iremonger
1468c9a3374SJohn McNamara:numref:`table_test_pipeline_1` :ref:`table_test_pipeline_1`
147