diff options
author | Matias Elo <matias.elo@nokia.com> | 2023-12-19 12:16:20 +0200 |
---|---|---|
committer | Matias Elo <matias.elo@nokia.com> | 2023-12-22 11:03:42 +0200 |
commit | e6aa73088da2d937911888b80749e26fdeee0630 (patch) | |
tree | 27c2afe7114e9ae6e7f14e0d52d9825938d0961a | |
parent | c0b7fb84bdfc57b7587c2299c01efb1c3a1933a9 (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-- | CHANGELOG | 108 | ||||
-rw-r--r-- | configure.ac | 6 |
2 files changed, 111 insertions, 3 deletions
@@ -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], |