diff options
author | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2010-08-09 08:59:57 +0000 |
---|---|---|
committer | Sebastian Huber <sebastian.huber@embedded-brains.de> | 2010-08-09 08:59:57 +0000 |
commit | e5a2eb4d32432123c01ce8b8d2225abc43799a70 (patch) | |
tree | 5c7f155c1a05f8d9066445febc8de1a140bd9560 /cpukit/rtems/include/rtems.h | |
parent | 2010-08-09 Sebastian Huber <sebastian.huber@embedded-brains.de> (diff) | |
download | rtems-e5a2eb4d32432123c01ce8b8d2225abc43799a70.tar.bz2 |
2010-08-09 Sebastian Huber <sebastian.huber@embedded-brains.de>
* rtems/include/rtems.h, rtems/mainpage.h,
rtems/include/rtems/rtems/types.h: Documentation.
Diffstat (limited to '')
-rw-r--r-- | cpukit/rtems/include/rtems.h | 17 |
1 files changed, 17 insertions, 0 deletions
diff --git a/cpukit/rtems/include/rtems.h b/cpukit/rtems/include/rtems.h index 4b759edce2..17b1ce0394 100644 --- a/cpukit/rtems/include/rtems.h +++ b/cpukit/rtems/include/rtems.h @@ -150,12 +150,29 @@ const char *rtems_get_version_string(void); /** * @brief Minimum stack size which every thread must exceed. + * + * It is the minimum stack size recommended for use on this processor. This + * value is selected by the RTEMS developers conservatively to minimize the + * risk of blown stacks for most user applications. Using this constant when + * specifying the task stack size, indicates that the stack size will be at + * least RTEMS_MINIMUM_STACK_SIZE bytes in size. If the user configured minimum + * stack size is larger than the recommended minimum, then it will be used. */ #define RTEMS_MINIMUM_STACK_SIZE STACK_MINIMUM_SIZE /** * @brief Specifies that the task should be created with the configured minimum * stack size. + * + * Using this constant when specifying the task stack size indicates that this + * task is to be created with a stack size of the minimum stack size that was + * configured by the application. If not explicitly configured by the + * application, the default configured minimum stack size is the processor + * dependent value RTEMS_MINIMUM_STACK_SIZE. Since this uses the configured + * minimum stack size value, you may get a stack size that is smaller or larger + * than the recommended minimum. This can be used to provide large stacks for + * all tasks on complex applications or small stacks on applications that are + * trying to conserve memory. */ #define RTEMS_CONFIGURED_MINIMUM_STACK_SIZE 0 |