manual: Move mbstouwcs to an example C file
[glibc.git] / htl / pt-exit.c
blobcb62f474fa82924c1811f18398ab85900c4b959f
1 /* Thread termination.
2 Copyright (C) 2000-2018 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <http://www.gnu.org/licenses/>. */
19 #include <assert.h>
20 #include <errno.h>
21 #include <pthread.h>
22 #include <stdlib.h>
24 #include <pt-internal.h>
25 #include <pthreadP.h>
27 #include <atomic.h>
30 /* Terminate the current thread and make STATUS available to any
31 thread that might join it. */
32 void
33 __pthread_exit (void *status)
35 struct __pthread *self = _pthread_self ();
36 struct __pthread_cancelation_handler **handlers;
37 int oldstate;
39 /* Run any cancelation handlers. According to POSIX, the
40 cancellation cleanup handlers should be called with cancellation
41 disabled. */
42 __pthread_setcancelstate (PTHREAD_CANCEL_DISABLE, &oldstate);
44 for (handlers = ___pthread_get_cleanup_stack ();
45 *handlers != NULL;
46 *handlers = (*handlers)->__next)
47 (*handlers)->__handler ((*handlers)->__arg);
49 __pthread_setcancelstate (oldstate, &oldstate);
51 /* Decrease the number of threads. We use an atomic operation to
52 make sure that only the last thread calls `exit'. */
53 if (atomic_decrement_and_test (&__pthread_total))
54 /* We are the last thread. */
55 exit (0);
57 /* Note that after this point the process can be terminated at any
58 point if another thread calls `pthread_exit' and happens to be
59 the last thread. */
61 __pthread_mutex_lock (&self->state_lock);
63 if (self->cancel_state == PTHREAD_CANCEL_ENABLE && self->cancel_pending)
64 status = PTHREAD_CANCELED;
66 switch (self->state)
68 default:
69 assert (!"Consistency error: unexpected self->state");
70 abort ();
71 break;
73 case PTHREAD_DETACHED:
74 __pthread_mutex_unlock (&self->state_lock);
76 break;
78 case PTHREAD_JOINABLE:
79 /* We need to stay around for a while since another thread
80 might want to join us. */
81 self->state = PTHREAD_EXITED;
83 /* We need to remember the exit status. A thread joining us
84 might ask for it. */
85 self->status = status;
87 /* Broadcast the condition. This will wake up threads that are
88 waiting to join us. */
89 __pthread_cond_broadcast (&self->state_cond);
90 __pthread_mutex_unlock (&self->state_lock);
92 break;
95 /* Destroy any thread specific data. */
96 __pthread_destroy_specific (self);
98 /* Destroy any signal state. */
99 __pthread_sigstate_destroy (self);
101 /* Self terminating requires TLS, so defer the release of the TCB until
102 the thread structure is reused. */
104 /* Release kernel resources, including the kernel thread and the stack,
105 and drop the self reference. */
106 __pthread_thread_terminate (self);
108 /* NOTREACHED */
109 abort ();
112 strong_alias (__pthread_exit, pthread_exit);