rte_lcore.h File Reference

#include <rte_config.h>
#include <rte_per_lcore.h>
#include <rte_eal.h>
#include <rte_launch.h>

Go to the source code of this file.

Data Structures
struct	lcore_config

Macros
#define	LCORE_ID_ANY   UINT32_MAX
#define	RTE_LCORE_FOREACH(i)
#define	RTE_LCORE_FOREACH_SLAVE(i)

Functions
	RTE_DECLARE_PER_LCORE (unsigned, _lcore_id)
	RTE_DECLARE_PER_LCORE (rte_cpuset_t, _cpuset)
static unsigned	rte_lcore_id (void)
static unsigned	rte_get_master_lcore (void)
static unsigned	rte_lcore_count (void)
static int	rte_lcore_index (int lcore_id)
unsigned	rte_socket_id (void)
static unsigned	rte_lcore_to_socket_id (unsigned lcore_id)
static int	rte_lcore_is_enabled (unsigned lcore_id)
static unsigned	rte_get_next_lcore (unsigned i, int skip_master, int wrap)
int	rte_thread_set_affinity (rte_cpuset_t *cpusetp)
void	rte_thread_get_affinity (rte_cpuset_t *cpusetp)
int	rte_thread_setname (pthread_t id, const char *name)
int	rte_lcore_has_role (unsigned int lcore_id, enum rte_lcore_role_t role)

Variables
struct lcore_config	lcore_config [RTE_MAX_LCORE]

Detailed Description

API for lcore and socket manipulation

Definition in file rte_lcore.h.

Macro Definition Documentation

#define LCORE_ID_ANY   UINT32_MAX

Any lcore.

Definition at line 52 of file rte_lcore.h.

#define RTE_LCORE_FOREACH

(

i

)

Value:

for (i = rte_get_next_lcore(-1, 0, 0);              \
         i<RTE_MAX_LCORE;                       \
         i = rte_get_next_lcore(i, 0, 0))

Macro to browse all running lcores.

Examples:

examples/exception_path/main.c, examples/ipv4_multicast/main.c, examples/l2fwd-jobstats/main.c, examples/multi_process/symmetric_mp/main.c, examples/vm_power_manager/guest_cli/main.c, and examples/vm_power_manager/guest_cli/vm_power_cli_guest.c.

Definition at line 218 of file rte_lcore.h.

#define RTE_LCORE_FOREACH_SLAVE

(

i

)

Value:

for (i = rte_get_next_lcore(-1, 1, 0);              \
         i<RTE_MAX_LCORE;                       \
         i = rte_get_next_lcore(i, 1, 0))

Macro to browse all running lcores except the master lcore.

Examples:

examples/bond/main.c, examples/distributor/main.c, examples/ethtool/ethtool-app/main.c, examples/eventdev_pipeline_sw_pmd/main.c, examples/exception_path/main.c, examples/helloworld/main.c, examples/ip_fragmentation/main.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/main.c, examples/link_status_interrupt/main.c, examples/load_balancer/main.c, examples/multi_process/l2fwd_fork/flib.c, examples/multi_process/simple_mp/main.c, examples/packet_ordering/main.c, examples/performance-thread/l3fwd-thread/main.c, examples/performance-thread/pthread_shim/main.c, examples/qos_meter/main.c, examples/tep_termination/main.c, examples/timer/main.c, examples/vhost/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 226 of file rte_lcore.h.

Function Documentation

RTE_DECLARE_PER_LCORE	(	unsigned	,
		_lcore_id
	)

Per thread "lcore id".

RTE_DECLARE_PER_LCORE	(	rte_cpuset_t	,
		_cpuset
	)

Per thread "cpuset".

static unsigned rte_lcore_id ( void  )

inlinestatic

Return the ID of the execution unit we are running on.

Returns

Logical core ID (in EAL thread) or LCORE_ID_ANY (in non-EAL thread)

Examples:

examples/bond/main.c, examples/distributor/main.c, examples/ethtool/ethtool-app/main.c, examples/eventdev_pipeline_sw_pmd/main.c, examples/exception_path/main.c, examples/flow_classify/flow_classify.c, examples/helloworld/main.c, examples/ip_fragmentation/main.c, examples/ip_pipeline/thread.c, examples/ip_reassembly/main.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipsec-secgw/ipsec.c, examples/ipv4_multicast/main.c, examples/kni/main.c, examples/l2fwd-cat/l2fwd-cat.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/l3fwd_lpm.c, examples/link_status_interrupt/main.c, examples/load_balancer/runtime.c, examples/multi_process/client_server_mp/mp_server/main.c, examples/multi_process/l2fwd_fork/flib.c, examples/multi_process/l2fwd_fork/main.c, examples/multi_process/simple_mp/main.c, examples/multi_process/symmetric_mp/main.c, examples/packet_ordering/main.c, examples/performance-thread/common/lthread.c, examples/performance-thread/common/lthread_diag.c, examples/performance-thread/common/lthread_sched.c, examples/performance-thread/l3fwd-thread/main.c, examples/performance-thread/pthread_shim/main.c, examples/ptpclient/ptpclient.c, examples/qos_meter/main.c, examples/qos_sched/main.c, examples/quota_watermark/qw/main.c, examples/rxtx_callbacks/main.c, examples/server_node_efd/server/main.c, examples/skeleton/basicfwd.c, examples/tep_termination/main.c, examples/timer/main.c, examples/vhost/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 94 of file rte_lcore.h.

static unsigned rte_get_master_lcore ( void  )

inlinestatic

Get the id of the master lcore

Returns

the id of the master lcore

Examples:

examples/l2fwd-crypto/main.c, examples/l2fwd/main.c, examples/l3fwd-vf/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/qos_sched/args.c, and examples/quota_watermark/qw/main.c.

Definition at line 106 of file rte_lcore.h.

static unsigned rte_lcore_count ( void  )

inlinestatic

Return the number of execution units (lcores) on the system.

Returns

the number of execution units (lcores) on the system.

Examples:

examples/distributor/main.c, examples/ethtool/ethtool-app/main.c, examples/eventdev_pipeline_sw_pmd/main.c, examples/flow_classify/flow_classify.c, examples/ip_fragmentation/main.c, examples/ip_reassembly/main.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipv4_multicast/main.c, examples/l2fwd-cat/l2fwd-cat.c, examples/l3fwd-acl/main.c, examples/l3fwd-power/main.c, examples/l3fwd-vf/main.c, examples/l3fwd/main.c, examples/packet_ordering/main.c, examples/performance-thread/l3fwd-thread/main.c, examples/ptpclient/ptpclient.c, examples/qos_meter/main.c, examples/quota_watermark/qw/args.c, examples/rxtx_callbacks/main.c, examples/skeleton/basicfwd.c, examples/tep_termination/main.c, examples/tep_termination/vxlan_setup.c, examples/vhost/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

Definition at line 118 of file rte_lcore.h.

static int rte_lcore_index ( int  lcore_id )

inlinestatic

Return the index of the lcore starting from zero. The order is physical or given by command line (-l option).

Parameters

lcore_id

The targeted lcore, or -1 for the current one.

Returns

The relative index, or -1 if not enabled.

Examples:

examples/performance-thread/common/lthread_sched.c.

Definition at line 134 of file rte_lcore.h.

unsigned rte_socket_id

(

void

)

Return the ID of the physical socket of the logical core we are running on.

Returns

the ID of current lcoreid's physical socket

Examples:

examples/bond/main.c, examples/distributor/main.c, examples/ethtool/ethtool-app/main.c, examples/ethtool/lib/rte_ethtool.c, examples/eventdev_pipeline_sw_pmd/main.c, examples/exception_path/main.c, examples/flow_classify/flow_classify.c, examples/flow_filtering/main.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipv4_multicast/main.c, examples/kni/main.c, examples/l2fwd-cat/l2fwd-cat.c, examples/l2fwd-crypto/main.c, examples/l2fwd-jobstats/main.c, examples/l2fwd-keepalive/main.c, examples/l2fwd/main.c, examples/link_status_interrupt/main.c, examples/multi_process/client_server_mp/mp_server/init.c, examples/multi_process/l2fwd_fork/main.c, examples/multi_process/simple_mp/main.c, examples/multi_process/symmetric_mp/main.c, examples/netmap_compat/bridge/bridge.c, examples/packet_ordering/main.c, examples/performance-thread/common/lthread_sched.c, examples/ptpclient/ptpclient.c, examples/qos_meter/main.c, examples/quota_watermark/qw/init.c, examples/quota_watermark/qw/main.c, examples/rxtx_callbacks/main.c, examples/server_node_efd/node/node.c, examples/server_node_efd/server/init.c, examples/server_node_efd/server/main.c, examples/skeleton/basicfwd.c, examples/tep_termination/main.c, examples/vhost/main.c, examples/vm_power_manager/main.c, examples/vmdq/main.c, and examples/vmdq_dcb/main.c.

static unsigned rte_lcore_to_socket_id ( unsigned  lcore_id )

inlinestatic

Get the ID of the physical socket of the specified lcore

Parameters

lcore_id

the targeted lcore, which MUST be between 0 and RTE_MAX_LCORE-1.

Returns

the ID of lcoreid's physical socket

Examples:

examples/ip_fragmentation/main.c, examples/ip_reassembly/main.c, examples/ipsec-secgw/ipsec-secgw.c, examples/ipv4_multicast/main.c, examples/l3fwd-acl/main.c, examples/l3fwd-power/main.c, examples/l3fwd-vf/main.c, examples/l3fwd/main.c, examples/load_balancer/config.c, examples/load_balancer/init.c, examples/performance-thread/l3fwd-thread/main.c, examples/qos_sched/args.c, and examples/qos_sched/init.c.

Definition at line 160 of file rte_lcore.h.

static int rte_lcore_is_enabled ( unsigned  lcore_id )

inlinestatic

Test if an lcore is enabled.

Parameters

lcore_id

The identifier of the lcore, which MUST be between 0 and RTE_MAX_LCORE-1.

Returns

True if the given lcore is enabled; false otherwise.

Examples:

examples/exception_path/main.c, examples/ip_fragmentation/main.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/main.c, examples/link_status_interrupt/main.c, examples/load_balancer/config.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/performance-thread/pthread_shim/main.c, examples/quota_watermark/qw/main.c, examples/tep_termination/main.c, examples/vhost/main.c, and examples/vmdq/main.c.

Definition at line 175 of file rte_lcore.h.

static unsigned rte_get_next_lcore ( unsigned  i, int  skip_master, int  wrap  )

inlinestatic

Get the next enabled lcore ID.

Parameters

i	The current lcore (reference).
skip_master	If true, do not return the ID of the master lcore.
wrap	If true, go back to 0 when RTE_MAX_LCORE is reached; otherwise, return RTE_MAX_LCORE.

Returns

The next lcore_id or RTE_MAX_LCORE if not found.

Examples:

examples/bond/main.c, examples/ethtool/ethtool-app/main.c, examples/timer/main.c, and examples/vm_power_manager/main.c.

Definition at line 197 of file rte_lcore.h.

int rte_thread_set_affinity

(

rte_cpuset_t *

cpusetp

)

Set core affinity of the current thread. Support both EAL and non-EAL thread and update TLS.

Parameters

cpusetp

Point to cpu_set_t for setting current thread affinity.

Returns

On success, return 0; otherwise return -1;

void rte_thread_get_affinity

(

rte_cpuset_t *

cpusetp

)

Get core affinity of the current thread.

Parameters

cpusetp

Point to cpu_set_t for getting current thread cpu affinity. It presumes input is not NULL, otherwise it causes panic.

int rte_thread_setname	(	pthread_t	id,
		const char *	name
	)

Set thread names.

Note

It fails with glibc < 2.12.

Parameters

id	Thread id.
name	Thread name to set.

Returns

On success, return 0; otherwise return a negative value.

Examples:

examples/tep_termination/main.c, and examples/vhost/main.c.

int rte_lcore_has_role	(	unsigned int	lcore_id,
		enum rte_lcore_role_t	role
	)

Test if the core supplied has a specific role

Parameters

lcore_id	The identifier of the lcore, which MUST be between 0 and RTE_MAX_LCORE-1.
role	The role to be checked against.

Returns

On success, return 0; otherwise return a negative value.

Variable Documentation

struct lcore_config lcore_config[RTE_MAX_LCORE]

Internal configuration (per-lcore)