DPDK patches and discussions
 help / color / mirror / Atom feed
From: David Marchand <david.marchand@redhat.com>
To: dev@dpdk.org
Cc: thomas@monjalon.net, john.mcnamara@intel.com, ferruh.yigit@intel.com
Subject: [dpdk-dev] [PATCH] doc: remove file listings
Date: Thu, 17 Jan 2019 10:05:51 +0100	[thread overview]
Message-ID: <1547715951-11128-1-git-send-email-david.marchand@redhat.com> (raw)

No need to keep those file listings, they are very likely to become
outdated.

Signed-off-by: David Marchand <david.marchand@redhat.com>
---
 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 <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.
-- 
1.8.3.1

             reply	other threads:[~2019-01-17  9:05 UTC|newest]

Thread overview: 13+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-01-17  9:05 David Marchand [this message]
2019-01-17  9:16 ` Thomas Monjalon
2019-01-17 15:42   ` Kovacevic, Marko
2019-01-17 16:08     ` Thomas Monjalon
2019-01-17 16:53       ` Kovacevic, Marko
2019-01-17 17:01         ` Thomas Monjalon
2019-01-18  9:29           ` Kovacevic, Marko
2019-01-18  9:33             ` Thomas Monjalon
2019-01-18 10:15               ` David Marchand
2019-01-17 14:36 ` Ferruh Yigit
2019-01-18 15:31 ` [dpdk-dev] [PATCH v2] " David Marchand
2019-01-18 15:35   ` Kovacevic, Marko
2019-01-20 12:10     ` Thomas Monjalon

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=1547715951-11128-1-git-send-email-david.marchand@redhat.com \
    --to=david.marchand@redhat.com \
    --cc=dev@dpdk.org \
    --cc=ferruh.yigit@intel.com \
    --cc=john.mcnamara@intel.com \
    --cc=thomas@monjalon.net \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).