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 /*    pthread_attr_setdetachstate                         PORTABLE C      */
35 /*                                                           6.1.7        */
36 /*  AUTHOR                                                                */
37 /*                                                                        */
38 /*    William E. Lamie, Microsoft Corporation                             */
39 /*                                                                        */
40 /*  DESCRIPTION                                                           */
41 /*                                                                        */
42 /*     This function sets the detach state attribute from a pthread       */
43 /*     attributes object specified.The detach state of a thread indicates */
44 /*     whether the system is allowed to free thread resources when the    */
45 /*     thread terminates.                                                 */
46 /*     The detach state specifies one of:                                 */
47 /*     PTHREAD_CREATE_DETACHED or PTHREAD_CREATE_JOINABLE.                */
48 /*     The default detach state (DEFAULT_DETACHSTATE) is:                 */
49 /*     PTHREAD_CREATE_JOINABLE.                                           */
50 /*                                                                        */
51 /*  INPUT                                                                 */
52 /*                                                                        */
53 /*    attr                           Address of the thread attributes     */
54 /*    detachstate                    detach state to set                  */
55 /*                                                                        */
56 /*                                                                        */
57 /*  OUTPUT                                                                */
58 /*                                                                        */
59 /*     0                             if successful                        */
60 /*     Value                         in case of any error                 */
61 /*                                                                        */
62 /*  CALLS                                                                 */
63 /*                                                                        */
64 /*    None                                                                */
65 /*                                                                        */
66 /*  CALLED BY                                                             */
67 /*                                                                        */
68 /*    Application Code                                                    */
69 /*                                                                        */
70 /*  RELEASE HISTORY                                                       */
71 /*                                                                        */
72 /*    DATE              NAME                      DESCRIPTION             */
73 /*                                                                        */
74 /*  06-02-2021     William E. Lamie         Initial Version 6.1.7         */
75 /*                                                                        */
76 /**************************************************************************/
77 
pthread_attr_setdetachstate(pthread_attr_t * attr,INT detachstate)78 INT pthread_attr_setdetachstate(pthread_attr_t *attr,INT detachstate)
79 {
80     /* First check the attribute object is already destroyed? */
81     if (attr->inuse == TX_FALSE)
82     {
83         posix_errno = EINVAL;
84 	    posix_set_pthread_errno(EINVAL);
85         return(EINVAL);
86     }
87     else
88     {
89         attr->detach_state = detachstate ;
90         return(OK);
91     }
92 }
93