Skip to content

Commit 14915c2

Browse files
committed
api: increment ODP API version to 1.42.1
Increment API version number to reflect the following changes: Backward compatible: - cls: add odp_cls_pmr_create_multi() function - cls: add odp_cls_pmr_destroy_multi() function - cls: add odp_cls_cos_create_multi() function - cls: add odp_cos_destroy_multi() function - crypto: clarify packet ordering of async crypto ops - crypto: add null_crypto crypto op flag for skipping crypto - crypto: allow both basic and out-of-place ops in one session - pktio: add ODP_PKTIO_MAX_INDEX define - queue: add odp_queue_create_multi() function - queue: add odp_queue_destroy_multi() function - queue: clarify odp_queue_param_t default value specification - system: add new ARMv8 and v9 enumerations - timer: clean up odp_timer_pool_param_t.num_timers description - timer: add odp_timeout_alloc_multi() function - timer: add odp_timeout_free_multi() function Helper library (1.4.0): Backward incompatible: - protocols: rename ODP_GTP_HLEN define to ODPH_GTP_HLEN - protocols: rename ODP_IGMP_HLEN define to ODPH_IGMP_HLEN - protocols: remove unused ICMP defines and add missing ODPH_ prefix to the remaining defines Backward compatible: - macros: add ODPH_MIN() and ODPH_MAX() helper macros - macros: add ODPH_ARRAY_SIZE() helper macro - macros: add ODPH_ABS() helper macro Signed-off-by: Matias Elo <matias.elo@nokia.com> Reviewed-by: Petri Savolainen <petri.savolainen@nokia.com>
1 parent 303fb45 commit 14915c2

File tree

2 files changed

+104
-2
lines changed

2 files changed

+104
-2
lines changed

CHANGELOG

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,105 @@
1+
== OpenDataPlane (1.42.1.0)
2+
3+
=== Backward compatible API changes
4+
==== Classifier
5+
* Add new `odp_cls_pmr_create_multi()` function for creating multiple packet
6+
matching rules with a single call.
7+
* Add new `odp_cls_pmr_destroy_multi()` function for destroying multiple PMRs
8+
with a single call.
9+
* Add new `odp_cls_cos_create_multi()` function for creating multiple class-of-
10+
services with a single call.
11+
* Add new `odp_cos_destroy_multi()` function for destroying multiple CoSes with
12+
a single call.
13+
14+
==== Crypto
15+
* Clarify packet ordering of async crypto ops (`odp_crypto_op_enq()`).
16+
* Add `odp_crypto_packet_op_param_t.null_crypto` parameter that tells that a
17+
packet should be processed as if the configured algorithms were null cipher and
18+
null auth algorithm.
19+
* Add `ODP_CRYPTO_OP_TYPE_BASIC_AND_OOP` crypto operation type that allows both
20+
basic and out-of-place operations in the same session.
21+
22+
==== Packet IO
23+
* Add new API define `ODP_PKTIO_MAX_INDEX` for maximum packet IO interface
24+
index.
25+
26+
==== Queue
27+
* Add new `odp_queue_create_multi()` function for creating multiple queues with
28+
a single call.
29+
* Add new `odp_queue_destroy_multi()` function for destroying multiple queues
30+
with a single call.
31+
* Clarify `odp_queue_param_t` default value specification.
32+
33+
==== System
34+
* Add enumerations for ARM ISA versions ARMv8.8-A, ARMv8.9-A, and ARMv9.3-A.
35+
36+
==== Timer
37+
* Change `odp_timer_pool_param_t.num_timers` description to allow applications
38+
to attempt to allocate more timers than there are in a timer pool.
39+
* Add new `odp_timeout_alloc_multi()` function for allocating multiple timeouts
40+
with a single call.
41+
* Add new `odp_timeout_free_multi()` function for freeing multiple timeouts with
42+
a single call.
43+
44+
=== Helper (1.4.0)
45+
==== Backward incompatible changes
46+
===== Protocols
47+
* Rename `ODP_GTP_HLEN` define to `ODPH_GTP_HLEN`.
48+
* Rename `ODP_IGMP_HLEN` define to `ODPH_IGMP_HLEN`.
49+
* Remove unused ICMP defines and add missing `ODPH_` prefix to the remaining
50+
ones.
51+
52+
==== Backward compatible changes
53+
===== Macros
54+
* Add new `ODPH_MIN()` and `ODPH_MAX()` helper macros for comparison operations.
55+
* Add new `ODPH_ARRAY_SIZE()` helper macro for calculating array size.
56+
* Add new `ODPH_ABS()` helper macro for calculating the absolute value of a
57+
signed variable.
58+
59+
=== Implementation
60+
==== CPU
61+
* Optimize `odp_cpu_cycles()` performance on aarch64 by implementing the
62+
function using `cntvct_el0` virtual counter register.
63+
64+
==== Packet IO
65+
* Transmitting packet vectors is not supported by the current API, so remove
66+
the code from the implementation. This may improve performance when transmitting
67+
packets through event queues.
68+
* Add support for packet transmit completion check through polling
69+
(`ODP_PACKET_TX_COMPL_POLL`).
70+
71+
=== Example Applications
72+
==== sysinfo
73+
* Add prints for various missing capabilities (e.g. pool, packet IO, timer).
74+
75+
==== timer_accuracy
76+
* Add new (`-c, --count`) option to set the CPU count.
77+
* Add new (`-t, --queue_type`) option to set the queue sync type.
78+
* Add new (`-q, --num_queue`) option to set the number of queues.
79+
* Add new (`-G, --sched_groups`) option to use a dedicated schedule group for
80+
each queue.
81+
82+
=== Performance Tests
83+
==== bench_pktio_sp
84+
* Add new `odp_bench_pktio_sp` application for measuring delays of ODP packet IO
85+
slow path functions.
86+
87+
==== dmafwd
88+
* Add new `odp_dmafwd` application for comparing packet forwarding throughput
89+
when received packets are first copied either with software memory copy
90+
or with DMA offload and then echoed back to sender(s).
91+
92+
==== packet_gen
93+
* Add new (`-m, --tx_mode`) option for selecting how packets are transmitted.
94+
95+
==== stash_perf
96+
* Add new `odp_stash_perf` application for measuring ODP stash fast path API
97+
performance.
98+
99+
==== timer_perf
100+
* Add new mode (`-m 2`) for measuring `odp_schedule()` overhead while
101+
continuously restarting expiring timers.
102+
1103
== OpenDataPlane (1.42.0.0)
2104

3105
=== Backward incompatible API changes

configure.ac

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ AC_PREREQ([2.5])
44
##########################################################################
55
m4_define([odp_version_generation], [1])
66
m4_define([odp_version_major], [42])
7-
m4_define([odp_version_minor], [0])
7+
m4_define([odp_version_minor], [1])
88
m4_define([odp_version_patch], [0])
99

1010
m4_define([odp_version_api],
@@ -27,7 +27,7 @@ AC_SUBST(ODP_VERSION_API)
2727
# Helper library version
2828
##########################################################################
2929
m4_define([odph_version_generation], [1])
30-
m4_define([odph_version_major], [3])
30+
m4_define([odph_version_major], [4])
3131
m4_define([odph_version_minor], [0])
3232

3333
m4_define([odph_version],

0 commit comments

Comments
 (0)