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 /* FUNCTION RELEASE */
32 /* */
33 /* posix_putback_queue PORTABLE C */
34 /* 6.1.7 */
35 /* AUTHOR */
36 /* */
37 /* William E. Lamie, Microsoft Corporation */
38 /* */
39 /* DESCRIPTION */
40 /* */
41 /* This function "puts back" a ThreadX queue into the POSIX */
42 /* variable length message queue pool. */
43 /* */
44 /* INPUT */
45 /* */
46 /* qid Queue ID */
47 /* */
48 /* OUTPUT */
49 /* */
50 /* None */
51 /* */
52 /* CALLS */
53 /* */
54 /* posix_memory_putback Free memory */
55 /* */
56 /* CALLED BY */
57 /* */
58 /* POSIX internal Code */
59 /* */
60 /* RELEASE HISTORY */
61 /* */
62 /* DATE NAME DESCRIPTION */
63 /* */
64 /* 06-02-2021 William E. Lamie Initial Version 6.1.7 */
65 /* */
66 /**************************************************************************/
posix_putback_queue(TX_QUEUE * qid)67 VOID posix_putback_queue(TX_QUEUE * qid)
68 {
69
70 POSIX_MSG_QUEUE * q_ptr;
71
72 /* Convert TX_QUEUE into POSIX_QUEUE datatype. */
73 q_ptr = MAKE_POSIX_QUEUE(qid);
74
75 /* Free the queue's memory. */
76 posix_memory_release(q_ptr->storage);
77
78 /* This queue is no longer in use. */
79 q_ptr->in_use = TX_FALSE;
80 return;
81 }
82