xref: /Kernel-v10.6.2/portable/MemMang/heap_3.c (revision ef7b253b56c9788077f5ecd6c9deb4021923d646)
1 /*
2  * FreeRTOS Kernel V10.6.2
3  * Copyright (C) 2021 Amazon.com, Inc. or its affiliates.  All Rights Reserved.
4  *
5  * SPDX-License-Identifier: MIT
6  *
7  * Permission is hereby granted, free of charge, to any person obtaining a copy of
8  * this software and associated documentation files (the "Software"), to deal in
9  * the Software without restriction, including without limitation the rights to
10  * use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
11  * the Software, and to permit persons to whom the Software is furnished to do so,
12  * subject to the following conditions:
13  *
14  * The above copyright notice and this permission notice shall be included in all
15  * copies or substantial portions of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
19  * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
20  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
21  * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23  *
24  * https://www.FreeRTOS.org
25  * https://github.com/FreeRTOS
26  *
27  */
28 
29 
30 /*
31  * Implementation of pvPortMalloc() and vPortFree() that relies on the
32  * compilers own malloc() and free() implementations.
33  *
34  * This file can only be used if the linker is configured to to generate
35  * a heap memory area.
36  *
37  * See heap_1.c, heap_2.c and heap_4.c for alternative implementations, and the
38  * memory management pages of https://www.FreeRTOS.org for more information.
39  */
40 
41 #include <stdlib.h>
42 
43 /* Defining MPU_WRAPPERS_INCLUDED_FROM_API_FILE prevents task.h from redefining
44  * all the API functions to use the MPU wrappers.  That should only be done when
45  * task.h is included from an application file. */
46 #define MPU_WRAPPERS_INCLUDED_FROM_API_FILE
47 
48 #include "FreeRTOS.h"
49 #include "task.h"
50 
51 #undef MPU_WRAPPERS_INCLUDED_FROM_API_FILE
52 
53 #if ( configSUPPORT_DYNAMIC_ALLOCATION == 0 )
54     #error This file must not be used if configSUPPORT_DYNAMIC_ALLOCATION is 0
55 #endif
56 
57 /*-----------------------------------------------------------*/
58 
pvPortMalloc(size_t xWantedSize)59 void * pvPortMalloc( size_t xWantedSize )
60 {
61     void * pvReturn;
62 
63     vTaskSuspendAll();
64     {
65         pvReturn = malloc( xWantedSize );
66         traceMALLOC( pvReturn, xWantedSize );
67     }
68     ( void ) xTaskResumeAll();
69 
70     #if ( configUSE_MALLOC_FAILED_HOOK == 1 )
71     {
72         if( pvReturn == NULL )
73         {
74             vApplicationMallocFailedHook();
75         }
76     }
77     #endif
78 
79     return pvReturn;
80 }
81 /*-----------------------------------------------------------*/
82 
vPortFree(void * pv)83 void vPortFree( void * pv )
84 {
85     if( pv != NULL )
86     {
87         vTaskSuspendAll();
88         {
89             free( pv );
90             traceFREE( pv, 0 );
91         }
92         ( void ) xTaskResumeAll();
93     }
94 }
95