2e378ff297
This API will enable application to register for notifications on page allocations that are about to happen, giving the application a chance to allow or deny the allocation when total memory utilization as a result would be above specified limit on specified socket. Signed-off-by: Anatoly Burakov <anatoly.burakov@intel.com> Tested-by: Santosh Shukla <santosh.shukla@caviumnetworks.com> Tested-by: Hemant Agrawal <hemant.agrawal@nxp.com> Tested-by: Gowrishankar Muthukrishnan <gowrishankar.m@linux.vnet.ibm.com>
80 lines
1.9 KiB
C
80 lines
1.9 KiB
C
/* SPDX-License-Identifier: BSD-3-Clause
|
|
* Copyright(c) 2017-2018 Intel Corporation
|
|
*/
|
|
|
|
#ifndef EAL_MEMALLOC_H
|
|
#define EAL_MEMALLOC_H
|
|
|
|
#include <stdbool.h>
|
|
|
|
#include <rte_memory.h>
|
|
#include <rte_eal_memconfig.h>
|
|
|
|
/*
|
|
* Allocate segment of specified page size.
|
|
*/
|
|
struct rte_memseg *
|
|
eal_memalloc_alloc_seg(size_t page_sz, int socket);
|
|
|
|
/*
|
|
* Allocate `n_segs` segments.
|
|
*
|
|
* Note: `ms` can be NULL.
|
|
*
|
|
* Note: it is possible to request best-effort allocation by setting `exact` to
|
|
* `false`, in which case allocator will return however many pages it managed to
|
|
* allocate successfully.
|
|
*/
|
|
int
|
|
eal_memalloc_alloc_seg_bulk(struct rte_memseg **ms, int n_segs, size_t page_sz,
|
|
int socket, bool exact);
|
|
|
|
/*
|
|
* Deallocate segment
|
|
*/
|
|
int
|
|
eal_memalloc_free_seg(struct rte_memseg *ms);
|
|
|
|
/*
|
|
* Deallocate `n_segs` segments. Returns 0 on successful deallocation of all
|
|
* segments, returns -1 on error. Any segments that could have been deallocated,
|
|
* will be deallocated even in case of error.
|
|
*/
|
|
int
|
|
eal_memalloc_free_seg_bulk(struct rte_memseg **ms, int n_segs);
|
|
|
|
/*
|
|
* Check if memory pointed to by `start` and of `length` that resides in
|
|
* memseg list `msl` is IOVA-contiguous.
|
|
*/
|
|
bool
|
|
eal_memalloc_is_contig(const struct rte_memseg_list *msl, void *start,
|
|
size_t len);
|
|
|
|
/* synchronize local memory map to primary process */
|
|
int
|
|
eal_memalloc_sync_with_primary(void);
|
|
|
|
int
|
|
eal_memalloc_mem_event_callback_register(const char *name,
|
|
rte_mem_event_callback_t clb);
|
|
|
|
int
|
|
eal_memalloc_mem_event_callback_unregister(const char *name);
|
|
|
|
void
|
|
eal_memalloc_mem_event_notify(enum rte_mem_event event, const void *start,
|
|
size_t len);
|
|
|
|
int
|
|
eal_memalloc_mem_alloc_validator_register(const char *name,
|
|
rte_mem_alloc_validator_t clb, int socket_id, size_t limit);
|
|
|
|
int
|
|
eal_memalloc_mem_alloc_validator_unregister(const char *name, int socket_id);
|
|
|
|
int
|
|
eal_memalloc_mem_alloc_validate(int socket_id, size_t new_len);
|
|
|
|
#endif /* EAL_MEMALLOC_H */
|