modes_native.hss 1.5 KB

123456789101112131415161718192021222324252627
  1. [Main]
  2. Title=TIGCC-Native Linking Mode
  3. [Top]
  4. This mode (which can be enabled using the <B>'--native'</B>
  5. <A HREF="$$LINK(invocation_ld)">command-line option</A> or the control symbol
  6. <A HREF="$$LINK(control_tigcc_native)">_tigcc_native</A>) is the
  7. recommended mode for all new programs. When operating in this mode, the TIGCC
  8. linker does not process the program in any special way, except that it
  9. requires the definition of at least one startup section. The idea is that
  10. stub code should not be handled by the linker itself but rather included
  11. manually by the program as needed. However, every program (regardless of the
  12. architecture and operating system) needs to have a prolog that either
  13. contains the location of the main entry point or is itself the startup code
  14. of the program. On the TI platforms with official assembly program support,
  15. execution always starts at the beginning of the program, so the prolog is
  16. actually the startup code.
  17. <BR><BR>
  18. Ideally, every program should be able to use this mode. However, at the
  19. moment, the output file format cannot be specified other than by switching to
  20. the appropriate mode. If you want to use a different output file format than
  21. the default TIOS format (i.e. Nostub DLL or Fargo II), you cannot use
  22. TIGCC-native mode. At the moment, adding support for explicit selection of
  23. the output file format does not have any particular benefit, since it does
  24. not permit the removal of any of the other modes. However, as soon as the
  25. need for another output format (e.g. raw) arises, there should be a
  26. command-line option to select the format.