language: c
cache:
ccache: true
- directories:
- - libabigail
- - reference
dist: bionic
- *required_packages
- [gcc-aarch64-linux-gnu, libc6-dev-arm64-cross, pkg-config-aarch64-linux-gnu]
-_libabigail_build_packages: &libabigail_build_packages
- - [autoconf, automake, libtool, pkg-config, libxml2-dev, libdw-dev]
-
_build_32b_packages: &build_32b_packages
- *required_packages
- [gcc-multilib]
before_install: ./.ci/${TRAVIS_OS_NAME}-setup.sh
script: ./.ci/${TRAVIS_OS_NAME}-build.sh
-env:
- global:
- - REF_GIT_TAG=v20.05
-
jobs:
include:
# x86_64 gcc jobs
packages:
- *required_packages
- *doc_packages
- - env: DEF_LIB="shared" ABI_CHECKS=1
- arch: amd64
- compiler: gcc
- addons:
- apt:
- packages:
- - *required_packages
- - *libabigail_build_packages
# x86_64 clang jobs
- env: DEF_LIB="static"
arch: amd64
packages:
- *required_packages
- *doc_packages
- - env: DEF_LIB="shared" ABI_CHECKS=1
- arch: arm64
- compiler: gcc
- addons:
- apt:
- packages:
- - *required_packages
- - *libabigail_build_packages
# aarch64 clang jobs
- env: DEF_LIB="static"
arch: arm64
symbol_version = INTERNAL
[suppress_variable]
symbol_version = INTERNAL
-
-; Ignore ABI 20.0.1 replaced with ABI 21
-[suppress_function]
- symbol_version = DPDK_20.0.1
-[suppress_variable]
- symbol_version = DPDK_20.0.1
-
-; Explicit ignore for driver-only ABI
-[suppress_type]
- name = rte_cryptodev_ops
-; Ignore this enum update as it is part of an experimental API
-[suppress_type]
- type_kind = enum
- name = rte_crypto_asym_xform_type
- changed_enumerators = RTE_CRYPTO_ASYM_XFORM_TYPE_LIST_END
-; Ignore updates of ring prod/cons
-[suppress_type]
- type_kind = struct
- name = rte_ring
-[suppress_type]
- type_kind = struct
- name = rte_event_ring
-; Ignore ethdev event enum update because new event cannot be
-; received if not registered
-[suppress_type]
- type_kind = enum
- name = rte_eth_event_type
- changed_enumerators = RTE_ETH_EVENT_MAX
-; Ignore this enum update as new flags remain unknown to applications
-[suppress_type]
- type_kind = enum
- name = rte_cpu_flag_t
- changed_enumerators = RTE_CPUFLAG_NUMFLAGS
-; Ignore Cryptodev AEAD xform enum and AEAD xform strings change
-; due to addition of Chacha20-Poly1305
-[suppress_type]
- type_kind = enum
- name = rte_crypto_aead_algorithm
- changed_enumerators = RTE_CRYPTO_AEAD_LIST_END
-[suppress_variable]
- name = rte_crypto_aead_algorithm_strings
-; Ignore updates of epoll event
-[suppress_type]
- type_kind = struct
- name = rte_epoll_event
-; Ignore updates of rte_mbuf_ext_shared_info refcnt_atomic
-[suppress_type]
- name = rte_mbuf_ext_shared_info
- has_data_member_inserted_between = {offset_of(refcnt_atomic), offset_of(refcnt_atomic)}
-
-;;;;;;;;;;;;;;;;;;;;;;
-; Temporary exceptions till DPDK 20.11
-;;;;;;;;;;;;;;;;;;;;;;
-; Ignore moving OCTEONTX2 stable functions to INTERNAL
-[suppress_file]
- file_name_regexp = ^librte_common_octeontx2\.
-[suppress_file]
- file_name_regexp = ^librte_mempool_octeontx2\.
-; Ignore moving mlx5 stable functions to INTERNAL
-[suppress_file]
- file_name_regexp = ^librte_common_mlx5\.
-; Ignore moving DPAAx stable functions to INTERNAL
-[suppress_file]
- file_name_regexp = ^librte_common_dpaax\.
-[suppress_file]
- file_name_regexp = ^librte_bus_fslmc\.
-[suppress_file]
- file_name_regexp = ^librte_bus_dpaa\.
-[suppress_variable]
- name = rte_dpaa_bpid_info
-[suppress_variable]
- name = rte_dpaa_memsegs
-[suppress_variable]
- name = rte_dpaa2_bpid_info
-[suppress_function]
- name = rte_dpaa2_mbuf_alloc_bulk
-[suppress_function]
- name_regexp = ^dpaa2?_.*tach$
-; Ignore soname changes for experimental libraries
-[suppress_file]
- file_name_regexp = ^librte_bbdev\.
-[suppress_file]
- file_name_regexp = ^librte_bpf\.
-[suppress_file]
- file_name_regexp = ^librte_compressdev\.
-[suppress_file]
- file_name_regexp = ^librte_fib\.
-[suppress_file]
- file_name_regexp = ^librte_flow_classify\.
-[suppress_file]
- file_name_regexp = ^librte_graph\.
-[suppress_file]
- file_name_regexp = ^librte_ipsec\.
-[suppress_file]
- file_name_regexp = ^librte_node\.
-[suppress_file]
- file_name_regexp = ^librte_rcu\.
-[suppress_file]
- file_name_regexp = ^librte_rib\.
-[suppress_file]
- file_name_regexp = ^librte_telemetry\.
-[suppress_file]
- file_name_regexp = ^librte_stack\.
--- /dev/null
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright 2020 The DPDK contributors
+
+.. include:: <isonum.txt>
+
+DPDK Release 20.11
+==================
+
+.. **Read this first.**
+
+ The text in the sections below explains how to update the release notes.
+
+ Use proper spelling, capitalization and punctuation in all sections.
+
+ Variable and config names should be quoted as fixed width text:
+ ``LIKE_THIS``.
+
+ Build the docs and view the output file to ensure the changes are correct::
+
+ make doc-guides-html
+ xdg-open build/doc/html/guides/rel_notes/release_20_11.html
+
+
+New Features
+------------
+
+.. This section should contain new features added in this release.
+ Sample format:
+
+ * **Add a title in the past tense with a full stop.**
+
+ Add a short 1-2 sentence description in the past tense.
+ The description should be enough to allow someone scanning
+ the release notes to understand the new feature.
+
+ If the feature adds a lot of sub-features you can use a bullet list
+ like this:
+
+ * Added feature foo to do something.
+ * Enhanced feature bar to do something else.
+
+ Refer to the previous release notes for examples.
+
+ Suggested order in release notes items:
+ * Core libs (EAL, mempool, ring, mbuf, buses)
+ * Device abstraction libs and PMDs
+ - ethdev (lib, PMDs)
+ - cryptodev (lib, PMDs)
+ - eventdev (lib, PMDs)
+ - etc
+ * Other libs
+ * Apps, Examples, Tools (if significant)
+
+ This section is a comment. Do not overwrite or remove it.
+ Also, make sure to start the actual text at the margin.
+ =======================================================
+
+
+Removed Items
+-------------
+
+.. This section should contain removed items in this release. Sample format:
+
+ * Add a short 1-2 sentence description of the removed item
+ in the past tense.
+
+ This section is a comment. Do not overwrite or remove it.
+ Also, make sure to start the actual text at the margin.
+ =======================================================
+
+
+API Changes
+-----------
+
+.. This section should contain API changes. Sample format:
+
+ * sample: Add a short 1-2 sentence description of the API change
+ which was announced in the previous releases and made in this release.
+ Start with a scope label like "ethdev:".
+ Use fixed width quotes for ``function_names`` or ``struct_names``.
+ Use the past tense.
+
+ This section is a comment. Do not overwrite or remove it.
+ Also, make sure to start the actual text at the margin.
+ =======================================================
+
+
+ABI Changes
+-----------
+
+.. This section should contain ABI changes. Sample format:
+
+ * sample: Add a short 1-2 sentence description of the ABI change
+ which was announced in the previous releases and made in this release.
+ Start with a scope label like "ethdev:".
+ Use fixed width quotes for ``function_names`` or ``struct_names``.
+ Use the past tense.
+
+ This section is a comment. Do not overwrite or remove it.
+ Also, make sure to start the actual text at the margin.
+ =======================================================
+
+
+Known Issues
+------------
+
+.. This section should contain new known issues in this release. Sample format:
+
+ * **Add title in present tense with full stop.**
+
+ Add a short 1-2 sentence description of the known issue
+ in the present tense. Add information on any known workarounds.
+
+ This section is a comment. Do not overwrite or remove it.
+ Also, make sure to start the actual text at the margin.
+ =======================================================
+
+
+Tested Platforms
+----------------
+
+.. This section should contain a list of platforms that were tested
+ with this release.
+
+ The format is:
+
+ * <vendor> platform with <vendor> <type of devices> combinations
+
+ * List of CPU
+ * List of OS
+ * List of devices
+ * Other relevant details...
+
+ This section is a comment. Do not overwrite or remove it.
+ Also, make sure to start the actual text at the margin.
+ =======================================================