numam-dpdk/doc/guides/prog_guide/source_org.rst
Ciara Power 3cc6ecfdfe build: remove makefiles
A decision was made [1] to no longer support Make in DPDK, this patch
removes all Makefiles that do not make use of pkg-config, along with
the mk directory previously used by make.

[1] https://mails.dpdk.org/archives/dev/2020-April/162839.html

Signed-off-by: Ciara Power <ciara.power@intel.com>
Reviewed-by: Ruifeng Wang <ruifeng.wang@arm.com>
Signed-off-by: Thomas Monjalon <thomas@monjalon.net>
2020-09-08 00:09:50 +02:00

45 lines
1.6 KiB
ReStructuredText

.. SPDX-License-Identifier: BSD-3-Clause
Copyright(c) 2010-2014 Intel Corporation.
**Part 2: Development Environment**
Source Organization
===================
This section describes the organization of sources in the DPDK framework.
Libraries
---------
Libraries are located in subdirectories of ``dpdk/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.
Drivers
-------
Drivers are special libraries which provide poll-mode driver implementations for
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.
.. note::
Several of the ``driver/net`` directories contain a ``base``
sub-directory. The ``base`` directory generally contains code the shouldn't
be modified directly by the user. Any enhancements should be done via the
``X_osdep.c`` and/or ``X_osdep.h`` files in that directory. Refer to the
local README in the base directories for driver specific instructions.
Applications
------------
Applications are source files that contain a ``main()`` function.
They are located in the ``dpdk/app`` and ``dpdk/examples`` directories.
The app directory contains sample applications that are used to test DPDK (such as autotests)
or the Poll Mode Drivers (test-pmd).
The examples directory contains :doc:`Sample applications<../sample_app_ug/index>` that show how libraries can be used.