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

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 23 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 201 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/bbdev_app/main.c, examples/bond/main.c, examples/distributor/main.c, examples/ethtool/ethtool-app/main.c, examples/eventdev_pipeline/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 209 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 Application thread ID of the execution unit.

Note: in most cases the lcore id returned here will also correspond to the processor id of the CPU on which the thread is pinned, this will not be the case if the user has explicitly changed the thread to core affinities using –lcores EAL argument e.g. –lcores '(0-3)@10' to run threads with lcore IDs 0, 1, 2 and 3 on physical core 10..

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/main.c, examples/eventdev_pipeline/pipeline_worker_generic.c, examples/eventdev_pipeline/pipeline_worker_tx.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 72 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/bbdev_app/main.c, 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 84 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/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 96 of file rte_lcore.h.

static int rte_lcore_index ( int lcore_id )

inlinestatic

Return the index of the lcore starting from zero.

When option -c or -l is given, the index corresponds to the order in the list. For example: -c 0x30, lcore 4 has index 0, and 5 has index 1. -l 22,18 lcore 22 has index 0, and 18 has index 1.

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 117 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/bbdev_app/main.c, examples/bond/main.c, examples/distributor/main.c, examples/ethtool/ethtool-app/main.c, examples/ethtool/lib/rte_ethtool.c, examples/eventdev_pipeline/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 143 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/bbdev_app/main.c, 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 158 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 180 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)

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

Function Documentation

Variable Documentation