97 #define Z_KERNEL_STACK_SIZE_ADJUST(size) (ROUND_UP(size, \  argument
107 #define K_KERNEL_STACK_LEN(size) \  argument
108 	ROUND_UP(Z_KERNEL_STACK_SIZE_ADJUST(size), Z_KERNEL_STACK_OBJ_ALIGN)
122  * @param size Size of the stack memory region
124 #define K_KERNEL_STACK_DECLARE(sym, size) \  argument
126 		sym[K_KERNEL_STACK_LEN(size)]
136  * @param size Size of the stack memory region
138 #define K_KERNEL_STACK_ARRAY_DECLARE(sym, nmemb, size) \  argument
140 		sym[nmemb][K_KERNEL_STACK_LEN(size)]
150  * @param size Size of the stack memory region
152 #define K_KERNEL_PINNED_STACK_ARRAY_DECLARE(sym, nmemb, size) \  argument
154 		sym[nmemb][K_KERNEL_STACK_LEN(size)]
166  * 'size' parameter. Use K_KERNEL_STACK_SIZEOF() instead.
169  * fixed-size stack overflow guards.
172  * @param size Size of the stack memory region
175 #define Z_KERNEL_STACK_DEFINE_IN(sym, size, lsect) \  argument
178 		sym[K_KERNEL_STACK_LEN(size)]
185  * @param size Size of the stack memory region
188 #define Z_KERNEL_STACK_ARRAY_DEFINE_IN(sym, nmemb, size, lsect) \  argument
191 		sym[nmemb][K_KERNEL_STACK_LEN(size)]
206  * 'size' parameter. Use K_KERNEL_STACK_SIZEOF() instead.
209  * fixed-size stack overflow guards.
212  * @param size Size of the stack memory region
214 #define K_KERNEL_STACK_DEFINE(sym, size) \  argument
215 	Z_KERNEL_STACK_DEFINE_IN(sym, size, __kstackmem)
227  * @param size Size of the stack memory region
230 #define K_KERNEL_PINNED_STACK_DEFINE(sym, size) \  argument
231 	Z_KERNEL_STACK_DEFINE_IN(sym, size, __pinned_noinit)
233 #define K_KERNEL_PINNED_STACK_DEFINE(sym, size) \  argument
234 	Z_KERNEL_STACK_DEFINE_IN(sym, size, __kstackmem)
244  * @param size Size of the stack memory region
246 #define K_KERNEL_STACK_ARRAY_DEFINE(sym, nmemb, size) \  argument
247 	Z_KERNEL_STACK_ARRAY_DEFINE_IN(sym, nmemb, size, __kstackmem)
260  * @param size Size of the stack memory region
263 #define K_KERNEL_PINNED_STACK_ARRAY_DEFINE(sym, nmemb, size) \  argument
264 	Z_KERNEL_STACK_ARRAY_DEFINE_IN(sym, nmemb, size, __pinned_noinit)
266 #define K_KERNEL_PINNED_STACK_ARRAY_DEFINE(sym, nmemb, size) \  argument
267 	Z_KERNEL_STACK_ARRAY_DEFINE_IN(sym, nmemb, size, __kstackmem)
277  * @param size Size of the stack memory region
279 #define K_KERNEL_STACK_MEMBER(sym, size) \  argument
280 	Z_KERNEL_STACK_DEFINE_IN(sym, size,)
334  * provided size. The requested size is significant only if
346  * @param size Requested size of the stack buffer (which could be ignored)
350 #define Z_THREAD_STACK_OBJ_ALIGN(size)	\  argument
351 	ARCH_THREAD_STACK_OBJ_ALIGN(Z_THREAD_STACK_SIZE_ADJUST(size))
353 #define Z_THREAD_STACK_OBJ_ALIGN(size)	ARCH_STACK_PTR_ALIGN  argument
357  * @brief Round up a requested stack size to satisfy constraints
359  * Given a requested stack buffer size, return an adjusted size value for
367  * If CONFIG_USERSPACE is enabled, this determines the size of stack objects
379  * @param size Requested size of the stack buffer
380  * @return Adjusted size of the stack object
383 #define Z_THREAD_STACK_SIZE_ADJUST(size) \  argument
384 	ARCH_THREAD_STACK_SIZE_ADJUST((size) + K_THREAD_STACK_RESERVED)
386 #define Z_THREAD_STACK_SIZE_ADJUST(size) \  argument
387 	(ROUND_UP((size), ARCH_STACK_PTR_ALIGN) + K_THREAD_STACK_RESERVED)
402  * @param size Size of the stack memory region
404 #define K_THREAD_STACK_DECLARE(sym, size) \  argument
406 		sym[K_THREAD_STACK_LEN(size)]
416  * @param size Size of the stack memory region
418 #define K_THREAD_STACK_ARRAY_DECLARE(sym, nmemb, size) \  argument
420 		sym[nmemb][K_THREAD_STACK_LEN(size)]
423  * @brief Return the size in bytes of a stack memory region
425  * Convenience macro for passing the desired stack size to k_thread_create()
429  * The value returned here is not guaranteed to match the 'size' parameter
434  * @return Size of the stack buffer
456  * 'size' parameter. Use K_THREAD_STACK_SIZEOF() instead.
458  * Some arches may round the size of the usable stack region up to satisfy
460  * size.
463  * @param size Size of the stack memory region
466 #define Z_THREAD_STACK_DEFINE_IN(sym, size, lsect) \  argument
468 		__aligned(Z_THREAD_STACK_OBJ_ALIGN(size)) \
469 		sym[K_THREAD_STACK_LEN(size)]
482  * @param size Size of the stack memory region
485 #define Z_THREAD_STACK_ARRAY_DEFINE_IN(sym, nmemb, size, lsect) \  argument
487 		__aligned(Z_THREAD_STACK_OBJ_ALIGN(size)) \
488 		sym[nmemb][K_THREAD_STACK_LEN(size)]
507  * 'size' parameter. Use K_THREAD_STACK_SIZEOF() instead.
509  * Some arches may round the size of the usable stack region up to satisfy
511  * size.
514  * @param size Size of the stack memory region
516 #define K_THREAD_STACK_DEFINE(sym, size) \  argument
517 	Z_THREAD_STACK_DEFINE_IN(sym, size, __stackmem)
536  * 'size' parameter. Use K_THREAD_STACK_SIZEOF() instead.
538  * Some arches may round the size of the usable stack region up to satisfy
540  * size.
547  * @param size Size of the stack memory region
550 #define K_THREAD_PINNED_STACK_DEFINE(sym, size) \  argument
551 	Z_THREAD_STACK_DEFINE_IN(sym, size, __pinned_noinit)
553 #define K_THREAD_PINNED_STACK_DEFINE(sym, size) \  argument
554 	K_THREAD_STACK_DEFINE(sym, size)
558  * @brief Calculate size of stacks to be allocated in a stack array
560  * This macro calculates the size to be allocated for the stacks
561  * inside a stack array. It accepts the indicated "size" as a parameter
564  * The returned size ensures each array member will be aligned to the
567  * @param size Size of the stack memory region
568  * @return Appropriate size for an array member
570 #define K_THREAD_STACK_LEN(size) \  argument
571 	ROUND_UP(Z_THREAD_STACK_SIZE_ADJUST(size), \
572 		 Z_THREAD_STACK_OBJ_ALIGN(size))
585  * @param size Size of the stack memory region
587 #define K_THREAD_STACK_ARRAY_DEFINE(sym, nmemb, size) \  argument
588 	Z_THREAD_STACK_ARRAY_DEFINE_IN(sym, nmemb, size, __stackmem)
605  * @param size Size of the stack memory region
608 #define K_THREAD_PINNED_STACK_ARRAY_DEFINE(sym, nmemb, size) \  argument
609 	Z_THREAD_PINNED_STACK_DEFINE_IN(sym, nmemb, size, __pinned_noinit)
611 #define K_THREAD_PINNED_STACK_ARRAY_DEFINE(sym, nmemb, size) \  argument
612 	K_THREAD_STACK_ARRAY_DEFINE(sym, nmemb, size)