rte_thread.h

Go to the documentation of this file.

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright(c) 2021 Mellanox Technologies, Ltd
 * Copyright (C) 2022 Microsoft Corporation
 */

#include <pthread.h>
#include <stdint.h>

#include <rte_os.h>
#include <rte_compat.h>

#ifndef _RTE_THREAD_H_
#define _RTE_THREAD_H_

#ifdef __cplusplus
extern "C" {
#endif

#define RTE_THREAD_NAME_SIZE 16
/* Old definition, aliased for compatibility. */
#define RTE_MAX_THREAD_NAME_LEN RTE_THREAD_NAME_SIZE

#define RTE_THREAD_INTERNAL_PREFIX "dpdk-"

#define RTE_THREAD_INTERNAL_NAME_SIZE 11

typedef struct {
    uintptr_t opaque_id; 
} rte_thread_t;

typedef uint32_t (*rte_thread_func) (void *arg);

enum rte_thread_priority {
    RTE_THREAD_PRIORITY_NORMAL            = 0,
    RTE_THREAD_PRIORITY_REALTIME_CRITICAL = 1,
};

typedef struct {
    enum rte_thread_priority priority; 
#ifdef RTE_HAS_CPUSET
    rte_cpuset_t cpuset; 
#endif
} rte_thread_attr_t;

typedef struct eal_tls_key *rte_thread_key;

int rte_thread_create(rte_thread_t *thread_id,
        const rte_thread_attr_t *thread_attr,
        rte_thread_func thread_func, void *arg);

int
rte_thread_create_control(rte_thread_t *thread, const char *name,
        rte_thread_func thread_func, void *arg);

__rte_internal
int
rte_thread_create_internal_control(rte_thread_t *id, const char *name,
        rte_thread_func func, void *arg);

int rte_thread_join(rte_thread_t thread_id, uint32_t *value_ptr);

int rte_thread_detach(rte_thread_t thread_id);

rte_thread_t rte_thread_self(void);

void
rte_thread_set_name(rte_thread_t thread_id, const char *thread_name);

__rte_internal
void
rte_thread_set_prefixed_name(rte_thread_t id, const char *name);

int rte_thread_equal(rte_thread_t t1, rte_thread_t t2);

int rte_thread_attr_init(rte_thread_attr_t *attr);

int rte_thread_attr_set_priority(rte_thread_attr_t *thread_attr,
        enum rte_thread_priority priority);

#ifdef RTE_HAS_CPUSET

int rte_thread_attr_set_affinity(rte_thread_attr_t *thread_attr,
        rte_cpuset_t *cpuset);

int rte_thread_attr_get_affinity(rte_thread_attr_t *thread_attr,
        rte_cpuset_t *cpuset);

int rte_thread_set_affinity_by_id(rte_thread_t thread_id,
        const rte_cpuset_t *cpuset);

int rte_thread_get_affinity_by_id(rte_thread_t thread_id,
        rte_cpuset_t *cpuset);

int rte_thread_set_affinity(rte_cpuset_t *cpusetp);

void rte_thread_get_affinity(rte_cpuset_t *cpusetp);

#endif /* RTE_HAS_CPUSET */

int rte_thread_get_priority(rte_thread_t thread_id,
        enum rte_thread_priority *priority);

int rte_thread_set_priority(rte_thread_t thread_id,
        enum rte_thread_priority priority);

int rte_thread_key_create(rte_thread_key *key,
            void (*destructor)(void *));

int rte_thread_key_delete(rte_thread_key key);

int rte_thread_value_set(rte_thread_key key, const void *value);

void *rte_thread_value_get(rte_thread_key key);

__rte_internal
void rte_thread_mutex_init_shared(pthread_mutex_t *mutex);

#ifdef __cplusplus
}
#endif

#endif /* _RTE_THREAD_H_ */