Annotation of gcc/crtstuff.c, revision 1.1

1.1     ! root        1: /* Specialized bits of code needed to support construction and
        !             2:    destruction of file-scope objects in C++ code.
        !             3: 
        !             4:    Written by Ron Guilmette ([email protected]) with help from Richard Stallman.
        !             5: 
        !             6: Copyright (C) 1991 Free Software Foundation, Inc.
        !             7: 
        !             8: This file is part of GNU CC.
        !             9: 
        !            10: GNU CC is free software; you can redistribute it and/or modify
        !            11: it under the terms of the GNU General Public License as published by
        !            12: the Free Software Foundation; either version 2, or (at your option)
        !            13: any later version.
        !            14: 
        !            15: GNU CC is distributed in the hope that it will be useful,
        !            16: but WITHOUT ANY WARRANTY; without even the implied warranty of
        !            17: MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
        !            18: GNU General Public License for more details.
        !            19: 
        !            20: You should have received a copy of the GNU General Public License
        !            21: along with GNU CC; see the file COPYING.  If not, write to
        !            22: the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
        !            23: 
        !            24: /* As a special exception, if you link this library with files
        !            25:    compiled with GCC to produce an executable, this does not cause
        !            26:    the resulting executable to be covered by the GNU General Public License.
        !            27:    This exception does not however invalidate any other reasons why
        !            28:    the executable file might be covered by the GNU General Public License.  */
        !            29: 
        !            30: /* This file is a bit like libgcc1.c/libgcc2.c in that it is compiled
        !            31:    multiple times and yields multiple .o files.
        !            32: 
        !            33:    This file is useful on target machines where the object file format
        !            34:    supports multiple "user-defined" sections (e.g. COFF, ELF, ROSE).  On
        !            35:    such systems, this file allows us to avoid running collect (or any
        !            36:    other such slow and painful kludge).  Additionally, if the target
        !            37:    system supports a .init section, this file allows us to support the
        !            38:    linking of C++ code with a non-C++ main program.
        !            39: 
        !            40:    Note that if INIT_SECTION_ASM_OP is defined in the tm.h file, then
        !            41:    this file *will* make use of the .init section.  If that symbol is
        !            42:    not defined however, then the .init section will not be used.
        !            43: 
        !            44:    Currently, only ELF is actually supported.
        !            45:    The other formats probably need just alternative macro definitions.
        !            46: 
        !            47:    This file must be compiled with gcc.  */
        !            48: 
        !            49: /* It is incorrect to include config.h here, because this file is being
        !            50:    compiled for the target, and hence definitions concerning only the host
        !            51:    do not apply.  */
        !            52: 
        !            53: #include "tm.h"
        !            54: 
        !            55: #ifndef CTORS_SECTION_ASM_OP
        !            56: #define CTORS_SECTION_ASM_OP   "\t.section\t.ctors,\"a\",@progbits"
        !            57: #endif
        !            58: #ifndef DTORS_SECTION_ASM_OP
        !            59: #define DTORS_SECTION_ASM_OP   "\t.section\t.dtors,\"a\",@progbits"
        !            60: #endif
        !            61: 
        !            62: #include "gbl-ctors.h"
        !            63: 
        !            64: #ifndef ON_EXIT /* DO_GLOBAL_CTORS_BODY uses ON_EXIT */
        !            65: #define ON_EXIT(a, b)
        !            66: #endif
        !            67: 
        !            68: #ifdef CRT_BEGIN
        !            69: 
        !            70: #ifdef INIT_SECTION_ASM_OP
        !            71: 
        !            72: /* Force cc1 to switch to .text section.  */
        !            73: static void force_to_text () { }
        !            74: 
        !            75: asm (INIT_SECTION_ASM_OP);     /* cc1 doesn't know that we are switching! */
        !            76: 
        !            77: /* A routine to invoke all of the global constructors upon entry to the
        !            78:    program.  We put this into the .init section (for systems that have
        !            79:    such a thing) so that we can properly perform the construction of
        !            80:    file-scope static-storage C++ objects within shared libraries.   */
        !            81: 
        !            82: static void
        !            83: __do_global_ctors ()           /* prologue goes in .init section */
        !            84: {
        !            85:   asm (TEXT_SECTION_ASM_OP);   /* don't put epilogue and body in .init */
        !            86:   DO_GLOBAL_CTORS_BODY;
        !            87: }
        !            88: 
        !            89: #endif /* defined(INIT_SECTION_ASM_OP) */
        !            90: 
        !            91: /* Force cc1 to switch to .data section.  */
        !            92: static func_ptr force_to_data[0] = { };
        !            93: 
        !            94: /* The -1 is a flag to __do_global_[cd]tors
        !            95:    indicating that this table does not start with a count of elements.  */
        !            96: asm (CTORS_SECTION_ASM_OP);    /* cc1 doesn't know that we are switching! */
        !            97: func_ptr __CTOR_LIST__[1] = { (func_ptr) (-1) };
        !            98: 
        !            99: asm (DTORS_SECTION_ASM_OP);    /* cc1 doesn't know that we are switching! */
        !           100: func_ptr __DTOR_LIST__[1] = { (func_ptr) (-1) };
        !           101: 
        !           102: #endif /* defined(CRT_BEGIN) */
        !           103: 
        !           104: #ifdef CRT_END
        !           105: 
        !           106: #ifdef INIT_SECTION_ASM_OP
        !           107: 
        !           108: /* A routine to invoke all of the global constructors upon entry to the
        !           109:    program.  We put this into the .init section (for systems that have
        !           110:    such a thing) so that we can properly perform the construction of
        !           111:    file-scope static-storage C++ objects within shared libraries.
        !           112: 
        !           113:    This must be virtually identical to the one above so that we can
        !           114:    insure that the function prologue from the one above works correctly
        !           115:    with the epilogue from this one.  (They will both go into the .init
        !           116:    section as the first and last things (respectively) that the linker
        !           117:    will put in that section.)
        !           118: */
        !           119: 
        !           120: static void
        !           121: __do_global_ctors ()           /* prologue goes in .text section */
        !           122: {
        !           123:   asm (INIT_SECTION_ASM_OP);
        !           124:   DO_GLOBAL_CTORS_BODY;
        !           125: }                              /* epilogue and body go in .init section */
        !           126: 
        !           127: #endif /* defined(INIT_SECTION_ASM_OP) */
        !           128: 
        !           129: /* Force cc1 to switch to .data section.  */
        !           130: static func_ptr force_to_data[0] = { };
        !           131: 
        !           132: asm (CTORS_SECTION_ASM_OP);    /* cc1 doesn't know that we are switching! */
        !           133: func_ptr __CTOR_END__[1] = { (func_ptr) 0 };
        !           134: 
        !           135: asm (DTORS_SECTION_ASM_OP);    /* cc1 doesn't know that we are switching! */
        !           136: func_ptr __DTOR_END__[1] = { (func_ptr) 0 };
        !           137: 
        !           138: #endif /* defined(CRT_END) */

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.