home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / info / gcc.info-18 (.txt) < prev    next >
GNU Info File  |  1994-12-22  |  51KB  |  951 lines
  1. This is Info file gcc.info, produced by Makeinfo-1.55 from the input
  2. file gcc.texi.
  3.    This file documents the use and the internals of the GNU compiler.
  4.    Published by the Free Software Foundation 675 Massachusetts Avenue
  5. Cambridge, MA 02139 USA
  6.    Copyright (C) 1988, 1989, 1992, 1993, 1994 Free Software Foundation,
  7.    Permission is granted to make and distribute verbatim copies of this
  8. manual provided the copyright notice and this permission notice are
  9. preserved on all copies.
  10.    Permission is granted to copy and distribute modified versions of
  11. this manual under the conditions for verbatim copying, provided also
  12. that the sections entitled "GNU General Public License," "Funding for
  13. Free Software," and "Protect Your Freedom--Fight `Look And Feel'" are
  14. included exactly as in the original, and provided that the entire
  15. resulting derived work is distributed under the terms of a permission
  16. notice identical to this one.
  17.    Permission is granted to copy and distribute translations of this
  18. manual into another language, under the above conditions for modified
  19. versions, except that the sections entitled "GNU General Public
  20. License," "Funding for Free Software," and "Protect Your Freedom--Fight
  21. `Look And Feel'", and this permission notice, may be included in
  22. translations approved by the Free Software Foundation instead of in the
  23. original English.
  24. File: gcc.info,  Node: Driver,  Next: Run-time Target,  Up: Target Macros
  25. Controlling the Compilation Driver, `gcc'
  26. =========================================
  27.    You can control the compilation driver.
  28. `SWITCH_TAKES_ARG (CHAR)'
  29.      A C expression which determines whether the option `-CHAR' takes
  30.      arguments.  The value should be the number of arguments that
  31.      option takes-zero, for many options.
  32.      By default, this macro is defined to handle the standard options
  33.      properly.  You need not define it unless you wish to add additional
  34.      options which take arguments.
  35. `WORD_SWITCH_TAKES_ARG (NAME)'
  36.      A C expression which determines whether the option `-NAME' takes
  37.      arguments.  The value should be the number of arguments that
  38.      option takes-zero, for many options.  This macro rather than
  39.      `SWITCH_TAKES_ARG' is used for multi-character option names.
  40.      By default, this macro is defined as
  41.      `DEFAULT_WORD_SWITCH_TAKES_ARG', which handles the standard options
  42.      properly.  You need not define `WORD_SWITCH_TAKES_ARG' unless you
  43.      wish to add additional options which take arguments.  Any
  44.      redefinition should call `DEFAULT_WORD_SWITCH_TAKES_ARG' and then
  45.      check for additional options.
  46. `SWITCHES_NEED_SPACES'
  47.      A string-valued C expression which is nonempty if the linker needs
  48.      a space between the `-L' or `-o' option and its argument.
  49.      If this macro is not defined, the default value is 0.
  50. `CPP_SPEC'
  51.      A C string constant that tells the GNU CC driver program options to
  52.      pass to CPP.  It can also specify how to translate options you
  53.      give to GNU CC into options for GNU CC to pass to the CPP.
  54.      Do not define this macro if it does not need to do anything.
  55. `NO_BUILTIN_SIZE_TYPE'
  56.      If this macro is defined, the preprocessor will not define the
  57.      builtin macro `__SIZE_TYPE__'.  The macro `__SIZE_TYPE__' must
  58.      then be defined by `CPP_SPEC' instead.
  59.      This should be defined if `SIZE_TYPE' depends on target dependent
  60.      flags which are not accessible to the preprocessor.  Otherwise, it
  61.      should not be defined.
  62. `NO_BUILTIN_PTRDIFF_TYPE'
  63.      If this macro is defined, the preprocessor will not define the
  64.      builtin macro `__PTRDIFF_TYPE__'.  The macro `__PTRDIFF_TYPE__'
  65.      must then be defined by `CPP_SPEC' instead.
  66.      This should be defined if `PTRDIFF_TYPE' depends on target
  67.      dependent flags which are not accessible to the preprocessor.
  68.      Otherwise, it should not be defined.
  69. `SIGNED_CHAR_SPEC'
  70.      A C string constant that tells the GNU CC driver program options to
  71.      pass to CPP.  By default, this macro is defined to pass the option
  72.      `-D__CHAR_UNSIGNED__' to CPP if `char' will be treated as
  73.      `unsigned char' by `cc1'.
  74.      Do not define this macro unless you need to override the default
  75.      definition.
  76. `CC1_SPEC'
  77.      A C string constant that tells the GNU CC driver program options to
  78.      pass to `cc1'.  It can also specify how to translate options you
  79.      give to GNU CC into options for GNU CC to pass to the `cc1'.
  80.      Do not define this macro if it does not need to do anything.
  81. `CC1PLUS_SPEC'
  82.      A C string constant that tells the GNU CC driver program options to
  83.      pass to `cc1plus'.  It can also specify how to translate options
  84.      you give to GNU CC into options for GNU CC to pass to the
  85.      `cc1plus'.
  86.      Do not define this macro if it does not need to do anything.
  87. `ASM_SPEC'
  88.      A C string constant that tells the GNU CC driver program options to
  89.      pass to the assembler.  It can also specify how to translate
  90.      options you give to GNU CC into options for GNU CC to pass to the
  91.      assembler.  See the file `sun3.h' for an example of this.
  92.      Do not define this macro if it does not need to do anything.
  93. `ASM_FINAL_SPEC'
  94.      A C string constant that tells the GNU CC driver program how to
  95.      run any programs which cleanup after the normal assembler.
  96.      Normally, this is not needed.  See the file `mips.h' for an
  97.      example of this.
  98.      Do not define this macro if it does not need to do anything.
  99. `LINK_SPEC'
  100.      A C string constant that tells the GNU CC driver program options to
  101.      pass to the linker.  It can also specify how to translate options
  102.      you give to GNU CC into options for GNU CC to pass to the linker.
  103.      Do not define this macro if it does not need to do anything.
  104. `LIB_SPEC'
  105.      Another C string constant used much like `LINK_SPEC'.  The
  106.      difference between the two is that `LIB_SPEC' is used at the end
  107.      of the command given to the linker.
  108.      If this macro is not defined, a default is provided that loads the
  109.      standard C library from the usual place.  See `gcc.c'.
  110. `STARTFILE_SPEC'
  111.      Another C string constant used much like `LINK_SPEC'.  The
  112.      difference between the two is that `STARTFILE_SPEC' is used at the
  113.      very beginning of the command given to the linker.
  114.      If this macro is not defined, a default is provided that loads the
  115.      standard C startup file from the usual place.  See `gcc.c'.
  116. `ENDFILE_SPEC'
  117.      Another C string constant used much like `LINK_SPEC'.  The
  118.      difference between the two is that `ENDFILE_SPEC' is used at the
  119.      very end of the command given to the linker.
  120.      Do not define this macro if it does not need to do anything.
  121. `LINK_LIBGCC_SPECIAL'
  122.      Define this macro meaning that `gcc' should find the library
  123.      `libgcc.a' by hand, rather than passing the argument `-lgcc' to
  124.      tell the linker to do the search; also, `gcc' should not generate
  125.      `-L' options to pass to the linker (as it normally does).
  126. `LINK_LIBGCC_SPECIAL_1'
  127.      Define this macro meaning that `gcc' should find the library
  128.      `libgcc.a' by hand, rather than passing the argument `-lgcc' to
  129.      tell the linker to do the search.
  130. `RELATIVE_PREFIX_NOT_LINKDIR'
  131.      Define this macro to tell `gcc' that it should only translate a
  132.      `-B' prefix into a `-L' linker option if the prefix indicates an
  133.      absolute file name.
  134. `STANDARD_EXEC_PREFIX'
  135.      Define this macro as a C string constant if you wish to override
  136.      the standard choice of `/usr/local/lib/gcc-lib/' as the default
  137.      prefix to try when searching for the executable files of the
  138.      compiler.
  139. `MD_EXEC_PREFIX'
  140.      If defined, this macro is an additional prefix to try after
  141.      `STANDARD_EXEC_PREFIX'.  `MD_EXEC_PREFIX' is not searched when the
  142.      `-b' option is used, or the compiler is built as a cross compiler.
  143. `STANDARD_STARTFILE_PREFIX'
  144.      Define this macro as a C string constant if you wish to override
  145.      the standard choice of `/usr/local/lib/' as the default prefix to
  146.      try when searching for startup files such as `crt0.o'.
  147. `MD_STARTFILE_PREFIX'
  148.      If defined, this macro supplies an additional prefix to try after
  149.      the standard prefixes.  `MD_EXEC_PREFIX' is not se