aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatias Elo <matias.elo@nokia.com>2023-12-19 12:16:20 +0200
committerMatias Elo <matias.elo@nokia.com>2023-12-22 11:03:42 +0200
commite6aa73088da2d937911888b80749e26fdeee0630 (patch)
tree27c2afe7114e9ae6e7f14e0d52d9825938d0961a
parentc0b7fb84bdfc57b7587c2299c01efb1c3a1933a9 (diff)
api: increment ODP API version to 1.43.0v1.43.0.0
Increment API version number to reflect the following changes: Backward incompatible: - cls: add new odp_cls_capability_t.max_pmr and odp_cls_capability_t.max_pmr_per_cos capabilities - cls: rename odp_cls_capability_t.max_pmr_terms field to odp_cls_capability_t.max_terms_per_pmr - time: change local/global time specification to allow timestamp values to start from an implementation defined value - timer: deprecate odp_timer_set_t type - timer: deprecate odp_timer_pool_start() function - timer: deprecate odp_timeout_fresh() function - timer: change odp_timer_free() specification to remove the possibility to free a timer that is running - timer: change odp_timer_pool_create() specification to state that timer pool handles must not be used by other APIs before being started Backward compatible: - event: add odp_event_pool() function - hints: fix a type conversion issue in odp_unlikely() implementation - packet: clarify that ODP_PACKET_FREE_CTRL_DONT_FREE option does not affect direct packet free calls - packet: clarify that packet IO time is specific to the packet IO interface - pool: clarify that disabled/unused per thread statistics counters will not necessarily be zeroed by odp_pool_stats() - sched: clarify event ordering in ordered scheduling contexts - thread: add new functions odp_thread_control_count_max() and odp_thread_worker_count_max() - thread: add new functions odp_thread_control_count() and odp_thread_worker_count() - time: add odp_time_add_ns() function - time: add odp_time_startup() function - time: clarify odp_time_sum() specification by adding a notification that resulting timestamp may wrap around - timer: add odp_timer_pool_start_multi() function - timer: clarify that timer ticks and related nanosecond values are specific to a timer pool and may not start from zero Removed deprecated APIs: - cls: odp_cls_drop_t enum - cls: odp_cos_drop_set() function - cls: odp_cos_drop() function - cls: odp_cos_with_l2_priority() function - cls: odp_cos_with_l3_qos() function - crypto: ODP_CRYPTO_SES_CREATE_ERR_NONE, ODP_CRYPTO_SES_CREATE_ERR_ENOMEM, ODP_CRYPTO_SES_CREATE_ERR_INV_CIPHER, and ODP_CRYPTO_SES_CREATE_ERR_INV_AUTH defines - crypto: odp_crypto_alg_err_t.ODP_CRYPTO_ALG_ERR_KEY_SIZE and odp_crypto_alg_err_t.ODP_CRYPTO_ALG_ERR_IV_INVALID enums - crypto: odp_crypto_hw_err_t enum - crypto: odp_crypto_packet_result_t.ok field - sched: ODP_SCHED_PRIO_HIGHEST, ODP_SCHED_PRIO_NORMAL, ODP_SCHED_PRIO_LOWEST, and ODP_SCHED_PRIO_DEFAULT defines - timer: ODP_CLOCK_CPU and ODP_CLOCK_EXT defines - timer: ODP_TIMER_TOOEARLY, ODP_TIMER_TOOLATE and ODP_TIMER_NOEVENT defines - timer: odp_timer_set_abs() function - timer: odp_timer_set_rel() function Helper library (1.5.0): Backward incompatible: - threads: remove deprecated odph_odpthread_t and odph_odpthread_params_t types - threads: remove deprecated odph_thread_param_t.instance field - threads: remove deprecated odph_odpthreads_create() and odph_odpthreads_join() functions Signed-off-by: Matias Elo <matias.elo@nokia.com> Reviewed-by: Petri Savolainen <petri.savolainen@nokia.com>
-rw-r--r--CHANGELOG108
-rw-r--r--configure.ac6
2 files changed, 111 insertions, 3 deletions
diff --git a/CHANGELOG b/CHANGELOG
index 4cb2a57cb..dd3d04048 100644
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,3 +1,111 @@
+== OpenDataPlane (1.43.0.0)
+
+=== Backward incompatible API changes
+==== Classifier
+* Add new `odp_cls_capability_t.max_pmr` and
+`odp_cls_capability_t.max_pmr_per_cos` packet matching rule capabilities.
+* Rename `odp_cls_capability_t.max_pmr_terms` field to
+`odp_cls_capability_t.max_terms_per_pmr`.
+
+==== Time
+* Change local/global time specification to allow timestamp values to start from
+an implementation defined value, instead of always starting from zero.
+
+==== Timer
+* Deprecate `odp_timer_set_t` type. Use `odp_timer_retval_t` instead.
+* Deprecate `odp_timer_pool_start()` function in comments. Will be properly
+deprecated in an upcoming release. Use `odp_timer_pool_start_multi()` instead.
+* Deprecate `odp_timeout_fresh()` function.
+* Change `odp_timer_free()` specification to remove the possibility to free a
+timer that is running.
+* Change `odp_timer_pool_create()` specification to state that timer pool
+handles must not be used by other APIs, except `odp_timer_pool_to_u64()`,
+ before being started.
+
+=== Backward compatible API changes
+==== Event
+* Add `odp_event_pool()` function, which returns a handle to the pool where the
+event was allocated from.
+
+==== Hints
+* Fix a type conversion issue in `odp_unlikely()` implementation.
+
+==== Packet
+* Clarify that `ODP_PACKET_FREE_CTRL_DONT_FREE` option does not affect direct
+packet free calls.
+* Clarify that packet IO time is specific to the packet IO interface.
+
+==== Pool
+* Clarify that disabled/unused per thread statistics counters will not
+necessarily be zeroed by `odp_pool_stats()`.
+
+==== Scheduler
+* Clarify event ordering in ordered scheduling contexts.
+
+==== Thread
+* Add new functions `odp_thread_control_count_max()` and
+`odp_thread_worker_count_max()` for reading the maximum number of control and
+worker threads.
+* Add new functions `odp_thread_control_count()` and `odp_thread_worker_count()`
+for reading the current number of control and worker threads.
+
+==== Time
+* Add `odp_time_add_ns()` function for adding nanoseconds into a time value.
+* Add `odp_time_startup()` function for requesting ODP instance startup time.
+* Clarify `odp_time_sum()` specification by adding a notification that resulting
+timestamp may wrap around if large timestamp values are summed up.
+
+==== Timer
+* Add `odp_timer_pool_start_multi()` function for starting timer pools, which
+takes the to-be-started pool handles as arguments.
+* Clarify that timer ticks and related nanosecond values are specific to a timer
+pool. Also, state explicitly that those may not start from zero.
+
+=== Remove deprecated APIs
+==== Classifier
+* Remove deprecated `odp_cls_drop_t` enum.
+* Remove deprecated `odp_cos_drop_set()` function.
+* Remove deprecated `odp_cos_drop()` function.
+* Remove deprecated `odp_cos_with_l2_priority()` function.
+* Remove deprecated `odp_cos_with_l3_qos()` function.
+
+==== Crypto
+* Remove deprecated `ODP_CRYPTO_SES_CREATE_ERR_NONE`,
+`ODP_CRYPTO_SES_CREATE_ERR_ENOMEM`, `ODP_CRYPTO_SES_CREATE_ERR_INV_CIPHER`, and
+`ODP_CRYPTO_SES_CREATE_ERR_INV_AUTH` defines.
+* Remove deprecated `odp_crypto_alg_err_t.ODP_CRYPTO_ALG_ERR_KEY_SIZE` and
+`odp_crypto_alg_err_t.ODP_CRYPTO_ALG_ERR_IV_INVALID` enums.
+* Remove deprecated `odp_crypto_hw_err_t` enum.
+* Remove deprecated `odp_crypto_packet_result_t.ok` field.
+
+==== Scheduler
+* Remove deprecated `ODP_SCHED_PRIO_HIGHEST`, `ODP_SCHED_PRIO_NORMAL`,
+`ODP_SCHED_PRIO_LOWEST`, and `ODP_SCHED_PRIO_DEFAULT` defines.
+
+==== Timer
+* Remove deprecated `ODP_CLOCK_CPU` and `ODP_CLOCK_EXT` defines.
+* Remove deprecated `ODP_TIMER_TOOEARLY`, `ODP_TIMER_TOOLATE` and
+`ODP_TIMER_NOEVENT` defines.
+* Remove deprecated `odp_timer_set_abs()` function.
+* Remove deprecated `odp_timer_set_rel()` function.
+
+=== Helper (1.5.0)
+==== Backward incompatible changes
+* Remove deprecated `odph_odpthread_t` and `odph_odpthread_params_t` types.
+* Remove deprecated `odph_thread_param_t.instance` field.
+* Remove deprecated `odph_odpthreads_create()` and `odph_odpthreads_join()`
+functions.
+
+=== Implementation
+==== Ticketlock
+* Add WFE based aarch64 ticketlock implementation (`--enable-wfe-locks`) for
+power saving.
+
+=== Performance Tests
+==== dma_perf
+* Add option for using software memory copy in addition to DMA transfers.
+* Add options for using sparse packets and memory as the transfer segment type.
+
== OpenDataPlane (1.42.1.0)
=== Backward compatible API changes
diff --git a/configure.ac b/configure.ac
index 18b3861d9..3184b85d2 100644
--- a/configure.ac
+++ b/configure.ac
@@ -3,8 +3,8 @@ AC_PREREQ([2.5])
# ODP API version
##########################################################################
m4_define([odp_version_generation], [1])
-m4_define([odp_version_major], [42])
-m4_define([odp_version_minor], [1])
+m4_define([odp_version_major], [43])
+m4_define([odp_version_minor], [0])
m4_define([odp_version_patch], [0])
m4_define([odp_version_api],
@@ -27,7 +27,7 @@ AC_SUBST(ODP_VERSION_API)
# Helper library version
##########################################################################
m4_define([odph_version_generation], [1])
-m4_define([odph_version_major], [4])
+m4_define([odph_version_major], [5])
m4_define([odph_version_minor], [0])
m4_define([odph_version],