summaryrefslogtreecommitdiffstats
path: root/cpukit/score/src/threadstackallocate.c
blob: 94483283651983eaee1d150ffa9f9e6b14ad6064 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
/*
 *  Thread Handler - Stack Allocate Helper
 *
 *  COPYRIGHT (c) 1989-2010.
 *  On-Line Applications Research Corporation (OAR).
 *
 *  The license and distribution terms for this file may be
 *  found in the file LICENSE in this distribution or at
 *  http://www.rtems.com/license/LICENSE.
 *
 *  $Id$
 */

#if HAVE_CONFIG_H
#include "config.h"
#endif

#include <rtems/system.h>
#include <rtems/score/apiext.h>
#include <rtems/score/context.h>
#include <rtems/score/interr.h>
#include <rtems/score/isr.h>
#include <rtems/score/object.h>
#include <rtems/score/priority.h>
#include <rtems/score/states.h>
#include <rtems/score/sysstate.h>
#include <rtems/score/thread.h>
#include <rtems/score/threadq.h>
#include <rtems/score/userext.h>
#include <rtems/score/wkspace.h>
#include <rtems/config.h>

/*
 *  _Thread_Stack_Allocate
 *
 *  Allocate the requested stack space for the thread.
 *  return the actual size allocated after any adjustment
 *  or return zero if the allocation failed.
 *  Set the Start.stack field to the address of the stack
 */

size_t _Thread_Stack_Allocate(
  Thread_Control *the_thread,
  size_t          stack_size
)
{
  void *stack_addr = 0;
  size_t the_stack_size;
  rtems_stack_allocate_hook stack_allocate_hook =
    rtems_configuration_get_stack_allocate_hook();

  the_stack_size = _Stack_Ensure_minimum( stack_size );

  /*
   *  Pad the requested size so we allocate enough memory
   *  so the context initialization can align it properly.  The address
   *  returned the workspace allocate must be directly stored in the
   *  stack control block because it is later used in the free sequence.
   *
   *  Thus it is the responsibility of the CPU dependent code to
   *  get and keep the stack adjust factor, the stack alignment, and
   *  the context initialization sequence in sync.
   */
  the_stack_size = _Stack_Adjust_size( the_stack_size );

  stack_addr = (*stack_allocate_hook)( the_stack_size );

  if ( !stack_addr )
    the_stack_size = 0;

  the_thread->Start.stack = stack_addr;

  return the_stack_size;
}