Allow implementations to return zero in odp_system_meminfo_t.total_overhead field if tracking memory usage overhead is not supported.

Add a paragraph in the API principles section in include/README to describe parameter lifetimes of ODP API functions: Structures passed by reference (and structures referred by them) do not need to outlive the API call, unless otherwise noted in the API.

Clarify the presumed intent of back pressure API by specifying how exactly the back pressure threshold for any given pktio + pool/queue + pfc_level -tuple is derived from the configuration.

Add CoS parameter odp_cls_cos_param_t.aggr_enq_profile for selecting aggregator enqueuing profile (odp_aggr_enq_profile_t), which can generate hints to an event aggregator. Support is advertised through odp_cls_capability_t.aggr capability. The hints can affect e.g. the boundaries of vector events generated by an event aggregator.

Add odp_cpu_cycles_strict() function for reading current CPU cycle count value more strictly in the program order.

Add necessary fields to odp_dma_transfer_param_t for freeing DMA source segments of data format ODP_DMA_FORMAT_PACKET. Support is advertised through odp_dma_capability_t.src_seg_free capability.

Add necessary fields to odp_dma_seg_t, odp_dma_transfer_param_t, and odp_dma_result_t for allocating DMA destination segments of data format ODP_DMA_FORMAT_PACKET. Support is advertised through odp_dma_capability_t.dst_seg_alloc capability.

Add ODP_EVENT_VECTOR event type.

Add special ODP_EVENT_ANY event type, which does not match to any particular event type and can only be used when explicitly documented by the API.

Change odp_event_free() specification to state that in case of vector events (ODP_EVENT_VECTOR or ODP_EVENT_PACKET_VECTOR) it frees the vector and all events or packets stored inside it.

Add new generic event vector APIs. Event vectors can contain events of any type, as opposed to the existing packet vectors, which can contain only packets.

Add quantization parameters to input (odp_ml_input_info_t.quant_info) and output (odp_ml_output_info_t.quant_info) info. Implementation may optionally provide these parameters, if they are available for a given model.

Add ODP_POOL_EVENT_VECTOR pool type for allocating event vectors.

Clarify that odp_queue_sched_type(), odp_queue_sched_prio(), odp_queue_sched_group(), and odp_queue_lock_count() functions can be used only with queues of ODP_QUEUE_TYPE_SCHED type.

Add event aggregators that are associated with queues and have the same life time. Event aggregators are queues which try to aggregate multiple events into event vectors, which are then enqueued to the underlying queue. Event aggregators are configured through queue parameters (odp_queue_param_t.num_aggr and odp_queue_param_t.aggr) and the related capabilities are advertised using odp_event_aggr_capability_t struct. Event aggregators cannot be used simultaneously with the existing packet vector config in the same ODP application.

Add ODP_QUEUE_TYPE_AGGR queue type.

Add odp_queue_aggr() function for getting a queue handle of an event aggregator associated with a queue.

Add odp_aggr_enq_param_init() function for initializing event aggregator enqueuing parameters.

Add odp_queue_enq_aggr() function that can be used for passing hints to an event aggregator.

Add odp_schedule_group_param_init() function for initializing schedule group parameters.

Add odp_schedule_group_create_2() function, which is otherwise like odp_schedule_group_create(), but additionally accepts a set of parameters (odp_schedule_group_param_t). Parameters for predefined scheduling groups can be configured in odp_schedule_config().

Add possibility to configure cache stashing (odp_schedule_group_param_t.cache_stash_hints) at schedule group and/or priority levels. Stashing data of to-be-scheduled events and queues may improve performance in some workloads.

Add new timer pool parameter odp_timer_pool_param_t.priority and related capabilities. Timers allocated from pools with a higher priority value are served with higher priority than timers allocated from pools with a lower priority value.

Add odp_tm_node_stats() function for reading TM node specific statistics counters. The supported counters are advertised in odp_tm_level_capabilities_t.node_stats capability.

Add ODPH_DIV_ROUNDUP() macro for dividing two numbers and rounding up the result to the closest integer.

Add ODPH_ROUNDUP_MULTIPLE() macro for rounding up a value to a multiple of another value.

Add new -t option for selecting timer mode (shared/private).

Add a new "concurrency" mode (-m 4) that performs timer starts and cancels across multiple threads. This mode aims to uncover concurrency issues in the timer implementation, particularly with a short period, where timer expirations, starts, and cancels frequently occur close to each other.

Add new tool for benchmarking timer handling performance in different scenarios. Tester currently supports modes for single-shot (with and without cancelling) and periodic timers.

Change the default crypto op type written by odp_crypto_session_param_init() to ODP_CRYPTO_OP_TYPE_BASIC.

Deprecate old default crypto op type ODP_CRYPTO_OP_TYPE_LEGACY.

Modify certain details of IP and TCP Large Send Offload (LSO), specify missing details, add restrictions, and clarify the API in general.

Deprecate ODP_PACKET_TX_COMPL_ALL define. Use ODP_PACKET_TX_COMPL_EVENT instead.

Deprecate odp_pktio_capability_t.tx_compl.mode_all field. Use mode_event instead.

Deprecate odp_pktout_config_opt_t.bit.tx_compl_ena field. Use odp_pktio_config_t.mode_event instead.

Deprecate odp_timer_pool_start() function. Use odp_timer_pool_start_multi() instead.

Clarify odp_event_free() documentation by stating that it frees also the packets stored inside packet vectors.

Add printf format check to odp_override_log() and odp_log_func_t declarations.

Add odp_log_fn_get() function, which returns the current log function.

Add odp_abort_fn_get() function, which returns the abort function.

Add a new custom LSO operation (ODP_LSO_WRITE_BITS) for setting and clearing selected bits in first/middle/last segment when segmentation occurs.

Specify that all segments, except the last one, have the maximum payload length with the custom LSO protocol (ODP_LSO_PROTO_CUSTOM).

Remove deprecated odp_timeout_fresh() function.

Remove deprecated odp_timer_set_t type.

Deprecate odph_linux_pthread_create() and odph_linux_pthread_join() functions which have been replaced by generic odph_thread_create() and odph_thread_join() functions.

Deprecate odph_linux_process_fork(), odph_linux_process_fork_n(), and odph_linux_process_wait_n() functions which have been replaced by generic odph_thread_create() and odph_thread_join() functions.

Explicitly state that ODP must be initialized before calling helper functions and document exceptions to this rule individually.

Improve debug macro documentation.

Use the basic crypto operation type instead of now deprecated legacy operation type.

Remove explicit encrypt in-place operation option (-n).

New minimal performance optimized L2 forwarding benchmark application. Aim is to keep the tester as simple as possible in order to provide a stable benchmarking utility with comparable results across releases.

New machine learning (ML) performance test application. The application measures nanoseconds used for various ML operations, such as creating and destroying a model, loading and unloading a model, and inferencing.

Add new option (-X) for L4 checksum offloading.

Add new option (-T) for transmitting packets with LSO.

Add possibility to export test results into a .csv file by using --test-common-export option or TEST_COMMON_EXPORT environment variable.

Add new option (-p) for using private queues per worker.

Add pair test mode (-m 1) where events are moved between queue pairs connecting two or more workers.

Add new odp_atomic_fetch_min_u32() and odp_atomic_fetch_min_u64() functions for fetching and updating minimum values of atomic uint32_t or uint64_t variables.

Add new odp_atomic_fetch_max_u32() and odp_atomic_fetch_max_u64() functions for fetching and updating maximum values of atomic uint32_t or uint64_t variables.

Add functions for atomically setting and clearing bits in 32-bit atomic variables: odp_atomic_bit_set_u32(), odp_atomic_bit_fetch_set_u32(), odp_atomic_bit_clr_u32(), odp_atomic_bit_fetch_clr_u32(), odp_atomic_bit_set_rel_u32(), odp_atomic_bit_clr_rel_u32()

Add functions for atomically setting and clearing bits in 64-bit atomic variables: odp_atomic_bit_set_u64(), odp_atomic_bit_fetch_set_u64(), odp_atomic_bit_clr_u64(), odp_atomic_bit_fetch_clr_u64(), odp_atomic_bit_set_rel_u64(), odp_atomic_bit_clr_rel_u64()

Add flags for the new atomic functions into odp_atomic_op_t.

Add instruction prefetch function odp_prefetch_l1i().

Add debug function odp_dma_transfer_id_to_u64() for getting a printable value for a DMA transfer identifier.

Add debug function odp_instance_to_u64() for getting a printable value for an ODP instance handle.

Add functions for supporting quantization of int16_t and uint16_t data types: odp_ml_fp32_to_uint16(), odp_ml_fp32_from_uint16(), odp_ml_fp32_to_int16(), odp_ml_fp32_from_int16()

Add debug function odp_packet_tx_compl_to_u64() for getting a printable value for a Tx completion handle.

Clarify odp_packet_reset_max_len() documentation to state that the returned length may be less than the current packet data length if data length has been increased by utilizing head- or tailroom.

Add debug function odp_schedule_group_to_u64() for getting a printable value for a schedule group handle.

Clarify odp_bool_t documentation by stating how the data type can by used with standard C booleans and what is considered true/false.

Add a field of type __uint128_t in the union in odp_u128_t when the type is available, so that users that use __uint128_t or a compatible type do not need to type pun.

Add new example application, which loads a given ML model file, runs inference using a given input file and compares the output to a given reference file.

Add tests for new odp_packet_reset_meta() and odp_packet_reset_max_len() functions.

Add tests for event API fast path functions on packets.

Add new performance test application to measure CPU performance when application code size exceeds L1 instruction cache size.

Add new -U option to define custom L3 headers.

Add new none selection to the L4 protocol -N option.

Increase size of all_bits fields of odp_crypto_cipher_algos_t and odp_crypto_auth_algos_t algorithm capability unions.

Change odp_packet_reset() specification to use new odp_packet_reset_max_len() function for maximum packet data length value.

Limit length of odp_proto_stats_create() object name parameter to a new ODP_PROTO_STATS_NAME_LEN define.

Limit lengths of traffic manager object names to a new ODP_TM_NAME_LEN define.

Make mentions of maximum string lengths clear and consistent and always state that the null character is included.

Add more specific data prefetch variants: odp_prefetch_l1(), odp_prefetch_l2(), and odp_prefetch_l3().

Add more specific data prefetch variants for store: odp_prefetch_store_l1(), odp_prefetch_store_l2(), and odp_prefetch_store_l3().

Add streaming prefetch functions odp_prefetch_strm_l1() and odp_prefetch_store_strm_l1().

Add SHA-3 based cryptographic hash functions and HMACs based on them.

Add SNOW-V cipher algorithm and SNOW-V-GCM AEAD algorithm.

Add SM3 cryptographic hash function and a HMAC based on it.

Add SM4 cipher in ECB, CBC, CTR, GCM, CCM and GMAC modes.

Add odp_event_user_flag_set() function for setting/clearing event’s user flag value.

Clarify odp_packet_buf_len() specification to state that total packet buffer length includes also headroom and tailroom lengths.

Clarify odp_packet_reset() specification to state that packet data start is adjusted according to pool parameters, user area content is maintained, and packet data persistence is not guaranteed.

Add odp_packet_reset_meta() function for resetting only packet metadata without modifying packet data.

Clarify in odp_pool_param_t.buf.size specification that the actual buffer size may be rounded up by the implementation. Also, remove the limitation that an application will never store more than 'size' bytes in each buffer, which conflicted with odp_buffer_size() API.

Remove unused cuckoo table API.

Remove unused hash table API.

Remove unused linear table API.

Remove unused IP lookup table API.

Remove unused table interface API.

Add a simple dynamic worker tester that can be used to verify the ability of an ODP implementation to dynamically add and remove workers from one ODP application to another.

Add -O, --output_map option for changing the default output port mappings for interfaces.

Add -C, --tx_compl option for configuring packet transmit completion.

Add -X, --flow_control option for enabling reception and/or transmission of Ethernet pause frames.

Enable running the application with only RX or TX threads.

Add support for transmitting TCP packets (-N, --proto). The application doesn’t implement actual TCP protocol, but simply transmits packets with valid TCP headers at a selected rate.

Enable running the application indefinitely with special round count (-r) value 0.

Add -S, --stress option for selecting stress function(s) to be used on event data. Functions add various amount of CPU load to each event to simulate application data processing.

Rename -a option (--fairness) to -F for better match of short and long option names.

Add simple memory copy loop and square root calculation test modes (-m, --mode) to generate CPU load.

Add new API module for Machine Learning offload.

Implement the API using ONNX Runtime. A non-standard ONNX install path can be passed with --with-ort-path configure option. See DEPENDENCIES for additional information.

Print packet IO link information.

Add packet IO interface name option (-i).

Add support for measuring packet input delay.

Add packet input timestamping option (-T).

Add packet data prefetch option (-F).

Add packet data read option (-R).

Add packet print option (-V).

New pool latency tester application for profiling pool allocation and free latencies under different load patterns.

Add options to read (-u) and modify (-U) event user area contents per event reception.

Run application indefinitely when the number of events to schedule option (-s) is set to zero.

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.

Change local/global time specification to allow timestamp values to start from an implementation defined value, instead of always starting from zero.

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.

Add odp_event_pool() function, which returns a handle to the pool where the event was allocated from.

Fix a type conversion issue in odp_unlikely() implementation.

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.

Clarify that disabled/unused per thread statistics counters will not necessarily be zeroed by odp_pool_stats().

Clarify event ordering in ordered scheduling contexts.

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.

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.

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 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.

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.

Remove deprecated ODP_SCHED_PRIO_HIGHEST, ODP_SCHED_PRIO_NORMAL, ODP_SCHED_PRIO_LOWEST, and ODP_SCHED_PRIO_DEFAULT defines.

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.

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.

Add WFE based aarch64 ticketlock implementation (--enable-wfe-locks) for power saving.

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.

Add new odp_cls_pmr_create_multi() function for creating multiple packet matching rules with a single call.

Add new odp_cls_pmr_destroy_multi() function for destroying multiple PMRs with a single call.

Add new odp_cls_cos_create_multi() function for creating multiple class-of- services with a single call.

Add new odp_cos_destroy_multi() function for destroying multiple CoSes with a single call.

Clarify packet ordering of async crypto ops (odp_crypto_op_enq()).

Add odp_crypto_packet_op_param_t.null_crypto parameter that tells that a packet should be processed as if the configured algorithms were null cipher and null auth algorithm.

Add ODP_CRYPTO_OP_TYPE_BASIC_AND_OOP crypto operation type that allows both basic and out-of-place operations in the same session.

Add new API define ODP_PKTIO_MAX_INDEX for maximum packet IO interface index.

Add new odp_queue_create_multi() function for creating multiple queues with a single call.

Add new odp_queue_destroy_multi() function for destroying multiple queues with a single call.

Clarify odp_queue_param_t default value specification.

Add enumerations for ARM ISA versions ARMv8.8-A, ARMv8.9-A, and ARMv9.3-A.

Change odp_timer_pool_param_t.num_timers description to allow applications to attempt to allocate more timers than there are in a timer pool.

Add new odp_timeout_alloc_multi() function for allocating multiple timeouts with a single call.

Add new odp_timeout_free_multi() function for freeing multiple timeouts with a single call.

Optimize odp_cpu_cycles() performance on aarch64 by implementing the function using cntvct_el0 virtual counter register.

Transmitting packet vectors is not supported by the current API, so remove the code from the implementation. This may improve performance when transmitting packets through event queues.

Add support for packet transmit completion check through polling (ODP_PACKET_TX_COMPL_POLL).

Add prints for various missing capabilities (e.g. pool, packet IO, timer).

Add new (-c, --count) option to set the CPU count.

Add new (-t, --queue_type) option to set the queue sync type.

Add new (-q, --num_queue) option to set the number of queues.

Add new (-G, --sched_groups) option to use a dedicated schedule group for each queue.

Add new odp_bench_pktio_sp application for measuring delays of ODP packet IO slow path functions.

Add new odp_dmafwd application for comparing packet forwarding throughput when received packets are first copied either with software memory copy or with DMA offload and then echoed back to sender(s).

Add new (-m, --tx_mode) option for selecting how packets are transmitted.

Add new odp_stash_perf application for measuring ODP stash fast path API performance.

Add new mode (-m 2) for measuring odp_schedule() overhead while continuously restarting expiring timers.

Add odp_crypto_session_param_t.cipher_range_in_bits and odp_crypto_session_param_t.auth_range_in_bits session parameters that control whether cipher/auth range is given in bits or bytes.

Change odp_crypto_cipher_capability_t.bit_mode cipher/auth capability flag to indicate whether bit mode is supported in addition to byte mode that is always supported.

Add memory barriers (odp_mb_sync(), odp_mb_sync_load(), odp_mb_sync_store()) which ensure that load/store instructions started before the barrier are complete, before load/store instructions after the barrier are started.

Allow non-zero-length cipher and auth ranges (odp_crypto_packet_op_param_t.cipher_range/auth_range) for the null cipher and auth algorithms in the OOP operation type.

Add new odp_dma_pool_capability_t.uarea_persistence pool capability to signal if implementation is able to maintain the content of pool user areas across frees and allocations.

Add new odp_dma_pool_param_t.uarea_init pool parameters init_fn and args that can be used to initialize event user areas of a pool at pool creation time.

Move odp_dma_seg_t structure fields so that addr/packet field is directly followed by len and offset fields. After this change all commonly used fields are located in the first 16 bytes of the structure.

Add new odp_event_types_multi() function for reading event types and subtypes (optional) from all given events.

Add new odp_event_user_area_and_flag() function for reading both event user area pointer and user flag value.

Add new ODP_LOG_WARN log level to odp_log_level_t.

Change odp_packet_user_flag() and odp_packet_vector_user_flag() documentations to specify that the return values are positive if user flag is set.

Add new uarea_persistence pool capability to signal if implementation is able to maintain the content of pool user areas across frees and allocations.

Add new uarea_init pool parameters init_fn and args that can be used to initialize event user areas of a pool at pool creation time.

Add new odp_timeout_from_event_multi() function for converting multiple events of type ODP_EVENT_TIMEOUT to timeout handles.

Clarify odp_timer_alloc() and odp_timer_restart() documentation.

Refactor time codebase to enable more optimized architecture specific implementations. x86 and aarch64 architectures are assumed to always have support for HW time and fallback to POSIX time functions has been removed for improved performance.

Add odp_dma_compl_user_area() function which returns pointer to the user area configured with DMA completion event pool parameters.

Clarify that DMA session names don’t need to be unique.

Add odp_event_user_area() function which returns a pointer to the user area associated with the event.

Add odp_term_abnormal() function that can be used to abnormally terminate an ODP application after a non-recoverable error. Depending on the implementation, this function may attempt to dump stack and other memory areas, clean up and stop HW operations and/or perform other actions helpful in postmortem analysis.

Extend packet transmit completion (odp_packet_tx_compl_request()) with poll mode. When enabled, packet transmit completion status can be checked with odp_packet_tx_compl_done().

Add odp_packet_free_ctrl_set() function for controlling packet output interface to not free a packet after transmitting it.

Add odp_packet_free_ctrl() function for reading packet’s free control option value.

Relax odp_pool_stats() specification to allow implementations to have some delay until pool statistics are updated.

Add new function odp_pool_stats_selected() for reading only selected pool statistic(s).

Split odp_timer_cancel() failure reason into timing related and other failures.

Rename odp_timer_set_t to odp_timer_retval_t as it is used now for start, restart, and cancel operations. odp_timer_set_t remains as a typedef for backward compatibility.

Add odp_timer_sample_ticks() function that samples tick value of multiple timer pools simultaneously.

Allow implementation to place the first timer as close as it can to one period when starting a periodic timer with first_tick set to 0.

Clarify that periodic timer base frequency uses fractional numbers the same way as timer tick info (odp_timer_tick_info_t). Integer part specifies full hertz and fractional part specifies parts of a hertz.

Clarify that odp_timer_periodic_capability() call does not overwrite the base frequency value when 1 is returned.

Clarify that some implementations may support only certain periodic timer base frequencies and those depend on source clock frequency.

Add new test application for measuring call latency of small functions in the timer API.

Refactor DMA test application to support multiple worker threads. The number of in-flight transfers can be configured and workers will always try to keep that many transfers active through single or per-worker DMA session.

Add support for running the application in process mode.

Require that PMRs must be destroyed before the CoS they refer to is destroyed.

Deprecate the old session creation error names (ODP_CRYPTO_SES_CREATE_ERR_NONE, ODP_CRYPTO_SES_CREATE_ERR_ENOMEM, ODP_CRYPTO_SES_CREATE_ERR_INV_CIPHER, ODP_CRYPTO_SES_CREATE_ERR_INV_AUTH) that have been replaced by shorter error names.

Change return value of odp_crypto_result() to indicate crypto operation success/failure.

Deprecate odp_crypto_packet_result_t.ok field. Replaced by odp_crypto_result() return value.

Specify that the status fields of odp_crypto_packet_result_t are valid only when the operation failed (odp_crypto_result() returned -1).

Deprecate odp_crypto_hw_err_t type and odp_crypto_op_status_t.hw_err field. All errors are now reported through alg_err field.

Deprecate ODP_CRYPTO_ALG_ERR_KEY_SIZE and ODP_CRYPTO_ALG_ERR_IV_INVALID error codes.

Require that cipher range (odp_crypto_packet_op_param_t.cipher_range) and auth range (odp_crypto_packet_op_param_t.auth_range) have zero offset and zero length when used with null cipher and null auth algorithm, respectively, with the out-of-place operation type.

Remove mention about errno values specified in the API spec. Setting errno has been removed from all ODP APIs outside errno module.

Remove legacy reference to errno from odp_pktio_open() function.

Remove special meaning of odp_stash_capability_t.max_num_obj value zero.

Remove legacy references to errno from odp_timer_pool_create() and odp_timer_alloc() functions.

Clarify that the CoS to be destroyed with odp_cos_destroy() must not be in use.

Clarify that odp_cos_queue() returns ODP_QUEUE_INVALID if the queue is not set.

Allow CoS pool (odp_cls_cos_param_t.pool) to be set to ODP_POOL_INVALID, in which case the originating pktin pool is used.

Clarify when CoS queue may and may not be invalid.

Change IV (odp_crypto_packet_op_param_t.cipher_iv_ptr, odp_crypto_packet_op_param_t.auth_iv_ptr) and AAD ( odp_crypto_packet_op_param_t.aad_ptr) pointers to pointers to constants.

Clarify that algorithm order (odp_crypto_session_param_t.auth_cipher_text) is ignored with null algorithms.

Clarify when cipher (odp_crypto_packet_op_param_t.cipher_range) and auth (odp_crypto_packet_op_param_t.auth_range) ranges are ignored.

Allow the result pointer for odp_crypto_result() to be null, making filling the result structure optional.

Clarify the description of ODP_CRYPTO_ALG_ERR_DATA_SIZE.

Add a new crypto operation error ODP_CRYPTO_ALG_ERR_OTHER to cover cases for which the other errors do not fit.

Clarify that null cipher and auth algorithms ignore key length, IV length, digest length, etc. session parameters.

Clarify that crypto operations do not affect parse flags in packet metadata and thus odp_packet_has_error() cannot be used for checking operation result.

Allow the default CoS to be removed by passing ODP_COS_INVALID to odp_pktio_default_cos_set().

Clarify that the pool to be destroyed with odp_pool_destroy() must not be in use.

Clarify that odp_pool_capability_t.max_pools is used for all pool types defined in odp_pool_type_t.

Add new stash create parameter odp_stash_param_t.strict_size for performance optimization. The new option is disabled by default and the total object count limitation is removed from stash put functions.

Add new capabilities for maximum number of object handles per stash for each object size (odp_stash_capability_t.max_num).

Clarify that zero odp_timer_periodic_start_t.first_tick means that the first expiration time is one period after the current time, not at the current time.

Remove deprecated odp_crypto_compl_t crypto completion event.

Remove deprecated odp_crypto_op_param_t type.

Remove deprecated odp_crypto_op_result_t type.

Remove deprecated odp_crypto_session_param_t.pref_mode field.

Remove deprecated odp_crypto_compl_from_event() function.

Remove deprecated odp_crypto_compl_to_event() function.

Remove deprecated odp_crypto_compl_free() function.

Remove deprecated odp_crypto_operation() function.

Remove deprecated odp_crypto_compl_result() function.

Remove deprecated odp_crypto_compl_to_u64() function.

Remove deprecated ODP_EVENT_CRYPTO_COMPL event type.

Remove netmap pktio device.

Change recommended DPDK version for DPDK pktio device to v22.11.

Change implementation to use overflow safe MPMC rings by default. Previous strict size ring-based implementation can be used by enabling odp_stash_param_t.strict_size parameter.

Specify which packet metadata flags cannot be set simultaneously using odp_packet_has_XX_set() functions.

Use ODP_DEPRECATE() macro for odp_timer_set_abs() and odp_timer_set_rel() functions. Previously, the deprecation was only mentioned in the function documentation.

Deprecate old timer pool clock sources ODP_CLOCK_CPU and ODP_CLOCK_EXT, which have been replaced by ODP_CLOCK_DEFAULT and ODP_CLOCK_SRC_1.

Deprecate old timer set return values ODP_TIMER_TOOEARLY, ODP_TIMER_TOOLATE, and ODP_TIMER_NOEVENT, which have been replaced by ODP_TIMER_TOO_NEAR, ODP_TIMER_TOO_FAR, and ODP_TIMER_FAIL.

Add new operation type session parameter (odp_crypto_session_param_t.op_type) that controls how crypto operations interpret their parameters and handle output packets. Defaults to backward compatible ODP_CRYPTO_OP_TYPE_LEGACY mode.

Add ODP_CRYPTO_OP_TYPE_BASIC operation type with simplified interface compared to ODP_CRYPTO_OP_TYPE_LEGACY.

Add ODP_CRYPTO_OP_TYPE_OOP operation type that writes the output of the crypto operation into a caller provided output packet and does not consume the input packet.

Clarify that odp_crypto_op() copies all packet data and metadata from the input packet to the output packet in ODP_CRYPTO_OP_TYPE_LEGACY and ODP_CRYPTO_OP_TYPE_BASIC modes.

Require that odp_crypto_result() is called before packet data of asynchronously processed packets can be assumed to be valid in non-legacy modes.

Fix EIA2 IV length in API documentation. EIA2 uses 64-bit IV, not 128-bit as previously mentioned in the API text.

Clarify odp_packet_has_vlan() and odp_packet_has_vlan_qinq() specifications.

Remove deprecated per-session IV configuration.

Remove deprecated in_unknown_protos field from odp_pktio_stats_t.

Remove deprecated odp_pktin_ts_res() function.

Remove deprecated odp_pktin_ts_from_ns() function.

Remove deprecated ODP_SHM_SW_ONLY define.

Remove deprecated odp_tm_capabilities() function.

Remove deprecated commit_bps field from odp_tm_shaper_params_t.

Remove deprecated peak_bps field from odp_tm_shaper_params_t.

Add Multi-Buffer Crypto for IPsec library (Arm optimized) based crypto implementation. See DEPENDENCIES for additional information.

Add support for runtime event validation (buffer endmark checking). Event validation can be enabled during configure with --enable-event-validation [warn/abort] or with --enabled-debug=full. See README for additional information.

Deprecate odp_cos_with_l2_priority() function. Use ODP_PMR_VLAN_PCP_0 instead.

Deprecate packet drop policy option (odp_cls_cos_param_t.drop_policy) and related functions odp_cos_drop() and odp_cos_drop_set().

Change odp_shm_info() specification to disallow usage of invalid SHM handles.

Add multi variants of event conversion functions (odp_buffer_from_event_multi() and odp_buffer_to_event_multi()).

Add PFC priority level (odp_bp_param_t.pfc_level) to back pressure parameters.

Clarify PMR specification to state that in case of multiple PMRs matching within a CoS, it is implementation specific which PMR is selected.

Fix a stale reference to the renamed hash_result_not_in_auth_range session parameter to use the correct name (hash_result_in_auth_range) in the comment text of hash_result_offset.

Add support for additional L3 and L4 protocol types.

Add ODP_PKTIN_MAX_QUEUES define for maximum number of packet input queues.

Add new packet input queue size configuration option odp_pktin_queue_param_t.queue_size and matching capabilities odp_pktio_capability_t.min_input_queue_size and odp_pktio_capability_t.max_input_queue_size.

Add missing documentation to odp_pktio_link_status_t, odp_pktio_link_duplex_t, and odp_pktio_link_pause_t enumerations.

Add ODP_PKTIO_LINK_PFC_ON enumeration for PFC flow control mode.

Add capabilities (odp_pktio_capability_t.flow_control) and configuration parameters to control reception (odp_pktio_config_t.flow_control.pause_rx) and transmission (odp_pktio_config_t.flow_control.pause_tx) of Ethernet pause frames.

Add odp_shm_segment_info() function for retrieving information about each memory segment of an SHM block.

Clarified odp_shm_reserve() operation with the default options (no flags).

Add odp_system_meminfo() function for retrieving information about ODP memory usage.

Change odp_pool_capability_t.pkt.max_uarea_size specification to state that the value of zero means user area is not supported.

Specify that the default value of odp_pool_param_t.pkt.uarea_size is zero and implementation may round up the given value.

Add odp_buffer_user_area() function which returns pointer to the user area configured with pool create parameters.

Add experimental ZUC-256 support.

Add odp_packet_vector_user_area() function which returns pointer to the user area configured with pool create parameters.

Add new user flag metadata to packets (odp_packet_user_flag(), odp_packet_user_flag_set()) and packet vectors (odp_packet_vector_user_flag(), odp_packet_vector_user_flag_set()).

Add user area size capability and parameter into buffer, timeout, and vector event pools.

Add batch variants of all put/get functions and capabilities for maximum supported batch sizes.

Clarify odp_thread_id() specification to state that thread IDs are assigned sequentially starting from 0 in the order threads call odp_init_local().

Add odp_timeout_user_area() function which returns pointer to the user area configured with pool create parameters.

Allow usage of NULL pointer with odp_cpumask_default_worker() and odp_cpumask_default_control() calls. This enables applications to check the number of worker/control CPUs without allocating a temporary mask.

Clarify odp_cpumask_default_worker() and odp_cpumask_default_control() specifications to mention that system may allow usage of other CPUs as well.

Specify that interfaces that support promiscuous mode set operation have promiscuous mode disabled by default.

Add new statistics counters (odp_pool_stats_t.thread.cache_available) for reading per thread pool cache usage.

Add odp_stash_print() function for printing implementation specific debug information to the ODP log.

Add statistics counters to stash API. Counter support is defined by stash capabilities (odp_stash_capability_t.stats). Supported counters can be enabled in odp_stash_create() and read with odp_stash_stats().

Clarify that odp_pktout_send_lso() can be used also for packets that have payload less than max_payload_len bytes.

Change 32-bit and 64-bit specific get/put functions' parameter names to avoid name conflicts.

Add option to do rate limiting instead of rate shaping in TM nodes and queues.

Deprecate odp_cos_with_l3_qos() function. Use new ODP_PMR_IP_DSCP PMR term instead.

Add new PMR term enumeration ODP_PMR_IP_DSCP for Differentiated Services Code Point (DSCP) bits in IP header.

Add new PMR term enumeration ODP_PMR_VLAN_PCP_0 for Priority Code Point (PCP) bits in VLAN header.

Clarify ODP_PMR_ETHTYPE_0, ODP_PMR_VLAN_ID_0, and ODP_PMR_VLAN_ID_X PMR term specifications.

Remove unused odp_cos_hdr_flow_fields_t enumeration.

Add new odp_schedule_order_wait() function which waits until the currently held scheduling context is the first in order.

Add new experimental AF_XDP socket based packet IO device.

Add an action parameter odp_cos_action_t to CoS parameters (odp_cls_cos_param_t). Action may be to enqueue or drop the packet classified to the CoS. The old methods of creating a drop CoS have been replaced by the new drop action.

Deprecate odp_crypto_operation(), the associated data structures, and the completion event. Use odp_crypto_op() or odp_crypto_op_enq() instead.

Split odp_tm_capabilities_t.tm_queue_threshold capability into byte and packet modes.

Split odp_tm_level_capabilities_t.tm_node_threshold capability into byte and packet modes.

Add CoS specific statistics counters (odp_cls_cos_stats_t) and matching capabilities (odp_cls_stats_capability_t). Statistics counters can be read with odp_cls_cos_stats().

Convert unsigned int types to uint32_t.

Remove unused TM shaper color enum odp_tm_shaper_color_t and ODP_NUM_SHAPER_COLORS define.

Deprecate scheduling priority level defines ODP_SCHED_PRIO_HIGHEST, ODP_SCHED_PRIO_NORMAL, ODP_SCHED_PRIO_LOWEST, and ODP_SCHED_PRIO_DEFAULT. These defines have been replaced by matching functions.

Change meaning of odp_tm_enq_multi() return value of zero from failure code to part of normal operation.

Remove references to deprecated odp_pktin_ts_res() and odp_pktin_ts_from_ns() functions.

Add ODP_PKTOUT_MAX_QUEUES define for the maximum number of packet output queues.

Add new packet output queue size configuration option odp_pktout_queue_param_t.queue_size and matching capabilities odp_pktio_capability_t.min_output_queue_size and odp_pktio_capability_t.max_output_queue_size.

Clarify odp_pktio_config() usage in the interface setup sequence.

Allow large send offload (LSO) usage with traffic manager (odp_pktio_config_t.enable_lso).

Clarify timer tick properties and especially that it may run with a higher frequency than the requested timer pool resolution.

Add new timer pool parameter (odp_timer_pool_param_t.exp_mode), which application can use to select if timer expiration may happen before or only after the specified time.

Add new odp_timer_start() and odp_timer_restart() functions.

Add support for periodic timers. New capabilities, parameters, and functions are added to create/start/ack periodic timers.

Add odp_tm_enq_multi_lso() function which does also LSO as part of the TM output operation.

Remove deprecated ODP_PMR_INVAL define.

Remove deprecated old style cipher algorithm enumerations ODP_CIPHER_ALG_AES128_CBC and ODP_CIPHER_ALG_AES128_GCM.

Remove deprecated old style authentication algorithm enumerations ODP_AUTH_ALG_MD5_96, ODP_AUTH_ALG_SHA256_128, and ODP_AUTH_ALG_AES128_GCM.

Remove deprecated fields aes128_cbc and aes128_gcm from odp_crypto_cipher_algos_t.

Remove deprecated fields md5_96, sha256_128, and aes128_gcm from odp_crypto_auth_algos_t.

Remove deprecated data range specifier odp_crypto_data_range_t.

Remove deprecated iv field from odp_crypto_session_param_t.

Remove deprecated odp_crypto_session_params_t type.

Remove deprecated override_iv_ptr field from odp_crypto_op_param_t.

Remove deprecated override_iv_ptr field from odp_crypto_packet_op_param_t.

Remove deprecated odp_crypto_op_params_t type.

Remove deprecated odp_crypto_compl_status_t type.

Remove deprecated parser layer defines (ODP_PKTIO_PARSER_LAYER_*).

Remove deprecated odp_pktio_capability_t.loop_supported capability.

Remove deprecated odp_pktio_mtu() function.

Remove deprecated scheduled queue capabilities from odp_queue_capability_t.

Remove deprecated odp.h header file which has been replaced by odp_api.h.

Specify that hash result field is not cleared in hash generation in encode sessions. Applications can do the clearing if needed if the hash result lies within the authenticated range.

Specify that the hash result field is left to an undefined value after verification.

Add a new session parameter odp_crypto_session_param_t.hash_result_in_auth_range to indicate if the hash result location may overlap the authenticated range. Leaving the flag unset may enable optimizations in the implementation.

Define new fields for cipher and auth IV lengths in the session parameter structure odp_crypto_session_param_t. Deprecated the old fields for cipher and auth IV lengths.

Deprecate the mechanism of configuring initialization vectors in sessions since reusing the same IV with the same key is almost always wrong. Require that IV is provided for each packet in the operation parameters.

Add capabilities to odp_tm_level_capabilities_t for platforms to express shaper rate and burst min and max limits.

Remove support for min and max shaper rate via platform defined macros ODP_TM_MIN_SHAPER_BW and ODP_TM_MAX_SHAPER_BW. Min and Max shaper bandwidths can be read from TM per level capabilities (odp_tm_level_capabilities_t).

Clarify that in case of AEAD algorithms the odp_crypto_op_param_t.auth_range parameter is not used, except with AES-GMAC.

Clarify ODP_AUTH_ALG_AES_GMAC API text to not sound as if ODP did not use AAD as defined in the GMAC algorithm specification.

Make the names of session creation errors (odp_crypto_ses_create_err_t) a bit shorter but retain the old names for backward compatibility.

Add crypto session creation error codes (odp_crypto_ses_create_err_t) for cases where the requested combination of algorithms, order of algorithms or other combination of creation parameters is not supported.

Explicitly state that the same series of odp_random_test_data() calls is required to generate the same data.

Clarify that peak rate and peak burst are ignored when dual rate is set to false in odp_tm_shaper_params_t, indicating that the single rate is commit rate.

Define the default values for many parameters to be set by various init functions.

Added a bit mask capability odp_shm_capability_t.flags for ODP_SHM_* flags

Added initialization function odp_timer_pool_param_init() for timer pool parameters. Application must use it to initialize parameters to their default values.

Added missing default values for odp_cls_cos_param_t.num_queue, odp_cls_cos_param_t.red.enable, odp_cls_cos_param_t.bp.enable, and odp_pmr_param_t.range_term.

Clarified that odp_crypto_session_create() parameters, including the key and IV data, can be freed after session creation.

Added new DMA module which enables applications to offload memory transfers (copies) to DMA hardware. See include/odp/api/spec/dma.h for more information.

Added possibility to request completed packets as packet vector events instead of packet events. Packet vector capabilities are provided by odp_ipsec_capability_t.vector and the configuration is done using odp_ipsec_config_t.vector.

Clarified that odp_ipsec_sa_create() parameters, including the various memory buffers pointed to by the parameters, can be freed after SA creation.

Clarified odp_pktin_vector_config_t.enable documentation to state that when packet vectors are enabled, packets may be delivered both as packet vector events and packet events. Packet vectors are disabled by default.

Clarified that the type of input queues (scheduled versus plain) is deduced from the pktio input mode in odp_pktin_queue_config(), and that the default queue type value and the queue type value passed in odp_pktin_queue_param_t.queue_param are ignored.

Added ODP_SHM_NO_HP flag which can be used to prevent the implementation from allocating the shared memory block from huge pages

Added DMA flag to odp_feature_t

Added odp_instance() function for reading the current ODP instance handle

Clarified bit field unions' all member intended usage

Clarified odp_proto_chksums_t.all_chksum intended usage

Clarified odp_pktin_hash_proto_t.all_bits intended usage

Added odp_pool_print_all() function for printing implementation defined information about all created pools to the ODP log

Clarified odp_pool_param_t.pkt.seg_len documentation

Added 32-bit only odp_stash_put_u32() and odp_stash_get_u32() functions

Added 64-bit only odp_stash_put_u64() and odp_stash_get_u64() functions

Added pointer only odp_stash_put_ptr() and odp_stash_get_ptr() functions

Added destination queue capabilities odp_ipsec_capability_t.queue_type_sched and odp_ipsec_capability_t.queue_type_plain

Modified specification to not promise the original packet back after all error cases

Added original ESP/AH packet length into IPsec packet result (odp_ipsec_packet_result_t.orig_ip_len)

Added odp_packet_reass_info() function for reading completed reassembly details

Moved all contents of support and feature modules into ODP Std module

AES-EEA2 and AES-EIA2 crypto algorithms that operate in bit mode interpret the crypto/auth offset now as bits as specified in the ODP API. This correction requires corresponding changes in applications that have relied on the old, incorrect behavior that interpreted the offset in bytes.

Added new TM feature capabilities and an egress specific capability function odp_tm_egress_capabilities()

Deprecated odp_tm_capabilities() function which is replaced by odp_tm_egress_capabilities()

Added odp_tm_capabilities_t.max_schedulers_per_node capability to express the maximum number of schedulers per TM node

Added support for non-global packet priority mode

Added queue specific statistics counters (odp_cls_queue_stats())

Added ICV length into SA configuration parameters (odp_ipsec_crypto_param_t.icv_len)

Moved packet type definitions into a separate packet_types.h header to enable easier function inlining

Added odp_packet_disassemble(), odp_packet_reassemble(), and other new functions for packets allocated from external memory pools

Added packet protocol statistics functions odp_packet_proto_stats_request() and odp_packet_proto_stats()

Added odp_pktout_config_opt_t.bit.proto_stats_ena option for enabling packet protocol statistics updates

Added new concept of external memory pools, which are populated with application provided memory

Added new odp_pool_type_t enumeration

Moved pool type definitions into a separate pool_types.h header to enable easier function inlining

Added new generic protocol statistics framework

Moved queue type definitions into a separate queue_types.h header to enable easier function inlining

Renamed std_clib module std and moved all generic ODP data types and functions there

Increased scheduling weight parameter size (uint8_t to uint32_t)

Added queue specific statistics counters (odp_tm_queue_stats())

Added odp_tm_enq_multi() function for enqueueing multiple packets at a time

Added odp_tm_queue_params_t.ordered_enqueue option which can be used to control if ordering is enabled

Modified odp_pktio_stats_t.in_octets/out_octets definitions to not include CRC (4 bytes)

Added odp_pktio_stats_capability_t struct to odp_pktio_capability_t to inform about supported statistics counters

Added new statistics counters and related capabilities for received/transmitted multicast and broadcast Ethernet packets (in_mcast_pkts, in_bcast_pkts, out_mcast_pkts, out_bcast_pkts)

Added new pktio input/output queue specific statistics counters (odp_pktin_queue_stats_t and odp_pktout_queue_stats_t) and related functions and capabilities

Added new functions for reading and printing ODP implementation specific custom packet IO statistics counters: odp_pktio_extra_stat_info(), odp_pktio_extra_stats(), odp_pktio_extra_stats_print()

Specified that the default value of odp_pktio_config_t.enable_loop option is false

Specified that the default values of the IPsec specific reassembly enables are false

Added odp_schedule_print() function for printing debug information about scheduler status into the ODP log

Added odp_fract_u64_t type which can be used to define fractional numbers accurately

Added odp_fract_u64_to_dbl() function for converting odp_fract_u64_t fractional numbers into doubles

Added timer tick info as part of odp_timer_pool_info_t. This enables timer implementation to specify tick frequency and duration very accurately.

New success bytes field in stats (odp_ipsec_stats_t.success_bytes)

Specify explicitly that an application may enqueue to packet input side event queues, and cannot dequeue from output side event queues

Added time stamp read functions which read time stamp value more strictly in the program order: odp_time_local_strict(), odp_time_local_strict_ns(), odp_time_global_strict(), odp_time_global_strict_ns()

Added new default clock source enumeration ODP_CLOCK_DEFAULT (=ODP_CLOCK_SRC_0) and support for multiple clock sources (ODP_CLOCK_SRC_1, ODP_CLOCK_SRC_2…​). The old ODP_CLOCK_CPU and ODP_CLOCK_EXT enumerations will be deprecated in the future.

Renamed set operation return codes (odp_timer_set_t) to better document expiration time position to current time: ODP_TIMER_TOOEARLY → ODP_TIMER_TOO_NEAR, ODP_TIMER_TOOLATE → ODP_TIMER_TOO_FAR

Renamed set operation failure code (odp_timer_set_t) to cover all error cases: ODP_TIMER_NOEVENT → ODP_TIMER_FAIL

Added option to enable packet mode shaper (packets per second as opposed to bits per second)

Added new mandatory odp_tm_start() and odp_tm_stop() calls for starting and stopping traffic manager system

Added capabilities (odp_tm_capabilities_t) for supported dynamic configuration updates

Deprecated shaper commit information rate bps (odp_tm_shaper_params_t.commit_bps) and peak information rate bps (odp_tm_shaper_params_t.peak_bps) fields. odp_tm_shaper_params_t.commit_rate and odp_tm_shaper_params_t.peak_rate fields should be used instead.

Modified statistics counters (odp_pktio_stats_t) definitions

Deprecated statistics counter odp_pktio_stats_t.in_unknown_protos

New odp_pktio_stats_t.in_packets and odp_pktio_stats_t.out_packets statistics counters

New APIs for packet input inline IP reassembly offload

New odp_packet_reass_status() function added for checking packet reassembly status

New odp_packet_reass_partial_state() function added for reading packet partial reassembly state

New APIs for inline IP reassembly offload

New odp_log_thread_fn_set() function added for setting a thread specific log function

New crypto capabilities for defining if a queue type (scheduled/plain) can be used as a crypto completion event destination

New packet TX completion event type and related functions

New packet APIs for requesting packet TX completion events

New packet APIs for requesting packet TX drop based on packet age

New odp_cls_print_all() function for printing implementation specific debug information about all classifier rules

New enumerations for ARMv8.7-A, ARMv9.0-A, ARMv9.1-A, and ARMv9.2-A ISA versions

Added missing const qualifiers

Improved Doxygen module descriptions

Use param_init functions for parameter defaults

Make supporting CPU frequency and cycle counter optional

Added feature bits stash and compress into odp_feature_t.

Clarify packet length function argument definitions

Added odp_packet_input_set() function

Added odp_pktio_link_info() function for reading link status information

Modified odp_pktio_link_status() to return odp_pktio_link_status_t enum (backward compatible values)

Added cache_size parameters to odp_pool_capability_t and odp_pool_param_t

Removed default value of packet max_len from odp_pool_param_t

Added packet data align parameter to odp_pool_param_t

Unify max_size capa specification for all plain queue types

Clarify that queue operations include memory barriers

Clarify how much data odp_random_data() and odp_random_test_data() output on success.

Clarify synchronization of store operations during atomic context

Clarify that schedule operations include memory barriers

Add ODP_SHM_HW_ACCESS flag

Added new stash API module

Added odp_time_local_ns() and odp_time_global_ns() functions for acquiring current time stamp in nanoseconds

Clarify that odp_timeout_tick() returns original expiration time

Add resolution in hertz parameter res_hz into odp_timer_pool_param_t

Add missing handle debug functions

Info structures are written only on success

Added ODP_VERSION_API define and ODP_VERSION_API_NUM macro

Rewrote buffer tests for improved coverage

Allow allocated buffer size to be larger than requested

Fix duplicate global variable definition

Use odp_schedule_wait_time() correctly

Fix var len array scope

Add tests for new compress and stash feature bits

Improved log prints

Fixed invalid allocation of zero length test packet

Fixed invalid test for user pointer value

Add max pools test

Add packet alloc align test

Fix max_num expectations

Prevent test trying to allocate zero length packets

Remove pools from suite init

Remove reset test packet from suite init

Rename default pool

Use common pool capability

Check parser flags on receive

Check pktio index

Decrease timeout in odp_pktin_recv_tmo() test

Make pktio_check_start_stop() test conditional

Remove unnecessary test start-up input flushes

Test odp_packet_input_set()

Test user pointer on receive

Do no attempt to continue with invalid queue handle

Add pool cache size tests

Add test for packet pool seg_len parameter

Lockfree queue max_size may be zero

Add new stress test

Fix plain+sched test

Test odp_schedule_group_create() with non-zero mask

Add reserve flag tests

Fix printf format types for pointers

Add tests for the new API

Add test for ODP_CACHE_LINE_ROUNDUP

Add version macro test

Call version string functions

Cpu cycle counter may not be supported

Make odp_cpu_hz_max() tests conditional

Timeout tick equals requested tick

Always initialize odp_timer_pool_param_t contents

Fix shaper profile parameter check

Init structs between tests

Added tests for missing packet functions

Removed -c command line option

Added number of packets option -n

Added packet copy option -p

Added pool per interface option -y

Added VLAN support

Added new simple packet generator test application

Added option for selecting event forwarding mode -f

Increased the number of warm-up and scheduling rounds

Added data touch options -n and -m

Added queue context data touch options -k and -l

Improved test reliability

Added 5 minute aging time to MAC table entries

Added signal handler for SIGINT

Added support for detecting invalid and broadcast ethernet addresses

Improved packet drop statistics printing

Added burst gap option -g

Added mode option -m

Added option -e to retry on too early error

Added output file option -o

Added timer burst option -b

Fixed: Issue 796 seg[0].data MUST return to its initial value on odp_packet_reset

Fixed: Issue 826 max_size requires clarification for ODP_NONBLOCKING_LF and ODP_NONBLOCKING_WF

Fixed: Issue 915 SIGSEGV: example/sysinfo (raspberry Pi 3B+, arm7, odp-linux, gcc 8.2.0)

Fixed: Issue 930 Build failing with GCC 9.2

Fixed: Issue 959 ODP build fails with GCC 10.1

Fixed: crypto: fix session allocation when out of sessions

Fixed: dpdk: DPDK renamed protocol structs

Fixed: dpdk: fix rx/tx checksum offload

Fixed: fix print failures on 32-bit systems

Fixed: pool: fix overflow when creating a huge packet pool

Fixed: pool: rename pool global variable

Fixed: sched scalable: fix pktio ingress queue polling dead lock

Fixed: test: fix global variables that are defined multiple times

Fixed: timer: fix timer pool create sync with inline timer scan

From default CoS to dest IPv4 CoS

From dest IPv4 CoS to dest UDP CoS

From default CoS to dest IPv4 CoS

From dest IPv4 CoS to a parallel UDP CoS per destination port number

odp_packet_data_seg_len()

odp_packet_free_sp()

odp_packet_from_event_multi()

odp_packet_to_event_multi()

odp_packet_subtype()

odp_packet_parse()

odp_packet_parse_multi()

Fixed socket mmap pktio throughput collapse under heavy traffic

Fixed missing config header in install directory

Include only ODP defines in autogenerated header files

Fixed GCC 9 address-of-packed-member warnings

Disable building static test applications without static ODP lib

Fixed a segfault in odp_pktin_recv_mq_tmo() implementation

Fixed classifier vlan match bugs and tests

Fixed classifier matching of parallel PMRs

ODP_CIPHER_ALG_3DES_ECB

ODP_CIPHER_ALG_AES_ECB

ODP_CIPHER_ALG_AES_CFB128

ODP_CIPHER_ALG_AES_XTS

ODP_CIPHER_ALG_AES_EEA2

ODP_AUTH_ALG_SHA224_HMAC

ODP_AUTH_ALG_AES_EIA2

ODP_AUTH_ALG_MD5

ODP_AUTH_ALG_SHA1

ODP_AUTH_ALG_SHA224

ODP_AUTH_ALG_SHA256

ODP_AUTH_ALG_SHA384

ODP_AUTH_ALG_SHA512

ODP_TIME_MIN_IN_NS

ODP_TIME_HOUR_IN_NS

ODPH_VERSION_GENERATION

ODPH_VERSION_MAJOR

ODPH_VERSION_MINOR

ODPH_DEBUG is 1 when helper debugging is enabled (--enable-helper-debug)

ODPH_DEBUG_PRINT is 1 when helper debug printing is enabled (--enable-helper-debug-print)

ODPH_ASSERT() generates assertion code when helper debugging is enabled

Fixed: Issue 827 API doc links are not working

Fixed: Issue 817 ODP fails to compile with latest OpenSSL

Fixed: Issue 784 Bus error

Fixed build problems on Debian 8

Fixed AES-GMAC with OpenSSL 1.1.1b and later

Fixed out-of-tree build

Fixed pcapng pipe read permissions and made possible to capture traffic from multiple interfaces

Latest version of netmap nm_ring_empty() implementation has changed. PktIO netmap support updated to support this as well as previous releases.

Improved compatibility of PktIO socket support with latest versions of the clang compiler.

Add match pattern for missing DPDK PMD drivers for improved compatibility.

Fixed enq/deq issues encountered on architectures with weak memory ordering.

Return 0 from odp_sys_huge_page_size_all() if hugepages are not supported/detected. Tests modified to not treat this as an error.

Set ODP_CACHE_LINE_SIZE to 128 on ppc64le systems.

iplookuptable fix putting values into table

DPDK pktio support now works properly across multiple ODP instances.

Zero timer pool memory on reserve (fixes timer failures due to uninitialized variables).

-march=native disabled for clang. This fixes a known issue with recent levels of clang.

ODP_SCHEDULER=basic Explicitly selects the default scheduler

ODP_SCHEDULER=sp Selects the strict priority scheduler

ODP_SCHEDULER=iquery Selects the iQuery scheduler

ODP_SCHEDULER=scalable Selects the scalable scheduler

odp_packet_l2_offset()

odp_packet_l2_ptr()

odp_packet_l3_offset()

odp_packet_l3_ptr()

odp_packet_l4_offset()

odp_packet_l4_ptr()

The odp_scheduling performance test now handles dequeueing from potentially concurrent queues properly.

The traffic manager and time tests are now invoked via scripts to better account for load-sensitivity when running regressions in CI environments.

The l2fwd test now supports an additional parameter to specify the number of scheduling groups to use in the test.

The odp_sched_latency performance test now handles queue draining in a robust manner.

The crypto validation tests now properly check and validate message digests, and include negative tests to verify that incorrect digests are properly flagged. Note that this may expose omissions in other ODP implementations that had previously passed this validation test.

The crypto validation test now adds an explicit test for the NULL cipher, as well as HMAC-SHA-1 and HMAC-SHA-512.

The pktio_ipc test now properly cleans up only its own temp files.

The odp_generator example now properly honors stop criteria based on number of packets sent.

The odp_generator example now properly flushes output messages

The odp_generator example now supports port configuration.

monospace font is now indicated by demarking the text with backticks (`) rather than plus signs (+).

Callouts are now indicated by C++-style double slash comments (// <1>) instead of C-style comments (/* <1> */). So, for example writing

Move to capabilite structures: The classification, crypto, pktio, pool, queue, shared memory, and traffic manager areas all add new APIs to query implementation-specific capability limits for enhanced program portability.

Addition of a structure that defines system level classification capability

Addition of range PMRs to complement the existing value PMRs to permit application to specify classification rules over a range of values.

Provides a way to get the available cipher and authentication algorithms.

Adds the ODP_STATIC_ASSERT() API to permit compile-time assertions.

Rename and add new packet copy and move functionality.

Add packet prefetch API for performance optimization.

New APIs to permit packet headroom and tailroom to be extended to additional segments or truncated as needed.

Align an area of packet data (e.g. IP/UDP headers) so that it is contiguous in memory and starts in a specified minimum alignment.

Add packet time stamp metadata support.

Add packet input index metadata support to allow application context to be anchored from the associated interface that received the packet.

Deprecation and removal of segment-level buffer APIs that are now superseded by additional packet-level manipulation APIs discussed above.

Replaced config definition for maximum pktio entries with maximum packet IO index call

Added the classify_enable bit to the odp_pktin_queue_param_t that allows applications to explicitly control which pktin queues are subject to full classifier support.

Addition of pktin configuration options to control packet timestamping and checksum validation processing.

Addition of pktout configuration options to control packet checksum offload processing.

Add the ability to query (via capabilities) whether a pktio interface supports operating in loopback mode and if so to enable/disable this mode of operation.

Round out the polling APIs be adding the ability to receive packets in poll mode from one or more pktin queues with timeout.

Add the ability to set the pktio interface index for ease of setting up application context areas associated with each pktio.

Add the ability to inqure the timestamp resolution associated with pktio interfaces that support packet timestamping.

Add a queue capability API to query system-wide queue capabilities and limits.

Extend queue context with an explicit data length parameter that serves as a performance hint for the amount of context to prefetch when the scheduler selects an event from a scheduled queue.

Add the ability to query information about a defined scheduler group

Add a capability inquiry API to obtain implementation shared memory limits.

Add a capability inquiry API to obtain implementation traffic mngr limits.

Split TOS marking into two separate calls.

Add new APIs to support VLAN, ECN, and drop precedence marking.

Add destroy APIs for shapers, scheduler profiles, thresholds, WRED profiles, TM queues, and TM nodes for symmetry and completeness to allow applications to terminate gracefully without resource leakage.

Add the ability to disconnect TM queues from their fanouts.

Add TM node contexts to permit applications to anchor user context areas to TM nodes.

Add the ability to query info about TM node fanins and TM queues.

Deprecate and remove the odp_tm_periodic_update() API

More complete and correct checksum implementation