rte_mbuf_pool_ops.h File Reference

Go to the source code of this file.

Functions
int	rte_mbuf_set_platform_mempool_ops (const char *ops_name)
const char *	rte_mbuf_platform_mempool_ops (void)
int	rte_mbuf_set_user_mempool_ops (const char *ops_name)
const char *	rte_mbuf_user_mempool_ops (void)
const char *	rte_mbuf_best_mempool_ops (void)

Detailed Description

RTE Mbuf Pool Ops

These APIs are for configuring the mbuf pool ops names to be largely used by rte_pktmbuf_pool_create(). However, this can also be used to set and inquire the best mempool ops available.

Definition in file rte_mbuf_pool_ops.h.

Function Documentation

rte_mbuf_set_platform_mempool_ops()

int rte_mbuf_set_platform_mempool_ops

(

const char *

ops_name

)

Set the platform supported pktmbuf HW mempool ops name

This function allow the HW to register the actively supported HW mempool ops_name. Only one HW mempool ops can be registered at any point of time.

Parameters

ops_name

Returns

• On success, zero.
• On failure, a negative value.

rte_mbuf_platform_mempool_ops()

const char* rte_mbuf_platform_mempool_ops

(

void

)

Get configured platform supported pktmbuf HW mempool ops name

This function returns the platform supported mempool ops name.

Returns

• On success, platform pool ops name.
• On failure, NULL.

rte_mbuf_set_user_mempool_ops()

int rte_mbuf_set_user_mempool_ops

(

const char *

ops_name

)

Set the user preferred pktmbuf mempool ops name

This function can be used by the user to configure user preferred mempool ops name.

Parameters

ops_name

Returns

• On success, zero.
• On failure, a negative value.

rte_mbuf_user_mempool_ops()

const char* rte_mbuf_user_mempool_ops

(

void

)

Get user preferred pool ops name for mbuf

This function returns the user configured mempool ops name.

Returns

• On success, user pool ops name..
• On failure, NULL.

rte_mbuf_best_mempool_ops()

const char* rte_mbuf_best_mempool_ops

(

void

)

Get the best mempool ops name for pktmbuf.

This function is used to determine the best options for mempool ops for pktmbuf allocations. Following are the priority order:

1. User defined, 2. Platform HW supported, 3. Compile time configured. This function is also used by the rte_pktmbuf_pool_create to get the best mempool ops name.

Returns

returns preferred mbuf pool ops name

Examples:

examples/ntb/ntb_fwd.c.