begriffs open source - freertos/blob - portable/MemMang/heap_3.c

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