1 /* The common simulator framework for GDB, the GNU Debugger.
3 Copyright 2002-2020 Free Software Foundation, Inc.
5 Contributed by Andrew Cagney and Red Hat.
7 This file is part of GDB.
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 3 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
19 You should have received a copy of the GNU General Public License
20 along with this program. If not, see <http://www.gnu.org/licenses/>. */
27 /* INLINE CODE SELECTION:
29 GCC -O3 attempts to inline any function or procedure in scope. The
30 options below facilitate finer grained control over what is and
31 what is not inlined. In particular, it allows the selection of
32 modules for inlining. Doing this allows the compiler to both
33 eliminate the overhead of function calls and (as a consequence)
34 also eliminate further dead code.
36 On a CISC (x86) I've found that I can achieve an order of magnitude
37 speed improvement (x3-x5). In the case of RISC (sparc) while the
38 performance gain isn't as great it is still significant.
40 Each module is controled by the macro <module>_INLINE which can
41 have the values described below
45 Do not inline any thing for the given module
47 The following bit fields values can be combined:
52 Include the C file for the module into the file being
53 compiled. The actual inlining is controlled separatly.
55 While of no apparent benefit, this makes it possible for the
56 included module, when compiled, to inline its calls to what
57 would otherwize be external functions.
59 {C_,H_} Determines where the module is inlined. A
60 H_REVEALS_MODULE will be included everywhere.
64 Make external functions within the module `inline'. Thus if
65 the module is included into a file being compiled, calls to
66 the included modules funtions can be eliminated. INLINE_MODULE
67 implies REVEAL_MODULE.
71 Make internal (static) functions within the module `inline'.
76 The inline ability is enabled by specifying every data and function
77 declaration and definition using one of the following methods:
80 GLOBAL INLINE FUNCTIONS:
82 Such functions are small and used heavily. Inlining them
83 will eliminate an unnecessary function call overhead.
85 .h: INLINE_OURPKG (void) ourpkg_func
89 .c: INLINE_OURPKG (void)
97 GLOBAL INLINE VARIABLES:
99 This doesn't make much sense.
102 GLOBAL NON-INLINE (EXTERN) FUNCTIONS AND VARIABLES:
104 These include functions with varargs parameters. It can
105 also include large rarely used functions that contribute
108 .h: extern int ourpkg_print
110 extern int a_global_variable;
112 .c: #if EXTERN_OURPKG_P
114 ourpkg_print (char *fmt,
121 int a_global_variable = 1;
125 LOCAL (STATIC) FUNCTIONS:
127 These can either be marked inline or just static static vis:
129 .h: STATIC_INLINE_OURPKG (int) ourpkg_staticf (void);
130 .c: STATIC_INLINE_OURPKG (int)
131 ourpkg_staticf (void)
136 .h: STATIC_OURPKG (int) ourpkg_staticf (void);
137 .c: STATIC_OURPKG (int)
138 ourpkg_staticf (void)
147 All modules must wrap their .h code in the following:
154 In addition, modules that want to allow global inlining must
155 include the lines (below) at the end of the .h file. (FIXME:
156 Shouldn't be needed).
158 #if H_REVEALS_MODULE_P (OURPKG_INLINE)
165 All modules must wrap their .c code in the following
177 Since no inlining is defined. All macro's get standard defaults
178 (extern, static, ...).
182 H_REVEALS_MODULE (alt includes our):
185 altprog.c defines ALTPROG_C and then includes sim-inline.h.
187 In sim-inline.h the expression `` H_REVEALS_MODULE_P
188 (OURPROG_INLINE) && ! defined (OURPROG_C) && REVEAL_MODULE_P
189 (OURPROG_INLINE) '' is TRUE so it defines *_OURPROG as static
190 and EXTERN_OURPROG_P as FALSE.
192 altprog.c includes ourprog.h.
194 In ourprog.h the expression ``H_REVEALS_MODULE_P
195 (OURPROG_INLINE)'' is TRUE so it includes ourprog.c.
197 Consequently, all the code in ourprog.c is visible and static in
202 H_REVEALS_MODULE (our includes our):
205 ourprog.c defines OURPROG_C and then includes sim-inline.h.
207 In sim-inline.h the term `` ! defined (OURPROG_C) '' is FALSE so
208 it defines *_OURPROG as non-static and EXTERN_OURPROG_P as TRUE.
210 ourprog.c includes ourprog.h.
212 In ourprog.h the expression ``H_REVEALS_MODULE_P
213 (OURPROG_INLINE)'' is true so it includes ourprog.c.
215 In ourprog.c (second include) the expression defined (OURPROG_C)
216 and so the body is not re-included.
218 Consequently, ourprog.o will contain a non-static copy of all
219 the exported symbols.
223 C_REVEALS_MODULE (alt includes our):
226 altprog.c defines ALTPROG_C and then includes sim-inline.c
228 sim-inline.c defines C_INLINE_C and then includes sim-inline.h
230 In sim-inline.h the expression `` defined (SIM_INLINE) && !
231 defined (OURPROG_C) && REVEAL_MODULE_P (OURPROG_INLINE) '' is
232 true so it defines *_OURPROG as static and EXTERN_OURPROG_P as
235 In sim-inline.c the expression ``C_REVEALS_MODULE_P
236 (OURPROG_INLINE)'' is true so it includes ourprog.c.
238 Consequently, all the code in ourprog.c is visible and static in
243 C_REVEALS_MODULE (our includes our):
246 ourprog.c defines OURPROG_C and then includes sim-inline.c
248 sim-inline.c defines C_INLINE_C and then includes sim-inline.h
250 In sim-inline.h the term `` ! defined (OURPROG_C) '' is FALSE
251 so it defines *_OURPROG as non-static and EXTERN_OURPROG_P as
254 Consequently, ourprog.o will contain a non-static copy of all
255 the exported symbols.
261 This is not for the faint hearted. I've seen GCC get up to 500mb
262 trying to compile what this can create. */
264 #define H_REVEALS_MODULE 1
265 #define C_REVEALS_MODULE 2
266 #define INLINE_GLOBALS 4
267 #define INLINE_LOCALS 8
269 #define ALL_H_INLINE (H_REVEALS_MODULE | INLINE_GLOBALS | INLINE_LOCALS)
270 #define ALL_C_INLINE (C_REVEALS_MODULE | INLINE_GLOBALS | INLINE_LOCALS)
273 /* Default macro to simplify control several of key the inlines */
275 #ifndef DEFAULT_INLINE
276 #define DEFAULT_INLINE INLINE_LOCALS
279 #define REVEAL_MODULE_P(X) (X & (H_REVEALS_MODULE | C_REVEALS_MODULE))
280 #define H_REVEALS_MODULE_P(X) ((X & H_REVEALS_MODULE))
281 #define C_REVEALS_MODULE_P(X) ((X & C_REVEALS_MODULE))
291 /* Your compilers inline prefix */
294 #if defined (__GNUC__) && defined (__OPTIMIZE__)
295 #define INLINE __inline__
297 #define INLINE /*inline*/
301 /* ??? Temporary, pending decision to always use extern inline and do a vast
302 cleanup of inline support. */
304 #if defined (__GNUC_GNU_INLINE__) || defined (__GNUC_STDC_INLINE__)
305 #define INLINE2 __inline__ __attribute__ ((__gnu_inline__))
306 #elif defined (__GNUC__)
307 #define INLINE2 __inline__
309 #define INLINE2 /*inline*/
314 /* Your compiler's static inline prefix */
316 #ifndef STATIC_INLINE
317 #define STATIC_INLINE static INLINE
321 /* Your compiler's extern inline prefix */
323 #ifndef EXTERN_INLINE
324 #define EXTERN_INLINE extern INLINE2
328 /* Your compiler's no-return reserved word */
336 /* Your compilers's unused reserved word */
338 #if !defined (UNUSED)
339 #if (!defined (__GNUC__) \
341 || (__GNUC__ == 2 && __GNUC_MINOR__ < 7))
344 #define UNUSED __attribute__((__unused__))
354 #if !defined (SIM_ARANGE_INLINE) && (DEFAULT_INLINE)
355 # define SIM_ARANGE_INLINE (ALL_H_INLINE)
358 #if ((H_REVEALS_MODULE_P (SIM_ARANGE_INLINE) || defined (SIM_INLINE_C)) \
359 && !defined (SIM_ARANGE_C) \
360 && (REVEAL_MODULE_P (SIM_ARANGE_INLINE)))
361 # if (SIM_ARANGE_INLINE & INLINE_GLOBALS)
362 # define INLINE_SIM_ARANGE(TYPE) static INLINE TYPE UNUSED
363 # define EXTERN_SIM_ARANGE_P 0
365 # define INLINE_SIM_ARANGE(TYPE) static TYPE UNUSED
366 # define EXTERN_SIM_ARANGE_P 0
369 # define INLINE_SIM_ARANGE(TYPE) TYPE
370 # define EXTERN_SIM_ARANGE_P 1
373 #if (SIM_ARANGE_INLINE & INLINE_LOCALS)
374 # define STATIC_INLINE_SIM_ARANGE(TYPE) static INLINE TYPE
376 # define STATIC_INLINE_SIM_ARANGE(TYPE) static TYPE
379 #define STATIC_SIM_ARANGE(TYPE) static TYPE
384 sim-bits and sim-endian are treated differently from the rest
385 of the modules below. Their default value is ALL_H_INLINE.
386 The rest are ALL_C_INLINE. Don't blink, you'll miss it!
392 #if !defined (SIM_BITS_INLINE) && (DEFAULT_INLINE)
393 # define SIM_BITS_INLINE (ALL_H_INLINE)
396 #if ((H_REVEALS_MODULE_P (SIM_BITS_INLINE) || defined (SIM_INLINE_C)) \
397 && !defined (SIM_BITS_C) \
398 && (REVEAL_MODULE_P (SIM_BITS_INLINE)))
399 # if (SIM_BITS_INLINE & INLINE_GLOBALS)
400 # define INLINE_SIM_BITS(TYPE) static INLINE TYPE UNUSED
401 # define EXTERN_SIM_BITS_P 0
403 # define INLINE_SIM_BITS(TYPE) static TYPE UNUSED
404 # define EXTERN_SIM_BITS_P 0
407 # define INLINE_SIM_BITS(TYPE) TYPE
408 # define EXTERN_SIM_BITS_P 1
411 #if (SIM_BITS_INLINE & INLINE_LOCALS)
412 # define STATIC_INLINE_SIM_BITS(TYPE) static INLINE TYPE
414 # define STATIC_INLINE_SIM_BITS(TYPE) static TYPE
417 #define STATIC_SIM_BITS(TYPE) static TYPE
423 #if !defined (SIM_CORE_INLINE) && (DEFAULT_INLINE)
424 # define SIM_CORE_INLINE ALL_C_INLINE
427 #if ((H_REVEALS_MODULE_P (SIM_CORE_INLINE) || defined (SIM_INLINE_C)) \
428 && !defined (SIM_CORE_C) \
429 && (REVEAL_MODULE_P (SIM_CORE_INLINE)))
430 # if (SIM_CORE_INLINE & INLINE_GLOBALS)
431 # define INLINE_SIM_CORE(TYPE) static INLINE TYPE UNUSED
432 # define EXTERN_SIM_CORE_P 0
434 # define INLINE_SIM_CORE(TYPE) static TYPE UNUSED
435 # define EXTERN_SIM_CORE_P 0
438 # define INLINE_SIM_CORE(TYPE) TYPE
439 # define EXTERN_SIM_CORE_P 1
442 #if (SIM_CORE_INLINE & INLINE_LOCALS)
443 # define STATIC_INLINE_SIM_CORE(TYPE) static INLINE TYPE
445 # define STATIC_INLINE_SIM_CORE(TYPE) static TYPE
448 #define STATIC_SIM_CORE(TYPE) static TYPE
454 #if !defined (SIM_ENDIAN_INLINE) && (DEFAULT_INLINE)
455 # define SIM_ENDIAN_INLINE ALL_H_INLINE
458 #if ((H_REVEALS_MODULE_P (SIM_ENDIAN_INLINE) || defined (SIM_INLINE_C)) \
459 && !defined (SIM_ENDIAN_C) \
460 && (REVEAL_MODULE_P (SIM_ENDIAN_INLINE)))
461 # if (SIM_ENDIAN_INLINE & INLINE_GLOBALS)
462 # define INLINE_SIM_ENDIAN(TYPE) static INLINE TYPE UNUSED
463 # define EXTERN_SIM_ENDIAN_P 0
465 # define INLINE_SIM_ENDIAN(TYPE) static TYPE UNUSED
466 # define EXTERN_SIM_ENDIAN_P 0
469 # define INLINE_SIM_ENDIAN(TYPE) TYPE
470 # define EXTERN_SIM_ENDIAN_P 1
473 #if (SIM_ENDIAN_INLINE & INLINE_LOCALS)
474 # define STATIC_INLINE_SIM_ENDIAN(TYPE) static INLINE TYPE
476 # define STATIC_INLINE_SIM_ENDIAN(TYPE) static TYPE
479 #define STATIC_SIM_ENDIAN(TYPE) static TYPE
485 #if !defined (SIM_EVENTS_INLINE) && (DEFAULT_INLINE)
486 # define SIM_EVENTS_INLINE ALL_C_INLINE
489 #if ((H_REVEALS_MODULE_P (SIM_EVENTS_INLINE) || defined (SIM_INLINE_C)) \
490 && !defined (SIM_EVENTS_C) \
491 && (REVEAL_MODULE_P (SIM_EVENTS_INLINE)))
492 # if (SIM_EVENTS_INLINE & INLINE_GLOBALS)
493 # define INLINE_SIM_EVENTS(TYPE) static INLINE TYPE UNUSED
494 # define EXTERN_SIM_EVENTS_P 0
496 # define INLINE_SIM_EVENTS(TYPE) static TYPE UNUSED
497 # define EXTERN_SIM_EVENTS_P 0
500 # define INLINE_SIM_EVENTS(TYPE) TYPE
501 # define EXTERN_SIM_EVENTS_P 1
504 #if (SIM_EVENTS_INLINE & INLINE_LOCALS)
505 # define STATIC_INLINE_SIM_EVENTS(TYPE) static INLINE TYPE
507 # define STATIC_INLINE_SIM_EVENTS(TYPE) static TYPE
510 #define STATIC_SIM_EVENTS(TYPE) static TYPE
516 #if !defined (SIM_FPU_INLINE) && (DEFAULT_INLINE)
517 # define SIM_FPU_INLINE ALL_C_INLINE
520 #if ((H_REVEALS_MODULE_P (SIM_FPU_INLINE) || defined (SIM_INLINE_C)) \
521 && !defined (SIM_FPU_C) \
522 && (REVEAL_MODULE_P (SIM_FPU_INLINE)))
523 # if (SIM_FPU_INLINE & INLINE_GLOBALS)
524 # define INLINE_SIM_FPU(TYPE) static INLINE TYPE UNUSED
525 # define EXTERN_SIM_FPU_P 0
527 # define INLINE_SIM_FPU(TYPE) static TYPE UNUSED
528 # define EXTERN_SIM_FPU_P 0
531 # define INLINE_SIM_FPU(TYPE) TYPE
532 # define EXTERN_SIM_FPU_P 1
535 #if (SIM_FPU_INLINE & INLINE_LOCALS)
536 # define STATIC_INLINE_SIM_FPU(TYPE) static INLINE TYPE
538 # define STATIC_INLINE_SIM_FPU(TYPE) static TYPE
541 #define STATIC_SIM_FPU(TYPE) static TYPE
547 #if ((H_REVEALS_MODULE_P (SIM_TYPES_INLINE) || defined (SIM_INLINE_C)) \
548 && !defined (SIM_TYPES_C) \
549 && (REVEAL_MODULE_P (SIM_TYPES_INLINE)))
550 # if (SIM_TYPES_INLINE & INLINE_GLOBALS)
551 # define INLINE_SIM_TYPES(TYPE) static INLINE TYPE UNUSED
552 # define EXTERN_SIM_TYPES_P 0
554 # define INLINE_SIM_TYPES(TYPE) static TYPE UNUSED
555 # define EXTERN_SIM_TYPES_P 0
558 # define INLINE_SIM_TYPES(TYPE) TYPE
559 # define EXTERN_SIM_TYPES_P 1
562 #if (SIM_TYPES_INLINE & INLINE_LOCALS)
563 # define STATIC_INLINE_SIM_TYPES(TYPE) static INLINE TYPE
565 # define STATIC_INLINE_SIM_TYPES(TYPE) static TYPE
568 #define STATIC_SIM_TYPES(TYPE) static TYPE
574 #if !defined (SIM_MAIN_INLINE) && (DEFAULT_INLINE)
575 # define SIM_MAIN_INLINE (ALL_C_INLINE)
578 #if ((H_REVEALS_MODULE_P (SIM_MAIN_INLINE) || defined (SIM_INLINE_C)) \
579 && !defined (SIM_MAIN_C) \
580 && (REVEAL_MODULE_P (SIM_MAIN_INLINE)))
581 # if (SIM_MAIN_INLINE & INLINE_GLOBALS)
582 # define INLINE_SIM_MAIN(TYPE) static INLINE TYPE UNUSED
583 # define EXTERN_SIM_MAIN_P 0
585 # define INLINE_SIM_MAIN(TYPE) static TYPE UNUSED
586 # define EXTERN_SIM_MAIN_P 0
589 # define INLINE_SIM_MAIN(TYPE) TYPE
590 # define EXTERN_SIM_MAIN_P 1
593 #if (SIM_MAIN_INLINE & INLINE_LOCALS)
594 # define STATIC_INLINE_SIM_MAIN(TYPE) static INLINE TYPE
596 # define STATIC_INLINE_SIM_MAIN(TYPE) static TYPE
599 #define STATIC_SIM_MAIN(TYPE) static TYPE
603 #if ((H_REVEALS_MODULE_P (ENGINE_INLINE) || defined (SIM_INLINE_C)) \
604 && !defined (ENGINE_C) \
605 && (REVEAL_MODULE_P (ENGINE_INLINE)))
606 # if (ENGINE_INLINE & INLINE_GLOBALS)
607 # define INLINE_ENGINE(TYPE) static INLINE TYPE UNUSED
608 # define EXTERN_ENGINE_P 0
610 # define INLINE_ENGINE(TYPE) static TYPE UNUSED
611 # define EXTERN_ENGINE_P 0
614 # define INLINE_ENGINE(TYPE) TYPE
615 # define EXTERN_ENGINE_P 1
618 #if (ENGINE_INLINE & INLINE_LOCALS)
619 # define STATIC_INLINE_ENGINE(TYPE) static INLINE TYPE
621 # define STATIC_INLINE_ENGINE(TYPE) static TYPE
624 #define STATIC_ENGINE(TYPE) static TYPE
630 #if ((H_REVEALS_MODULE_P (ICACHE_INLINE) || defined (SIM_INLINE_C)) \
631 && !defined (ICACHE_C) \
632 && (REVEAL_MODULE_P (ICACHE_INLINE)))
633 # if (ICACHE_INLINE & INLINE_GLOBALS)
634 # define INLINE_ICACHE(TYPE) static INLINE TYPE UNUSED
635 # define EXTERN_ICACHE_P 0
637 # define INLINE_ICACHE(TYPE) static TYPE UNUSED
638 # define EXTERN_ICACHE_P 0
641 # define INLINE_ICACHE(TYPE) TYPE
642 # define EXTERN_ICACHE_P 1
645 #if (ICACHE_INLINE & INLINE_LOCALS)
646 # define STATIC_INLINE_ICACHE(TYPE) static INLINE TYPE
648 # define STATIC_INLINE_ICACHE(TYPE) static TYPE
651 #define STATIC_ICACHE(TYPE) static TYPE
657 #if ((H_REVEALS_MODULE_P (IDECODE_INLINE) || defined (SIM_INLINE_C)) \
658 && !defined (IDECODE_C) \
659 && (REVEAL_MODULE_P (IDECODE_INLINE)))
660 # if (IDECODE_INLINE & INLINE_GLOBALS)
661 # define INLINE_IDECODE(TYPE) static INLINE TYPE UNUSED
662 # define EXTERN_IDECODE_P 0
664 # define INLINE_IDECODE(TYPE) static TYPE UNUSED
665 # define EXTERN_IDECODE_P 0
668 # define INLINE_IDECODE(TYPE) TYPE
669 # define EXTERN_IDECODE_P 1
672 #if (IDECODE_INLINE & INLINE_LOCALS)
673 # define STATIC_INLINE_IDECODE(TYPE) static INLINE TYPE
675 # define STATIC_INLINE_IDECODE(TYPE) static TYPE
678 #define STATIC_IDECODE(TYPE) static TYPE
684 #if ((H_REVEALS_MODULE_P (SEMANTICS_INLINE) || defined (SIM_INLINE_C)) \
685 && !defined (SEMANTICS_C) \
686 && (REVEAL_MODULE_P (SEMANTICS_INLINE)))
687 # if (SEMANTICS_INLINE & INLINE_GLOBALS)
688 # define INLINE_SEMANTICS(TYPE) static INLINE TYPE UNUSED
689 # define EXTERN_SEMANTICS_P 0
691 # define INLINE_SEMANTICS(TYPE) static TYPE UNUSED
692 # define EXTERN_SEMANTICS_P 0
695 # define INLINE_SEMANTICS(TYPE) TYPE
696 # define EXTERN_SEMANTICS_P 1
699 #if EXTERN_SEMANTICS_P
700 # define EXTERN_SEMANTICS(TYPE) TYPE
702 # define EXTERN_SEMANTICS(TYPE) static TYPE UNUSED
705 #if (SEMANTICS_INLINE & INLINE_LOCALS)
706 # define STATIC_INLINE_SEMANTICS(TYPE) static INLINE TYPE
708 # define STATIC_INLINE_SEMANTICS(TYPE) static TYPE
711 #define STATIC_SEMANTICS(TYPE) static TYPE
717 #if !defined (SUPPORT_INLINE) && (DEFAULT_INLINE)
718 # define SUPPORT_INLINE ALL_C_INLINE
721 #if ((H_REVEALS_MODULE_P (SUPPORT_INLINE) || defined (SIM_INLINE_C)) \
722 && !defined (SUPPORT_C) \
723 && (REVEAL_MODULE_P (SUPPORT_INLINE)))
724 # if (SUPPORT_INLINE & INLINE_GLOBALS)
725 # define INLINE_SUPPORT(TYPE) static INLINE TYPE UNUSED
726 # define EXTERN_SUPPORT_P 0
728 # define INLINE_SUPPORT(TYPE) static TYPE UNUSED
729 # define EXTERN_SUPPORT_P 0
732 # define INLINE_SUPPORT(TYPE) TYPE
733 # define EXTERN_SUPPORT_P 1
736 #if (SUPPORT_INLINE & INLINE_LOCALS)
737 # define STATIC_INLINE_SUPPORT(TYPE) static INLINE TYPE
739 # define STATIC_INLINE_SUPPORT(TYPE) static TYPE
742 #define STATIC_SUPPORT(TYPE) static TYPE