David Marchand b41befd3af eal: add lcore iterators
Add a helper to iterate all lcores.
The iterator callback is read-only wrt the lcores list.

Implement a dump function on top of this for debugging.

Signed-off-by: David Marchand <david.marchand@redhat.com>
Reviewed-by: Olivier Matz <olivier.matz@6wind.com>
Acked-by: Konstantin Ananyev <konstantin.ananyev@intel.com>
2020-07-08 14:41:06 +02:00

62 lines
1.3 KiB
C

/* SPDX-License-Identifier: BSD-3-Clause
* Copyright(c) 2010-2014 Intel Corporation
*/
#ifndef EAL_THREAD_H
#define EAL_THREAD_H
#include <rte_lcore.h>
/**
* basic loop of thread, called for each thread by eal_init().
*
* @param arg
* opaque pointer
*/
__rte_noreturn void *eal_thread_loop(void *arg);
/**
* Get the NUMA socket id from cpu id.
* This function is private to EAL.
*
* @param cpu_id
* The logical process id.
* @return
* socket_id or SOCKET_ID_ANY
*/
unsigned eal_cpu_socket_id(unsigned cpu_id);
/**
* Default buffer size to use with eal_thread_dump_affinity()
*/
#define RTE_CPU_AFFINITY_STR_LEN 256
/**
* Dump the cpuset as a human readable string.
* This function is private to EAL.
*
* Note:
* If the dump size is greater than the size of given buffer,
* the string will be truncated and with '\0' at the end.
*
* @param cpuset
* The CPU affinity object to dump.
* @param str
* The string buffer the cpuset will dump to.
* @param size
* The string buffer size.
* @return
* 0 for success, -1 if truncation happens.
*/
int
eal_thread_dump_affinity(rte_cpuset_t *cpuset, char *str, unsigned int size);
/**
* Dump the current thread cpuset.
* This is a wrapper on eal_thread_dump_affinity().
*/
int
eal_thread_dump_current_affinity(char *str, unsigned int size);
#endif /* EAL_THREAD_H */