1/* Helper program for testing the pthread_mutex_t pretty printer.
2
3 Copyright (C) 2016-2022 Free Software Foundation, Inc.
4 This file is part of the GNU C Library.
5
6 The GNU C Library is free software; you can redistribute it and/or
7 modify it under the terms of the GNU Lesser General Public
8 License as published by the Free Software Foundation; either
9 version 2.1 of the License, or (at your option) any later version.
10
11 The GNU C Library is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
15
16 You should have received a copy of the GNU Lesser General Public
17 License along with the GNU C Library; if not, see
18 <https://www.gnu.org/licenses/>. */
19
20/* Keep the calls to the pthread_* functions on separate lines to make it easy
21 to advance through the program using the gdb 'next' command. */
22
23#include <stdlib.h>
24#include <errno.h>
25#include <pthread.h>
26
27#define PASS 0
28#define FAIL 1
29
30static int test_status_destroyed (pthread_mutex_t *mutex);
31static int test_status_no_robust (pthread_mutex_t *mutex,
32 pthread_mutexattr_t *attr);
33static int test_status_robust (pthread_mutex_t *mutex,
34 pthread_mutexattr_t *attr);
35static int test_locking_state_robust (pthread_mutex_t *mutex);
36static void *thread_func (void *arg);
37static int test_recursive_locks (pthread_mutex_t *mutex,
38 pthread_mutexattr_t *attr);
39
40int
41main (void)
42{
43 pthread_mutex_t mutex;
44 pthread_mutexattr_t attr;
45 int result = FAIL;
46
47 if (pthread_mutexattr_init (attr: &attr) == 0
48 && test_status_destroyed (mutex: &mutex) == PASS
49 && test_status_no_robust (mutex: &mutex, attr: &attr) == PASS
50 && test_status_robust (mutex: &mutex, attr: &attr) == PASS
51 && test_recursive_locks (mutex: &mutex, attr: &attr) == PASS)
52 result = PASS;
53 /* Else, one of the pthread_mutex* functions failed. */
54
55 return result;
56}
57
58/* Initializes MUTEX, then destroys it. */
59static int
60test_status_destroyed (pthread_mutex_t *mutex)
61{
62 int result = FAIL;
63
64 if (pthread_mutex_init (mutex: mutex, NULL) == 0
65 && pthread_mutex_destroy (mutex: mutex) == 0)
66 result = PASS; /* Test status (destroyed). */
67
68 return result;
69}
70
71/* Tests locking of non-robust mutexes. */
72static int
73test_status_no_robust (pthread_mutex_t *mutex, pthread_mutexattr_t *attr)
74{
75 int result = FAIL;
76
77 if (pthread_mutexattr_setrobust (attr: attr, robustness: PTHREAD_MUTEX_STALLED) == 0
78 && pthread_mutex_init (mutex: mutex, mutexattr: attr) == 0
79 && pthread_mutex_lock (mutex: mutex) == 0 /* Test status (non-robust). */
80 && pthread_mutex_unlock (mutex: mutex) == 0
81 && pthread_mutex_destroy (mutex: mutex) == 0)
82 result = PASS;
83
84 return result;
85}
86
87/* Tests locking of robust mutexes. */
88static int
89test_status_robust (pthread_mutex_t *mutex, pthread_mutexattr_t *attr)
90{
91 int result = FAIL;
92
93 if (pthread_mutexattr_setrobust (attr: attr, robustness: PTHREAD_MUTEX_ROBUST) == 0
94 && pthread_mutex_init (mutex: mutex, mutexattr: attr) == 0
95 && test_locking_state_robust (mutex) == PASS /* Test status (robust). */
96 && pthread_mutex_destroy (mutex: mutex) == 0)
97 result = PASS;
98
99 return result;
100}
101
102/* Tests locking and state corruption of robust mutexes. We'll mark it as
103 inconsistent, then not recoverable. */
104static int
105test_locking_state_robust (pthread_mutex_t *mutex)
106{
107 int result = FAIL;
108 pthread_t thread;
109
110 if (pthread_create (newthread: &thread, NULL, start_routine: thread_func, arg: mutex) == 0 /* Create. */
111 && pthread_join (th: thread, NULL) == 0
112 && pthread_mutex_lock (mutex: mutex) == EOWNERDEAD /* Test locking (robust). */
113 && pthread_mutex_unlock (mutex: mutex) == 0)
114 result = PASS;
115
116 return result;
117}
118
119/* Function to be called by the child thread when testing robust mutexes. */
120static void *
121thread_func (void *arg)
122{
123 pthread_mutex_t *mutex = (pthread_mutex_t *)arg;
124
125 if (pthread_mutex_lock (mutex: mutex) != 0) /* Thread function. */
126 exit (FAIL);
127
128 /* Thread terminates without unlocking the mutex, thus marking it as
129 inconsistent. */
130 return NULL;
131}
132
133/* Tests locking the mutex multiple times in a row. */
134static int
135test_recursive_locks (pthread_mutex_t *mutex, pthread_mutexattr_t *attr)
136{
137 int result = FAIL;
138
139 if (pthread_mutexattr_settype (attr: attr, kind: PTHREAD_MUTEX_RECURSIVE) == 0
140 && pthread_mutex_init (mutex: mutex, mutexattr: attr) == 0
141 && pthread_mutex_lock (mutex: mutex) == 0
142 && pthread_mutex_lock (mutex: mutex) == 0
143 && pthread_mutex_lock (mutex: mutex) == 0 /* Test recursive locks. */
144 && pthread_mutex_unlock (mutex: mutex) == 0
145 && pthread_mutex_unlock (mutex: mutex) == 0
146 && pthread_mutex_unlock (mutex: mutex) == 0
147 && pthread_mutex_destroy (mutex: mutex) == 0)
148 result = PASS;
149
150 return result;
151}
152

source code of glibc/nptl/test-mutex-printers.c