michaelh/zephyr
1
0
Fork 0
Code Releases Activity

arch: add interface to get stack space of privileged stack

Browse source 
This adds a new arch_thread_priv_stack_space_get() interface for
each architecture to report privileged stack space usage. Each
architecture will need to implement this function as each arch
has their own way of defining privileged stacks.

Signed-off-by: Daniel Leung <daniel.leung@intel.com>
This commit is contained in:
Daniel Leung 2024-07-30 12:26:09 -07:00 • committed by Anas Nashif
commit b4c455c754
2 changed files with 33 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

5
arch/Kconfig
View file

@ -700,6 +700,11 @@ config ARCH_SUPPORTS_MEM_MAPPED_STACKS
help
Select when the architecture supports memory mapped stacks.
config ARCH_HAS_THREAD_PRIV_STACK_SPACE_GET
bool
help
Select when the architecture implements arch_thread_priv_stack_space_get().
#
# Other architecture related options
#

28
kernel/include/kernel_arch_interface.h
View file

@ -208,6 +208,34 @@ int arch_float_disable(struct k_thread *thread);
int arch_float_enable(struct k_thread *thread, unsigned int options);
#endif /* CONFIG_FPU && CONFIG_FPU_SHARING */
#if defined(CONFIG_USERSPACE) && defined(CONFIG_ARCH_HAS_THREAD_PRIV_STACK_SPACE_GET)
/**
* @brief Obtain privileged stack usage information for the specified thread
*
* Must be called under supervisor mode.
*
* Some hardware may prevent inspection of a stack buffer currently in use.
* If this API is called from supervisor mode, on the currently running thread,
* on a platform which selects @kconfig{CONFIG_NO_UNUSED_STACK_INSPECTION}, an
* error will be generated.
*
* @param[in] thread Thread to inspect stack information
* @param[out] stack_size Filled in with the size of the stack space of
* the target thread in bytes.
* @param[out] unused_ptr Filled in with the unused stack space of
* the target thread in bytes.
*
* @return 0 on success
* @return -EBADF Bad thread object
* @return -EPERM No permissions on thread object
* #return -ENOTSUP Forbidden by hardware policy
* @return -EINVAL Thread is uninitialized or exited or not a user thread
* @return -EFAULT Bad memory address for unused_ptr
*/
int arch_thread_priv_stack_space_get(const struct k_thread *thread, size_t *stack_size,
size_t *unused_ptr);
#endif /* CONFIG_USERSPACE && CONFIG_ARCH_HAS_THREAD_PRIV_STACK_SPACE_GET */
/** @} */
/**