annotate usr/src/lib/libc/port/unwind/unwind.c @ 13726:056b82d21d71

1450 Illumos should be buildable with GCC4 Reviewed by: Joshua M. Clulow <josh@sysmgr.org> Reviewed by: Keith Wesolowski <keith.wesolowski@joyent.com> Reviewed by: Gordon Ross <gwr@nexenta.com> Reviewed by: Albert Lee <trisk@nexenta.com> Approved by: Gordon Ross <gwr@nexenta.com>
author Richard Lowe <richlowe@richlowe.net>
date Sat, 14 Apr 2012 20:29:22 -0400
parents febeba71273d
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
1 /*
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
2 * CDDL HEADER START
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
3 *
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
4 * The contents of this file are subject to the terms of the
6812
febeba71273d PSARC 2008/309 expunge synonyms.h
raf
parents: 1219
diff changeset
5 * Common Development and Distribution License (the "License").
febeba71273d PSARC 2008/309 expunge synonyms.h
raf
parents: 1219
diff changeset
6 * You may not use this file except in compliance with the License.
0
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
7 *
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
9 * or http://www.opensolaris.org/os/licensing.
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
10 * See the License for the specific language governing permissions
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
11 * and limitations under the License.
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
12 *
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
13 * When distributing Covered Code, include this CDDL HEADER in each
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
15 * If applicable, add the following below this CDDL HEADER, with the
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
16 * fields enclosed by brackets "[]" replaced with your own identifying
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
17 * information: Portions Copyright [yyyy] [name of copyright owner]
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
18 *
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
19 * CDDL HEADER END
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
20 */
1219
f89f56c2d9ac 6362982 namespace pollution/protection in libc
raf
parents: 0
diff changeset
21
0
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
22 /*
6812
febeba71273d PSARC 2008/309 expunge synonyms.h
raf
parents: 1219
diff changeset
23 * Copyright 2008 Sun Microsystems, Inc. All rights reserved.
0
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
24 * Use is subject to license terms.
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
25 */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
26
6812
febeba71273d PSARC 2008/309 expunge synonyms.h
raf
parents: 1219
diff changeset
27 #include "lint.h"
0
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
28 #include "thr_uberdata.h"
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
29 #include <dlfcn.h>
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
30
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
31 /*
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
32 * This is common code for sparc, sparcv9, and i386.
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
33 * The amd64 unwind code is vastly different from this.
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
34 * Look under the amd64-specific directory structure for details.
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
35 */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
36
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
37 /*
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
38 * _ex_unwind() is provided by libC, but if libC is not loaded we
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
39 * need to call a local version of _ex_unwind() which does exactly
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
40 * the same thing except for calling C++ destructors.
13726
056b82d21d71 1450 Illumos should be buildable with GCC4
Richard Lowe <richlowe@richlowe.net>
parents: 6812
diff changeset
41 *
056b82d21d71 1450 Illumos should be buildable with GCC4
Richard Lowe <richlowe@richlowe.net>
parents: 6812
diff changeset
42 * Note that neither of these literally "returns twice" as, for eg, setjmp
056b82d21d71 1450 Illumos should be buildable with GCC4
Richard Lowe <richlowe@richlowe.net>
parents: 6812
diff changeset
43 * does, but they induce unusual control flow which the compiler should treat
056b82d21d71 1450 Illumos should be buildable with GCC4
Richard Lowe <richlowe@richlowe.net>
parents: 6812
diff changeset
44 * in the same manner (make all registers dead, etc.).
0
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
45 */
13726
056b82d21d71 1450 Illumos should be buildable with GCC4
Richard Lowe <richlowe@richlowe.net>
parents: 6812
diff changeset
46 extern void _ex_clnup_handler(void *, void (*)(void *)) __RETURNS_TWICE;
056b82d21d71 1450 Illumos should be buildable with GCC4
Richard Lowe <richlowe@richlowe.net>
parents: 6812
diff changeset
47 extern void _ex_unwind_local(void) __RETURNS_TWICE;
0
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
48 #pragma unknown_control_flow(_ex_clnup_handler)
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
49 #pragma unknown_control_flow(_ex_unwind_local)
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
50
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
51 /*
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
52 * _t_cancel(fp):calls cleanup handlers if there are any in
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
53 * frame (fp), and calls _ex_unwind() to call
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
54 * destructors if libC has been linked.
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
55 *
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
56 * Control comes here from _thrp_unwind. Logically:
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
57 *
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
58 * _thrp_unwind: first arg = current fp;
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
59 * jump _t_cancel;
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
60 *
6812
febeba71273d PSARC 2008/309 expunge synonyms.h
raf
parents: 1219
diff changeset
61 * We could have called _t_cancel(_getfp) from thr_exit()
0
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
62 * but _ex_unwind() also calls _t_cancel() and it does after
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
63 * poping out the two frames. If _ex_unwind() passes the current
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
64 * fp, then it will be invalid. For a caller of _thrp_unwind()
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
65 * it looks as if it is calling _t_cancel(fp).
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
66 *
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
67 * _t_cancel will eventually call _thrp_exit().
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
68 * It never returns from _t_cancel().
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
69 *
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
70 */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
71 void
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
72 _t_cancel(void *fp)
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
73 {
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
74 ulwp_t *self = curthread;
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
75 __cleanup_t *head;
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
76 void (*fptr)(void (*func)(void *), void *arg);
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
77
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
78 /* Do this once per thread exit, not once per unwind frame */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
79 if (self->ul_ex_unwind == NULL &&
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
80 (self->ul_ex_unwind = dlsym(RTLD_PROBE, "_ex_unwind")) == NULL)
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
81 self->ul_ex_unwind = (void *)-1;
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
82
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
83 if (self->ul_ex_unwind == (void *)-1)
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
84 fptr = NULL;
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
85 else
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
86 fptr = (void (*)())self->ul_ex_unwind;
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
87
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
88 if (fp == NULL) {
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
89 _thrp_exit();
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
90 thr_panic("_t_cancel(): _thrp_exit() returned");
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
91 }
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
92
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
93 if ((head = self->ul_clnup_hdr) != NULL && fp == head->fp) {
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
94 self->ul_clnup_hdr = head->next;
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
95 /* execute the cleanup handler */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
96 _ex_clnup_handler(head->arg, head->func);
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
97 thr_panic("_t_cancel(): _ex_clnup_handler() returned");
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
98 }
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
99
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
100 if (fptr != NULL && self->ul_unwind) {
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
101 /* libC is loaded and thread is canceled, call libC version */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
102 (*fptr)(_thrp_unwind, NULL);
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
103 thr_panic("_t_cancel(): _ex_unwind() returned");
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
104 } else if (head != NULL) {
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
105 /* libC not present, call local version */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
106 _ex_unwind_local();
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
107 thr_panic("_t_cancel(): _ex_unwind_local() returned");
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
108 } else {
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
109 /* libC not present and no cleanup handlers, exit here */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
110 _thrp_exit();
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
111 thr_panic("_t_cancel(): _thrp_exit() returned");
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
112 }
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
113 /* never returns here */
68f95e015346 OpenSolaris Launch
stevel@tonic-gate
parents:
diff changeset
114 }