kernel: move thread definitions to thread.h
Move thread definitions to its own header to avoid redeclaration and redefinition of types which is not allowed in some standards. Fixes #29937 Signed-off-by: Anas Nashif <anas.nashif@intel.com>
This commit is contained in:
Anas Nashif
parent
ca0e5df219
commit
fc1b5de4c3
4 changed files with 323 additions and 314 deletions
|
|
@ -12,15 +12,12 @@
|
||||||
#include <stddef.h>
|
#include <stddef.h>
|
||||||
#include <sys/dlist.h>
|
#include <sys/dlist.h>
|
||||||
#include <toolchain.h>
|
#include <toolchain.h>
|
||||||
|
#include <kernel/thread.h>
|
||||||
|
|
||||||
#ifdef __cplusplus
|
#ifdef __cplusplus
|
||||||
extern "C" {
|
extern "C" {
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
/* Forward declaration */
|
|
||||||
struct k_thread;
|
|
||||||
typedef struct k_thread *k_tid_t;
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @defgroup mem_domain_apis Memory domain APIs
|
* @defgroup mem_domain_apis Memory domain APIs
|
||||||
* @ingroup kernel_apis
|
* @ingroup kernel_apis
|
||||||
|
|
|
||||||
314
include/kernel.h
314
include/kernel.h
|
|
@ -114,322 +114,16 @@ struct k_mem_domain;
|
||||||
struct k_mem_partition;
|
struct k_mem_partition;
|
||||||
struct k_futex;
|
struct k_futex;
|
||||||
|
|
||||||
/**
|
|
||||||
* @typedef k_thread_entry_t
|
|
||||||
* @brief Thread entry point function type.
|
|
||||||
*
|
|
||||||
* A thread's entry point function is invoked when the thread starts executing.
|
|
||||||
* Up to 3 argument values can be passed to the function.
|
|
||||||
*
|
|
||||||
* The thread terminates execution permanently if the entry point function
|
|
||||||
* returns. The thread is responsible for releasing any shared resources
|
|
||||||
* it may own (such as mutexes and dynamically allocated memory), prior to
|
|
||||||
* returning.
|
|
||||||
*
|
|
||||||
* @param p1 First argument.
|
|
||||||
* @param p2 Second argument.
|
|
||||||
* @param p3 Third argument.
|
|
||||||
*
|
|
||||||
* @return N/A
|
|
||||||
*/
|
|
||||||
|
|
||||||
#ifdef CONFIG_THREAD_MONITOR
|
|
||||||
struct __thread_entry {
|
|
||||||
k_thread_entry_t pEntry;
|
|
||||||
void *parameter1;
|
|
||||||
void *parameter2;
|
|
||||||
void *parameter3;
|
|
||||||
};
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/* can be used for creating 'dummy' threads, e.g. for pending on objects */
|
|
||||||
struct _thread_base {
|
|
||||||
|
|
||||||
/* this thread's entry in a ready/wait queue */
|
|
||||||
union {
|
|
||||||
sys_dnode_t qnode_dlist;
|
|
||||||
struct rbnode qnode_rb;
|
|
||||||
};
|
|
||||||
|
|
||||||
/* wait queue on which the thread is pended (needed only for
|
|
||||||
* trees, not dumb lists)
|
|
||||||
*/
|
|
||||||
_wait_q_t *pended_on;
|
|
||||||
|
|
||||||
/* user facing 'thread options'; values defined in include/kernel.h */
|
|
||||||
uint8_t user_options;
|
|
||||||
|
|
||||||
/* thread state */
|
|
||||||
uint8_t thread_state;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* scheduler lock count and thread priority
|
|
||||||
*
|
|
||||||
* These two fields control the preemptibility of a thread.
|
|
||||||
*
|
|
||||||
* When the scheduler is locked, sched_locked is decremented, which
|
|
||||||
* means that the scheduler is locked for values from 0xff to 0x01. A
|
|
||||||
* thread is coop if its prio is negative, thus 0x80 to 0xff when
|
|
||||||
* looked at the value as unsigned.
|
|
||||||
*
|
|
||||||
* By putting them end-to-end, this means that a thread is
|
|
||||||
* non-preemptible if the bundled value is greater than or equal to
|
|
||||||
* 0x0080.
|
|
||||||
*/
|
|
||||||
union {
|
|
||||||
struct {
|
|
||||||
#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
|
|
||||||
uint8_t sched_locked;
|
|
||||||
int8_t prio;
|
|
||||||
#else /* LITTLE and PDP */
|
|
||||||
int8_t prio;
|
|
||||||
uint8_t sched_locked;
|
|
||||||
#endif
|
|
||||||
};
|
|
||||||
uint16_t preempt;
|
|
||||||
};
|
|
||||||
|
|
||||||
#ifdef CONFIG_SCHED_DEADLINE
|
|
||||||
int prio_deadline;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
uint32_t order_key;
|
|
||||||
|
|
||||||
#ifdef CONFIG_SMP
|
|
||||||
/* True for the per-CPU idle threads */
|
|
||||||
uint8_t is_idle;
|
|
||||||
|
|
||||||
/* CPU index on which thread was last run */
|
|
||||||
uint8_t cpu;
|
|
||||||
|
|
||||||
/* Recursive count of irq_lock() calls */
|
|
||||||
uint8_t global_lock_count;
|
|
||||||
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifdef CONFIG_SCHED_CPU_MASK
|
|
||||||
/* "May run on" bits for each CPU */
|
|
||||||
uint8_t cpu_mask;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/* data returned by APIs */
|
|
||||||
void *swap_data;
|
|
||||||
|
|
||||||
#ifdef CONFIG_SYS_CLOCK_EXISTS
|
|
||||||
/* this thread's entry in a timeout queue */
|
|
||||||
struct _timeout timeout;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
_wait_q_t join_waiters;
|
|
||||||
#if __ASSERT_ON
|
|
||||||
/* For detecting calls to k_thread_create() on threads that are
|
|
||||||
* already active
|
|
||||||
*/
|
|
||||||
atomic_t cookie;
|
|
||||||
#endif
|
|
||||||
};
|
|
||||||
|
|
||||||
typedef struct _thread_base _thread_base_t;
|
|
||||||
|
|
||||||
#if defined(CONFIG_THREAD_STACK_INFO)
|
|
||||||
/* Contains the stack information of a thread */
|
|
||||||
struct _thread_stack_info {
|
|
||||||
/* Stack start - Represents the start address of the thread-writable
|
|
||||||
* stack area.
|
|
||||||
*/
|
|
||||||
uintptr_t start;
|
|
||||||
|
|
||||||
/* Thread writable stack buffer size. Represents the size of the actual
|
|
||||||
* buffer, starting from the 'start' member, that should be writable by
|
|
||||||
* the thread. This comprises of the thread stack area, any area reserved
|
|
||||||
* for local thread data storage, as well as any area left-out due to
|
|
||||||
* random adjustments applied to the initial thread stack pointer during
|
|
||||||
* thread initialization.
|
|
||||||
*/
|
|
||||||
size_t size;
|
|
||||||
|
|
||||||
/* Adjustment value to the size member, removing any storage
|
|
||||||
* used for TLS or random stack base offsets. (start + size - delta)
|
|
||||||
* is the initial stack pointer for a thread. May be 0.
|
|
||||||
*/
|
|
||||||
size_t delta;
|
|
||||||
};
|
|
||||||
|
|
||||||
typedef struct _thread_stack_info _thread_stack_info_t;
|
|
||||||
#endif /* CONFIG_THREAD_STACK_INFO */
|
|
||||||
|
|
||||||
#if defined(CONFIG_USERSPACE)
|
|
||||||
struct _mem_domain_info {
|
|
||||||
/** memory domain queue node */
|
|
||||||
sys_dnode_t mem_domain_q_node;
|
|
||||||
/** memory domain of the thread */
|
|
||||||
struct k_mem_domain *mem_domain;
|
|
||||||
};
|
|
||||||
|
|
||||||
#endif /* CONFIG_USERSPACE */
|
|
||||||
|
|
||||||
#ifdef CONFIG_THREAD_USERSPACE_LOCAL_DATA
|
|
||||||
struct _thread_userspace_local_data {
|
|
||||||
#if defined(CONFIG_ERRNO) && !defined(CONFIG_ERRNO_IN_TLS)
|
|
||||||
int errno_var;
|
|
||||||
#endif
|
|
||||||
};
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/* private, used by k_poll and k_work_poll */
|
|
||||||
struct k_work_poll;
|
|
||||||
typedef int (*_poller_cb_t)(struct k_poll_event *event, uint32_t state);
|
|
||||||
struct z_poller {
|
|
||||||
bool is_polling;
|
|
||||||
uint8_t mode;
|
|
||||||
};
|
|
||||||
|
|
||||||
#ifdef CONFIG_THREAD_RUNTIME_STATS
|
|
||||||
struct k_thread_runtime_stats {
|
|
||||||
/* Thread execution cycles */
|
|
||||||
#ifdef CONFIG_THREAD_RUNTIME_STATS_USE_TIMING_FUNCTIONS
|
|
||||||
timing_t execution_cycles;
|
|
||||||
#else
|
|
||||||
uint64_t execution_cycles;
|
|
||||||
#endif
|
|
||||||
};
|
|
||||||
|
|
||||||
typedef struct k_thread_runtime_stats k_thread_runtime_stats_t;
|
|
||||||
|
|
||||||
struct _thread_runtime_stats {
|
|
||||||
/* Timestamp when last switched in */
|
|
||||||
#ifdef CONFIG_THREAD_RUNTIME_STATS_USE_TIMING_FUNCTIONS
|
|
||||||
timing_t last_switched_in;
|
|
||||||
#else
|
|
||||||
uint32_t last_switched_in;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
k_thread_runtime_stats_t stats;
|
|
||||||
};
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/**
|
|
||||||
* @ingroup thread_apis
|
|
||||||
* Thread Structure
|
|
||||||
*/
|
|
||||||
struct k_thread {
|
|
||||||
|
|
||||||
struct _thread_base base;
|
|
||||||
|
|
||||||
/** defined by the architecture, but all archs need these */
|
|
||||||
struct _callee_saved callee_saved;
|
|
||||||
|
|
||||||
/** static thread init data */
|
|
||||||
void *init_data;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* abort function
|
|
||||||
*
|
|
||||||
* This function pointer, if non-NULL, will be run once after the
|
|
||||||
* thread has completely exited. It may run in the context of:
|
|
||||||
* - the idle thread if the thread self-exited
|
|
||||||
* - another thread calling k_thread_abort()
|
|
||||||
* - a fatal exception handler on a special stack
|
|
||||||
*
|
|
||||||
* It will never run in the context of the thread itself.
|
|
||||||
*
|
|
||||||
* A pointer to the thread object that was aborted is provided. At the
|
|
||||||
* time this runs, this thread object has completely exited. It may
|
|
||||||
* be re-used with k_thread_create() or return it to a heap or slab
|
|
||||||
* pool.
|
|
||||||
*
|
|
||||||
* This function does not run with any kind of lock active and
|
|
||||||
* there is the possibility of races leading to undefined behavior
|
|
||||||
* if other threads are attempting to free or recycle this object
|
|
||||||
* concurrently.
|
|
||||||
*/
|
|
||||||
void (*fn_abort)(struct k_thread *aborted);
|
|
||||||
|
|
||||||
#if defined(CONFIG_POLL)
|
|
||||||
struct z_poller poller;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#if defined(CONFIG_THREAD_MONITOR)
|
|
||||||
/** thread entry and parameters description */
|
|
||||||
struct __thread_entry entry;
|
|
||||||
|
|
||||||
/** next item in list of all threads */
|
|
||||||
struct k_thread *next_thread;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#if defined(CONFIG_THREAD_NAME)
|
|
||||||
/** Thread name */
|
|
||||||
char name[CONFIG_THREAD_MAX_NAME_LEN];
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifdef CONFIG_THREAD_CUSTOM_DATA
|
|
||||||
/** crude thread-local storage */
|
|
||||||
void *custom_data;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifdef CONFIG_THREAD_USERSPACE_LOCAL_DATA
|
|
||||||
struct _thread_userspace_local_data *userspace_local_data;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#if defined(CONFIG_ERRNO) && !defined(CONFIG_ERRNO_IN_TLS)
|
|
||||||
#ifndef CONFIG_USERSPACE
|
|
||||||
/** per-thread errno variable */
|
|
||||||
int errno_var;
|
|
||||||
#endif
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#if defined(CONFIG_THREAD_STACK_INFO)
|
|
||||||
/** Stack Info */
|
|
||||||
struct _thread_stack_info stack_info;
|
|
||||||
#endif /* CONFIG_THREAD_STACK_INFO */
|
|
||||||
|
|
||||||
#if defined(CONFIG_USERSPACE)
|
|
||||||
/** memory domain info of the thread */
|
|
||||||
struct _mem_domain_info mem_domain_info;
|
|
||||||
/** Base address of thread stack */
|
|
||||||
k_thread_stack_t *stack_obj;
|
|
||||||
/** current syscall frame pointer */
|
|
||||||
void *syscall_frame;
|
|
||||||
#endif /* CONFIG_USERSPACE */
|
|
||||||
|
|
||||||
|
|
||||||
#if defined(CONFIG_USE_SWITCH)
|
|
||||||
/* When using __switch() a few previously arch-specific items
|
|
||||||
* become part of the core OS
|
|
||||||
*/
|
|
||||||
|
|
||||||
/** z_swap() return value */
|
|
||||||
int swap_retval;
|
|
||||||
|
|
||||||
/** Context handle returned via arch_switch() */
|
|
||||||
void *switch_handle;
|
|
||||||
#endif
|
|
||||||
/** resource pool */
|
|
||||||
struct k_heap *resource_pool;
|
|
||||||
|
|
||||||
#if defined(CONFIG_THREAD_LOCAL_STORAGE)
|
|
||||||
/* Pointer to arch-specific TLS area */
|
|
||||||
uintptr_t tls;
|
|
||||||
#endif /* CONFIG_THREAD_LOCAL_STORAGE */
|
|
||||||
|
|
||||||
#ifdef CONFIG_THREAD_RUNTIME_STATS
|
|
||||||
/** Runtime statistics */
|
|
||||||
struct _thread_runtime_stats rt_stats;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/** arch-specifics: must always be at the end */
|
|
||||||
struct _thread_arch arch;
|
|
||||||
};
|
|
||||||
|
|
||||||
typedef struct k_thread _thread_t;
|
|
||||||
typedef struct k_thread *k_tid_t;
|
|
||||||
|
|
||||||
enum execution_context_types {
|
enum execution_context_types {
|
||||||
K_ISR = 0,
|
K_ISR = 0,
|
||||||
K_COOP_THREAD,
|
K_COOP_THREAD,
|
||||||
K_PREEMPT_THREAD,
|
K_PREEMPT_THREAD,
|
||||||
};
|
};
|
||||||
|
|
||||||
|
/* private, used by k_poll and k_work_poll */
|
||||||
|
struct k_work_poll;
|
||||||
|
typedef int (*_poller_cb_t)(struct k_poll_event *event, uint32_t state);
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @addtogroup thread_apis
|
* @addtogroup thread_apis
|
||||||
* @{
|
* @{
|
||||||
|
|
|
||||||
317
include/kernel/thread.h
Normal file
317
include/kernel/thread.h
Normal file
|
|
@ -0,0 +1,317 @@
|
||||||
|
/*
|
||||||
|
* Copyright (c) 2016, Wind River Systems, Inc.
|
||||||
|
*
|
||||||
|
* SPDX-License-Identifier: Apache-2.0
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifndef ZEPHYR_INCLUDE_KERNEL_THREAD_H_
|
||||||
|
#define ZEPHYR_INCLUDE_KERNEL_THREAD_H_
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @typedef k_thread_entry_t
|
||||||
|
* @brief Thread entry point function type.
|
||||||
|
*
|
||||||
|
* A thread's entry point function is invoked when the thread starts executing.
|
||||||
|
* Up to 3 argument values can be passed to the function.
|
||||||
|
*
|
||||||
|
* The thread terminates execution permanently if the entry point function
|
||||||
|
* returns. The thread is responsible for releasing any shared resources
|
||||||
|
* it may own (such as mutexes and dynamically allocated memory), prior to
|
||||||
|
* returning.
|
||||||
|
*
|
||||||
|
* @param p1 First argument.
|
||||||
|
* @param p2 Second argument.
|
||||||
|
* @param p3 Third argument.
|
||||||
|
*
|
||||||
|
* @return N/A
|
||||||
|
*/
|
||||||
|
|
||||||
|
#ifdef CONFIG_THREAD_MONITOR
|
||||||
|
struct __thread_entry {
|
||||||
|
k_thread_entry_t pEntry;
|
||||||
|
void *parameter1;
|
||||||
|
void *parameter2;
|
||||||
|
void *parameter3;
|
||||||
|
};
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* can be used for creating 'dummy' threads, e.g. for pending on objects */
|
||||||
|
struct _thread_base {
|
||||||
|
|
||||||
|
/* this thread's entry in a ready/wait queue */
|
||||||
|
union {
|
||||||
|
sys_dnode_t qnode_dlist;
|
||||||
|
struct rbnode qnode_rb;
|
||||||
|
};
|
||||||
|
|
||||||
|
/* wait queue on which the thread is pended (needed only for
|
||||||
|
* trees, not dumb lists)
|
||||||
|
*/
|
||||||
|
_wait_q_t *pended_on;
|
||||||
|
|
||||||
|
/* user facing 'thread options'; values defined in include/kernel.h */
|
||||||
|
uint8_t user_options;
|
||||||
|
|
||||||
|
/* thread state */
|
||||||
|
uint8_t thread_state;
|
||||||
|
|
||||||
|
/*
|
||||||
|
* scheduler lock count and thread priority
|
||||||
|
*
|
||||||
|
* These two fields control the preemptibility of a thread.
|
||||||
|
*
|
||||||
|
* When the scheduler is locked, sched_locked is decremented, which
|
||||||
|
* means that the scheduler is locked for values from 0xff to 0x01. A
|
||||||
|
* thread is coop if its prio is negative, thus 0x80 to 0xff when
|
||||||
|
* looked at the value as unsigned.
|
||||||
|
*
|
||||||
|
* By putting them end-to-end, this means that a thread is
|
||||||
|
* non-preemptible if the bundled value is greater than or equal to
|
||||||
|
* 0x0080.
|
||||||
|
*/
|
||||||
|
union {
|
||||||
|
struct {
|
||||||
|
#if __BYTE_ORDER__ == __ORDER_BIG_ENDIAN__
|
||||||
|
uint8_t sched_locked;
|
||||||
|
int8_t prio;
|
||||||
|
#else /* LITTLE and PDP */
|
||||||
|
int8_t prio;
|
||||||
|
uint8_t sched_locked;
|
||||||
|
#endif
|
||||||
|
};
|
||||||
|
uint16_t preempt;
|
||||||
|
};
|
||||||
|
|
||||||
|
#ifdef CONFIG_SCHED_DEADLINE
|
||||||
|
int prio_deadline;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
uint32_t order_key;
|
||||||
|
|
||||||
|
#ifdef CONFIG_SMP
|
||||||
|
/* True for the per-CPU idle threads */
|
||||||
|
uint8_t is_idle;
|
||||||
|
|
||||||
|
/* CPU index on which thread was last run */
|
||||||
|
uint8_t cpu;
|
||||||
|
|
||||||
|
/* Recursive count of irq_lock() calls */
|
||||||
|
uint8_t global_lock_count;
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef CONFIG_SCHED_CPU_MASK
|
||||||
|
/* "May run on" bits for each CPU */
|
||||||
|
uint8_t cpu_mask;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/* data returned by APIs */
|
||||||
|
void *swap_data;
|
||||||
|
|
||||||
|
#ifdef CONFIG_SYS_CLOCK_EXISTS
|
||||||
|
/* this thread's entry in a timeout queue */
|
||||||
|
struct _timeout timeout;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
_wait_q_t join_waiters;
|
||||||
|
#if __ASSERT_ON
|
||||||
|
/* For detecting calls to k_thread_create() on threads that are
|
||||||
|
* already active
|
||||||
|
*/
|
||||||
|
atomic_t cookie;
|
||||||
|
#endif
|
||||||
|
};
|
||||||
|
|
||||||
|
typedef struct _thread_base _thread_base_t;
|
||||||
|
|
||||||
|
#if defined(CONFIG_THREAD_STACK_INFO)
|
||||||
|
/* Contains the stack information of a thread */
|
||||||
|
struct _thread_stack_info {
|
||||||
|
/* Stack start - Represents the start address of the thread-writable
|
||||||
|
* stack area.
|
||||||
|
*/
|
||||||
|
uintptr_t start;
|
||||||
|
|
||||||
|
/* Thread writable stack buffer size. Represents the size of the actual
|
||||||
|
* buffer, starting from the 'start' member, that should be writable by
|
||||||
|
* the thread. This comprises of the thread stack area, any area reserved
|
||||||
|
* for local thread data storage, as well as any area left-out due to
|
||||||
|
* random adjustments applied to the initial thread stack pointer during
|
||||||
|
* thread initialization.
|
||||||
|
*/
|
||||||
|
size_t size;
|
||||||
|
|
||||||
|
/* Adjustment value to the size member, removing any storage
|
||||||
|
* used for TLS or random stack base offsets. (start + size - delta)
|
||||||
|
* is the initial stack pointer for a thread. May be 0.
|
||||||
|
*/
|
||||||
|
size_t delta;
|
||||||
|
};
|
||||||
|
|
||||||
|
typedef struct _thread_stack_info _thread_stack_info_t;
|
||||||
|
#endif /* CONFIG_THREAD_STACK_INFO */
|
||||||
|
|
||||||
|
#if defined(CONFIG_USERSPACE)
|
||||||
|
struct _mem_domain_info {
|
||||||
|
/** memory domain queue node */
|
||||||
|
sys_dnode_t mem_domain_q_node;
|
||||||
|
/** memory domain of the thread */
|
||||||
|
struct k_mem_domain *mem_domain;
|
||||||
|
};
|
||||||
|
|
||||||
|
#endif /* CONFIG_USERSPACE */
|
||||||
|
|
||||||
|
#ifdef CONFIG_THREAD_USERSPACE_LOCAL_DATA
|
||||||
|
struct _thread_userspace_local_data {
|
||||||
|
#if defined(CONFIG_ERRNO) && !defined(CONFIG_ERRNO_IN_TLS)
|
||||||
|
int errno_var;
|
||||||
|
#endif
|
||||||
|
};
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef CONFIG_THREAD_RUNTIME_STATS
|
||||||
|
struct k_thread_runtime_stats {
|
||||||
|
/* Thread execution cycles */
|
||||||
|
#ifdef CONFIG_THREAD_RUNTIME_STATS_USE_TIMING_FUNCTIONS
|
||||||
|
timing_t execution_cycles;
|
||||||
|
#else
|
||||||
|
uint64_t execution_cycles;
|
||||||
|
#endif
|
||||||
|
};
|
||||||
|
|
||||||
|
typedef struct k_thread_runtime_stats k_thread_runtime_stats_t;
|
||||||
|
|
||||||
|
struct _thread_runtime_stats {
|
||||||
|
/* Timestamp when last switched in */
|
||||||
|
#ifdef CONFIG_THREAD_RUNTIME_STATS_USE_TIMING_FUNCTIONS
|
||||||
|
timing_t last_switched_in;
|
||||||
|
#else
|
||||||
|
uint32_t last_switched_in;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
k_thread_runtime_stats_t stats;
|
||||||
|
};
|
||||||
|
#endif
|
||||||
|
|
||||||
|
struct z_poller {
|
||||||
|
bool is_polling;
|
||||||
|
uint8_t mode;
|
||||||
|
};
|
||||||
|
|
||||||
|
/**
|
||||||
|
* @ingroup thread_apis
|
||||||
|
* Thread Structure
|
||||||
|
*/
|
||||||
|
struct k_thread {
|
||||||
|
|
||||||
|
struct _thread_base base;
|
||||||
|
|
||||||
|
/** defined by the architecture, but all archs need these */
|
||||||
|
struct _callee_saved callee_saved;
|
||||||
|
|
||||||
|
/** static thread init data */
|
||||||
|
void *init_data;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* abort function
|
||||||
|
*
|
||||||
|
* This function pointer, if non-NULL, will be run once after the
|
||||||
|
* thread has completely exited. It may run in the context of:
|
||||||
|
* - the idle thread if the thread self-exited
|
||||||
|
* - another thread calling k_thread_abort()
|
||||||
|
* - a fatal exception handler on a special stack
|
||||||
|
*
|
||||||
|
* It will never run in the context of the thread itself.
|
||||||
|
*
|
||||||
|
* A pointer to the thread object that was aborted is provided. At the
|
||||||
|
* time this runs, this thread object has completely exited. It may
|
||||||
|
* be re-used with k_thread_create() or return it to a heap or slab
|
||||||
|
* pool.
|
||||||
|
*
|
||||||
|
* This function does not run with any kind of lock active and
|
||||||
|
* there is the possibility of races leading to undefined behavior
|
||||||
|
* if other threads are attempting to free or recycle this object
|
||||||
|
* concurrently.
|
||||||
|
*/
|
||||||
|
void (*fn_abort)(struct k_thread *aborted);
|
||||||
|
|
||||||
|
#if defined(CONFIG_POLL)
|
||||||
|
struct z_poller poller;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(CONFIG_THREAD_MONITOR)
|
||||||
|
/** thread entry and parameters description */
|
||||||
|
struct __thread_entry entry;
|
||||||
|
|
||||||
|
/** next item in list of all threads */
|
||||||
|
struct k_thread *next_thread;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(CONFIG_THREAD_NAME)
|
||||||
|
/** Thread name */
|
||||||
|
char name[CONFIG_THREAD_MAX_NAME_LEN];
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef CONFIG_THREAD_CUSTOM_DATA
|
||||||
|
/** crude thread-local storage */
|
||||||
|
void *custom_data;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#ifdef CONFIG_THREAD_USERSPACE_LOCAL_DATA
|
||||||
|
struct _thread_userspace_local_data *userspace_local_data;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(CONFIG_ERRNO) && !defined(CONFIG_ERRNO_IN_TLS)
|
||||||
|
#ifndef CONFIG_USERSPACE
|
||||||
|
/** per-thread errno variable */
|
||||||
|
int errno_var;
|
||||||
|
#endif
|
||||||
|
#endif
|
||||||
|
|
||||||
|
#if defined(CONFIG_THREAD_STACK_INFO)
|
||||||
|
/** Stack Info */
|
||||||
|
struct _thread_stack_info stack_info;
|
||||||
|
#endif /* CONFIG_THREAD_STACK_INFO */
|
||||||
|
|
||||||
|
#if defined(CONFIG_USERSPACE)
|
||||||
|
/** memory domain info of the thread */
|
||||||
|
struct _mem_domain_info mem_domain_info;
|
||||||
|
/** Base address of thread stack */
|
||||||
|
k_thread_stack_t *stack_obj;
|
||||||
|
/** current syscall frame pointer */
|
||||||
|
void *syscall_frame;
|
||||||
|
#endif /* CONFIG_USERSPACE */
|
||||||
|
|
||||||
|
|
||||||
|
#if defined(CONFIG_USE_SWITCH)
|
||||||
|
/* When using __switch() a few previously arch-specific items
|
||||||
|
* become part of the core OS
|
||||||
|
*/
|
||||||
|
|
||||||
|
/** z_swap() return value */
|
||||||
|
int swap_retval;
|
||||||
|
|
||||||
|
/** Context handle returned via arch_switch() */
|
||||||
|
void *switch_handle;
|
||||||
|
#endif
|
||||||
|
/** resource pool */
|
||||||
|
struct k_heap *resource_pool;
|
||||||
|
|
||||||
|
#if defined(CONFIG_THREAD_LOCAL_STORAGE)
|
||||||
|
/* Pointer to arch-specific TLS area */
|
||||||
|
uintptr_t tls;
|
||||||
|
#endif /* CONFIG_THREAD_LOCAL_STORAGE */
|
||||||
|
|
||||||
|
#ifdef CONFIG_THREAD_RUNTIME_STATS
|
||||||
|
/** Runtime statistics */
|
||||||
|
struct _thread_runtime_stats rt_stats;
|
||||||
|
#endif
|
||||||
|
|
||||||
|
/** arch-specifics: must always be at the end */
|
||||||
|
struct _thread_arch arch;
|
||||||
|
};
|
||||||
|
|
||||||
|
typedef struct k_thread _thread_t;
|
||||||
|
typedef struct k_thread *k_tid_t;
|
||||||
|
|
||||||
|
#endif
|
||||||
|
|
@ -39,5 +39,6 @@
|
||||||
#include <sys/thread_stack.h>
|
#include <sys/thread_stack.h>
|
||||||
#include <app_memory/mem_domain.h>
|
#include <app_memory/mem_domain.h>
|
||||||
#include <sys/kobject.h>
|
#include <sys/kobject.h>
|
||||||
|
#include <kernel/thread.h>
|
||||||
|
|
||||||
#endif /* ZEPHYR_INCLUDE_KERNEL_INCLUDES_H_ */
|
#endif /* ZEPHYR_INCLUDE_KERNEL_INCLUDES_H_ */
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue