1 /***************************************************************************
2 * Copyright (c) 2024 Microsoft Corporation
3 *
4 * This program and the accompanying materials are made available under the
5 * terms of the MIT License which is available at
6 * https://opensource.org/licenses/MIT.
7 *
8 * SPDX-License-Identifier: MIT
9 **************************************************************************/
10
11
12 /**************************************************************************/
13 /**************************************************************************/
14 /** */
15 /** POSIX wrapper for THREADX */
16 /** */
17 /** */
18 /** */
19 /**************************************************************************/
20 /**************************************************************************/
21
22 /* Include necessary system files. */
23
24 #include "tx_api.h" /* Threadx API */
25 #include "pthread.h" /* Posix API */
26 #include "px_int.h" /* Posix helper functions */
27
28 /**************************************************************************/
29 /* */
30 /* FUNCTION RELEASE */
31 /* */
32 /* posix_putback_queue PORTABLE C */
33 /* 6.1.7 */
34 /* AUTHOR */
35 /* */
36 /* William E. Lamie, Microsoft Corporation */
37 /* */
38 /* DESCRIPTION */
39 /* */
40 /* This function "puts back" a ThreadX queue into the POSIX */
41 /* variable length message queue pool. */
42 /* */
43 /* INPUT */
44 /* */
45 /* qid Queue ID */
46 /* */
47 /* OUTPUT */
48 /* */
49 /* None */
50 /* */
51 /* CALLS */
52 /* */
53 /* posix_memory_putback Free memory */
54 /* */
55 /* CALLED BY */
56 /* */
57 /* POSIX internal Code */
58 /* */
59 /* RELEASE HISTORY */
60 /* */
61 /* DATE NAME DESCRIPTION */
62 /* */
63 /* 06-02-2021 William E. Lamie Initial Version 6.1.7 */
64 /* */
65 /**************************************************************************/
posix_putback_queue(TX_QUEUE * qid)66 VOID posix_putback_queue(TX_QUEUE * qid)
67 {
68
69 POSIX_MSG_QUEUE * q_ptr;
70
71 /* Convert TX_QUEUE into POSIX_QUEUE datatype. */
72 q_ptr = MAKE_POSIX_QUEUE(qid);
73
74 /* Free the queue's memory. */
75 posix_memory_release(q_ptr->storage);
76
77 /* This queue is no longer in use. */
78 q_ptr->in_use = TX_FALSE;
79 return;
80 }
81
