rte_memory.h File Reference

#include <stdint.h>
#include <stddef.h>
#include <stdio.h>
#include <rte_config.h>
#include <rte_common.h>

Go to the source code of this file.

Data Structures
struct	rte_memseg

Macros
#define	SOCKET_ID_ANY   -1
#define	RTE_CACHE_LINE_MASK   (RTE_CACHE_LINE_SIZE-1)
#define	RTE_CACHE_LINE_ROUNDUP(size)   (RTE_CACHE_LINE_SIZE * ((size + RTE_CACHE_LINE_SIZE - 1) / RTE_CACHE_LINE_SIZE))
#define	RTE_CACHE_LINE_MIN_SIZE   64
#define	__rte_cache_aligned   __rte_aligned(RTE_CACHE_LINE_SIZE)
#define	__rte_cache_min_aligned   __rte_aligned(RTE_CACHE_LINE_MIN_SIZE)

Typedefs
typedef uint64_t	phys_addr_t

Functions
int	rte_mem_lock_page (const void *virt)
phys_addr_t	rte_mem_virt2phy (const void *virt)
struct rte_memseg *	rte_eal_get_physmem_layout (void)
void	rte_dump_physmem_layout (FILE *f)
uint64_t	rte_eal_get_physmem_size (void)
unsigned	rte_memory_get_nchannel (void)
unsigned	rte_memory_get_nrank (void)

Detailed Description

Memory-related RTE API.

Definition in file rte_memory.h.

Macro Definition Documentation

#define SOCKET_ID_ANY   -1

Any NUMA socket.

Examples:

examples/ip_fragmentation/main.c, examples/ip_pipeline/init.c, examples/ip_reassembly/main.c, examples/l2fwd-crypto/main.c, and examples/netmap_compat/bridge/bridge.c.

Definition at line 73 of file rte_memory.h.

#define RTE_CACHE_LINE_MASK   (RTE_CACHE_LINE_SIZE-1)

Cache line mask.

Definition at line 74 of file rte_memory.h.

#define RTE_CACHE_LINE_ROUNDUP

(

size

)

(RTE_CACHE_LINE_SIZE * ((size + RTE_CACHE_LINE_SIZE - 1) / RTE_CACHE_LINE_SIZE))

Return the first cache-aligned value greater or equal to size. Cache line size in terms of log2

Examples:

examples/ip_pipeline/pipeline/pipeline_firewall.c, examples/ip_pipeline/pipeline/pipeline_firewall_be.c, examples/ip_pipeline/pipeline/pipeline_flow_actions.c, examples/ip_pipeline/pipeline/pipeline_flow_actions_be.c, examples/ip_pipeline/pipeline/pipeline_flow_classification.c, examples/ip_pipeline/pipeline/pipeline_flow_classification_be.c, examples/ip_pipeline/pipeline/pipeline_master_be.c, examples/ip_pipeline/pipeline/pipeline_passthrough_be.c, examples/ip_pipeline/pipeline/pipeline_routing.c, and examples/ip_pipeline/pipeline/pipeline_routing_be.c.

Definition at line 76 of file rte_memory.h.

#define RTE_CACHE_LINE_MIN_SIZE   64

Minimum Cache line size.

Definition at line 91 of file rte_memory.h.

struct rte_mempool_ops_table __rte_cache_aligned   __rte_aligned(RTE_CACHE_LINE_SIZE)

Force alignment to cache line.

Examples:

examples/bond/main.c, examples/distributor/main.c, examples/ip_fragmentation/main.c, examples/ip_pipeline/pipeline/pipeline_firewall_be.c, examples/ip_pipeline/pipeline/pipeline_flow_actions.c, examples/ip_pipeline/pipeline/pipeline_flow_actions_be.c, examples/ip_pipeline/pipeline/pipeline_flow_classification_be.c, examples/ip_pipeline/pipeline/pipeline_master_be.c, examples/ip_pipeline/pipeline/pipeline_passthrough_be.c, examples/ip_pipeline/pipeline/pipeline_routing_be.c, examples/ip_reassembly/main.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipv4_multicast/main.c, examples/kni/main.c, examples/l2fwd-crypto/main.c, examples/l2fwd-jobstats/main.c, examples/l2fwd-keepalive/main.c, examples/l2fwd/main.c, examples/l3fwd-acl/main.c, examples/l3fwd-power/main.c, examples/l3fwd-vf/main.c, examples/l3fwd/l3fwd_em.c, examples/l3fwd/main.c, examples/link_status_interrupt/main.c, examples/multi_process/l2fwd_fork/flib.c, examples/multi_process/l2fwd_fork/main.c, examples/packet_ordering/main.c, examples/performance-thread/l3fwd-thread/main.c, examples/qos_sched/app_thread.c, examples/vhost_xen/main.c, and examples/vm_power_manager/power_manager.c.

Definition at line 96 of file rte_memory.h.

struct rte_eth_txq_info __rte_cache_min_aligned   __rte_aligned(RTE_CACHE_LINE_MIN_SIZE)

Force minimum cache line alignment.

Definition at line 101 of file rte_memory.h.

Typedef Documentation

typedef uint64_t phys_addr_t

Physical address definition.

Definition at line 103 of file rte_memory.h.

Function Documentation

int rte_mem_lock_page

(

const void *

virt

)

Lock page in physical memory and prevent from swapping.

Parameters

virt	The virtual address.

Returns

0 on success, negative on error.

phys_addr_t rte_mem_virt2phy

(

const void *

virt

)

Get physical address of any mapped virtual address in the current process. It is found by browsing the /proc/self/pagemap special file. The page must be locked.

Parameters

virt	The virtual address.

Returns

The physical address or RTE_BAD_PHYS_ADDR on error.

struct rte_memseg* rte_eal_get_physmem_layout ( void  )

read

Get the layout of the available physical memory.

It can be useful for an application to have the full physical memory layout to decide the size of a memory zone to reserve. This table is stored in rte_config (see rte_eal_get_configuration()).

Returns

• On success, return a pointer to a read-only table of struct rte_physmem_desc elements, containing the layout of all addressable physical memory. The last element of the table contains a NULL address.
• On error, return NULL. This should not happen since it is a fatal error that will probably cause the entire system to panic.

void rte_dump_physmem_layout

(

FILE *

f

)

Dump the physical memory layout to a file.

Parameters

f	A pointer to a file for output

uint64_t rte_eal_get_physmem_size

(

void

)

Get the total amount of available physical memory.

Returns

The total amount of available physical memory in bytes.

unsigned rte_memory_get_nchannel

(

void

)

Get the number of memory channels.

Returns

The number of memory channels on the system. The value is 0 if unknown or not the same on all devices.

unsigned rte_memory_get_nrank

(

void

)

Get the number of memory ranks.

Returns

The number of memory ranks on the system. The value is 0 if unknown or not the same on all devices.