d/numam-dpdk
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

mem: document callbacks not being supported in some cases

Browse Source 
Mem event and validator callbacks may not be supported under all
circumstances (such as when running in legacy memory mode, or on
FreeBSD), and this case needs to be handled by any code that will
use these callbacks. Spell this out more clearly, because it's not
immediately obvious that this is an expected use case.

Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com>
This commit is contained in:
Anatoly Burakov 2018-05-25 14:39:44 +01:00 committed by Thomas Monjalon
parent e22266669e
commit 0d0ad70175
1 changed files with 8 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
lib/librte_eal/common/include/rte_memory.h
View File

@ -339,6 +339,10 @@ typedef void (*rte_mem_event_callback_t)(enum rte_mem_event event_type,
* therefore some functions (e.g. `rte_memseg_walk()`) will cause a
* deadlock when called from within such callbacks.
*
* @note mem event callbacks not being supported is an expected error condition,
* so user code needs to handle this situation. In these cases, return
* value will be -1, and rte_errno will be set to ENOTSUP.
*
* @param name
* Name associated with specified callback to be added to the list.
*
@ -399,6 +403,10 @@ typedef int (*rte_mem_alloc_validator_t)(int socket_id,
* therefore some functions (e.g. `rte_memseg_walk()`) will cause a
* deadlock when called from within such callbacks.
*
* @note validator callbacks not being supported is an expected error condition,
* so user code needs to handle this situation. In these cases, return
* value will be -1, and rte_errno will be set to ENOTSUP.
*
* @param name
* Name associated with specified callback to be added to the list.
*