home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Source Code 1993 July / THE_SOURCE_CODE_CD_ROM.iso / msdos / djgpp / docs / gcc / gcc.i3 < prev    next >
Encoding:
GNU Info File  |  1993-05-29  |  49.8 KB  |  1,298 lines
  1. This is Info file gcc.info, produced by Makeinfo-1.54 from the input
  2. file gcc.texi.
  3.  
  4.    This file documents the use and the internals of the GNU compiler.
  5.  
  6.    Copyright (C) 1988, 1989, 1992, 1993 Free Software Foundation, Inc.
  7.  
  8.    Permission is granted to make and distribute verbatim copies of this
  9. manual provided the copyright notice and this permission notice are
  10. preserved on all copies.
  11.  
  12.    Permission is granted to copy and distribute modified versions of
  13. this manual under the conditions for verbatim copying, provided also
  14. that the sections entitled "GNU General Public License" and "Protect
  15. Your Freedom--Fight `Look And Feel'" are included exactly as in the
  16. original, and provided that the entire resulting derived work is
  17. distributed under the terms of a permission notice identical to this
  18. one.
  19.  
  20.    Permission is granted to copy and distribute translations of this
  21. manual into another language, under the above conditions for modified
  22. versions, except that the sections entitled "GNU General Public
  23. License" and "Protect Your Freedom--Fight `Look And Feel'", and this
  24. permission notice, may be included in translations approved by the Free
  25. Software Foundation instead of in the original English.
  26.  
  27. 
  28. File: gcc.info,  Node: Preprocessor Options,  Next: Assembler Options,  Prev: Optimize Options,  Up: Invoking GCC
  29.  
  30. Options Controlling the Preprocessor
  31. ====================================
  32.  
  33.    These options control the C preprocessor, which is run on each C
  34. source file before actual compilation.
  35.  
  36.    If you use the `-E' option, nothing is done except preprocessing.
  37. Some of these options make sense only together with `-E' because they
  38. cause the preprocessor output to be unsuitable for actual compilation.
  39.  
  40. `-include FILE'
  41.      Process FILE as input before processing the regular input file.
  42.      In effect, the contents of FILE are compiled first.  Any `-D' and
  43.      `-U' options on the command line are always processed before
  44.      `-include FILE', regardless of the order in which they are
  45.      written.  All the `-include' and `-imacros' options are processed
  46.      in the order in which they are written.
  47.  
  48. `-imacros FILE'
  49.      Process FILE as input, discarding the resulting output, before
  50.      processing the regular input file.  Because the output generated
  51.      from FILE is discarded, the only effect of `-imacros FILE' is to
  52.      make the macros defined in FILE available for use in the main
  53.      input.
  54.  
  55.      Any `-D' and `-U' options on the command line are always processed
  56.      before `-imacros FILE', regardless of the order in which they are
  57.      written.  All the `-include' and `-imacros' options are processed
  58.      in the order in which they are written.
  59.  
  60. `-idirafter DIR'
  61.      Add the directory DIR to the second include path.  The directories
  62.      on the second include path are searched when a header file is not
  63.      found in any of the directories in the main include path (the one
  64.      that `-I' adds to).
  65.  
  66. `-iprefix PREFIX'
  67.      Specify PREFIX as the prefix for subsequent `-iwithprefix' options.
  68.  
  69. `-iwithprefix DIR'
  70.      Add a directory to the second include path.  The directory's name
  71.      is made by concatenating PREFIX and DIR, where PREFIX was
  72.      specified previously with `-iprefix'.
  73.  
  74. `-nostdinc'
  75.      Do not search the standard system directories for header files.
  76.      Only the directories you have specified with `-I' options (and the
  77.      current directory, if appropriate) are searched.  *Note Directory
  78.      Options::, for information on `-I'.
  79.  
  80.      By using both `-nostdinc' and `-I-', you can limit the include-file
  81.      search path to only those directories you specify explicitly.
  82.  
  83. `-undef'
  84.      Do not predefine any nonstandard macros.  (Including architecture
  85.      flags).
  86.  
  87. `-E'
  88.      Run only the C preprocessor.  Preprocess all the C source files
  89.      specified and output the results to standard output or to the
  90.      specified output file.
  91.  
  92. `-C'
  93.      Tell the preprocessor not to discard comments.  Used with the `-E'
  94.      option.
  95.  
  96. `-P'
  97.      Tell the preprocessor not to generate `#line' commands.  Used with
  98.      the `-E' option.
  99.  
  100. `-M'
  101.      Tell the preprocessor to output a rule suitable for `make'
  102.      describing the dependencies of each object file.  For each source
  103.      file, the preprocessor outputs one `make'-rule whose target is the
  104.      object file name for that source file and whose dependencies are
  105.      all the `#include' header files it uses.  This rule may be a
  106.      single line or may be continued with `\'-newline if it is long.
  107.      The list of rules is printed on standard output instead of the
  108.      preprocessed C program.
  109.  
  110.      `-M' implies `-E'.
  111.  
  112.      Another way to specify output of a `make' rule is by setting the
  113.      environment variable `DEPENDENCIES_OUTPUT' (*note Environment
  114.      Variables::.).
  115.  
  116. `-MM'
  117.      Like `-M' but the output mentions only the user header files
  118.      included with `#include "FILE"'.  System header files included
  119.      with `#include <FILE>' are omitted.
  120.  
  121. `-MD'
  122.      Like `-M' but the dependency information is written to files with
  123.      names made by replacing `.o' with `.d' at the end of the output
  124.      file names.  This is in addition to compiling the input files as
  125.      specified--`-MD' does not inhibit ordinary compilation the way
  126.      `-M' does.
  127.  
  128.      The Mach utility `md' can be used to merge the `.d' files into a
  129.      single dependency file suitable for using with the `make' command.
  130.  
  131. `-MMD'
  132.      Like `-MD' except mention only user header files, not system
  133.      header files.
  134.  
  135. `-H'
  136.      Print the name of each header file used, in addition to other
  137.      normal activities.
  138.  
  139. `-AQUESTION(ANSWER)'
  140.      Assert the answer ANSWER for QUESTION, in case it is tested with a
  141.      preprocessor conditional such as `#if #QUESTION(ANSWER)'.  `-A-'
  142.      disables the standard assertions that normally describe the target
  143.      machine.
  144.  
  145. `-DMACRO'
  146.      Define macro MACRO with the string `1' as its definition.
  147.  
  148. `-DMACRO=DEFN'
  149.      Define macro MACRO as DEFN.  All instances of `-D' on the command
  150.      line are processed before any `-U' options.
  151.  
  152. `-UMACRO'
  153.      Undefine macro MACRO.  `-U' options are evaluated after all `-D'
  154.      options, but before any `-include' and `-imacros' options.
  155.  
  156. `-dM'
  157.      Tell the preprocessor to output only a list of the macro
  158.      definitions that are in effect at the end of preprocessing.  Used
  159.      with the `-E' option.
  160.  
  161. `-dD'
  162.      Tell the preprocessing to pass all macro definitions into the
  163.      output, in their proper sequence in the rest of the output.
  164.  
  165. `-dN'
  166.      Like `-dD' except that the macro arguments and contents are
  167.      omitted.  Only `#define NAME' is included in the output.
  168.  
  169. `-trigraphs'
  170.      Support ANSI C trigraphs.  You don't want to know about this
  171.      brain-damage.  The `-ansi' option also has this effect.
  172.  
  173. 
  174. File: gcc.info,  Node: Assembler Options,  Next: Link Options,  Prev: Preprocessor Options,  Up: Invoking GCC
  175.  
  176. Passing Options to the Assembler
  177. ================================
  178.  
  179. `-Wa,OPTION'
  180.      Pass OPTION as an option to the assembler.  If OPTION contains
  181.      commas, it is split into multiple options at the commas.
  182.  
  183. 
  184. File: gcc.info,  Node: Link Options,  Next: Directory Options,  Prev: Assembler Options,  Up: Invoking GCC
  185.  
  186. Options for Linking
  187. ===================
  188.  
  189.    These options come into play when the compiler links object files
  190. into an executable output file.  They are meaningless if the compiler is
  191. not doing a link step.
  192.  
  193. `OBJECT-FILE-NAME'
  194.      A file name that does not end in a special recognized suffix is
  195.      considered to name an object file or library.  (Object files are
  196.      distinguished from libraries by the linker according to the file
  197.      contents.)  If linking is done, these object files are used as
  198.      input to the linker.
  199.  
  200. `-c'
  201. `-S'
  202. `-E'
  203.      If any of these options is used, then the linker is not run, and
  204.      object file names should not be used as arguments.  *Note Overall
  205.      Options::.
  206.  
  207. `-lLIBRARY'
  208.      Search the library named LIBRARY when linking.
  209.  
  210.      It makes a difference where in the command you write this option;
  211.      the linker searches processes libraries and object files in the
  212.      order they are specified.  Thus, `foo.o -lz bar.o' searches
  213.      library `z' after file `foo.o' but before `bar.o'.  If `bar.o'
  214.      refers to functions in `z', those functions may not be loaded.
  215.  
  216.      The linker searches a standard list of directories for the library,
  217.      which is actually a file named `libLIBRARY.a'.  The linker then
  218.      uses this file as if it had been specified precisely by name.
  219.  
  220.      The directories searched include several standard system
  221.      directories plus any that you specify with `-L'.
  222.  
  223.      Normally the files found this way are library files--archive files
  224.      whose members are object files.  The linker handles an archive
  225.      file by scanning through it for members which define symbols that
  226.      have so far been referenced but not defined.  But if the file that
  227.      is found is an ordinary object file, it is linked in the usual
  228.      fashion.  The only difference between using an `-l' option and
  229.      specifying a file name is that `-l' surrounds LIBRARY with `lib'
  230.      and `.a' and searches several directories.
  231.  
  232. `-lobjc'
  233.      You need this special case of the `-l' option in order to link an
  234.      Objective C program.
  235.  
  236. `-nostartfiles'
  237.      Do not use the standard system startup files when linking.  The
  238.      standard libraries are used normally.
  239.  
  240. `-nostdlib'
  241.      Don't use the standard system libraries and startup files when
  242.      linking.  Only the files you specify will be passed to the linker.
  243.  
  244. `-static'
  245.      On systems that support dynamic linking, this prevents linking
  246.      with the shared libraries.  On other systems, this option has no
  247.      effect.
  248.  
  249. `-shared'
  250.      Produce a shared object which can then be linked with other
  251.      objects to form an executable.  Only a few systems support this
  252.      option.
  253.  
  254. `-symbolic'
  255.      Bind references to global symbols when building a shared object.
  256.      Warn about any unresolved references (unless overridden by the
  257.      link editor option `-Xlinker -z -Xlinker defs').  Only a few
  258.      systems support this option.
  259.  
  260. `-Xlinker OPTION'
  261.      Pass OPTION as an option to the linker.  You can use this to
  262.      supply system-specific linker options which GNU CC does not know
  263.      how to recognize.
  264.  
  265.      If you want to pass an option that takes an argument, you must use
  266.      `-Xlinker' twice, once for the option and once for the argument.
  267.      For example, to pass `-assert definitions', you must write
  268.      `-Xlinker -assert -Xlinker definitions'.  It does not work to write
  269.      `-Xlinker "-assert definitions"', because this passes the entire
  270.      string as a single argument, which is not what the linker expects.
  271.  
  272. `-Wl,OPTION'
  273.      Pass OPTION as an option to the linker.  If OPTION contains
  274.      commas, it is split into multiple options at the commas.
  275.  
  276. `-u SYMBOL'
  277.      Pretend the symbol SYMBOL is undefined, to force linking of
  278.      library modules to define it.  You can use `-u' multiple times with
  279.      different symbols to force loading of additional library modules.
  280.  
  281. 
  282. File: gcc.info,  Node: Directory Options,  Next: Target Options,  Prev: Link Options,  Up: Invoking GCC
  283.  
  284. Options for Directory Search
  285. ============================
  286.  
  287.    These options specify directories to search for header files, for
  288. libraries and for parts of the compiler:
  289.  
  290. `-IDIR'
  291.      Append directory DIR to the list of directories searched for
  292.      include files.
  293.  
  294. `-I-'
  295.      Any directories you specify with `-I' options before the `-I-'
  296.      option are searched only for the case of `#include "FILE"'; they
  297.      are not searched for `#include <FILE>'.
  298.  
  299.      If additional directories are specified with `-I' options after
  300.      the `-I-', these directories are searched for all `#include'
  301.      directives.  (Ordinarily *all* `-I' directories are used this way.)
  302.  
  303.      In addition, the `-I-' option inhibits the use of the current
  304.      directory (where the current input file came from) as the first
  305.      search directory for `#include "FILE"'.  There is no way to
  306.      override this effect of `-I-'.  With `-I.' you can specify
  307.      searching the directory which was current when the compiler was
  308.      invoked.  That is not exactly the same as what the preprocessor
  309.      does by default, but it is often satisfactory.
  310.  
  311.      `-I-' does not inhibit the use of the standard system directories
  312.      for header files.  Thus, `-I-' and `-nostdinc' are independent.
  313.  
  314. `-LDIR'
  315.      Add directory DIR to the list of directories to be searched for
  316.      `-l'.
  317.  
  318. `-BPREFIX'
  319.      This option specifies where to find the executables, libraries and
  320.      data files of the compiler itself.
  321.  
  322.      The compiler driver program runs one or more of the subprograms
  323.      `cpp', `cc1', `as' and `ld'.  It tries PREFIX as a prefix for each
  324.      program it tries to run, both with and without `MACHINE/VERSION/'
  325.      (*note Target Options::.).
  326.  
  327.      For each subprogram to be run, the compiler driver first tries the
  328.      `-B' prefix, if any.  If that name is not found, or if `-B' was
  329.      not specified, the driver tries two standard prefixes, which are
  330.      `/usr/lib/gcc/' and `/usr/local/lib/gcc-lib/'.  If neither of
  331.      those results in a file name that is found, the unmodified program
  332.      name is searched for using the directories specified in your
  333.      `PATH' environment variable.
  334.  
  335.      `-B' prefixes that effectively specify directory names also apply
  336.      to libraries in the linker, because the compiler translates these
  337.      options into `-L' options for the linker.
  338.  
  339.      The run-time support file `libgcc.a' can also be searched for using
  340.      the `-B' prefix, if needed.  If it is not found there, the two
  341.      standard prefixes above are tried, and that is all.  The file is
  342.      left out of the link if it is not found by those means.
  343.  
  344.      Another way to specify a prefix much like the `-B' prefix is to use
  345.      the environment variable `GCC_EXEC_PREFIX'.  *Note Environment
  346.      Variables::.
  347.  
  348. 
  349. File: gcc.info,  Node: Target Options,  Next: Submodel Options,  Prev: Directory Options,  Up: Invoking GCC
  350.  
  351. Specifying Target Machine and Compiler Version
  352. ==============================================
  353.  
  354.    By default, GNU CC compiles code for the same type of machine that
  355. you are using.  However, it can also be installed as a cross-compiler,
  356. to compile for some other type of machine.  In fact, several different
  357. configurations of GNU CC, for different target machines, can be
  358. installed side by side.  Then you specify which one to use with the
  359. `-b' option.
  360.  
  361.    In addition, older and newer versions of GNU CC can be installed side
  362. by side.  One of them (probably the newest) will be the default, but
  363. you may sometimes wish to use another.
  364.  
  365. `-b MACHINE'
  366.      The argument MACHINE specifies the target machine for compilation.
  367.      This is useful when you have installed GNU CC as a cross-compiler.
  368.  
  369.      The value to use for MACHINE is the same as was specified as the
  370.      machine type when configuring GNU CC as a cross-compiler.  For
  371.      example, if a cross-compiler was configured with `configure
  372.      i386v', meaning to compile for an 80386 running System V, then you
  373.      would specify `-b i386v' to run that cross compiler.
  374.  
  375.      When you do not specify `-b', it normally means to compile for the
  376.      same type of machine that you are using.
  377.  
  378. `-V VERSION'
  379.      The argument VERSION specifies which version of GNU CC to run.
  380.      This is useful when multiple versions are installed.  For example,
  381.      VERSION might be `2.0', meaning to run GNU CC version 2.0.
  382.  
  383.      The default version, when you do not specify `-V', is controlled
  384.      by the way GNU CC is installed.  Normally, it will be a version
  385.      that is recommended for general use.
  386.  
  387.    The `-b' and `-V' options actually work by controlling part of the
  388. file name used for the executable files and libraries used for
  389. compilation.  A given version of GNU CC, for a given target machine, is
  390. normally kept in the directory `/usr/local/lib/gcc-lib/MACHINE/VERSION'.
  391.  
  392.    It follows that sites can customize the effect of `-b' or `-V'
  393. either by changing the names of these directories or adding alternate
  394. names (or symbolic links).  Thus, if `/usr/local/lib/gcc-lib/80386' is
  395. a link to `/usr/local/lib/gcc-lib/i386v', then `-b 80386' becomes an
  396. alias for `-b i386v'.
  397.  
  398.    In one respect, the `-b' or `-V' do not completely change to a
  399. different compiler: the top-level driver program `gcc' that you
  400. originally invoked continues to run and invoke the other executables
  401. (preprocessor, compiler per se, assembler and linker) that do the real
  402. work.  However, since no real work is done in the driver program, it
  403. usually does not matter that the driver program in use is not the one
  404. for the specified target and version.
  405.  
  406.    The only way that the driver program depends on the target machine is
  407. in the parsing and handling of special machine-specific options.
  408. However, this is controlled by a file which is found, along with the
  409. other executables, in the directory for the specified version and
  410. target machine.  As a result, a single installed driver program adapts
  411. to any specified target machine and compiler version.
  412.  
  413.    The driver program executable does control one significant thing,
  414. however: the default version and target machine.  Therefore, you can
  415. install different instances of the driver program, compiled for
  416. different targets or versions, under different names.
  417.  
  418.    For example, if the driver for version 2.0 is installed as `ogcc'
  419. and that for version 2.1 is installed as `gcc', then the command `gcc'
  420. will use version 2.1 by default, while `ogcc' will use 2.0 by default.
  421. However, you can choose either version with either command with the
  422. `-V' option.
  423.  
  424. 
  425. File: gcc.info,  Node: Submodel Options,  Next: Code Gen Options,  Prev: Target Options,  Up: Invoking GCC
  426.  
  427. Hardware Models and Configurations
  428. ==================================
  429.  
  430.    Earlier we discussed the standard option `-b' which chooses among
  431. different installed compilers for completely different target machines,
  432. such as Vax vs. 68000 vs. 80386.
  433.  
  434.    In addition, each of these target machine types can have its own
  435. special options, starting with `-m', to choose among various hardware
  436. models or configurations--for example, 68010 vs 68020, floating
  437. coprocessor or none.  A single installed version of the compiler can
  438. compile for any model or configuration, according to the options
  439. specified.
  440.  
  441.    Some configurations of the compiler also support additional special
  442. options, usually for compatibility with other compilers on the same
  443. platform.
  444.  
  445.    These options are defined by the macro `TARGET_SWITCHES' in the
  446. machine description.  The default for the options is also defined by
  447. that macro, which enables you to change the defaults.
  448.  
  449. * Menu:
  450.  
  451. * M680x0 Options::
  452. * VAX Options::
  453. * SPARC Options::
  454. * Convex Options::
  455. * AMD29K Options::
  456. * M88K Options::
  457. * RS/6000 Options::
  458. * RT Options::
  459. * MIPS Options::
  460. * i386 Options::
  461. * HPPA Options::
  462. * Intel 960 Options::
  463. * DEC Alpha Options::
  464. * System V Options::
  465.  
  466. 
  467. File: gcc.info,  Node: M680x0 Options,  Next: VAX Options,  Up: Submodel Options
  468.  
  469. M680x0 Options
  470. --------------
  471.  
  472.    These are the `-m' options defined for the 68000 series.  The default
  473. values for these options depends on which style of 68000 was selected
  474. when the compiler was configured; the defaults for the most common
  475. choices are given below.
  476.  
  477. `-m68000'
  478. `-mc68000'
  479.      Generate output for a 68000.  This is the default when the
  480.      compiler is configured for 68000-based systems.
  481.  
  482. `-m68020'
  483. `-mc68020'
  484.      Generate output for a 68020.  This is the default when the
  485.      compiler is configured for 68020-based systems.
  486.  
  487. `-m68881'
  488.      Generate output containing 68881 instructions for floating point.
  489.      This is the default for most 68020 systems unless `-nfp' was
  490.      specified when the compiler was configured.
  491.  
  492. `-m68030'
  493.      Generate output for a 68030.  This is the default when the
  494.      compiler is configured for 68030-based systems.
  495.  
  496. `-m68040'
  497.      Generate output for a 68040.  This is the default when the
  498.      compiler is configured for 68040-based systems.
  499.  
  500. `-m68020-40'
  501.      Generate output for a 68040, without using any of the new
  502.      instructions.  This results in code which can run relatively
  503.      efficiently on either a 68020/68881 or a 68030 or a 68040.
  504.  
  505. `-mfpa'
  506.      Generate output containing Sun FPA instructions for floating point.
  507.  
  508. `-msoft-float'
  509.      Generate output containing library calls for floating point.
  510.      *Warning:* the requisite libraries are not part of GNU CC.
  511.      Normally the facilities of the machine's usual C compiler are
  512.      used, but this can't be done directly in cross-compilation.  You
  513.      must make your own arrangements to provide suitable library
  514.      functions for cross-compilation.
  515.  
  516. `-mshort'
  517.      Consider type `int' to be 16 bits wide, like `short int'.
  518.  
  519. `-mnobitfield'
  520.      Do not use the bit-field instructions.  The `-m68000' option
  521.      implies `-mnobitfield'.
  522.  
  523. `-mbitfield'
  524.      Do use the bit-field instructions.  The `-m68020' option implies
  525.      `-mbitfield'.  This is the default if you use the unmodified
  526.      sources configured for a 68020.
  527.  
  528. `-mrtd'
  529.      Use a different function-calling convention, in which functions
  530.      that take a fixed number of arguments return with the `rtd'
  531.      instruction, which pops their arguments while returning.  This
  532.      saves one instruction in the caller since there is no need to pop
  533.      the arguments there.
  534.  
  535.      This calling convention is incompatible with the one normally used
  536.      on Unix, so you cannot use it if you need to call libraries
  537.      compiled with the Unix compiler.
  538.  
  539.      Also, you must provide function prototypes for all functions that
  540.      take variable numbers of arguments (including `printf'); otherwise
  541.      incorrect code will be generated for calls to those functions.
  542.  
  543.      In addition, seriously incorrect code will result if you call a
  544.      function with too many arguments.  (Normally, extra arguments are
  545.      harmlessly ignored.)
  546.  
  547.      The `rtd' instruction is supported by the 68010 and 68020
  548.      processors, but not by the 68000.
  549.  
  550. 
  551. File: gcc.info,  Node: VAX Options,  Next: SPARC Options,  Prev: M680x0 Options,  Up: Submodel Options
  552.  
  553. VAX Options
  554. -----------
  555.  
  556.    These `-m' options are defined for the Vax:
  557.  
  558. `-munix'
  559.      Do not output certain jump instructions (`aobleq' and so on) that
  560.      the Unix assembler for the Vax cannot handle across long ranges.
  561.  
  562. `-mgnu'
  563.      Do output those jump instructions, on the assumption that you will
  564.      assemble with the GNU assembler.
  565.  
  566. `-mg'
  567.      Output code for g-format floating point numbers instead of
  568.      d-format.
  569.  
  570. 
  571. File: gcc.info,  Node: SPARC Options,  Next: Convex Options,  Prev: VAX Options,  Up: Submodel Options
  572.  
  573. SPARC Options
  574. -------------
  575.  
  576.    These `-m' switches are supported on the SPARC:
  577.  
  578. `-mfpu'
  579. `-mhard-float'
  580.      Generate output containing floating point instructions.  This is
  581.      the default.
  582.  
  583. `-mno-fpu'
  584. `-msoft-float'
  585.      Generate output containing library calls for floating point.
  586.      *Warning:* there is no GNU floating-point library for SPARC.
  587.      Normally the facilities of the machine's usual C compiler are
  588.      used, but this cannot be done directly in cross-compilation.  You
  589.      must make your own arrangements to provide suitable library
  590.      functions for cross-compilation.
  591.  
  592.      `-msoft-float' changes the calling convention in the output file;
  593.      therefore, it is only useful if you compile *all* of a program with
  594.      this option.
  595.  
  596. `-mno-epilogue'
  597. `-mepilogue'
  598.      With `-mepilogue' (the default), the compiler always emits code for
  599.      function exit at the end of each function.  Any function exit in
  600.      the middle of the function (such as a return statement in C) will
  601.      generate a jump to the exit code at the end of the function.
  602.  
  603.      With `-mno-epilogue', the compiler tries to emit exit code inline
  604.      at every function exit.
  605.  
  606. `-mv8'
  607. `-msparclite'
  608.      These two options select variations on the SPARC architecture.
  609.  
  610.      By default (unless specifically configured for the Fujitsu
  611.      SPARClite), GCC generates code for the v7 variant of the SPARC
  612.      architecture.
  613.  
  614.      `-mv8' will give you SPARC v8 code.  The only difference from v7
  615.      code is that the compiler emits the integer multiply and integer
  616.      divide instructions which exist in SPARC v8 but not in SPARC v7.
  617.  
  618.      `-msparclite' will give you SPARClite code.  This adds the integer
  619.      multiply, integer divide step and scan (`ffs') instructions which
  620.      exist in SPARClite but not in SPARC v7.
  621.  
  622. 
  623. File: gcc.info,  Node: Convex Options,  Next: AMD29K Options,  Prev: SPARC Options,  Up: Submodel Options
  624.  
  625. Convex Options
  626. --------------
  627.  
  628.    These `-m' options are defined for Convex:
  629.  
  630. `-mc1'
  631.      Generate output for C1.  The code will run on any Convex machine.
  632.      The preprocessor symbol `__convex__c1__' is defined.
  633.  
  634. `-mc2'
  635.      Generate output for C2.  Uses instructions not available on C1.
  636.      Scheduling and other optimizations are chosen for max performance
  637.      on C2.  The preprocessor symbol `__convex_c2__' is defined.
  638.  
  639. `-mc32'
  640.      Generate output for C32xx.  Uses instructions not available on C1.
  641.      Scheduling and other optimizations are chosen for max performance
  642.      on C32.  The preprocessor symbol `__convex_c32__' is defined.
  643.  
  644. `-mc34'
  645.      Generate output for C34xx.  Uses instructions not available on C1.
  646.      Scheduling and other optimizations are chosen for max performance
  647.      on C34.  The preprocessor symbol `__convex_c34__' is defined.
  648.  
  649. `-mc38'
  650.      Generate output for C38xx.  Uses instructions not available on C1.
  651.      Scheduling and other optimizations are chosen for max performance
  652.      on C38.  The preprocessor symbol `__convex_c38__' is defined.
  653.  
  654. `-margcount'
  655.      Generate code which puts an argument count in the word preceding
  656.      each argument list.  This is compatible with regular CC, and a few
  657.      programs may need the argument count word.  GDB and other
  658.      source-level debuggers do not need it; this info is in the symbol
  659.      table.
  660.  
  661. `-mnoargcount'
  662.      Omit the argument count word.  This is the default.
  663.  
  664. `-mvolatile-cache'
  665.      Allow volatile references to be cached.  This is the default.
  666.  
  667. `-mvolatile-nocache'
  668.      Volatile references bypass the data cache, going all the way to
  669.      memory.  This is only needed for multi-processor code that does
  670.      not use standard synchronization instructions.  Making
  671.      non-volatile references to volatile locations will not necessarily
  672.      work.
  673.  
  674. `-mlong32'
  675.      Type long is 32 bits, the same as type int.  This is the default.
  676.  
  677. `-mlong64'
  678.      Type long is 64 bits, the same as type long long.  This option is
  679.      useless, because no library support exists for it.
  680.  
  681. 
  682. File: gcc.info,  Node: AMD29K Options,  Next: M88K Options,  Prev: Convex Options,  Up: Submodel Options
  683.  
  684. AMD29K Options
  685. --------------
  686.  
  687.    These `-m' options are defined for the AMD Am29000:
  688.  
  689. `-mdw'
  690.      Generate code that assumes the `DW' bit is set, i.e., that byte and
  691.      halfword operations are directly supported by the hardware.  This
  692.      is the default.
  693.  
  694. `-mnodw'
  695.      Generate code that assumes the `DW' bit is not set.
  696.  
  697. `-mbw'
  698.      Generate code that assumes the system supports byte and halfword
  699.      write operations.  This is the default.
  700.  
  701. `-mnbw'
  702.      Generate code that assumes the systems does not support byte and
  703.      halfword write operations.  `-mnbw' implies `-mnodw'.
  704.  
  705. `-msmall'
  706.      Use a small memory model that assumes that all function addresses
  707.      are either within a single 256 KB segment or at an absolute
  708.      address of less than 256K.  This allows the `call' instruction to
  709.      be used instead of a `const', `consth', `calli' sequence.
  710.  
  711. `-mlarge'
  712.      Do not assume that the `call' instruction can be used; this is the
  713.      default.
  714.  
  715. `-m29050'
  716.      Generate code for the Am29050.
  717.  
  718. `-m29000'
  719.      Generate code for the Am29000.  This is the default.
  720.  
  721. `-mkernel-registers'
  722.      Generate references to registers `gr64-gr95' instead of to
  723.      registers `gr96-gr127'.  This option can be used when compiling
  724.      kernel code that wants a set of global registers disjoint from
  725.      that used by user-mode code.
  726.  
  727.      Note that when this option is used, register names in `-f' flags
  728.      must use the normal, user-mode, names.
  729.  
  730. `-muser-registers'
  731.      Use the normal set of global registers, `gr96-gr127'.  This is the
  732.      default.
  733.  
  734. `-mstack-check'
  735.      Insert a call to `__msp_check' after each stack adjustment.  This
  736.      is often used for kernel code.
  737.  
  738. 
  739. File: gcc.info,  Node: M88K Options,  Next: RS/6000 Options,  Prev: AMD29K Options,  Up: Submodel Options
  740.  
  741. M88K Options
  742. ------------
  743.  
  744.    These `-m' options are defined for Motorola 88K architectures:
  745.  
  746. `-m88000'
  747.      Generate code that works well on both the m88100 and the m88110.
  748.  
  749. `-m88100'
  750.      Generate code that works best for the m88100, but that also runs
  751.      on the m88110.
  752.  
  753. `-m88110'
  754.      Generate code that works best for the m88110, and may not run on
  755.      the m88100.
  756.  
  757. `-midentify-revision'
  758.      Include an `ident' directive in the assembler output recording the
  759.      source file name, compiler name and version, timestamp, and
  760.      compilation flags used.
  761.  
  762. `-mno-underscores'
  763.      In assembler output, emit symbol names without adding an underscore
  764.      character at the beginning of each name.  The default is to use an
  765.      underscore as prefix on each name.
  766.  
  767. `-mocs-debug-info'
  768. `-mno-ocs-debug-info'
  769.      Include (or omit) additional debugging information (about
  770.      registers used in each stack frame) as specified in the 88open
  771.      Object Compatibility Standard, "OCS".  This extra information
  772.      allows debugging of code that has had the frame pointer
  773.      eliminated.  The default for DG/UX, SVr4, and Delta 88 SVr3.2 is
  774.      to include this information; other 88k configurations omit this
  775.      information by default.
  776.  
  777. `-mocs-frame-position'
  778.      When emitting COFF debugging information for automatic variables
  779.      and parameters stored on the stack, use the offset from the
  780.      canonical frame address, which is the stack pointer (register 31)
  781.      on entry to the function.  The DG/UX, SVr4, Delta88 SVr3.2, and
  782.      BCS configurations use `-mocs-frame-position'; other 88k
  783.      configurations have the default `-mno-ocs-frame-position'.
  784.  
  785. `-mno-ocs-frame-position'
  786.      When emitting COFF debugging information for automatic variables
  787.      and parameters stored on the stack, use the offset from the frame
  788.      pointer register (register 30).  When this option is in effect,
  789.      the frame pointer is not eliminated when debugging information is
  790.      selected by the -g switch.
  791.  
  792. `-moptimize-arg-area'
  793. `-mno-optimize-arg-area'
  794.      Control how to store function arguments in stack frames.
  795.      `-moptimize-arg-area' saves space, but conflicts with the 88open
  796.      specifications.  However, `-mno-optimize-arg-area' conforms to the
  797.      88open standards.  By default GNU CC does not optimize the argument
  798.      area.
  799.  
  800. `-mshort-data-NUM'
  801.      Generate smaller data references by making them relative to `r0',
  802.      which allows loading a value using a single instruction (rather
  803.      than the usual two).  You control which data references are
  804.      affected by specifying NUM with this option.  For example, if you
  805.      specify `-mshort-data-512', then the data references affected are
  806.      those involving displacements of less than 512 bytes.
  807.      `-mshort-data-NUM' is not effective for NUM greater than 64K.
  808.  
  809. `-mserialize-volatile'
  810. `-mno-serialize-volatile'
  811.      Do, or do not, generate code to guarantee sequential consistency of
  812.      volatile memory references.
  813.  
  814.      GNU CC always guarantees consistency by default, for the preferred
  815.      processor submodel.  How this is done depends on the submodel.
  816.  
  817.      The m88100 processor does not reorder memory references and so
  818.      always provides sequential consistency.  If you use `-m88100', GNU
  819.      CC does not generate any special instructions for sequential
  820.      consistency.
  821.  
  822.      The order of memory references made by the m88110 processor does
  823.      not always match the order of the instructions requesting those
  824.      references.  In particular, a load instruction may execute before
  825.      a preceding store instruction.  Such reordering violates
  826.      sequential consistency of volatile memory references, when there
  827.      are multiple processors.  When you use `-m88000' or `-m88110', GNU
  828.      CC generates special instructions when appropriate, to force
  829.      execution in the proper order.
  830.  
  831.      The extra code generated to guarantee consistency may affect the
  832.      performance of your application.  If you know that you can safely
  833.      forgo this guarantee, you may use the option
  834.      `-mno-serialize-volatile'.
  835.  
  836.      If you use the `-m88100' option but require sequential consistency
  837.      when running on the m88110 processor, you should use
  838.      `-mserialize-volatile'.
  839.  
  840. `-msvr4'
  841. `-msvr3'
  842.      Turn on (`-msvr4') or off (`-msvr3') compiler extensions related
  843.      to System V release 4 (SVr4).  This controls the following:
  844.  
  845.        1. Which variant of the assembler syntax to emit (which you can
  846.           select independently using `-mversion-03.00').
  847.  
  848.        2. `-msvr4' makes the C preprocessor recognize `#pragma weak'
  849.           that is used on System V release 4.
  850.  
  851.        3. `-msvr4' makes GNU CC issue additional declaration directives
  852.           used in SVr4.
  853.  
  854.      `-msvr3' is the default for all m88K configurations except the
  855.      SVr4 configuration.
  856.  
  857. `-mversion-03.00'
  858.      In the DG/UX configuration, there are two flavors of SVr4.  This
  859.      option modifies `-msvr4' to select whether the hybrid-COFF or
  860.      real-ELF flavor is used.  All other configurations ignore this
  861.      option.
  862.  
  863. `-mno-check-zero-division'
  864. `-mcheck-zero-division'
  865.      Early models of the 88K architecture had problems with division by
  866.      zero; in particular, many of them didn't trap.  Use these options
  867.      to avoid including (or to include explicitly) additional code to
  868.      detect division by zero and signal an exception.  All GNU CC
  869.      configurations for the 88K use `-mcheck-zero-division' by default.
  870.  
  871. `-muse-div-instruction'
  872.      Do not emit code to check both the divisor and dividend when doing
  873.      signed integer division to see if either is negative, and adjust
  874.      the signs so the divide is done using non-negative numbers.
  875.      Instead, rely on the operating system to calculate the correct
  876.      value when the `div' instruction traps.  This results in different
  877.      behavior when the most negative number is divided by -1, but is
  878.      useful when most or all signed integer divisions are done with
  879.      positive numbers.
  880.  
  881. `-mtrap-large-shift'
  882. `-mhandle-large-shift'
  883.      Include code to detect bit-shifts of more than 31 bits;
  884.      respectively, trap such shifts or emit code to handle them
  885.      properly.  By default GNU CC makes no special provision for large
  886.      bit shifts.
  887.  
  888. `-mwarn-passed-structs'
  889.      Warn when a function passes a struct as an argument or result.
  890.      Structure-passing conventions have changed during the evolution of
  891.      the C language, and are often the source of portability problems.
  892.      By default, GNU CC issues no such warning.
  893.  
  894. 
  895. File: gcc.info,  Node: RS/6000 Options,  Next: RT Options,  Prev: M88K Options,  Up: Submodel Options
  896.  
  897. IBM RS/6000 Options
  898. -------------------
  899.  
  900.    Only one pair of `-m' options is defined for the IBM RS/6000:
  901.  
  902. `-mfp-in-toc'
  903. `-mno-fp-in-toc'
  904.      Control whether or not floating-point constants go in the Table of
  905.      Contents (TOC), a table of all global variable and function
  906.      addresses.  By default GNU CC puts floating-point constants there;
  907.      if the TOC overflows, `-mno-fp-in-toc' will reduce the size of the
  908.      TOC, which may avoid the overflow.
  909.  
  910. 
  911. File: gcc.info,  Node: RT Options,  Next: MIPS Options,  Prev: RS/6000 Options,  Up: Submodel Options
  912.  
  913. IBM RT Options
  914. --------------
  915.  
  916.    These `-m' options are defined for the IBM RT PC:
  917.  
  918. `-min-line-mul'
  919.      Use an in-line code sequence for integer multiplies.  This is the
  920.      default.
  921.  
  922. `-mcall-lib-mul'
  923.      Call `lmul$$' for integer multiples.
  924.  
  925. `-mfull-fp-blocks'
  926.      Generate full-size floating point data blocks, including the
  927.      minimum amount of scratch space recommended by IBM.  This is the
  928.      default.
  929.  
  930. `-mminimum-fp-blocks'
  931.      Do not include extra scratch space in floating point data blocks.
  932.      This results in smaller code, but slower execution, since scratch
  933.      space must be allocated dynamically.
  934.  
  935. `-mfp-arg-in-fpregs'
  936.      Use a calling sequence incompatible with the IBM calling
  937.      convention in which floating point arguments are passed in
  938.      floating point registers.  Note that `varargs.h' and `stdargs.h'
  939.      will not work with floating point operands if this option is
  940.      specified.
  941.  
  942. `-mfp-arg-in-gregs'
  943.      Use the normal calling convention for floating point arguments.
  944.      This is the default.
  945.  
  946. `-mhc-struct-return'
  947.      Return structures of more than one word in memory, rather than in a
  948.      register.  This provides compatibility with the MetaWare HighC (hc)
  949.      compiler.  Use `-fpcc-struct-return' for compatibility with the
  950.      Portable C Compiler (pcc).
  951.  
  952. `-mnohc-struct-return'
  953.      Return some structures of more than one word in registers, when
  954.      convenient.  This is the default.  For compatibility with the
  955.      IBM-supplied compilers, use either `-fpcc-struct-return' or
  956.      `-mhc-struct-return'.
  957.  
  958. 
  959. File: gcc.info,  Node: MIPS Options,  Next: i386 Options,  Prev: RT Options,  Up: Submodel Options
  960.  
  961. MIPS Options
  962. ------------
  963.  
  964.    These `-m' options are defined for the MIPS family of computers:
  965.  
  966. `-mcpu=CPU TYPE'
  967.      Assume the defaults for the machine type CPU TYPE when scheduling
  968.      instructions.  The default CPU TYPE is `default', which picks the
  969.      longest cycles times for any of the machines, in order that the
  970.      code run at reasonable rates on all MIPS cpu's.  Other choices for
  971.      CPU TYPE are `r2000', `r3000', `r4000', and `r6000'.  While
  972.      picking a specific CPU TYPE will schedule things appropriately for
  973.      that particular chip, the compiler will not generate any code that
  974.      does not meet level 1 of the MIPS ISA (instruction set
  975.      architecture) without the `-mips2' or `-mips3' switches being used.
  976.  
  977. `-mips2'
  978.      Issue instructions from level 2 of the MIPS ISA (branch likely,
  979.      square root instructions).  The `-mcpu=r4000' or `-mcpu=r6000'
  980.      switch must be used in conjunction with `-mips2'.
  981.  
  982. `-mips3'
  983.      Issue instructions from level 3 of the MIPS ISA (64 bit
  984.      instructions).  You must use the `-mcpu=r4000' switch along with
  985.      `-mips3'.
  986.  
  987. `-mint64'
  988. `-mlong64'
  989. `-mlonglong128'
  990.      These options don't work at present.
  991.  
  992. `-mmips-as'
  993.      Generate code for the MIPS assembler, and invoke `mips-tfile' to
  994.      add normal debug information.  This is the default for all
  995.      platforms except for the OSF/1 reference platform, using the
  996.      OSF/rose object format.  If the either of the `-gstabs' or
  997.      `-gstabs+' switches are used, the `mips-tfile' program will
  998.      encapsulate the stabs within MIPS ECOFF.
  999.  
  1000. `-mgas'
  1001.      Generate code for the GNU assembler.  This is the default on the
  1002.      OSF/1 reference platform, using the OSF/rose object format.
  1003.  
  1004. `-mrnames'
  1005. `-mno-rnames'
  1006.      The `-mrnames' switch says to output code using the MIPS software
  1007.      names for the registers, instead of the hardware names (ie, A0
  1008.      instead of $4).  The GNU assembler does not support the `-mrnames'
  1009.      switch, and the MIPS assembler will be instructed to run the MIPS
  1010.      C preprocessor over the source file.  The `-mno-rnames' switch is
  1011.      default.
  1012.  
  1013. `-mgpopt'
  1014. `-mno-gpopt'
  1015.      The `-mgpopt' switch says to write all of the data declarations
  1016.      before the instructions in the text section, this allows the MIPS
  1017.      assembler to generate one word memory references instead of using
  1018.      two words for short global or static data items.  This is on by
  1019.      default if optimization is selected.
  1020.  
  1021. `-mstats'
  1022. `-mno-stats'
  1023.      For each non-inline function processed, the `-mstats' switch
  1024.      causes the compiler to emit one line to the standard error file to
  1025.      print statistics about the program (number of registers saved,
  1026.      stack size, etc.).
  1027.  
  1028. `-mmemcpy'
  1029. `-mno-memcpy'
  1030.      The `-mmemcpy' switch makes all block moves call the appropriate
  1031.      string function (`memcpy' or `bcopy') instead of possibly
  1032.      generating inline code.
  1033.  
  1034. `-mmips-tfile'
  1035. `-mno-mips-tfile'
  1036.      The `-mno-mips-tfile' switch causes the compiler not postprocess
  1037.      the object file with the `mips-tfile' program, after the MIPS
  1038.      assembler has generated it to add debug support.  If `mips-tfile'
  1039.      is not run, then no local variables will be available to the
  1040.      debugger.  In addition, `stage2' and `stage3' objects will have
  1041.      the temporary file names passed to the assembler embedded in the
  1042.      object file, which means the objects will not compare the same.
  1043.      The `-mno-mips-tfile' switch should only be used when there are
  1044.      bugs in the `mips-tfile' program that prevents compilation.
  1045.  
  1046. `-msoft-float'
  1047.      Generate output containing library calls for floating point.
  1048.      *Warning:* the requisite libraries are not part of GNU CC.
  1049.      Normally the facilities of the machine's usual C compiler are
  1050.      used, but this can't be done directly in cross-compilation.  You
  1051.      must make your own arrangements to provide suitable library
  1052.      functions for cross-compilation.
  1053.  
  1054. `-mhard-float'
  1055.      Generate output containing floating point instructions.  This is
  1056.      the default if you use the unmodified sources.
  1057.  
  1058. `-mfp64'
  1059.      Assume that the FR bit in the status word is on, and that there
  1060.      are 32 64-bit floating point registers, instead of 32 32-bit
  1061.      floating point registers.  You must also specify the `-mcpu=r4000'
  1062.      and `-mips3' switches.
  1063.  
  1064. `-mfp32'
  1065.      Assume that there are 32 32-bit floating point registers.  This is
  1066.      the default.
  1067.  
  1068. `-mabicalls'
  1069. `-mno-abicalls'
  1070.      Emit (or do not emit) the `.abicalls', `.cpload', and `.cprestore'
  1071.      pseudo operations that some System V.4 ports use for position
  1072.      independent code.
  1073.  
  1074. `-mlong-calls'
  1075. `-mlong-calls'
  1076.      Do all calls with the `JALR' instruction, which requires loading
  1077.      up a function's address into a register before the call.  You need
  1078.      to use this switch, if you call outside of the current 512
  1079.      megabyte segment to functions that are not through pointers.
  1080.  
  1081. `-mhalf-pic'
  1082. `-mno-half-pic'
  1083.      Put pointers to extern references into the data section and load
  1084.      them up, rather than put the references in the text section.
  1085.  
  1086. `-G NUM'
  1087.      Put global and static items less than or equal to NUM bytes into
  1088.      the small data or bss sections instead of the normal data or bss
  1089.      section.  This allows the assembler to emit one word memory
  1090.      reference instructions based on the global pointer (GP or $28),
  1091.      instead of the normal two words used.  By default, NUM is 8 when
  1092.      the MIPS assembler is used, and 0 when the GNU assembler is used.
  1093.      The `-G NUM' switch is also passed to the assembler and linker.
  1094.      All modules should be compiled with the same `-G NUM' value.
  1095.  
  1096. `-nocpp'
  1097.      Tell the MIPS assembler to not run it's preprocessor over user
  1098.      assembler files (with a `.s' suffix) when assembling them.
  1099.  
  1100.    These options are defined by the macro `TARGET_SWITCHES' in the
  1101. machine description.  The default for the options is also defined by
  1102. that macro, which enables you to change the defaults.
  1103.  
  1104. 
  1105. File: gcc.info,  Node: i386 Options,  Next: HPPA Options,  Prev: MIPS Options,  Up: Submodel Options
  1106.  
  1107. Intel 386 Options
  1108. -----------------
  1109.  
  1110.    These `-m' options are defined for the i386 family of computers:
  1111.  
  1112. `-m486'
  1113. `-mno-486'
  1114.      Control whether or not code is optimized for a 486 instead of an
  1115.      386.  Code generated for an 486 will run on a 386 and vice versa.
  1116.  
  1117. `-msoft-float'
  1118.      Generate output containing library calls for floating point.
  1119.      *Warning:* the requisite libraries are not part of GNU CC.
  1120.      Normally the facilities of the machine's usual C compiler are
  1121.      used, but this can't be done directly in cross-compilation.  You
  1122.      must make your own arrangements to provide suitable library
  1123.      functions for cross-compilation.
  1124.  
  1125.      On machines where a function returns floating point results in the
  1126.      80387 register stack, some floating point opcodes may be emitted
  1127.      even if `-msoft-float' is used.
  1128.  
  1129. `-mno-fp-ret-in-387'
  1130.      Do not use the FPU registers for return values of functions.
  1131.  
  1132.      The usual calling convention has functions return values of types
  1133.      `float' and `double' in an FPU register, even if there is no FPU.
  1134.      The idea is that the operating system should emulate an FPU.
  1135.  
  1136.      The option `-mno-fp-ret-in-387' causes such values to be returned
  1137.      in ordinary CPU registers instead.
  1138.  
  1139. 
  1140. File: gcc.info,  Node: HPPA Options,  Next: Intel 960 Options,  Prev: i386 Options,  Up: Submodel Options
  1141.  
  1142. HPPA Options
  1143. ------------
  1144.  
  1145.    These `-m' options are defined for the HPPA family of computers:
  1146.  
  1147. `-mpa-risc-1-0'
  1148.      Generate code for a PA 1.0 processor.
  1149.  
  1150. `-mpa-risc-1-1'
  1151.      Generate code for a PA 1.1 processor.
  1152.  
  1153. `-mkernel'
  1154.      Generate code which is suitable for use in kernels.  Specifically,
  1155.      avoid `add' instructions in which one of the arguments is the DP
  1156.      register; generate `addil' instructions instead.  This avoids a
  1157.      rather serious bug in the HP-UX linker.
  1158.  
  1159. `-mshared-libs'
  1160.      Generate code that can be linked against HP-UX shared libraries.
  1161.      This option is not fully function yet, and is not on by default
  1162.      for any PA target.  Using this option can cause incorrect code to
  1163.      be generated by the compiler.
  1164.  
  1165. `-mno-shared-libs'
  1166.      Don't generate code that will be linked against shared libraries.
  1167.      This is the default for all PA targets.
  1168.  
  1169. `-mlong-calls'
  1170.      Generate code which allows calls to functions greater than 256K
  1171.      away from the caller when the caller and callee are in the same
  1172.      source file.  Do not turn this option on unless code refuses to
  1173.      link with "branch out of range errors" from the linker.
  1174.  
  1175. `-mdisable-fpregs'
  1176.      Prevent floating point registers from being used in any manner.
  1177.      This is necessary for compiling kernels which perform lazy context
  1178.      switching of floating point registers.  If you use this option and
  1179.      attempt to perform floating point operations, the compiler will
  1180.      abort.
  1181.  
  1182. `-mdisable-indexing'
  1183.      Prevent the compiler from using indexing address modes.  This
  1184.      avoids some rather obscure problems when compiling MIG generated
  1185.      code under MACH.
  1186.  
  1187. `-mtrailing-colon'
  1188.      Add a colon to the end of label definitions (for ELF assemblers).
  1189.  
  1190. 
  1191. File: gcc.info,  Node: Intel 960 Options,  Next: DEC Alpha Options,  Prev: HPPA Options,  Up: Submodel Options
  1192.  
  1193. Intel 960 Options
  1194. -----------------
  1195.  
  1196.    These `-m' options are defined for the Intel 960 implementations:
  1197.  
  1198. `-mCPU TYPE'
  1199.      Assume the defaults for the machine type CPU TYPE for some of the
  1200.      other options, including instruction scheduling, floating point
  1201.      support, and addressing modes.  The choices for CPU TYPE are `ka',
  1202.      `kb', `mc', `ca', `cf', `sa', and `sb'.  The default is `kb'.
  1203.  
  1204. `-mnumerics'
  1205. `-msoft-float'
  1206.      The `-mnumerics' option indicates that the processor does support
  1207.      floating-point instructions.  The `-msoft-float' option indicates
  1208.      that floating-point support should not be assumed.
  1209.  
  1210. `-mleaf-procedures'
  1211. `-mno-leaf-procedures'
  1212.      Do (or do not) attempt to alter leaf procedures to be callable
  1213.      with the `bal' instruction as well as `call'.  This will result in
  1214.      more efficient code for explicit calls when the `bal' instruction
  1215.      can be substituted by the assembler or linker, but less efficient
  1216.      code in other cases, such as calls via function pointers, or using
  1217.      a linker that doesn't support this optimization.
  1218.  
  1219. `-mtail-call'
  1220. `-mno-tail-call'
  1221.      Do (or do not) make additional attempts (beyond those of the
  1222.      machine-independent portions of the compiler) to optimize
  1223.      tail-recursive calls into branches.  You may not want to do this
  1224.      because the detection of cases where this is not valid is not
  1225.      totally complete.  The default is `-mno-tail-call'.
  1226.  
  1227. `-mcomplex-addr'
  1228. `-mno-complex-addr'
  1229.      Assume (or do not assume) that the use of a complex addressing
  1230.      mode is a win on this implementation of the i960.  Complex
  1231.      addressing modes may not be worthwhile on the K-series, but they
  1232.      definitely are on the C-series.  The default is currently
  1233.      `-mcomplex-addr' for all processors except the CB and CC.
  1234.  
  1235. `-mcode-align'
  1236. `-mno-code-align'
  1237.      Align code to 8-byte boundaries for faster fetching (or don't
  1238.      bother).  Currently turned on by default for C-series
  1239.      implementations only.
  1240.  
  1241. `-mic-compat'
  1242. `-mic2.0-compat'
  1243. `-mic3.0-compat'
  1244.      Enable compatibility with iC960 v2.0 or v3.0.
  1245.  
  1246. `-masm-compat'
  1247. `-mintel-asm'
  1248.      Enable compatibility with the iC960 assembler.
  1249.  
  1250. `-mstrict-align'
  1251. `-mno-strict-align'
  1252.      Do not permit (do permit) unaligned accesses.
  1253.  
  1254. `-mold-align'
  1255.      Enable structure-alignment compatibility with Intel's gcc release
  1256.      version 1.3 (based on gcc 1.37).  Currently this is buggy in that
  1257.      `#pragma align 1' is always assumed as well, and cannot be turned
  1258.      off.
  1259.  
  1260. 
  1261. File: gcc.info,  Node: DEC Alpha Options,  Next: System V Options,  Prev: Intel 960 Options,  Up: Submodel Options
  1262.  
  1263. DEC Alpha Options
  1264. -----------------
  1265.  
  1266.    These `-m' options are defined for the DEC Alpha implementations:
  1267.  
  1268. `-mno-soft-float'
  1269. `-msoft-float'
  1270.      Use (do not use) the hardware floating-point instructions for
  1271.      floating-point operations.  When `-msoft-float' is specified,
  1272.      functions in `libgcc1.c' will be used to perform floating-point
  1273.      operations.  Unless they are replaced by routines that emulate the
  1274.      floating-point operations, or compiled in such a way as to call
  1275.      such emulations routines, these routines will issue floating-point
  1276.      operations.   If you are compiling for an Alpha without
  1277.      floating-point operations, you must ensure that the library is
  1278.      built so as not to call them.
  1279.  
  1280.      Note that Alpha implementations without floating-point operations
  1281.      are required to have floating-point registers.
  1282.  
  1283. `-mfp-reg'
  1284. `-mno-fp-regs'
  1285.      Generate code that uses (does not use) the floating-point register
  1286.      set.  `-mno-fp-regs' implies `-msoft-float'.  If the floating-point
  1287.      register set is not used, floating point operands are passed in
  1288.      integer registers as if they were integers and floating-point
  1289.      results are passed in $0 instead of $f0.  This is a non-standard
  1290.      calling sequence, so any function with a floating-point argument
  1291.      or return value called by code compiled with `-mno-fp-regs' must
  1292.      also be compiled with that option.
  1293.  
  1294.      A typical use of this option is building a kernel that does not
  1295.      use, and hence need not save and restore, any floating-point
  1296.      registers.
  1297.  
  1298.