Patches #1 and #2: odp_cpumask_to_str(), odp_pktio_mac_addr() follows and extends the model of odp_hw_random_get() where output buffer size is passed by reference and the variable is updated with the number of bytes written on success or the minimum required buffer size should it be too small. Updated the implementations of these calls. Updated all usages of these calls in example and test programs.
Patches #1-#15: Updated doxygen descriptions, particularly the @return/@retval descriptions. No change of implementation necessary. Specifically documented those API calls which are guaranteed to handle invalid/stale handles. Patch #16: Changed the definition of odp_queue_enq_multi() to support partial success (e.g. enqueued some but not all of the events specified). Returns the number of events enqueued (equivalent to odp_queue_deq_multi()). This change is necessary to support ODP implementations that use fixed size queues (e.g. ODP linux-dpdk). Updated the implementation in odp_queue.c to conform to the new semantics. Updated the necessary test/validation/performance programs. (This document/code contribution attached is provided under the terms of agreement LES-LTM-21309) Ola Liljedahl (16): api: odp_cpumask.h: odp_cpumask_to_str() return bufsz api: odp_pktio.h: odp_pktio_mac_addr() return bufsz api: odp_crypto.h: return descriptions api: odp_buffer.h: undefined behavior description api: odp_byteorder.h: updated comment api: odp_classification.h: updated return descriptions api: odp_init.h: updated return descriptions api: odp_packet.h: updated return descriptions api: odp_packet_flags.h: updated return descriptions api: odp_packet_io.h: updated return descriptions api: odp_queue.h: updated return descriptions api: odp_schedule.h: updated return descriptions api: odp_shared_memory.h: updated return descriptions api: odp_thread.h: updated return descriptions api: odp_timer.h: updated return descriptions api: odp_queue.h: odp_queue_enq_multi() returns partial success example/generator/odp_generator.c | 5 +- example/ipsec/odp_ipsec.c | 5 +- example/l2fwd/odp_l2fwd.c | 5 +- example/packet/odp_pktio.c | 5 +- example/timer/odp_timer_test.c | 5 +- platform/linux-generic/include/api/odp_buffer.h | 4 +- platform/linux-generic/include/api/odp_byteorder.h | 2 +- .../linux-generic/include/api/odp_classification.h | 48 ++++++---- platform/linux-generic/include/api/odp_cpumask.h | 103 ++++++++++++-------- platform/linux-generic/include/api/odp_crypto.h | 22 +++-- platform/linux-generic/include/api/odp_init.h | 20 ++-- platform/linux-generic/include/api/odp_packet.h | 68 ++++++++------ .../linux-generic/include/api/odp_packet_flags.h | 57 +++++++---- platform/linux-generic/include/api/odp_packet_io.h | 104 ++++++++++++--------- platform/linux-generic/include/api/odp_queue.h | 38 +++++--- platform/linux-generic/include/api/odp_schedule.h | 3 +- .../linux-generic/include/api/odp_shared_memory.h | 17 ++-- platform/linux-generic/include/api/odp_thread.h | 6 +- platform/linux-generic/include/api/odp_timer.h | 52 ++++------- platform/linux-generic/odp_cpumask.c | 34 ++++--- platform/linux-generic/odp_packet_io.c | 21 +++-- platform/linux-generic/odp_queue.c | 4 +- test/api_test/odp_common.c | 5 +- test/performance/odp_scheduling.c | 15 ++- test/validation/odp_pktio.c | 41 +++++--- test/validation/odp_queue.c | 3 +- 26 files changed, 401 insertions(+), 291 deletions(-) -- 1.9.1 _______________________________________________ lng-odp mailing list [email protected] http://lists.linaro.org/mailman/listinfo/lng-odp
