From patchwork Thu Jan 17 09:05:51 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: David Marchand X-Patchwork-Id: 49901 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 4F0612C16; Thu, 17 Jan 2019 10:06:00 +0100 (CET) Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by dpdk.org (Postfix) with ESMTP id 5F5A82C15 for ; Thu, 17 Jan 2019 10:05:58 +0100 (CET) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com [10.5.11.15]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 2420A2883B; Thu, 17 Jan 2019 09:05:57 +0000 (UTC) Received: from dmarchan.remote.csb (ovpn-117-32.ams2.redhat.com [10.36.117.32]) by smtp.corp.redhat.com (Postfix) with ESMTP id A71F25D6A9; Thu, 17 Jan 2019 09:05:55 +0000 (UTC) From: David Marchand To: dev@dpdk.org Cc: thomas@monjalon.net, john.mcnamara@intel.com, ferruh.yigit@intel.com Date: Thu, 17 Jan 2019 10:05:51 +0100 Message-Id: <1547715951-11128-1-git-send-email-david.marchand@redhat.com> X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.28]); Thu, 17 Jan 2019 09:05:57 +0000 (UTC) Subject: [dpdk-dev] [PATCH] doc: remove file listings X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" No need to keep those file listings, they are very likely to become outdated. Signed-off-by: David Marchand Reviewed-by: Ferruh Yigit --- doc/guides/prog_guide/dev_kit_build_system.rst | 43 -------------- doc/guides/prog_guide/source_org.rst | 79 +------------------------- 2 files changed, 2 insertions(+), 120 deletions(-) diff --git a/doc/guides/prog_guide/dev_kit_build_system.rst b/doc/guides/prog_guide/dev_kit_build_system.rst index da83a31..855b5da 100644 --- a/doc/guides/prog_guide/dev_kit_build_system.rst +++ b/doc/guides/prog_guide/dev_kit_build_system.rst @@ -52,49 +52,6 @@ which is equivalent to: make O=my_sdk_build_dir -The content of the my_sdk_build_dir is then: - -:: - - -- .config # used configuration - - -- Makefile # wrapper that calls head Makefile - # with $PWD as build directory - - - -- build #All temporary files used during build - +--app # process, including . o, .d, and .cmd files. - | +-- test # For libraries, we have the .a file. - | +-- test.o # For applications, we have the elf file. - | `-- ... - +-- lib - +-- librte_eal - | `-- ... - +-- librte_mempool - | +-- mempool-file1.o - | +-- .mempool-file1.o.cmd - | +-- .mempool-file1.o.d - | +-- mempool-file2.o - | +-- .mempool-file2.o.cmd - | +-- .mempool-file2.o.d - | `-- mempool.a - `-- ... - - -- include # All include files installed by libraries - +-- librte_mempool.h # and applications are located in this - +-- rte_eal.h # directory. The installed files can depend - +-- rte_spinlock.h # on configuration if needed (environment, - +-- rte_atomic.h # architecture, ..) - `-- \*.h ... - - -- lib # all compiled libraries are copied in this - +-- librte_eal.a # directory - +-- librte_mempool.a - `-- \*.a ... - - -- app # All compiled applications are installed - + --test # here. It includes the binary in elf format - Refer to :ref:`Development Kit Root Makefile Help ` for details about make commands that can be used from the root of DPDK. diff --git a/doc/guides/prog_guide/source_org.rst b/doc/guides/prog_guide/source_org.rst index cee4ce6..1fb7abc 100644 --- a/doc/guides/prog_guide/source_org.rst +++ b/doc/guides/prog_guide/source_org.rst @@ -34,27 +34,6 @@ Libraries are located in subdirectories of ``$(RTE_SDK)/lib``. By convention a library refers to any code that provides an API to an application. Typically, it generates an archive file (``.a``), but a kernel module would also go in the same directory. -The lib directory contains:: - - lib - +-- librte_cmdline # Command line interface helper - +-- librte_distributor # Packet distributor - +-- librte_eal # Environment abstraction layer - +-- librte_ethdev # Generic interface to poll mode driver - +-- librte_hash # Hash library - +-- librte_ip_frag # IP fragmentation library - +-- librte_kni # Kernel NIC interface - +-- librte_kvargs # Argument parsing library - +-- librte_lpm # Longest prefix match library - +-- librte_mbuf # Packet buffer manipulation - +-- librte_mempool # Memory pool manager (fixed sized objects) - +-- librte_meter # QoS metering library - +-- librte_net # Various IP-related headers - +-- librte_power # Power management library - +-- librte_ring # Software rings (act as lockless FIFOs) - +-- librte_sched # QoS scheduler and dropper library - +-- librte_timer # Timer library - Drivers ------- @@ -63,25 +42,6 @@ devices: either hardware devices or pseudo/virtual devices. They are contained in the *drivers* subdirectory, classified by type, and each compiles to a library with the format ``librte_pmd_X.a`` where ``X`` is the driver name. -The drivers directory has a *net* subdirectory which contains:: - - drivers/net - +-- af_packet # Poll mode driver based on Linux af_packet - +-- bonding # Bonding poll mode driver - +-- cxgbe # Chelsio Terminator 10GbE/40GbE poll mode driver - +-- e1000 # 1GbE poll mode drivers (igb and em) - +-- enic # Cisco VIC Ethernet NIC Poll-mode Driver - +-- fm10k # Host interface PMD driver for FM10000 Series - +-- i40e # 40GbE poll mode driver - +-- ixgbe # 10GbE poll mode driver - +-- mlx4 # Mellanox ConnectX-3 poll mode driver - +-- null # NULL poll mode driver for testing - +-- pcap # PCAP poll mode driver - +-- ring # Ring poll mode driver - +-- szedata2 # SZEDATA2 poll mode driver - +-- virtio # Virtio poll mode driver - +-- vmxnet3 # VMXNET3 poll mode driver - .. note:: Several of the ``driver/net`` directories contain a ``base`` @@ -98,41 +58,6 @@ Applications are source files that contain a ``main()`` function. They are located in the ``$(RTE_SDK)/app`` and ``$(RTE_SDK)/examples`` directories. The app directory contains sample applications that are used to test DPDK (such as autotests) -or the Poll Mode Drivers (test-pmd):: - - app - +-- chkincs # Test program to check include dependencies - +-- cmdline_test # Test the commandline library - +-- test # Autotests to validate DPDK features - +-- test-acl # Test the ACL library - +-- test-pipeline # Test the IP Pipeline framework - +-- test-pmd # Test and benchmark poll mode drivers - -The examples directory contains sample applications that show how libraries can be used:: - - examples - +-- cmdline # Example of using the cmdline library - +-- exception_path # Sending packets to and from Linux TAP device - +-- helloworld # Basic Hello World example - +-- ip_reassembly # Example showing IP reassembly - +-- ip_fragmentation # Example showing IPv4 fragmentation - +-- ipv4_multicast # Example showing IPv4 multicast - +-- kni # Kernel NIC Interface (KNI) example - +-- l2fwd # L2 forwarding with and without SR-IOV - +-- l3fwd # L3 forwarding example - +-- l3fwd-power # L3 forwarding example with power management - +-- l3fwd-vf # L3 forwarding example with SR-IOV - +-- link_status_interrupt # Link status change interrupt example - +-- load_balancer # Load balancing across multiple cores/sockets - +-- multi_process # Example apps using multiple DPDK processes - +-- qos_meter # QoS metering example - +-- qos_sched # QoS scheduler and dropper example - +-- timer # Example of using librte_timer library - +-- vmdq_dcb # Example of VMDQ and DCB receiving - +-- vmdq # Example of VMDQ receiving - +-- vhost # Example of userspace vhost and switch - -.. note:: +or the Poll Mode Drivers (test-pmd). - The actual examples directory may contain additional sample applications to those shown above. - Check the latest DPDK source files for details. +The examples directory contains sample applications that show how libraries can be used.