1 /**************************************************************************/
2 /* */
3 /* Copyright (c) Microsoft Corporation. All rights reserved. */
4 /* */
5 /* This software is licensed under the Microsoft Software License */
6 /* Terms for Microsoft Azure RTOS. Full text of the license can be */
7 /* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */
8 /* and in the root directory of this software. */
9 /* */
10 /**************************************************************************/
11
12
13 /**************************************************************************/
14 /**************************************************************************/
15 /** */
16 /** POSIX wrapper for THREADX */
17 /** */
18 /** */
19 /** */
20 /**************************************************************************/
21 /**************************************************************************/
22
23 /* Include necessary system files. */
24
25 #include "tx_api.h" /* Threadx API */
26 #include "pthread.h" /* Posix API */
27 #include "px_int.h" /* Posix helper functions */
28
29
30 /**************************************************************************/
31 /* */
32 /* FUNCTION RELEASE */
33 /* */
34 /* posix_memory_allocate PORTABLE C */
35 /* 6.1.7 */
36 /* AUTHOR */
37 /* */
38 /* William E. Lamie, Microsoft Corporation */
39 /* */
40 /* DESCRIPTION */
41 /* */
42 /* This function attempts to obtain the specified amount of memory */
43 /* from the POSIX heap. */
44 /* */
45 /* INPUT */
46 /* */
47 /* size Number of bytes in the pool */
48 /* memory_ptr Pointer to memory ptr variable*/
49 /* */
50 /* OUTPUT */
51 /* */
52 /* ERROR If error occurs */
53 /* retval Return value */
54 /* */
55 /* CALLS */
56 /* */
57 /* tx_byte_allocate Allocate from the pool */
58 /* posix_internal_error Generic posix error */
59 /* */
60 /* CALLED BY */
61 /* */
62 /* POSIX internal code */
63 /* */
64 /* RELEASE HISTORY */
65 /* */
66 /* DATE NAME DESCRIPTION */
67 /* */
68 /* 06-02-2021 William E. Lamie Initial Version 6.1.7 */
69 /* */
70 /**************************************************************************/
posix_memory_allocate(ULONG size,VOID ** memory_ptr)71 INT posix_memory_allocate(ULONG size, VOID **memory_ptr)
72 {
73
74 INT retval;
75
76 /* Init in case we fail. */
77 *memory_ptr = (VOID *)0;
78
79 /* Force all alignments to long word boundaries to be safe. */
80 if (size & 0x03)
81 {
82 /* Bump size up to next 4 byte boundary. */
83 size = ((size + 0x03) & ~0x03);
84 }
85 /* Attempt to allocate the desired memory from the POSIX heap.
86 Do not wait - if memory isn't available, flag an error. */
87 retval = tx_byte_allocate((TX_BYTE_POOL *)&posix_heap_byte_pool, memory_ptr,
88 size, TX_NO_WAIT);
89
90 /* Make sure the memory was obtained successfully. */
91 if (retval)
92 {
93 /* Error obtaining memory. */
94 posix_internal_error(555);
95 /* return error. */
96 return(ERROR);
97 }
98 /* Return to caller. */
99 return(retval);
100 }
101