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 /*                                                                        */
31 /*  FUNCTION                                               RELEASE        */
32 /*                                                                        */
33 /*    pthread_mutexattr_init                              PORTABLE C      */
34 /*                                                           6.1.7        */
35 /*  AUTHOR                                                                */
36 /*                                                                        */
37 /*    William E. Lamie, Microsoft Corporation                             */
38 /*                                                                        */
39 /*  DESCRIPTION                                                           */
40 /*                                                                        */
41 /*    This function initializes a pthread mutex attributes object to      */
42 /*    default values, if the object is already created this call will     */
43 /*    return an error.                                                    */
44 /*                                                                        */
45 /*  INPUT                                                                 */
46 /*                                                                        */
47 /*    attr                           Pointer to a mutex attributes        */
48 /*                                                                        */
49 /*  OUTPUT                                                                */
50 /*                                                                        */
51 /*     0                             If successful                        */
52 /*     Value                         In case of any error                 */
53 /*                                                                        */
54 /*  CALLS                                                                 */
55 /*                                                                        */
56 /*    posix_allocate_pthread_mutexattr  Get a new mutexattr object        */
57 /*    set_default_mutexattr             Set mutexattr with default values */
58 /*                                                                        */
59 /*  CALLED BY                                                             */
60 /*                                                                        */
61 /*    Application Code                                                    */
62 /*                                                                        */
63 /*  RELEASE HISTORY                                                       */
64 /*                                                                        */
65 /*    DATE              NAME                      DESCRIPTION             */
66 /*                                                                        */
67 /*  06-02-2021     William E. Lamie         Initial Version 6.1.7         */
68 /*                                                                        */
69 /**************************************************************************/
pthread_mutexattr_init(pthread_mutexattr_t * attr)70 INT pthread_mutexattr_init(pthread_mutexattr_t *attr)
71 {
72 
73 TX_INTERRUPT_SAVE_AREA
74 
75 
76     /* Disable interrupts.  */
77     TX_DISABLE
78 
79     /* Check this attributes object exists ? */
80     if (attr->in_use  == TX_TRUE)
81     {
82         posix_errno = EINVAL;
83 	    posix_set_pthread_errno(EINVAL);
84         TX_RESTORE
85         return (EINVAL);
86     }
87     attr->in_use = TX_TRUE;
88     set_default_mutexattr(attr);
89     TX_RESTORE
90     return(OK);
91 }
92