insert.hss 1.8 KB

123456789101112131415161718192021222324
  1. [Main]
  2. Title=Automatically Inserted Section Contents
  3. Subsections=insert_kernel_relocs, insert_mlink_relocs, insert_compressed_relocs, insert_fargo021_relocs, insert_kernel_bss_refs, insert_mlink_bss_refs, insert_compressed_bss_refs, insert_fargo020_bss_refs, insert_fargo021_bss_refs, insert_kernel_data_refs, insert_mlink_data_refs, insert_compressed_data_refs, insert_kernel_rom_calls, insert_mlink_rom_calls, insert_compressed_rom_calls, insert_kernel_ram_calls, insert_kernel_libs, insert_fargo020_libs, insert_fargo021_libs, insert_kernel_exports, insert_fargo_exports, insert_preos_compressed_tables, insert_nostub_comments, insert_data_var_name
  4. [Top]
  5. The TIGCC linker can insert certain variable-length data into the contents of
  6. sections. If a symbol (i.e., a label) at the end of a section is recognized
  7. as an insertion point, then the linker appends the data specified by the
  8. symbol name. If the symbol is not at the end of a section, the insertion will
  9. fail without notice, since these contents may have been inserted
  10. automatically already.
  11. <BR><BR>
  12. You may refer to an insertion symbol even if you did not put a label at a
  13. specific place. In this case, the data is written to an arbitrary place
  14. (usually the end of the program, but do <I>not</I> rely on this). However,
  15. all object files and archives are searched for exported symbols with this
  16. name first, to avoid duplication of the data.
  17. <BR><BR>
  18. This method is only used if some program-related data cannot be expressed
  19. using simple <A HREF="$$LINK(symbols)">built-in symbols</A>. It should be
  20. used with care, as the inserted data may be invalid under certain
  21. circumstances. The format of the data is fixed and usually represents some
  22. already established data format, but new data formats may be developed on
  23. demand. The insertion symbols which are currently recognized are: