OSDN Git Service

* config/stormy16/stormy16.h (ASM_COMMENT_START): Define.
[pf3gnuchains/gcc-fork.git] / gcc / config / stormy16 / stormy16.h
1 /* Stormy16 cpu description.
2    Copyright (C) 1997, 1998, 1999, 2000, 2001
3    Free Software Foundation, Inc.
4    Contributed by Red Hat, Inc.
5
6 This file is part of GNU CC.
7
8 GNU CC is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
11 any later version.
12
13 GNU CC is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 GNU General Public License for more details.
17
18 You should have received a copy of the GNU General Public License
19 along with GNU CC; see the file COPYING.  If not, write to
20 the Free Software Foundation, 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA.  */
22
23 \f
24 /* Set up System V.4 (aka ELF) defaults.  */
25 #include "svr4.h"
26
27 \f
28 /* Driver configuration */
29
30 /* A C expression which determines whether the option `-CHAR' takes arguments.
31    The value should be the number of arguments that option takes-zero, for many
32    options.
33
34    By default, this macro is defined to handle the standard options properly.
35    You need not define it unless you wish to add additional options which take
36    arguments.
37
38    Defined in svr4.h.  */
39 /* #define SWITCH_TAKES_ARG(CHAR) */
40
41 /* A C expression which determines whether the option `-NAME' takes arguments.
42    The value should be the number of arguments that option takes-zero, for many
43    options.  This macro rather than `SWITCH_TAKES_ARG' is used for
44    multi-character option names.
45
46    By default, this macro is defined as `DEFAULT_WORD_SWITCH_TAKES_ARG', which
47    handles the standard options properly.  You need not define
48    `WORD_SWITCH_TAKES_ARG' unless you wish to add additional options which take
49    arguments.  Any redefinition should call `DEFAULT_WORD_SWITCH_TAKES_ARG' and
50    then check for additional options.
51
52    Defined in svr4.h.  */
53 /* #define WORD_SWITCH_TAKES_ARG(NAME) */
54
55 /* A string-valued C expression which is nonempty if the linker needs a space
56    between the `-L' or `-o' option and its argument.
57
58    If this macro is not defined, the default value is 0.  */
59 /* #define SWITCHES_NEED_SPACES "" */
60
61 /* A C string constant that tells the GNU CC driver program options to pass to
62    CPP.  It can also specify how to translate options you give to GNU CC into
63    options for GNU CC to pass to the CPP.
64
65    Do not define this macro if it does not need to do anything.  */
66 /* #define CPP_SPEC "" */
67
68 /* If this macro is defined, the preprocessor will not define the builtin macro
69    `__SIZE_TYPE__'.  The macro `__SIZE_TYPE__' must then be defined by
70    `CPP_SPEC' instead.
71
72    This should be defined if `SIZE_TYPE' depends on target dependent flags
73    which are not accessible to the preprocessor.  Otherwise, it should not be
74    defined.  */
75 /* #define NO_BUILTIN_SIZE_TYPE */
76
77 /* If this macro is defined, the preprocessor will not define the builtin macro
78    `__PTRDIFF_TYPE__'.  The macro `__PTRDIFF_TYPE__' must then be defined by
79    `CPP_SPEC' instead.
80
81    This should be defined if `PTRDIFF_TYPE' depends on target dependent flags
82    which are not accessible to the preprocessor.  Otherwise, it should not be
83    defined.  */
84 /* #define NO_BUILTIN_PTRDIFF_TYPE */
85
86 /* A C string constant that tells the GNU CC driver program options to pass to
87    CPP.  By default, this macro is defined to pass the option
88    `-D__CHAR_UNSIGNED__' to CPP if `char' will be treated as `unsigned char' by
89    `cc1'.
90
91    Do not define this macro unless you need to override the default definition.  */
92 /* #if DEFAULT_SIGNED_CHAR
93    #define SIGNED_CHAR_SPEC "%{funsigned-char:-D__CHAR_UNSIGNED__}"
94    #else
95    #define SIGNED_CHAR_SPEC "%{!fsigned-char:-D__CHAR_UNSIGNED__}"
96    #endif */
97
98 /* A C string constant that tells the GNU CC driver program options to pass to
99    `cc1'.  It can also specify how to translate options you give to GNU CC into
100    options for GNU CC to pass to the `cc1'.
101
102    Do not define this macro if it does not need to do anything.  */
103 /* #define CC1_SPEC "" */
104
105 /* A C string constant that tells the GNU CC driver program options to pass to
106    `cc1plus'.  It can also specify how to translate options you give to GNU CC
107    into options for GNU CC to pass to the `cc1plus'.
108
109    Do not define this macro if it does not need to do anything.  */
110 /* #define CC1PLUS_SPEC "" */
111
112 /* A C string constant that tells the GNU CC driver program options to pass to
113    the assembler.  It can also specify how to translate options you give to GNU
114    CC into options for GNU CC to pass to the assembler.  See the file `sun3.h'
115    for an example of this.
116
117    Do not define this macro if it does not need to do anything.
118
119    Defined in svr4.h.  */
120 #undef ASM_SPEC
121
122 /* A C string constant that tells the GNU CC driver program how to run any
123    programs which cleanup after the normal assembler.  Normally, this is not
124    needed.  See the file `mips.h' for an example of this.
125
126    Do not define this macro if it does not need to do anything.
127
128    Defined in svr4.h.  */
129 /* #define ASM_FINAL_SPEC "" */
130
131 /* A C string constant that tells the GNU CC driver program options to pass to
132    the linker.  It can also specify how to translate options you give to GNU CC
133    into options for GNU CC to pass to the linker.
134
135    Do not define this macro if it does not need to do anything.
136
137    Defined in svr4.h.  */
138 /* #define LINK_SPEC "" */
139
140 /* Another C string constant used much like `LINK_SPEC'.  The difference
141    between the two is that `LIB_SPEC' is used at the end of the command given
142    to the linker.
143
144    If this macro is not defined, a default is provided that loads the standard
145    C library from the usual place.  See `gcc.c'.
146
147    Defined in svr4.h.  */
148 #undef LIB_SPEC
149 #if 0
150 #define LIB_SPEC "-( -lc %{msim:-lsim}%{!msim:-leva_app -lnosys} -)"
151 #endif
152 #define LIB_SPEC "-( -lc %{msim:-lsim} -)"
153
154 /* Another C string constant that tells the GNU CC driver program how and when
155    to place a reference to `libgcc.a' into the linker command line.  This
156    constant is placed both before and after the value of `LIB_SPEC'.
157
158    If this macro is not defined, the GNU CC driver provides a default that
159    passes the string `-lgcc' to the linker unless the `-shared' option is
160    specified.  */
161 /* #define LIBGCC_SPEC "" */
162
163 /* Another C string constant used much like `LINK_SPEC'.  The difference
164    between the two is that `STARTFILE_SPEC' is used at the very beginning of
165    the command given to the linker.
166
167    If this macro is not defined, a default is provided that loads the standard
168    C startup file from the usual place.  See `gcc.c'.
169
170    Defined in svr4.h.  */
171 #undef STARTFILE_SPEC
172 #define STARTFILE_SPEC "crt0.o%s crti.o%s crtbegin.o%s"
173
174 /* Another C string constant used much like `LINK_SPEC'.  The difference
175    between the two is that `ENDFILE_SPEC' is used at the very end of the
176    command given to the linker.
177
178    Do not define this macro if it does not need to do anything.
179
180    Defined in svr4.h.  */
181 #undef ENDFILE_SPEC
182 #define ENDFILE_SPEC "crtend.o%s crtn.o%s"
183
184 /* Define this macro if the driver program should find the library `libgcc.a'
185    itself and should not pass `-L' options to the linker.  If you do not define
186    this macro, the driver program will pass the argument `-lgcc' to tell the
187    linker to do the search and will pass `-L' options to it.  */
188 /* #define LINK_LIBGCC_SPECIAL */
189
190 /* Define this macro if the driver program should find the library `libgcc.a'.
191    If you do not define this macro, the driver program will pass the argument
192    `-lgcc' to tell the linker to do the search.  This macro is similar to
193    `LINK_LIBGCC_SPECIAL', except that it does not affect `-L' options.  */
194 /* #define LINK_LIBGCC_SPECIAL_1 */
195
196 /* Define this macro to provide additional specifications to put in the `specs'
197    file that can be used in various specifications like `CC1_SPEC'.
198
199    The definition should be an initializer for an array of structures,
200    containing a string constant, that defines the specification name, and a
201    string constant that provides the specification.
202
203    Do not define this macro if it does not need to do anything.  */
204 /* #define EXTRA_SPECS {{}} */
205
206 /* Define this macro as a C expression for the initializer of an array of
207    string to tell the driver program which options are defaults for this target
208    and thus do not need to be handled specially when using `MULTILIB_OPTIONS'.
209
210    Do not define this macro if `MULTILIB_OPTIONS' is not defined in the target
211    makefile fragment or if none of the options listed in `MULTILIB_OPTIONS' are
212    set by default.  */
213 /* #define MULTILIB_DEFAULTS {} */
214
215 /* Define this macro to tell `gcc' that it should only translate a `-B' prefix
216    into a `-L' linker option if the prefix indicates an absolute file name. */
217 /* #define RELATIVE_PREFIX_NOT_LINKDIR */
218
219 /* Define this macro as a C string constant if you wish to override the
220    standard choice of `/usr/local/lib/gcc-lib/' as the default prefix to try
221    when searching for the executable files of the compiler. */
222 /* #define STANDARD_EXEC_PREFIX "" */
223
224 /* If defined, this macro is an additional prefix to try after
225    `STANDARD_EXEC_PREFIX'.  `MD_EXEC_PREFIX' is not searched when the `-b'
226    option is used, or the compiler is built as a cross compiler.
227
228    Defined in svr4.h for host compilers.  */
229 /* #define MD_EXEC_PREFIX "" */
230
231 /* Define this macro as a C string constant if you wish to override the
232    standard choice of `/usr/local/lib/' as the default prefix to try when
233    searching for startup files such as `crt0.o'. */
234 /* #define STANDARD_STARTFILE_PREFIX "" */
235
236 /* If defined, this macro supplies an additional prefix to try after the
237    standard prefixes.  `MD_EXEC_PREFIX' is not searched when the `-b' option is
238    used, or when the compiler is built as a cross compiler.
239
240    Defined in svr4.h for host compilers.  */
241 /* #define MD_STARTFILE_PREFIX "" */
242
243 /* If defined, this macro supplies yet another prefix to try after the standard
244    prefixes.  It is not searched when the `-b' option is used, or when the
245    compiler is built as a cross compiler. */
246 /* #define MD_STARTFILE_PREFIX_1 "" */
247
248 /* Define this macro as a C string constant if you with to set environment
249    variables for programs called by the driver, such as the assembler and
250    loader.  The driver passes the value of this macro to `putenv' to initialize
251    the necessary environment variables. */
252 /* #define INIT_ENVIRONMENT "" */
253
254 /* Define this macro as a C string constant if you wish to override the
255    standard choice of `/usr/local/include' as the default prefix to try when
256    searching for local header files.  `LOCAL_INCLUDE_DIR' comes before
257    `SYSTEM_INCLUDE_DIR' in the search order.
258
259    Cross compilers do not use this macro and do not search either
260    `/usr/local/include' or its replacement.  */
261 /* #define LOCAL_INCLUDE_DIR "" */
262
263 /* Define this macro as a C string constant if you wish to specify a
264    system-specific directory to search for header files before the standard
265    directory.  `SYSTEM_INCLUDE_DIR' comes before `STANDARD_INCLUDE_DIR' in the
266    search order.
267
268    Cross compilers do not use this macro and do not search the directory
269    specified. */
270 /* #define SYSTEM_INCLUDE_DIR "" */
271
272 /* Define this macro as a C string constant if you wish to override the
273    standard choice of `/usr/include' as the default prefix to try when
274    searching for header files.
275
276    Cross compilers do not use this macro and do not search either
277    `/usr/include' or its replacement. */
278 /* #define STANDARD_INCLUDE_DIR "" */
279
280 /* Define this macro if you wish to override the entire default search path for
281    include files.  The default search path includes `GCC_INCLUDE_DIR',
282    `LOCAL_INCLUDE_DIR', `SYSTEM_INCLUDE_DIR', `GPLUSPLUS_INCLUDE_DIR', and
283    `STANDARD_INCLUDE_DIR'.  In addition, `GPLUSPLUS_INCLUDE_DIR' and
284    `GCC_INCLUDE_DIR' are defined automatically by `Makefile', and specify
285    private search areas for GCC.  The directory `GPLUSPLUS_INCLUDE_DIR' is used
286    only for C++ programs.
287
288      The definition should be an initializer for an array of structures.  Each
289      array element should have two elements: the directory name (a string
290      constant) and a flag for C++-only directories.  Mark the end of the array
291      with a null element.  For example, here is the definition used for VMS:
292
293           #define INCLUDE_DEFAULTS \
294           {                                       \
295             { "GNU_GXX_INCLUDE:", 1},             \
296             { "GNU_CC_INCLUDE:", 0},              \
297             { "SYS$SYSROOT:[SYSLIB.]", 0},        \
298             { ".", 0},                            \
299             { 0, 0}                               \
300           }
301
302    Here is the order of prefixes tried for exec files:
303
304   1. Any prefixes specified by the user with `-B'.
305
306   2. The environment variable `GCC_EXEC_PREFIX', if any.
307
308   3. The directories specified by the environment variable
309      `COMPILER_PATH'.
310
311   4. The macro `STANDARD_EXEC_PREFIX'.
312
313   5. `/usr/lib/gcc/'.
314
315   6. The macro `MD_EXEC_PREFIX', if any.
316
317    Here is the order of prefixes tried for startfiles:
318
319   1. Any prefixes specified by the user with `-B'.
320
321   2. The environment variable `GCC_EXEC_PREFIX', if any.
322
323   3. The directories specified by the environment variable
324      `LIBRARY_PATH' (native only, cross compilers do not use this).
325
326   4. The macro `STANDARD_EXEC_PREFIX'.
327
328   5. `/usr/lib/gcc/'.
329
330   6. The macro `MD_EXEC_PREFIX', if any.
331
332   7. The macro `MD_STARTFILE_PREFIX', if any.
333
334   8. The macro `STANDARD_STARTFILE_PREFIX'.
335
336   9. `/lib/'.
337
338  10. `/usr/lib/'.  */
339 /* #define INCLUDE_DEFAULTS {{ }} */
340
341 \f
342 /* Run-time target specifications */
343
344 /* Define this to be a string constant containing `-D' options to define the
345    predefined macros that identify this machine and system.  These macros will
346    be predefined unless the `-ansi' option is specified.
347
348    In addition, a parallel set of macros are predefined, whose names are made
349    by appending `__' at the beginning and at the end.  These `__' macros are
350    permitted by the ANSI standard, so they are predefined regardless of whether
351    `-ansi' is specified.
352
353    For example, on the Sun, one can use the following value:
354
355         "-Dmc68000 -Dsun -Dunix"
356
357    The result is to define the macros `__mc68000__', `__sun__' and `__unix__'
358    unconditionally, and the macros `mc68000', `sun' and `unix' provided `-ansi'
359    is not specified.  */
360 #define CPP_PREDEFINES "-Dstormy16 -Amachine=stormy16 -D__INT_MAX__=32767"
361
362 /* This declaration should be present.  */
363 extern int target_flags;
364
365 /* This series of macros is to allow compiler command arguments to enable or
366    disable the use of optional features of the target machine.  For example,
367    one machine description serves both the 68000 and the 68020; a command
368    argument tells the compiler whether it should use 68020-only instructions or
369    not.  This command argument works by means of a macro `TARGET_68020' that
370    tests a bit in `target_flags'.
371
372    Define a macro `TARGET_FEATURENAME' for each such option.  Its definition
373    should test a bit in `target_flags'; for example:
374
375         #define TARGET_68020 (target_flags & 1)
376
377    One place where these macros are used is in the condition-expressions of
378    instruction patterns.  Note how `TARGET_68020' appears frequently in the
379    68000 machine description file, `m68k.md'.  Another place they are used is
380    in the definitions of the other macros in the `MACHINE.h' file.  */
381 /* #define TARGET_... */
382
383 /* This macro defines names of command options to set and clear bits in
384    `target_flags'.  Its definition is an initializer with a subgrouping for
385    each command option.
386
387    Each subgrouping contains a string constant, that defines the
388    option name, a number, which contains the bits to set in
389    `target_flags', and an optional second string which is the textual
390    description that will be displayed when the user passes --help on
391    the command line.  If the number entry is negative then the
392    specified bits will be cleared instead of being set.  If the second
393    string entry is present but empty, then no help information will be
394    displayed for that option, but it will not count as an undocumented
395    option.  The actual option name, as seen on the command line is
396    made by appending `-m' to the specified name.
397
398    One of the subgroupings should have a null string.  The number in this
399    grouping is the default value for `target_flags'.  Any target options act
400    starting with that value.
401
402    Here is an example which defines `-m68000' and `-m68020' with opposite
403    meanings, and picks the latter as the default:
404
405         #define TARGET_SWITCHES \
406           { { "68020",  1, ""},      \
407             { "68000", -1, "Compile for the m68000"},     \
408             { "",       1, }}
409
410    This declaration must be present.  */
411
412 #define TARGET_SWITCHES                                 \
413   {{ "sim", 0, "Provide libraries for the simulator" }, \
414    { "", 0, "" }}
415
416 /* This macro is similar to `TARGET_SWITCHES' but defines names of command
417    options that have values.  Its definition is an initializer with a
418    subgrouping for each command option.
419
420    Each subgrouping contains a string constant, that defines the fixed part of
421    the option name, the address of a variable, and an optional description string.
422    The variable, of type `char *', is set to the text following the fixed part of
423    the option as it is specified on the command line.  The actual option name is
424    made by appending `-m' to the specified name.
425
426    Here is an example which defines `-mshort-data-NUMBER'.  If the given option
427    is `-mshort-data-512', the variable `m88k_short_data' will be set to the
428    string `"512"'.
429
430         extern char *m88k_short_data;
431         #define TARGET_OPTIONS \
432          { { "short-data-", & m88k_short_data, \
433          "Specify the size of the short data section"  } }
434
435    This declaration is optional.  */
436 /* #define TARGET_OPTIONS */
437
438 /* This macro is a C statement to print on `stderr' a string describing the
439    particular machine description choice.  Every machine description should
440    define `TARGET_VERSION'.  For example:
441
442         #ifdef MOTOROLA
443         #define TARGET_VERSION \
444           fprintf (stderr, " (68k, Motorola syntax)");
445         #else
446         #define TARGET_VERSION \
447           fprintf (stderr, " (68k, MIT syntax)");
448         #endif  */
449 #define TARGET_VERSION fprintf (stderr, " (stormy16 cpu core)");
450
451 /* Sometimes certain combinations of command options do not make sense on a
452    particular target machine.  You can define a macro `OVERRIDE_OPTIONS' to
453    take account of this.  This macro, if defined, is executed once just after
454    all the command options have been parsed.
455
456    Don't use this macro to turn on various extra optimizations for `-O'.  That
457    is what `OPTIMIZATION_OPTIONS' is for.  */
458 /* #define OVERRIDE_OPTIONS */
459
460 /* Some machines may desire to change what optimizations are performed for
461    various optimization levels.  This macro, if defined, is executed once just
462    after the optimization level is determined and before the remainder of the
463    command options have been parsed.  Values set in this macro are used as the
464    default values for the other command line options.
465
466    LEVEL is the optimization level specified; 2 if `-O2' is specified, 1 if
467    `-O' is specified, and 0 if neither is specified.
468
469    SIZE is non-zero if `-Os' is specified, 0 otherwise.  
470
471    You should not use this macro to change options that are not
472    machine-specific.  These should uniformly selected by the same optimization
473    level on all supported machines.  Use this macro to enable machbine-specific
474    optimizations.
475
476    *Do not examine `write_symbols' in this macro!* The debugging options are
477    *not supposed to alter the generated code.  */
478 /* #define OPTIMIZATION_OPTIONS(LEVEL,SIZE) */
479
480 /* Define this macro if debugging can be performed even without a frame
481    pointer.  If this macro is defined, GNU CC will turn on the
482    `-fomit-frame-pointer' option whenever `-O' is specified.  */
483 #define CAN_DEBUG_WITHOUT_FP
484
485 \f
486 /* Storage Layout */
487
488 /* Define this macro to have the value 1 if the most significant bit in a byte
489    has the lowest number; otherwise define it to have the value zero.  This
490    means that bit-field instructions count from the most significant bit.  If
491    the machine has no bit-field instructions, then this must still be defined,
492    but it doesn't matter which value it is defined to.  This macro need not be
493    a constant.
494
495    This macro does not affect the way structure fields are packed into bytes or
496    words; that is controlled by `BYTES_BIG_ENDIAN'.  */
497 #define BITS_BIG_ENDIAN 1
498
499 /* Define this macro to have the value 1 if the most significant byte in a word
500    has the lowest number.  This macro need not be a constant.  */
501 #define BYTES_BIG_ENDIAN 0
502
503 /* Define this macro to have the value 1 if, in a multiword object, the most
504    significant word has the lowest number.  This applies to both memory
505    locations and registers; GNU CC fundamentally assumes that the order of
506    words in memory is the same as the order in registers.  This macro need not
507    be a constant.  */
508 #define WORDS_BIG_ENDIAN 0
509
510 /* Define this macro if WORDS_BIG_ENDIAN is not constant.  This must be a
511    constant value with the same meaning as WORDS_BIG_ENDIAN, which will be used
512    only when compiling libgcc2.c.  Typically the value will be set based on
513    preprocessor defines.  */
514 /* #define LIBGCC2_WORDS_BIG_ENDIAN */
515
516 /* Define this macro to have the value 1 if `DFmode', `XFmode' or `TFmode'
517    floating point numbers are stored in memory with the word containing the
518    sign bit at the lowest address; otherwise define it to have the value 0.
519    This macro need not be a constant.
520
521    You need not define this macro if the ordering is the same as for multi-word
522    integers.  */
523 /* #define FLOAT_WORDS_BIG_ENDIAN */
524
525 /* Define this macro to be the number of bits in an addressable storage unit
526    (byte); normally 8.  */
527 #define BITS_PER_UNIT 8
528
529 /* Number of bits in a word; normally 32.  */
530 #define BITS_PER_WORD 16
531
532 /* Maximum number of bits in a word.  If this is undefined, the default is
533    `BITS_PER_WORD'.  Otherwise, it is the constant value that is the largest
534    value that `BITS_PER_WORD' can have at run-time.  */
535 /* #define MAX_BITS_PER_WORD */
536
537 /* Number of storage units in a word; normally 4.  */
538 #define UNITS_PER_WORD 2
539
540 /* Minimum number of units in a word.  If this is undefined, the default is
541    `UNITS_PER_WORD'.  Otherwise, it is the constant value that is the smallest
542    value that `UNITS_PER_WORD' can have at run-time.  */
543 /* #define MIN_UNITS_PER_WORD */
544
545 /* Width of a pointer, in bits.  You must specify a value no wider than the
546    width of `Pmode'.  If it is not equal to the width of `Pmode', you must
547    define `POINTERS_EXTEND_UNSIGNED'.  */
548 #define POINTER_SIZE 16
549
550 /* A C expression whose value is nonzero if pointers that need to be extended
551    from being `POINTER_SIZE' bits wide to `Pmode' are sign-extended and zero if
552    they are zero-extended.
553
554    You need not define this macro if the `POINTER_SIZE' is equal to the width
555    of `Pmode'.  */
556 /* #define POINTERS_EXTEND_UNSIGNED */
557
558 /* A macro to update MODE and UNSIGNEDP when an object whose type is TYPE and
559    which has the specified mode and signedness is to be stored in a register.
560    This macro is only called when TYPE is a scalar type.
561
562    On most RISC machines, which only have operations that operate on a full
563    register, define this macro to set M to `word_mode' if M is an integer mode
564    narrower than `BITS_PER_WORD'.  In most cases, only integer modes should be
565    widened because wider-precision floating-point operations are usually more
566    expensive than their narrower counterparts.
567
568    For most machines, the macro definition does not change UNSIGNEDP.  However,
569    some machines, have instructions that preferentially handle either signed or
570    unsigned quantities of certain modes.  For example, on the DEC Alpha, 32-bit
571    loads from memory and 32-bit add instructions sign-extend the result to 64
572    bits.  On such machines, set UNSIGNEDP according to which kind of extension
573    is more efficient.
574
575    Do not define this macro if it would never modify MODE.  */
576 #define PROMOTE_MODE(MODE,UNSIGNEDP,TYPE)                               \
577 do {                                                                    \
578   if (GET_MODE_CLASS (MODE) == MODE_INT                                 \
579       && GET_MODE_SIZE (MODE) < 2)                                      \
580     (MODE) = HImode;                                                    \
581 } while (0)
582
583 /* Define this macro if the promotion described by `PROMOTE_MODE' should also
584    be done for outgoing function arguments.  */
585 #define PROMOTE_FUNCTION_ARGS 1
586
587 /* Define this macro if the promotion described by `PROMOTE_MODE' should also
588    be done for the return value of functions.
589
590    If this macro is defined, `FUNCTION_VALUE' must perform the same promotions
591    done by `PROMOTE_MODE'.  */
592 #define PROMOTE_FUNCTION_RETURN 1
593
594 /* Define this macro if the promotion described by `PROMOTE_MODE' should *only*
595    be performed for outgoing function arguments or function return values, as
596    specified by `PROMOTE_FUNCTION_ARGS' and `PROMOTE_FUNCTION_RETURN',
597    respectively.  */
598 /* #define PROMOTE_FOR_CALL_ONLY */
599
600 /* Normal alignment required for function parameters on the stack, in bits.
601    All stack parameters receive at least this much alignment regardless of data
602    type.  On most machines, this is the same as the size of an integer.  */
603 #define PARM_BOUNDARY 16
604
605 /* Define this macro if you wish to preserve a certain alignment for the stack
606    pointer.  The definition is a C expression for the desired alignment
607    (measured in bits).
608
609    If `PUSH_ROUNDING' is not defined, the stack will always be aligned to the
610    specified boundary.  If `PUSH_ROUNDING' is defined and specifies a less
611    strict alignment than `STACK_BOUNDARY', the stack may be momentarily
612    unaligned while pushing arguments.  */
613 #define STACK_BOUNDARY 16
614
615 /* Alignment required for a function entry point, in bits.  */
616 #define FUNCTION_BOUNDARY 16
617
618 /* Biggest alignment that any data type can require on this machine,
619    in bits.  */
620 #define BIGGEST_ALIGNMENT 16
621
622 /* Biggest alignment that any structure field can require on this machine, in
623    bits.  If defined, this overrides `BIGGEST_ALIGNMENT' for structure fields
624    only.  */
625 /* #define BIGGEST_FIELD_ALIGNMENT */
626
627 /* An expression for the alignment of a structure field FIELD if the
628    alignment computed in the usual way is COMPUTED.  GNU CC uses this
629    value instead of the value in `BIGGEST_ALIGNMENT' or
630    `BIGGEST_FIELD_ALIGNMENT', if defined, for structure fields only.  */
631 /* #define ADJUST_FIELD_ALIGN(FIELD, COMPUTED) */
632
633 /* Biggest alignment supported by the object file format of this machine.  Use
634    this macro to limit the alignment which can be specified using the
635    `__attribute__ ((aligned (N)))' construct.  If not defined, the default
636    value is `BIGGEST_ALIGNMENT'.
637
638    Defined in svr4.h.  */
639 /* #define MAX_OFILE_ALIGNMENT */
640
641 /* If defined, a C expression to compute the alignment for a static variable.
642    TYPE is the data type, and ALIGN is the alignment that the object
643    would ordinarily have.  The value of this macro is used instead of that
644    alignment to align the object.
645
646    If this macro is not defined, then ALIGN is used.
647
648    One use of this macro is to increase alignment of medium-size data to make
649    it all fit in fewer cache lines.  Another is to cause character arrays to be
650    word-aligned so that `strcpy' calls that copy constants to character arrays
651    can be done inline.  */
652 #define DATA_ALIGNMENT(TYPE, ALIGN)             \
653   (TREE_CODE (TYPE) == ARRAY_TYPE               \
654    && TYPE_MODE (TREE_TYPE (TYPE)) == QImode    \
655    && (ALIGN) < BITS_PER_WORD ? BITS_PER_WORD : (ALIGN))
656
657 /* If defined, a C expression to compute the alignment given to a constant that
658    is being placed in memory.  CONSTANT is the constant and ALIGN is the
659    alignment that the object would ordinarily have.  The value of this macro is
660    used instead of that alignment to align the object.
661
662    If this macro is not defined, then ALIGN is used.
663
664    The typical use of this macro is to increase alignment for string constants
665    to be word aligned so that `strcpy' calls that copy constants can be done
666    inline.  */
667 #define CONSTANT_ALIGNMENT(EXP, ALIGN)  \
668   (TREE_CODE (EXP) == STRING_CST        \
669    && (ALIGN) < BITS_PER_WORD ? BITS_PER_WORD : (ALIGN))
670
671 /* Alignment in bits to be given to a structure bit field that follows an empty
672    field such as `int : 0;'.
673
674    Note that `PCC_BITFIELD_TYPE_MATTERS' also affects the alignment that
675    results from an empty field.  */
676 /* #define EMPTY_FIELD_BOUNDARY */
677
678 /* Number of bits which any structure or union's size must be a multiple of.
679    Each structure or union's size is rounded up to a multiple of this.
680
681    If you do not define this macro, the default is the same as `BITS_PER_UNIT'.  */
682 /* #define STRUCTURE_SIZE_BOUNDARY */
683
684 /* Define this macro to be the value 1 if instructions will fail to work if
685    given data not on the nominal alignment.  If instructions will merely go
686    slower in that case, define this macro as 0.  */
687 #define STRICT_ALIGNMENT 1
688
689 /* Define this if you wish to imitate the way many other C compilers handle
690    alignment of bitfields and the structures that contain them.
691
692    The behavior is that the type written for a bitfield (`int', `short', or
693    other integer type) imposes an alignment for the entire structure, as if the
694    structure really did contain an ordinary field of that type.  In addition,
695    the bitfield is placed within the structure so that it would fit within such
696    a field, not crossing a boundary for it.
697
698    Thus, on most machines, a bitfield whose type is written as `int' would not
699    cross a four-byte boundary, and would force four-byte alignment for the
700    whole structure.  (The alignment used may not be four bytes; it is
701    controlled by the other alignment parameters.)
702
703    If the macro is defined, its definition should be a C expression; a nonzero
704    value for the expression enables this behavior.
705
706    Note that if this macro is not defined, or its value is zero, some bitfields
707    may cross more than one alignment boundary.  The compiler can support such
708    references if there are `insv', `extv', and `extzv' insns that can directly
709    reference memory.
710
711    The other known way of making bitfields work is to define
712    `STRUCTURE_SIZE_BOUNDARY' as large as `BIGGEST_ALIGNMENT'.  Then every
713    structure can be accessed with fullwords.
714
715    Unless the machine has bitfield instructions or you define
716    `STRUCTURE_SIZE_BOUNDARY' that way, you must define
717    `PCC_BITFIELD_TYPE_MATTERS' to have a nonzero value.
718
719    If your aim is to make GNU CC use the same conventions for laying out
720    bitfields as are used by another compiler, here is how to investigate what
721    the other compiler does.  Compile and run this program:
722
723         struct foo1
724         {
725           char x;
726           char :0;
727           char y;
728         };
729
730         struct foo2
731         {
732           char x;
733           int :0;
734           char y;
735         };
736
737         main ()
738         {
739           printf ("Size of foo1 is %d\n",
740                   sizeof (struct foo1));
741           printf ("Size of foo2 is %d\n",
742                   sizeof (struct foo2));
743           exit (0);
744         }
745
746    If this prints 2 and 5, then the compiler's behavior is what you would get
747    from `PCC_BITFIELD_TYPE_MATTERS'.
748
749    Defined in svr4.h.  */
750 #define PCC_BITFIELD_TYPE_MATTERS 1
751
752 /* Like PCC_BITFIELD_TYPE_MATTERS except that its effect is limited to aligning
753    a bitfield within the structure.  */
754 /* #define BITFIELD_NBYTES_LIMITED */
755
756 /* Define this macro as an expression for the overall size of a structure
757    (given by STRUCT as a tree node) when the size computed from the fields is
758    SIZE and the alignment is ALIGN.
759
760    The default is to round SIZE up to a multiple of ALIGN.  */
761 /* #define ROUND_TYPE_SIZE(STRUCT, SIZE, ALIGN) */
762
763 /* Define this macro as an expression for the alignment of a structure (given
764    by STRUCT as a tree node) if the alignment computed in the usual way is
765    COMPUTED and the alignment explicitly specified was SPECIFIED.
766
767    The default is to use SPECIFIED if it is larger; otherwise, use the smaller
768    of COMPUTED and `BIGGEST_ALIGNMENT' */
769 /* #define ROUND_TYPE_ALIGN(STRUCT, COMPUTED, SPECIFIED) */
770
771 /* An integer expression for the size in bits of the largest integer machine
772    mode that should actually be used.  All integer machine modes of this size
773    or smaller can be used for structures and unions with the appropriate sizes.
774    If this macro is undefined, `GET_MODE_BITSIZE (DImode)' is assumed.  */
775 /* #define MAX_FIXED_MODE_SIZE */
776
777 /* A C statement to validate the value VALUE (of type `double') for mode MODE.
778    This means that you check whether VALUE fits within the possible range of
779    values for mode MODE on this target machine.  The mode MODE is always a mode
780    of class `MODE_FLOAT'.  OVERFLOW is nonzero if the value is already known to
781    be out of range.
782
783    If VALUE is not valid or if OVERFLOW is nonzero, you should set OVERFLOW to
784    1 and then assign some valid value to VALUE.  Allowing an invalid value to
785    go through the compiler can produce incorrect assembler code which may even
786    cause Unix assemblers to crash.
787
788    This macro need not be defined if there is no work for it to do.  */
789 /* #define CHECK_FLOAT_VALUE(MODE, VALUE, OVERFLOW) */
790
791 /* A code distinguishing the floating point format of the target machine.
792    There are three defined values:
793
794    IEEE_FLOAT_FORMAT'
795         This code indicates IEEE floating point.  It is the default;
796         there is no need to define this macro when the format is IEEE.
797
798    VAX_FLOAT_FORMAT'
799         This code indicates the peculiar format used on the Vax.
800
801    UNKNOWN_FLOAT_FORMAT'
802         This code indicates any other format.
803
804    The value of this macro is compared with `HOST_FLOAT_FORMAT'
805    to determine whether the target machine has the same format as
806    the host machine.  If any other formats are actually in use on supported
807    machines, new codes should be defined for them.
808
809    The ordering of the component words of floating point values stored in
810    memory is controlled by `FLOAT_WORDS_BIG_ENDIAN' for the target machine and
811    `HOST_FLOAT_WORDS_BIG_ENDIAN' for the host.  */
812 #define TARGET_FLOAT_FORMAT IEEE_FLOAT_FORMAT
813
814 /* GNU CC supports two ways of implementing C++ vtables: traditional or with
815    so-called "thunks".  The flag `-fvtable-thunk' chooses between them.  Define
816    this macro to be a C expression for the default value of that flag.  If
817    `DEFAULT_VTABLE_THUNKS' is 0, GNU CC uses the traditional implementation by
818    default.  The "thunk" implementation is more efficient (especially if you
819    have provided an implementation of `ASM_OUTPUT_MI_THUNK', but is not binary
820    compatible with code compiled using the traditional implementation.  If you
821    are writing a new ports, define `DEFAULT_VTABLE_THUNKS' to 1.
822
823    If you do not define this macro, the default for `-fvtable-thunk' is 0.  */
824 #define DEFAULT_VTABLE_THUNKS 1
825
826 \f
827 /* Layout of Source Language Data Types */
828
829 /* A C expression for the size in bits of the type `int' on the target machine.
830    If you don't define this, the default is one word.  */
831 #define INT_TYPE_SIZE 16
832
833 /* Maximum number for the size in bits of the type `int' on the target machine.
834    If this is undefined, the default is `INT_TYPE_SIZE'.  Otherwise, it is the
835    constant value that is the largest value that `INT_TYPE_SIZE' can have at
836    run-time.  This is used in `cpp'.  */
837 /* #define MAX_INT_TYPE_SIZE */
838
839 /* A C expression for the size in bits of the type `short' on the target
840    machine.  If you don't define this, the default is half a word.  (If this
841    would be less than one storage unit, it is rounded up to one unit.)  */
842 #define SHORT_TYPE_SIZE 16
843
844 /* A C expression for the size in bits of the type `long' on the target
845    machine.  If you don't define this, the default is one word.  */
846 #define LONG_TYPE_SIZE 32
847
848 /* Maximum number for the size in bits of the type `long' on the target
849    machine.  If this is undefined, the default is `LONG_TYPE_SIZE'.  Otherwise,
850    it is the constant value that is the largest value that `LONG_TYPE_SIZE' can
851    have at run-time.  This is used in `cpp'.  */
852 /* #define MAX_LONG_TYPE_SIZE */
853
854 /* A C expression for the size in bits of the type `long long' on the target
855    machine.  If you don't define this, the default is two words.  If you want
856    to support GNU Ada on your machine, the value of macro must be at least 64.  */
857 #define LONG_LONG_TYPE_SIZE 64
858
859 /* A C expression for the size in bits of the type `char' on the target
860    machine.  If you don't define this, the default is one quarter of a word.
861    (If this would be less than one storage unit, it is rounded up to one unit.)  */
862 #define CHAR_TYPE_SIZE 8
863
864 /* Maximum number for the size in bits of the type `char' on the target
865    machine.  If this is undefined, the default is `CHAR_TYPE_SIZE'.  Otherwise,
866    it is the constant value that is the largest value that `CHAR_TYPE_SIZE' can
867    have at run-time.  This is used in `cpp'.  */
868 /* #define MAX_CHAR_TYPE_SIZE */
869
870 /* A C expression for the size in bits of the type `float' on the target
871    machine.  If you don't define this, the default is one word.  */
872 #define FLOAT_TYPE_SIZE 32
873
874 /* A C expression for the size in bits of the type `double' on the target
875    machine.  If you don't define this, the default is two words.  */
876 #define DOUBLE_TYPE_SIZE 64
877
878 /* A C expression for the size in bits of the type `long double' on the target
879    machine.  If you don't define this, the default is two words.  */
880 #define LONG_DOUBLE_TYPE_SIZE 64
881
882 /* An expression whose value is 1 or 0, according to whether the type `char'
883    should be signed or unsigned by default.  The user can always override this
884    default with the options `-fsigned-char' and `-funsigned-char'.  */
885 #define DEFAULT_SIGNED_CHAR 0
886
887 /* A C expression to determine whether to give an `enum' type only as many
888    bytes as it takes to represent the range of possible values of that type.  A
889    nonzero value means to do that; a zero value means all `enum' types should
890    be allocated like `int'.
891
892    If you don't define the macro, the default is 0.  */
893 /* #define DEFAULT_SHORT_ENUMS */
894
895 /* A C expression for a string describing the name of the data type to use for
896    size values.  The typedef name `size_t' is defined using the contents of the
897    string.
898
899    The string can contain more than one keyword.  If so, separate them with
900    spaces, and write first any length keyword, then `unsigned' if appropriate,
901    and finally `int'.  The string must exactly match one of the data type names
902    defined in the function `init_decl_processing' in the file `c-decl.c'.  You
903    may not omit `int' or change the order--that would cause the compiler to
904    crash on startup.
905
906    If you don't define this macro, the default is `"long unsigned int"'.
907
908    Defined in svr4.h.  */
909 #define SIZE_TYPE "unsigned int"
910
911 /* A C expression for a string describing the name of the data type to use for
912    the result of subtracting two pointers.  The typedef name `ptrdiff_t' is
913    defined using the contents of the string.  See `SIZE_TYPE' above for more
914    information.
915
916    If you don't define this macro, the default is `"long int"'.
917
918    Defined in svr4.h.  */
919 #define PTRDIFF_TYPE "int"
920
921 /* A C expression for a string describing the name of the data type to use for
922    wide characters.  The typedef name `wchar_t' is defined using the contents
923    of the string.  See `SIZE_TYPE' above for more information.
924
925    If you don't define this macro, the default is `"int"'.
926
927    Defined in svr4.h, to "long int".  */
928 /* #define WCHAR_TYPE "long int" */
929
930 /* A C expression for the size in bits of the data type for wide characters.
931    This is used in `cpp', which cannot make use of `WCHAR_TYPE'.
932
933    Defined in svr4.h.  */
934 #undef WCHAR_TYPE_SIZE
935 #define WCHAR_TYPE_SIZE 32
936
937 /* Maximum number for the size in bits of the data type for wide characters.
938    If this is undefined, the default is `WCHAR_TYPE_SIZE'.  Otherwise, it is
939    the constant value that is the largest value that `WCHAR_TYPE_SIZE' can have
940    at run-time.  This is used in `cpp'.  */
941 /* #define MAX_WCHAR_TYPE_SIZE */
942
943 /* Define this macro if the type of Objective C selectors should be `int'.
944
945    If this macro is not defined, then selectors should have the type `struct
946    objc_selector *'.  */
947 /* #define OBJC_INT_SELECTORS */
948
949 /* Define this macro if the compiler can group all the selectors together into
950    a vector and use just one label at the beginning of the vector.  Otherwise,
951    the compiler must give each selector its own assembler label.
952
953    On certain machines, it is important to have a separate label for each
954    selector because this enables the linker to eliminate duplicate selectors.  */
955 /* #define OBJC_SELECTORS_WITHOUT_LABELS */
956
957 \f
958 /* Register Basics */
959
960 /* Number of hardware registers known to the compiler.  They receive numbers 0
961    through `FIRST_PSEUDO_REGISTER-1'; thus, the first pseudo register's number
962    really is assigned the number `FIRST_PSEUDO_REGISTER'.  */
963 #define FIRST_PSEUDO_REGISTER 19
964
965 /* An initializer that says which registers are used for fixed purposes all
966    throughout the compiled code and are therefore not available for general
967    allocation.  These would include the stack pointer, the frame pointer
968    (except on machines where that can be used as a general register when no
969    frame pointer is needed), the program counter on machines where that is
970    considered one of the addressable registers, and any other numbered register
971    with a standard use.
972
973    This information is expressed as a sequence of numbers, separated by commas
974    and surrounded by braces.  The Nth number is 1 if register N is fixed, 0
975    otherwise.
976
977    The table initialized from this macro, and the table initialized by the
978    following one, may be overridden at run time either automatically, by the
979    actions of the macro `CONDITIONAL_REGISTER_USAGE', or by the user with the
980    command options `-ffixed-REG', `-fcall-used-REG' and `-fcall-saved-REG'.  */
981 #define FIXED_REGISTERS \
982   { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1, 0, 1, 1 }
983
984 /* Like `FIXED_REGISTERS' but has 1 for each register that is clobbered (in
985    general) by function calls as well as for fixed registers.  This macro
986    therefore identifies the registers that are not available for general
987    allocation of values that must live across function calls.
988
989    If a register has 0 in `CALL_USED_REGISTERS', the compiler automatically
990    saves it on function entry and restores it on function exit, if the register
991    is used within the function.  */
992 #define CALL_USED_REGISTERS \
993   { 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 0, 0, 0, 0, 1, 1, 1, 1, 1 }
994
995 /* Zero or more C statements that may conditionally modify two variables
996    `fixed_regs' and `call_used_regs' (both of type `char []') after they have
997    been initialized from the two preceding macros.
998
999    This is necessary in case the fixed or call-clobbered registers depend on
1000    target flags.
1001
1002    You need not define this macro if it has no work to do.
1003
1004    If the usage of an entire class of registers depends on the target flags,
1005    you may indicate this to GCC by using this macro to modify `fixed_regs' and
1006    `call_used_regs' to 1 for each of the registers in the classes which should
1007    not be used by GCC.  Also define the macro `REG_CLASS_FROM_LETTER' to return
1008    `NO_REGS' if it is called with a letter for a class that shouldn't be used.
1009
1010    (However, if this class is not included in `GENERAL_REGS' and all of the
1011    insn patterns whose constraints permit this class are controlled by target
1012    switches, then GCC will automatically avoid using these registers when the
1013    target switches are opposed to them.)  */
1014 /* #define CONDITIONAL_REGISTER_USAGE */
1015
1016 /* If this macro is defined and has a nonzero value, it means that `setjmp' and
1017    related functions fail to save the registers, or that `longjmp' fails to
1018    restore them.  To compensate, the compiler avoids putting variables in
1019    registers in functions that use `setjmp'.  */
1020 /* #define NON_SAVING_SETJMP */
1021
1022 /* Define this macro if the target machine has register windows.  This C
1023    expression returns the register number as seen by the called function
1024    corresponding to the register number OUT as seen by the calling function.
1025    Return OUT if register number OUT is not an outbound register.  */
1026 /* #define INCOMING_REGNO(OUT) */
1027
1028 /* Define this macro if the target machine has register windows.  This C
1029    expression returns the register number as seen by the calling function
1030    corresponding to the register number IN as seen by the called function.
1031    Return IN if register number IN is not an inbound register.  */
1032 /* #define OUTGOING_REGNO(IN) */
1033
1034 \f
1035 /* Order of allocation of registers */
1036
1037 /* If defined, an initializer for a vector of integers, containing the numbers
1038    of hard registers in the order in which GNU CC should prefer to use them
1039    (from most preferred to least).
1040
1041    If this macro is not defined, registers are used lowest numbered first (all
1042    else being equal).
1043
1044    One use of this macro is on machines where the highest numbered registers
1045    must always be saved and the save-multiple-registers instruction supports
1046    only sequences of consecutive registers.  On such machines, define
1047    `REG_ALLOC_ORDER' to be an initializer that lists the highest numbered
1048    allocatable register first.  */
1049 #define REG_ALLOC_ORDER { 7, 6, 5, 4, 3, 2, 1, 0, 9, 8, 10, 11, 12, 13, 14, 15, 16 }
1050
1051 /* A C statement (sans semicolon) to choose the order in which to allocate hard
1052    registers for pseudo-registers local to a basic block.
1053
1054    Store the desired register order in the array `reg_alloc_order'.  Element 0
1055    should be the register to allocate first; element 1, the next register; and
1056    so on.
1057
1058    The macro body should not assume anything about the contents of
1059    `reg_alloc_order' before execution of the macro.
1060
1061    On most machines, it is not necessary to define this macro.  */
1062 /* #define ORDER_REGS_FOR_LOCAL_ALLOC */
1063
1064 \f
1065 /* How Values Fit in Registers */
1066
1067 /* A C expression for the number of consecutive hard registers, starting at
1068    register number REGNO, required to hold a value of mode MODE.
1069
1070    On a machine where all registers are exactly one word, a suitable definition
1071    of this macro is
1072
1073         #define HARD_REGNO_NREGS(REGNO, MODE)            \
1074            ((GET_MODE_SIZE (MODE) + UNITS_PER_WORD - 1)  \
1075             / UNITS_PER_WORD))  */
1076 #define HARD_REGNO_NREGS(REGNO, MODE)                           \
1077   ((GET_MODE_SIZE (MODE) + UNITS_PER_WORD - 1) / UNITS_PER_WORD)
1078
1079 /* A C expression that is nonzero if it is permissible to store a value of mode
1080    MODE in hard register number REGNO (or in several registers starting with
1081    that one).  For a machine where all registers are equivalent, a suitable
1082    definition is
1083
1084         #define HARD_REGNO_MODE_OK(REGNO, MODE) 1
1085
1086    It is not necessary for this macro to check for the numbers of fixed
1087    registers, because the allocation mechanism considers them to be always
1088    occupied.
1089
1090    On some machines, double-precision values must be kept in even/odd register
1091    pairs.  The way to implement that is to define this macro to reject odd
1092    register numbers for such modes.
1093
1094    The minimum requirement for a mode to be OK in a register is that the
1095    `movMODE' instruction pattern support moves between the register and any
1096    other hard register for which the mode is OK; and that moving a value into
1097    the register and back out not alter it.
1098
1099    Since the same instruction used to move `SImode' will work for all narrower
1100    integer modes, it is not necessary on any machine for `HARD_REGNO_MODE_OK'
1101    to distinguish between these modes, provided you define patterns `movhi',
1102    etc., to take advantage of this.  This is useful because of the interaction
1103    between `HARD_REGNO_MODE_OK' and `MODES_TIEABLE_P'; it is very desirable for
1104    all integer modes to be tieable.
1105
1106    Many machines have special registers for floating point arithmetic.  Often
1107    people assume that floating point machine modes are allowed only in floating
1108    point registers.  This is not true.  Any registers that can hold integers
1109    can safely *hold* a floating point machine mode, whether or not floating
1110    arithmetic can be done on it in those registers.  Integer move instructions
1111    can be used to move the values.
1112
1113    On some machines, though, the converse is true: fixed-point machine modes
1114    may not go in floating registers.  This is true if the floating registers
1115    normalize any value stored in them, because storing a non-floating value
1116    there would garble it.  In this case, `HARD_REGNO_MODE_OK' should reject
1117    fixed-point machine modes in floating registers.  But if the floating
1118    registers do not automatically normalize, if you can store any bit pattern
1119    in one and retrieve it unchanged without a trap, then any machine mode may
1120    go in a floating register, so you can define this macro to say so.
1121
1122    The primary significance of special floating registers is rather that they
1123    are the registers acceptable in floating point arithmetic instructions.
1124    However, this is of no concern to `HARD_REGNO_MODE_OK'.  You handle it by
1125    writing the proper constraints for those instructions.
1126
1127    On some machines, the floating registers are especially slow to access, so
1128    that it is better to store a value in a stack frame than in such a register
1129    if floating point arithmetic is not being done.  As long as the floating
1130    registers are not in class `GENERAL_REGS', they will not be used unless some
1131    pattern's constraint asks for one.  */
1132 #define HARD_REGNO_MODE_OK(REGNO, MODE) ((REGNO) != 16 || (MODE) == BImode)
1133
1134 /* A C expression that is nonzero if it is desirable to choose register
1135    allocation so as to avoid move instructions between a value of mode MODE1
1136    and a value of mode MODE2.
1137
1138    If `HARD_REGNO_MODE_OK (R, MODE1)' and `HARD_REGNO_MODE_OK (R, MODE2)' are
1139    ever different for any R, then `MODES_TIEABLE_P (MODE1, MODE2)' must be
1140    zero.  */
1141 #define MODES_TIEABLE_P(MODE1, MODE2) ((MODE1) != BImode && (MODE2) != BImode)
1142
1143 /* Define this macro if the compiler should avoid copies to/from CCmode
1144    registers.  You should only define this macro if support fo copying to/from
1145    CCmode is incomplete.  */
1146 /* #define AVOID_CCMODE_COPIES */
1147
1148 \f
1149 /* Handling Leaf Functions */
1150
1151 /* A C initializer for a vector, indexed by hard register number, which
1152    contains 1 for a register that is allowable in a candidate for leaf function
1153    treatment.
1154
1155    If leaf function treatment involves renumbering the registers, then the
1156    registers marked here should be the ones before renumbering--those that GNU
1157    CC would ordinarily allocate.  The registers which will actually be used in
1158    the assembler code, after renumbering, should not be marked with 1 in this
1159    vector.
1160
1161    Define this macro only if the target machine offers a way to optimize the
1162    treatment of leaf functions.  */
1163 /* #define LEAF_REGISTERS */
1164
1165 /* A C expression whose value is the register number to which REGNO should be
1166    renumbered, when a function is treated as a leaf function.
1167
1168    If REGNO is a register number which should not appear in a leaf function
1169    before renumbering, then the expression should yield -1, which will cause
1170    the compiler to abort.
1171
1172    Define this macro only if the target machine offers a way to optimize the
1173    treatment of leaf functions, and registers need to be renumbered to do this.  */
1174 /* #define LEAF_REG_REMAP(REGNO) */
1175
1176 \f
1177 /* Registers That Form a Stack.  */
1178
1179 /* Define this if the machine has any stack-like registers.  */
1180 /* #define STACK_REGS */
1181
1182 /* The number of the first stack-like register.  This one is the top
1183    of the stack.  */
1184 /* #define FIRST_STACK_REG */
1185
1186 /* The number of the last stack-like register.  This one is the
1187    bottom of the stack.  */
1188 /* #define LAST_STACK_REG */
1189
1190 \f
1191 /* Register Classes */
1192
1193 /* An enumeral type that must be defined with all the register class names as
1194    enumeral values.  `NO_REGS' must be first.  `ALL_REGS' must be the last
1195    register class, followed by one more enumeral value, `LIM_REG_CLASSES',
1196    which is not a register class but rather tells how many classes there are.
1197
1198    Each register class has a number, which is the value of casting the class
1199    name to type `int'.  The number serves as an index in many of the tables
1200    described below.  */
1201 enum reg_class
1202 {
1203   NO_REGS,
1204   R0_REGS,
1205   R1_REGS,
1206   TWO_REGS,
1207   R2_REGS,
1208   EIGHT_REGS,
1209   R8_REGS,
1210   ICALL_REGS,
1211   GENERAL_REGS,
1212   CARRY_REGS,
1213   ALL_REGS,
1214   LIM_REG_CLASSES
1215 };
1216
1217 /* The number of distinct register classes, defined as follows:
1218
1219         #define N_REG_CLASSES (int) LIM_REG_CLASSES  */
1220 #define N_REG_CLASSES ((int) LIM_REG_CLASSES)
1221
1222 /* An initializer containing the names of the register classes as C string
1223    constants.  These names are used in writing some of the debugging dumps.  */
1224 #define REG_CLASS_NAMES                         \
1225 {                                               \
1226   "NO_REGS",                                    \
1227   "R0_REGS",                                    \
1228   "R1_REGS",                                    \
1229   "TWO_REGS",                                   \
1230   "R2_REGS",                                    \
1231   "EIGHT_REGS",                                 \
1232   "R8_REGS",                                    \
1233   "ICALL_REGS",                                 \
1234   "GENERAL_REGS",                               \
1235   "CARRY_REGS",                                 \
1236   "ALL_REGS"                                    \
1237 }
1238
1239 /* An initializer containing the contents of the register classes, as integers
1240    which are bit masks.  The Nth integer specifies the contents of class N.
1241    The way the integer MASK is interpreted is that register R is in the class
1242    if `MASK & (1 << R)' is 1.
1243
1244    When the machine has more than 32 registers, an integer does not suffice.
1245    Then the integers are replaced by sub-initializers, braced groupings
1246    containing several integers.  Each sub-initializer must be suitable as an
1247    initializer for the type `HARD_REG_SET' which is defined in
1248    `hard-reg-set.h'.  */
1249 #define REG_CLASS_CONTENTS                      \
1250 {                                               \
1251   0x00000,                                      \
1252   0x00001,                                      \
1253   0x00002,                                      \
1254   0x00003,                                      \
1255   0x00004,                                      \
1256   0x000FF,                                      \
1257   0x00100,                                      \
1258   0x00300,                                      \
1259   0x6FFFF,                                      \
1260   0x10000,                                      \
1261   (1 << FIRST_PSEUDO_REGISTER) - 1              \
1262 }
1263
1264 /* A C expression whose value is a register class containing hard register
1265    REGNO.  In general there is more than one such class; choose a class which
1266    is "minimal", meaning that no smaller class also contains the register.  */
1267 #define REGNO_REG_CLASS(REGNO)                  \
1268   ((REGNO) == 0   ? R0_REGS                     \
1269    : (REGNO) == 1 ? R1_REGS                     \
1270    : (REGNO) == 2 ? R2_REGS                     \
1271    : (REGNO) < 8  ? EIGHT_REGS                  \
1272    : (REGNO) == 8 ? R8_REGS                     \
1273    : (REGNO) == 16 ? CARRY_REGS                 \
1274    : (REGNO) <= 18 ? GENERAL_REGS               \
1275    : ALL_REGS)
1276
1277 /* A macro whose definition is the name of the class to which a valid base
1278    register must belong.  A base register is one used in an address which is
1279    the register value plus a displacement.  */
1280 #define BASE_REG_CLASS GENERAL_REGS
1281
1282 /* A macro whose definition is the name of the class to which a valid index
1283    register must belong.  An index register is one used in an address where its
1284    value is either multiplied by a scale factor or added to another register
1285    (as well as added to a displacement).  */
1286 #define INDEX_REG_CLASS GENERAL_REGS
1287
1288 /* A C expression which defines the machine-dependent operand constraint
1289    letters for register classes.  If CHAR is such a letter, the value should be
1290    the register class corresponding to it.  Otherwise, the value should be
1291    `NO_REGS'.  The register letter `r', corresponding to class `GENERAL_REGS',
1292    will not be passed to this macro; you do not need to handle it.
1293
1294    The following letters are unavailable, due to being used as
1295    constraints:
1296         '0'..'9'
1297         '<', '>'
1298         'E', 'F', 'G', 'H'
1299         'I', 'J', 'K', 'L', 'M', 'N', 'O', 'P'
1300         'Q', 'R', 'S', 'T', 'U'
1301         'V', 'X'
1302         'g', 'i', 'm', 'n', 'o', 'p', 'r', 's' */
1303
1304 #define REG_CLASS_FROM_LETTER(CHAR)             \
1305  (  (CHAR) == 'a' ? R0_REGS                     \
1306   : (CHAR) == 'b' ? R1_REGS                     \
1307   : (CHAR) == 'c' ? R2_REGS                     \
1308   : (CHAR) == 'd' ? R8_REGS                     \
1309   : (CHAR) == 'e' ? EIGHT_REGS                  \
1310   : (CHAR) == 't' ? TWO_REGS                    \
1311   : (CHAR) == 'y' ? CARRY_REGS                  \
1312   : (CHAR) == 'z' ? ICALL_REGS                  \
1313   : NO_REGS)
1314
1315 /* A C expression which is nonzero if register number NUM is suitable for use
1316    as a base register in operand addresses.  It may be either a suitable hard
1317    register or a pseudo register that has been allocated such a hard register.  */
1318 #define REGNO_OK_FOR_BASE_P(NUM) 1
1319
1320 /* A C expression which is nonzero if register number NUM is suitable for use
1321    as an index register in operand addresses.  It may be either a suitable hard
1322    register or a pseudo register that has been allocated such a hard register.
1323
1324    The difference between an index register and a base register is that the
1325    index register may be scaled.  If an address involves the sum of two
1326    registers, neither one of them scaled, then either one may be labeled the
1327    "base" and the other the "index"; but whichever labeling is used must fit
1328    the machine's constraints of which registers may serve in each capacity.
1329    The compiler will try both labelings, looking for one that is valid, and
1330    will reload one or both registers only if neither labeling works.  */
1331 #define REGNO_OK_FOR_INDEX_P(NUM) REGNO_OK_FOR_BASE_P (NUM)
1332
1333 /* A C expression that places additional restrictions on the register class to
1334    use when it is necessary to copy value X into a register in class CLASS.
1335    The value is a register class; perhaps CLASS, or perhaps another, smaller
1336    class.  On many machines, the following definition is safe:
1337
1338         #define PREFERRED_RELOAD_CLASS(X,CLASS) CLASS
1339
1340    Sometimes returning a more restrictive class makes better code.  For
1341    example, on the 68000, when X is an integer constant that is in range for a
1342    `moveq' instruction, the value of this macro is always `DATA_REGS' as long
1343    as CLASS includes the data registers.  Requiring a data register guarantees
1344    that a `moveq' will be used.
1345
1346    If X is a `const_double', by returning `NO_REGS' you can force X into a
1347    memory constant.  This is useful on certain machines where immediate
1348    floating values cannot be loaded into certain kinds of registers.
1349
1350    This declaration must be present.  */
1351 #define PREFERRED_RELOAD_CLASS(X, CLASS) \
1352   stormy16_preferred_reload_class (X, CLASS)
1353
1354 /* Like `PREFERRED_RELOAD_CLASS', but for output reloads instead of input
1355    reloads.  If you don't define this macro, the default is to use CLASS,
1356    unchanged.  */
1357 #define PREFERRED_OUTPUT_RELOAD_CLASS(X, CLASS) \
1358   stormy16_preferred_reload_class (X, CLASS)
1359
1360 /* A C expression that places additional restrictions on the register class to
1361    use when it is necessary to be able to hold a value of mode MODE in a reload
1362    register for which class CLASS would ordinarily be used.
1363
1364    Unlike `PREFERRED_RELOAD_CLASS', this macro should be used when there are
1365    certain modes that simply can't go in certain reload classes.
1366
1367    The value is a register class; perhaps CLASS, or perhaps another, smaller
1368    class.
1369
1370    Don't define this macro unless the target machine has limitations which
1371    require the macro to do something nontrivial.  */
1372 /* #define LIMIT_RELOAD_CLASS(MODE, CLASS) */
1373
1374 /* Many machines have some registers that cannot be copied directly to or from
1375    memory or even from other types of registers.  An example is the `MQ'
1376    register, which on most machines, can only be copied to or from general
1377    registers, but not memory.  Some machines allow copying all registers to and
1378    from memory, but require a scratch register for stores to some memory
1379    locations (e.g., those with symbolic address on the RT, and those with
1380    certain symbolic address on the Sparc when compiling PIC).  In some cases,
1381    both an intermediate and a scratch register are required.
1382
1383    You should define these macros to indicate to the reload phase that it may
1384    need to allocate at least one register for a reload in addition to the
1385    register to contain the data.  Specifically, if copying X to a register
1386    CLASS in MODE requires an intermediate register, you should define
1387    `SECONDARY_INPUT_RELOAD_CLASS' to return the largest register class all of
1388    whose registers can be used as intermediate registers or scratch registers.
1389
1390    If copying a register CLASS in MODE to X requires an intermediate or scratch
1391    register, `SECONDARY_OUTPUT_RELOAD_CLASS' should be defined to return the
1392    largest register class required.  If the requirements for input and output
1393    reloads are the same, the macro `SECONDARY_RELOAD_CLASS' should be used
1394    instead of defining both macros identically.
1395
1396    The values returned by these macros are often `GENERAL_REGS'.  Return
1397    `NO_REGS' if no spare register is needed; i.e., if X can be directly copied
1398    to or from a register of CLASS in MODE without requiring a scratch register.
1399    Do not define this macro if it would always return `NO_REGS'.
1400
1401    If a scratch register is required (either with or without an intermediate
1402    register), you should define patterns for `reload_inM' or `reload_outM', as
1403    required..  These patterns, which will normally be implemented with a
1404    `define_expand', should be similar to the `movM' patterns, except that
1405    operand 2 is the scratch register.
1406
1407    Define constraints for the reload register and scratch register that contain
1408    a single register class.  If the original reload register (whose class is
1409    CLASS) can meet the constraint given in the pattern, the value returned by
1410    these macros is used for the class of the scratch register.  Otherwise, two
1411    additional reload registers are required.  Their classes are obtained from
1412    the constraints in the insn pattern.
1413
1414    X might be a pseudo-register or a `subreg' of a pseudo-register, which could
1415    either be in a hard register or in memory.  Use `true_regnum' to find out;
1416    it will return -1 if the pseudo is in memory and the hard register number if
1417    it is in a register.
1418
1419    These macros should not be used in the case where a particular class of
1420    registers can only be copied to memory and not to another class of
1421    registers.  In that case, secondary reload registers are not needed and
1422    would not be helpful.  Instead, a stack location must be used to perform the
1423    copy and the `movM' pattern should use memory as a intermediate storage.
1424    This case often occurs between floating-point and general registers.  */
1425
1426 /* This chip has the interesting property that only the first eight
1427    registers can be moved to/from memory.  */
1428 #define SECONDARY_RELOAD_CLASS(CLASS, MODE, X)                  \
1429   stormy16_secondary_reload_class (CLASS, MODE, X)
1430
1431 /* #define SECONDARY_INPUT_RELOAD_CLASS(CLASS, MODE, X) */
1432 /* #define SECONDARY_OUTPUT_RELOAD_CLASS(CLASS, MODE, X) */
1433
1434 /* Certain machines have the property that some registers cannot be copied to
1435    some other registers without using memory.  Define this macro on those
1436    machines to be a C expression that is non-zero if objects of mode M in
1437    registers of CLASS1 can only be copied to registers of class CLASS2 by
1438    storing a register of CLASS1 into memory and loading that memory location
1439    into a register of CLASS2.
1440
1441    Do not define this macro if its value would always be zero.  */
1442 /* #define SECONDARY_MEMORY_NEEDED(CLASS1, CLASS2, M) */
1443
1444 /* Normally when `SECONDARY_MEMORY_NEEDED' is defined, the compiler allocates a
1445    stack slot for a memory location needed for register copies.  If this macro
1446    is defined, the compiler instead uses the memory location defined by this
1447    macro.
1448
1449    Do not define this macro if you do not define
1450    `SECONDARY_MEMORY_NEEDED'.  */
1451 /* #define SECONDARY_MEMORY_NEEDED_RTX(MODE) */
1452
1453 /* When the compiler needs a secondary memory location to copy between two
1454    registers of mode MODE, it normally allocates sufficient memory to hold a
1455    quantity of `BITS_PER_WORD' bits and performs the store and load operations
1456    in a mode that many bits wide and whose class is the same as that of MODE.
1457
1458    This is right thing to do on most machines because it ensures that all bits
1459    of the register are copied and prevents accesses to the registers in a
1460    narrower mode, which some machines prohibit for floating-point registers.
1461
1462    However, this default behavior is not correct on some machines, such as the
1463    DEC Alpha, that store short integers in floating-point registers differently
1464    than in integer registers.  On those machines, the default widening will not
1465    work correctly and you must define this macro to suppress that widening in
1466    some cases.  See the file `alpha.h' for details.
1467
1468    Do not define this macro if you do not define `SECONDARY_MEMORY_NEEDED' or
1469    if widening MODE to a mode that is `BITS_PER_WORD' bits wide is correct for
1470    your machine.  */
1471 /* #define SECONDARY_MEMORY_NEEDED_MODE(MODE) */
1472
1473 /* Normally the compiler avoids choosing registers that have been explicitly
1474    mentioned in the rtl as spill registers (these registers are normally those
1475    used to pass parameters and return values).  However, some machines have so
1476    few registers of certain classes that there would not be enough registers to
1477    use as spill registers if this were done.
1478
1479    Define `SMALL_REGISTER_CLASSES' to be an expression with a non-zero value on
1480    these machines.  When this macro has a non-zero value, the compiler allows
1481    registers explicitly used in the rtl to be used as spill registers but
1482    avoids extending the lifetime of these registers.
1483
1484    It is always safe to define this macro with a non-zero value, but if you
1485    unnecessarily define it, you will reduce the amount of optimizations that
1486    can be performed in some cases.  If you do not define this macro with a
1487    non-zero value when it is required, the compiler will run out of spill
1488    registers and print a fatal error message.  For most machines, you should
1489    not define this macro at all.  */
1490 /* #define SMALL_REGISTER_CLASSES */
1491
1492 /* A C expression whose value is nonzero if pseudos that have been assigned to
1493    registers of class CLASS would likely be spilled because registers of CLASS
1494    are needed for spill registers.
1495
1496    The default value of this macro returns 1 if CLASS has exactly one register
1497    and zero otherwise.  On most machines, this default should be used.  Only
1498    define this macro to some other expression if pseudo allocated by
1499    `local-alloc.c' end up in memory because their hard registers were needed
1500    for spill registers.  If this macro returns nonzero for those classes, those
1501    pseudos will only be allocated by `global.c', which knows how to reallocate
1502    the pseudo to another register.  If there would not be another register
1503    available for reallocation, you should not change the definition of this
1504    macro since the only effect of such a definition would be to slow down
1505    register allocation.  */
1506 /* #define CLASS_LIKELY_SPILLED_P(CLASS) */
1507
1508 /* A C expression for the maximum number of consecutive registers of
1509    class CLASS needed to hold a value of mode MODE.
1510
1511    This is closely related to the macro `HARD_REGNO_NREGS'.  In fact, the value
1512    of the macro `CLASS_MAX_NREGS (CLASS, MODE)' should be the maximum value of
1513    `HARD_REGNO_NREGS (REGNO, MODE)' for all REGNO values in the class CLASS.
1514
1515    This macro helps control the handling of multiple-word values in
1516    the reload pass.
1517
1518    This declaration is required.  */
1519 #define CLASS_MAX_NREGS(CLASS, MODE) \
1520   ((GET_MODE_SIZE (MODE) + UNITS_PER_WORD - 1) / UNITS_PER_WORD)
1521
1522 /* If defined, a C expression for a class that contains registers which the
1523    compiler must always access in a mode that is the same size as the mode in
1524    which it loaded the register.
1525
1526    For the example, loading 32-bit integer or floating-point objects into
1527    floating-point registers on the Alpha extends them to 64-bits.  Therefore
1528    loading a 64-bit object and then storing it as a 32-bit object does not
1529    store the low-order 32-bits, as would be the case for a normal register.
1530    Therefore, `alpha.h' defines this macro as `FLOAT_REGS'.  */
1531 /* #define CLASS_CANNOT_CHANGE_SIZE */
1532
1533 /* A C expression that defines the machine-dependent operand constraint letters
1534    (`I', `J', `K', .. 'P') that specify particular ranges of integer values.
1535    If C is one of those letters, the expression should check that VALUE, an
1536    integer, is in the appropriate range and return 1 if so, 0 otherwise.  If C
1537    is not one of those letters, the value should be 0 regardless of VALUE.  */
1538 #define CONST_OK_FOR_LETTER_P(VALUE, C)                 \
1539   (  (C) == 'I' ? (VALUE) >= 0 && (VALUE) <= 3          \
1540    : (C) == 'J' ? exact_log2 (VALUE) != -1              \
1541    : (C) == 'K' ? exact_log2 (~(VALUE)) != -1           \
1542    : (C) == 'L' ? (VALUE) >= 0 && (VALUE) <= 255        \
1543    : (C) == 'M' ? (VALUE) >= -255 && (VALUE) <= 0       \
1544    : (C) == 'N' ? (VALUE) >= -3 && (VALUE) <= 0         \
1545    : (C) == 'O' ? (VALUE) >= 1 && (VALUE) <= 4          \
1546    : (C) == 'P' ? (VALUE) >= -4 && (VALUE) <= -1        \
1547    : 0 )
1548
1549 /* A C expression that defines the machine-dependent operand constraint letters
1550    (`G', `H') that specify particular ranges of `const_double' values.
1551
1552    If C is one of those letters, the expression should check that VALUE, an RTX
1553    of code `const_double', is in the appropriate range and return 1 if so, 0
1554    otherwise.  If C is not one of those letters, the value should be 0
1555    regardless of VALUE.
1556
1557    `const_double' is used for all floating-point constants and for `DImode'
1558    fixed-point constants.  A given letter can accept either or both kinds of
1559    values.  It can use `GET_MODE' to distinguish between these kinds.  */
1560 #define CONST_DOUBLE_OK_FOR_LETTER_P(VALUE, C) 0
1561
1562 /* A C expression that defines the optional machine-dependent constraint
1563    letters (`Q', `R', `S', `T', `U') that can be used to segregate specific
1564    types of operands, usually memory references, for the target machine.
1565    Normally this macro will not be defined.  If it is required for a particular
1566    target machine, it should return 1 if VALUE corresponds to the operand type
1567    represented by the constraint letter C.  If C is not defined as an extra
1568    constraint, the value returned should be 0 regardless of VALUE.
1569
1570    For example, on the ROMP, load instructions cannot have their output in r0
1571    if the memory reference contains a symbolic address.  Constraint letter `Q'
1572    is defined as representing a memory address that does *not* contain a
1573    symbolic address.  An alternative is specified with a `Q' constraint on the
1574    input and `r' on the output.  The next alternative specifies `m' on the
1575    input and a register class that does not include r0 on the output.  */
1576 #define EXTRA_CONSTRAINT(VALUE, C) \
1577   stormy16_extra_constraint_p (VALUE, C)
1578
1579 \f
1580 /* Basic Stack Layout */
1581
1582 /* Define this macro if pushing a word onto the stack moves the stack pointer
1583    to a smaller address.
1584
1585    When we say, "define this macro if ...," it means that the compiler checks
1586    this macro only with `#ifdef' so the precise definition used does not
1587    matter.  */
1588 /* #define STACK_GROWS_DOWNWARD */
1589
1590 /* We want to use post-increment instructions to push things on the stack,
1591    because we don't have any pre-increment ones.  */
1592 #define STACK_PUSH_CODE POST_INC
1593
1594 /* Define this macro if the addresses of local variable slots are at negative
1595    offsets from the frame pointer.  */
1596 /* #define FRAME_GROWS_DOWNWARD */
1597
1598 /* Define this macro if successive arguments to a function occupy decreasing
1599    addresses on the stack.  */
1600 #define ARGS_GROW_DOWNWARD 1
1601
1602 /* Offset from the frame pointer to the first local variable slot to be
1603    allocated.
1604
1605    If `FRAME_GROWS_DOWNWARD', find the next slot's offset by
1606    subtracting the first slot's length from `STARTING_FRAME_OFFSET'.
1607    Otherwise, it is found by adding the length of the first slot to
1608    the value `STARTING_FRAME_OFFSET'.  */
1609 #define STARTING_FRAME_OFFSET 0
1610
1611 /* Offset from the stack pointer register to the first location at which
1612    outgoing arguments are placed.  If not specified, the default value of zero
1613    is used.  This is the proper value for most machines.
1614
1615    If `ARGS_GROW_DOWNWARD', this is the offset to the location above the first
1616    location at which outgoing arguments are placed.  */
1617 /* #define STACK_POINTER_OFFSET */
1618
1619 /* Offset from the argument pointer register to the first argument's address.
1620    On some machines it may depend on the data type of the function.
1621
1622    If `ARGS_GROW_DOWNWARD', this is the offset to the location above the first
1623    argument's address.  */
1624 #define FIRST_PARM_OFFSET(FUNDECL) 0
1625
1626 /* Offset from the stack pointer register to an item dynamically allocated on
1627    the stack, e.g., by `alloca'.
1628
1629    The default value for this macro is `STACK_POINTER_OFFSET' plus the length
1630    of the outgoing arguments.  The default is correct for most machines.  See
1631    `function.c' for details.  */
1632 /* #define STACK_DYNAMIC_OFFSET(FUNDECL) */
1633
1634 /* A C expression whose value is RTL representing the address in a stack frame
1635    where the pointer to the caller's frame is stored.  Assume that FRAMEADDR is
1636    an RTL expression for the address of the stack frame itself.
1637
1638    If you don't define this macro, the default is to return the value of
1639    FRAMEADDR--that is, the stack frame address is also the address of the stack
1640    word that points to the previous frame.  */
1641 /* #define DYNAMIC_CHAIN_ADDRESS(FRAMEADDR) */
1642
1643 /* If defined, a C expression that produces the machine-specific code to setup
1644    the stack so that arbitrary frames can be accessed.  For example, on the
1645    Sparc, we must flush all of the register windows to the stack before we can
1646    access arbitrary stack frames.  This macro will seldom need to be defined.  */
1647 /* #define SETUP_FRAME_ADDRESSES() */
1648
1649 /* A C expression whose value is RTL representing the value of the return
1650    address for the frame COUNT steps up from the current frame, after the
1651    prologue.  FRAMEADDR is the frame pointer of the COUNT frame, or the frame
1652    pointer of the COUNT - 1 frame if `RETURN_ADDR_IN_PREVIOUS_FRAME' is
1653    defined.
1654
1655    The value of the expression must always be the correct address when COUNT is
1656    zero, but may be `NULL_RTX' if there is not way to determine the return
1657    address of other frames.  */
1658 #define RETURN_ADDR_RTX(COUNT, FRAMEADDR)       \
1659   ((COUNT) == 0                                 \
1660    ? gen_rtx_MEM (Pmode, arg_pointer_rtx)       \
1661    : NULL_RTX)
1662
1663 /* Define this if the return address of a particular stack frame is
1664    accessed from the frame pointer of the previous stack frame.  */
1665 /* #define RETURN_ADDR_IN_PREVIOUS_FRAME */
1666
1667 /* A C expression whose value is RTL representing the location of the incoming
1668    return address at the beginning of any function, before the prologue.  This
1669    RTL is either a `REG', indicating that the return value is saved in `REG',
1670    or a `MEM' representing a location in the stack.
1671
1672    You only need to define this macro if you want to support call frame
1673    debugging information like that provided by DWARF 2.  */
1674 #define INCOMING_RETURN_ADDR_RTX  \
1675    gen_rtx_MEM (SImode, gen_rtx_PLUS (Pmode, stack_pointer_rtx, GEN_INT (-4)))
1676
1677 /* A C expression whose value is an integer giving the offset, in bytes, from
1678    the value of the stack pointer register to the top of the stack frame at the
1679    beginning of any function, before the prologue.  The top of the frame is
1680    defined to be the value of the stack pointer in the previous frame, just
1681    before the call instruction.
1682
1683    You only need to define this macro if you want to support call frame
1684    debugging information like that provided by DWARF 2.  */
1685 #define INCOMING_FRAME_SP_OFFSET (stormy16_interrupt_function_p () ? 6 : 4)
1686
1687 \f
1688 /* Stack Checking.  */
1689
1690 /* A nonzero value if stack checking is done by the configuration files in a
1691    machine-dependent manner.  You should define this macro if stack checking is
1692    require by the ABI of your machine or if you would like to have to stack
1693    checking in some more efficient way than GNU CC's portable approach.  The
1694    default value of this macro is zero.  */
1695 /* #define STACK_CHECK_BUILTIN */
1696
1697 /* An integer representing the interval at which GNU CC must generate stack
1698    probe instructions.  You will normally define this macro to be no larger
1699    than the size of the "guard pages" at the end of a stack area.  The default
1700    value of 4096 is suitable for most systems.  */
1701 /* #define STACK_CHECK_PROBE_INTERVAL */
1702
1703 /* A integer which is nonzero if GNU CC should perform the stack probe as a
1704    load instruction and zero if GNU CC should use a store instruction.  The
1705    default is zero, which is the most efficient choice on most systems.  */
1706 /* #define STACK_CHECK_PROBE_LOAD */
1707
1708 /* The number of bytes of stack needed to recover from a stack overflow, for
1709    languages where such a recovery is supported.  The default value of 75 words
1710    should be adequate for most machines.  */
1711 /* #define STACK_CHECK_PROTECT */
1712
1713 /* The maximum size of a stack frame, in bytes.  GNU CC will generate probe
1714    instructions in non-leaf functions to ensure at least this many bytes of
1715    stack are available.  If a stack frame is larger than this size, stack
1716    checking will not be reliable and GNU CC will issue a warning.  The default
1717    is chosen so that GNU CC only generates one instruction on most systems.
1718    You should normally not change the default value of this macro.  */
1719 /* #define STACK_CHECK_MAX_FRAME_SIZE */
1720
1721 /* GNU CC uses this value to generate the above warning message.  It represents
1722    the amount of fixed frame used by a function, not including space for any
1723    callee-saved registers, temporaries and user variables.  You need only
1724    specify an upper bound for this amount and will normally use the default of
1725    four words.  */
1726 /* #define STACK_CHECK_FIXED_FRAME_SIZE */
1727
1728 /* The maximum size, in bytes, of an object that GNU CC will place in the fixed
1729    area of the stack frame when the user specifies `-fstack-check'.  GNU CC
1730    computed the default from the values of the above macros and you will
1731    normally not need to override that default.  */
1732 /* #define STACK_CHECK_MAX_VAR_SIZE */
1733
1734 \f
1735 /* Register That Address the Stack Frame.  */
1736
1737 /* The register number of the stack pointer register, which must also be a
1738    fixed register according to `FIXED_REGISTERS'.  On most machines, the
1739    hardware determines which register this is.  */
1740 #define STACK_POINTER_REGNUM 15
1741
1742 /* The register number of the frame pointer register, which is used to access
1743    automatic variables in the stack frame.  On some machines, the hardware
1744    determines which register this is.  On other machines, you can choose any
1745    register you wish for this purpose.  */
1746 #define FRAME_POINTER_REGNUM 17
1747
1748 /* On some machines the offset between the frame pointer and starting offset of
1749    the automatic variables is not known until after register allocation has
1750    been done (for example, because the saved registers are between these two
1751    locations).  On those machines, define `FRAME_POINTER_REGNUM' the number of
1752    a special, fixed register to be used internally until the offset is known,
1753    and define `HARD_FRAME_POINTER_REGNUM' to be actual the hard register number
1754    used for the frame pointer.
1755
1756    You should define this macro only in the very rare circumstances when it is
1757    not possible to calculate the offset between the frame pointer and the
1758    automatic variables until after register allocation has been completed.
1759    When this macro is defined, you must also indicate in your definition of
1760    `ELIMINABLE_REGS' how to eliminate `FRAME_POINTER_REGNUM' into either
1761    `HARD_FRAME_POINTER_REGNUM' or `STACK_POINTER_REGNUM'.
1762
1763    Do not define this macro if it would be the same as `FRAME_POINTER_REGNUM'.  */
1764 #define HARD_FRAME_POINTER_REGNUM 13
1765
1766 /* The register number of the arg pointer register, which is used to access the
1767    function's argument list.  On some machines, this is the same as the frame
1768    pointer register.  On some machines, the hardware determines which register
1769    this is.  On other machines, you can choose any register you wish for this
1770    purpose.  If this is not the same register as the frame pointer register,
1771    then you must mark it as a fixed register according to `FIXED_REGISTERS', or
1772    arrange to be able to eliminate it.  */
1773 #define ARG_POINTER_REGNUM 18
1774
1775 /* The register number of the return address pointer register, which is used to
1776    access the current function's return address from the stack.  On some
1777    machines, the return address is not at a fixed offset from the frame pointer
1778    or stack pointer or argument pointer.  This register can be defined to point
1779    to the return address on the stack, and then be converted by
1780    `ELIMINABLE_REGS' into either the frame pointer or stack pointer.
1781
1782    Do not define this macro unless there is no other way to get the return
1783    address from the stack.  */
1784 /* #define RETURN_ADDRESS_POINTER_REGNUM */
1785
1786 /* Register numbers used for passing a function's static chain pointer.  If
1787    register windows are used, the register number as seen by the called
1788    function is `STATIC_CHAIN_INCOMING_REGNUM', while the register number as
1789    seen by the calling function is `STATIC_CHAIN_REGNUM'.  If these registers
1790    are the same, `STATIC_CHAIN_INCOMING_REGNUM' need not be defined.
1791
1792    The static chain register need not be a fixed register.
1793
1794    If the static chain is passed in memory, these macros should not be defined;
1795    instead, the next two macros should be defined.  */
1796 #define STATIC_CHAIN_REGNUM 1
1797 /* #define STATIC_CHAIN_INCOMING_REGNUM */
1798
1799 /* If the static chain is passed in memory, these macros provide rtx giving
1800    `mem' expressions that denote where they are stored.  `STATIC_CHAIN' and
1801    `STATIC_CHAIN_INCOMING' give the locations as seen by the calling and called
1802    functions, respectively.  Often the former will be at an offset from the
1803    stack pointer and the latter at an offset from the frame pointer.
1804
1805    The variables `stack_pointer_rtx', `frame_pointer_rtx', and
1806    `arg_pointer_rtx' will have been initialized prior to the use of these
1807    macros and should be used to refer to those items.
1808
1809    If the static chain is passed in a register, the two previous
1810    macros should be defined instead.  */
1811 /* #define STATIC_CHAIN */
1812 /* #define STATIC_CHAIN_INCOMING */
1813
1814 \f
1815 /* Eliminating the Frame Pointer and the Arg Pointer */
1816
1817 /* A C expression which is nonzero if a function must have and use a frame
1818    pointer.  This expression is evaluated in the reload pass.  If its value is
1819    nonzero the function will have a frame pointer.
1820
1821    The expression can in principle examine the current function and decide
1822    according to the facts, but on most machines the constant 0 or the constant
1823    1 suffices.  Use 0 when the machine allows code to be generated with no
1824    frame pointer, and doing so saves some time or space.  Use 1 when there is
1825    no possible advantage to avoiding a frame pointer.
1826
1827    In certain cases, the compiler does not know how to produce valid code
1828    without a frame pointer.  The compiler recognizes those cases and
1829    automatically gives the function a frame pointer regardless of what
1830    `FRAME_POINTER_REQUIRED' says.  You don't need to worry about them.
1831
1832    In a function that does not require a frame pointer, the frame pointer
1833    register can be allocated for ordinary usage, unless you mark it as a fixed
1834    register.  See `FIXED_REGISTERS' for more information.  */
1835 #define FRAME_POINTER_REQUIRED 0
1836
1837 /* A C statement to store in the variable DEPTH_VAR the difference between the
1838    frame pointer and the stack pointer values immediately after the function
1839    prologue.  The value would be computed from information such as the result
1840    of `get_frame_size ()' and the tables of registers `regs_ever_live' and
1841    `call_used_regs'.
1842
1843    If `ELIMINABLE_REGS' is defined, this macro will be not be used and need not
1844    be defined.  Otherwise, it must be defined even if `FRAME_POINTER_REQUIRED'
1845    is defined to always be true; in that case, you may set DEPTH_VAR to
1846    anything.  */
1847 /* #define INITIAL_FRAME_POINTER_OFFSET(DEPTH_VAR) */
1848
1849 /* If defined, this macro specifies a table of register pairs used to eliminate
1850    unneeded registers that point into the stack frame.  If it is not defined,
1851    the only elimination attempted by the compiler is to replace references to
1852    the frame pointer with references to the stack pointer.
1853
1854    The definition of this macro is a list of structure initializations, each of
1855    which specifies an original and replacement register.
1856 */
1857
1858 #define ELIMINABLE_REGS                                 \
1859 {                                                       \
1860   {FRAME_POINTER_REGNUM, STACK_POINTER_REGNUM},         \
1861   {FRAME_POINTER_REGNUM, HARD_FRAME_POINTER_REGNUM},    \
1862   {ARG_POINTER_REGNUM,   STACK_POINTER_REGNUM},         \
1863   {ARG_POINTER_REGNUM,   HARD_FRAME_POINTER_REGNUM},    \
1864 }
1865
1866 /* A C expression that returns non-zero if the compiler is allowed to try to
1867    replace register number FROM with register number TO.  This macro need only
1868    be defined if `ELIMINABLE_REGS' is defined, and will usually be the constant
1869    1, since most of the cases preventing register elimination are things that
1870    the compiler already knows about.  */
1871
1872 #define CAN_ELIMINATE(FROM, TO)                                         \
1873  ((FROM) == ARG_POINTER_REGNUM && (TO) == STACK_POINTER_REGNUM          \
1874   ? ! frame_pointer_needed                                              \
1875   : 1)
1876
1877 /* This macro is similar to `INITIAL_FRAME_POINTER_OFFSET'.  It specifies the
1878    initial difference between the specified pair of registers.  This macro must
1879    be defined if `ELIMINABLE_REGS' is defined.  */
1880 #define INITIAL_ELIMINATION_OFFSET(FROM, TO, OFFSET) \
1881   (OFFSET) = stormy16_initial_elimination_offset (FROM, TO)
1882
1883 /* Define this macro if the `longjmp' function restores registers from the
1884    stack frames, rather than from those saved specifically by `setjmp'.
1885    Certain quantities must not be kept in registers across a call to `setjmp'
1886    on such machines.  */
1887 /* #define LONGJMP_RESTORE_FROM_STACK */
1888
1889 \f
1890 /* Passing Function Arguments on the Stack */
1891
1892 /* Define this macro if an argument declared in a prototype as an integral type
1893    smaller than `int' should actually be passed as an `int'.  In addition to
1894    avoiding errors in certain cases of mismatch, it also makes for better code
1895    on certain machines.  */
1896 #define PROMOTE_PROTOTYPES 1
1897
1898 /* A C expression that is the number of bytes actually pushed onto the stack
1899    when an instruction attempts to push NPUSHED bytes.
1900
1901    If the target machine does not have a push instruction, do not define this
1902    macro.  That directs GNU CC to use an alternate strategy: to allocate the
1903    entire argument block and then store the arguments into it.
1904
1905    On some machines, the definition
1906
1907         #define PUSH_ROUNDING(BYTES) (BYTES)
1908
1909    will suffice.  But on other machines, instructions that appear to push one
1910    byte actually push two bytes in an attempt to maintain alignment.  Then the
1911    definition should be
1912
1913         #define PUSH_ROUNDING(BYTES) (((BYTES) + 1) & ~1)  */
1914 #define PUSH_ROUNDING(BYTES) (((BYTES) + 1) & ~1)
1915
1916 /* If defined, the maximum amount of space required for outgoing arguments will
1917    be computed and placed into the variable
1918    `current_function_outgoing_args_size'.  No space will be pushed onto the
1919    stack for each call; instead, the function prologue should increase the
1920    stack frame size by this amount.
1921
1922    Defining both `PUSH_ROUNDING' and `ACCUMULATE_OUTGOING_ARGS' is not
1923    proper.  */
1924 /* #define ACCUMULATE_OUTGOING_ARGS */
1925
1926 /* Define this macro if functions should assume that stack space has been
1927    allocated for arguments even when their values are passed in registers.
1928
1929    The value of this macro is the size, in bytes, of the area reserved for
1930    arguments passed in registers for the function represented by FNDECL.
1931
1932    This space can be allocated by the caller, or be a part of the
1933    machine-dependent stack frame: `OUTGOING_REG_PARM_STACK_SPACE' says
1934    which.  */
1935 /* #define REG_PARM_STACK_SPACE(FNDECL) */
1936
1937 /* Define these macros in addition to the one above if functions might allocate
1938    stack space for arguments even when their values are passed in registers.
1939    These should be used when the stack space allocated for arguments in
1940    registers is not a simple constant independent of the function declaration.
1941
1942    The value of the first macro is the size, in bytes, of the area that we
1943    should initially assume would be reserved for arguments passed in registers.
1944
1945    The value of the second macro is the actual size, in bytes, of the area that
1946    will be reserved for arguments passed in registers.  This takes two
1947    arguments: an integer representing the number of bytes of fixed sized
1948    arguments on the stack, and a tree representing the number of bytes of
1949    variable sized arguments on the stack.
1950
1951    When these macros are defined, `REG_PARM_STACK_SPACE' will only be called
1952    for libcall functions, the current function, or for a function being called
1953    when it is known that such stack space must be allocated.  In each case this
1954    value can be easily computed.
1955
1956    When deciding whether a called function needs such stack space, and how much
1957    space to reserve, GNU CC uses these two macros instead of
1958    `REG_PARM_STACK_SPACE'.  */
1959 /* #define MAYBE_REG_PARM_STACK_SPACE */
1960 /* #define FINAL_REG_PARM_STACK_SPACE(CONST_SIZE, VAR_SIZE) */
1961
1962 /* Define this if it is the responsibility of the caller to allocate the area
1963    reserved for arguments passed in registers.
1964
1965    If `ACCUMULATE_OUTGOING_ARGS' is defined, this macro controls whether the
1966    space for these arguments counts in the value of
1967    `current_function_outgoing_args_size'.  */
1968 /* #define OUTGOING_REG_PARM_STACK_SPACE */
1969
1970 /* Define this macro if `REG_PARM_STACK_SPACE' is defined, but the stack
1971    parameters don't skip the area specified by it.
1972
1973    Normally, when a parameter is not passed in registers, it is placed on the
1974    stack beyond the `REG_PARM_STACK_SPACE' area.  Defining this macro
1975    suppresses this behavior and causes the parameter to be passed on the stack
1976    in its natural location.  */
1977 /* #define STACK_PARMS_IN_REG_PARM_AREA */
1978
1979 /* A C expression that should indicate the number of bytes of its own arguments
1980    that a function pops on returning, or 0 if the function pops no arguments
1981    and the caller must therefore pop them all after the function returns.
1982
1983    FUNDECL is a C variable whose value is a tree node that describes the
1984    function in question.  Normally it is a node of type `FUNCTION_DECL' that
1985    describes the declaration of the function.  From this it is possible to
1986    obtain the DECL_ATTRIBUTES of the function.
1987
1988    FUNTYPE is a C variable whose value is a tree node that describes the
1989    function in question.  Normally it is a node of type `FUNCTION_TYPE' that
1990    describes the data type of the function.  From this it is possible to obtain
1991    the data types of the value and arguments (if known).
1992
1993    When a call to a library function is being considered, FUNTYPE will contain
1994    an identifier node for the library function.  Thus, if you need to
1995    distinguish among various library functions, you can do so by their names.
1996    Note that "library function" in this context means a function used to
1997    perform arithmetic, whose name is known specially in the compiler and was
1998    not mentioned in the C code being compiled.
1999
2000    STACK-SIZE is the number of bytes of arguments passed on the stack.  If a
2001    variable number of bytes is passed, it is zero, and argument popping will
2002    always be the responsibility of the calling function.
2003
2004    On the Vax, all functions always pop their arguments, so the definition of
2005    this macro is STACK-SIZE.  On the 68000, using the standard calling
2006    convention, no functions pop their arguments, so the value of the macro is
2007    always 0 in this case.  But an alternative calling convention is available
2008    in which functions that take a fixed number of arguments pop them but other
2009    functions (such as `printf') pop nothing (the caller pops all).  When this
2010    convention is in use, FUNTYPE is examined to determine whether a function
2011    takes a fixed number of arguments.  */
2012 #define RETURN_POPS_ARGS(FUNDECL, FUNTYPE, STACK_SIZE) 0
2013
2014 \f
2015 /* Function Arguments in Registers */
2016
2017 #define NUM_ARGUMENT_REGISTERS 6
2018 #define FIRST_ARGUMENT_REGISTER 2
2019
2020 #define STORMY16_WORD_SIZE(TYPE, MODE)                          \
2021   ((((TYPE) ? int_size_in_bytes (TYPE) : GET_MODE_SIZE (MODE))  \
2022     + 1)                                                        \
2023    / 2)
2024
2025 /* A C expression that controls whether a function argument is passed in a
2026    register, and which register.
2027
2028    The arguments are CUM, of type CUMULATIVE_ARGS, which summarizes
2029    (in a way defined by INIT_CUMULATIVE_ARGS and FUNCTION_ARG_ADVANCE)
2030    all of the previous arguments so far passed in registers; MODE, the
2031    machine mode of the argument; TYPE, the data type of the argument
2032    as a tree node or 0 if that is not known (which happens for C
2033    support library functions); and NAMED, which is 1 for an ordinary
2034    argument and 0 for nameless arguments that correspond to `...' in
2035    the called function's prototype.
2036
2037    The value of the expression should either be a `reg' RTX for the hard
2038    register in which to pass the argument, or zero to pass the argument on the
2039    stack.
2040
2041    For machines like the Vax and 68000, where normally all arguments are
2042    pushed, zero suffices as a definition.
2043
2044    The usual way to make the ANSI library `stdarg.h' work on a machine where
2045    some arguments are usually passed in registers, is to cause nameless
2046    arguments to be passed on the stack instead.  This is done by making
2047    `FUNCTION_ARG' return 0 whenever NAMED is 0.
2048
2049    You may use the macro `MUST_PASS_IN_STACK (MODE, TYPE)' in the definition of
2050    this macro to determine if this argument is of a type that must be passed in
2051    the stack.  If `REG_PARM_STACK_SPACE' is not defined and `FUNCTION_ARG'
2052    returns non-zero for such an argument, the compiler will abort.  If
2053    `REG_PARM_STACK_SPACE' is defined, the argument will be computed in the
2054    stack and then loaded into a register.  */
2055 #define FUNCTION_ARG(CUM, MODE, TYPE, NAMED)                              \
2056   ((MODE) == VOIDmode ? const0_rtx                                        \
2057    : (CUM) + STORMY16_WORD_SIZE (TYPE, MODE) > NUM_ARGUMENT_REGISTERS ? 0 \
2058    : gen_rtx_REG (MODE, (CUM) + 2))
2059
2060 /* Define this macro if the target machine has "register windows", so that the
2061    register in which a function sees an arguments is not necessarily the same
2062    as the one in which the caller passed the argument.
2063
2064    For such machines, `FUNCTION_ARG' computes the register in which the caller
2065    passes the value, and `FUNCTION_INCOMING_ARG' should be defined in a similar
2066    fashion to tell the function being called where the arguments will arrive.
2067
2068    If `FUNCTION_INCOMING_ARG' is not defined, `FUNCTION_ARG' serves both
2069    purposes.  */
2070 /* #define FUNCTION_INCOMING_ARG(CUM, MODE, TYPE, NAMED) */
2071
2072 /* A C expression for the number of words, at the beginning of an argument,
2073    must be put in registers.  The value must be zero for arguments that are
2074    passed entirely in registers or that are entirely pushed on the stack.
2075
2076    On some machines, certain arguments must be passed partially in registers
2077    and partially in memory.  On these machines, typically the first N words of
2078    arguments are passed in registers, and the rest on the stack.  If a
2079    multi-word argument (a `double' or a structure) crosses that boundary, its
2080    first few words must be passed in registers and the rest must be pushed.
2081    This macro tells the compiler when this occurs, and how many of the words
2082    should go in registers.
2083
2084    `FUNCTION_ARG' for these arguments should return the first register to be
2085    used by the caller for this argument; likewise `FUNCTION_INCOMING_ARG', for
2086    the called function.  */
2087 #define FUNCTION_ARG_PARTIAL_NREGS(CUM, MODE, TYPE, NAMED) 0
2088
2089 /* A C expression that indicates when an argument must be passed by reference.
2090    If nonzero for an argument, a copy of that argument is made in memory and a
2091    pointer to the argument is passed instead of the argument itself.  The
2092    pointer is passed in whatever way is appropriate for passing a pointer to
2093    that type.
2094
2095    On machines where `REG_PARM_STACK_SPACE' is not defined, a suitable
2096    definition of this macro might be
2097         #define FUNCTION_ARG_PASS_BY_REFERENCE(CUM, MODE, TYPE, NAMED)  \
2098           MUST_PASS_IN_STACK (MODE, TYPE)  */
2099 #define FUNCTION_ARG_PASS_BY_REFERENCE(CUM, MODE, TYPE, NAMED) 0
2100
2101 /* If defined, a C expression that indicates when it is more
2102    desirable to keep an argument passed by invisible reference as a
2103    reference, rather than copying it to a pseudo register.  */
2104 /* #define FUNCTION_ARG_KEEP_AS_REFERENCE(CUM, MODE, TYPE, NAMED) */
2105
2106 /* If defined, a C expression that indicates when it is the called function's
2107    responsibility to make a copy of arguments passed by invisible reference.
2108    Normally, the caller makes a copy and passes the address of the copy to the
2109    routine being called.  When FUNCTION_ARG_CALLEE_COPIES is defined and is
2110    nonzero, the caller does not make a copy.  Instead, it passes a pointer to
2111    the "live" value.  The called function must not modify this value.  If it
2112    can be determined that the value won't be modified, it need not make a copy;
2113    otherwise a copy must be made.  */
2114 /* #define FUNCTION_ARG_CALLEE_COPIES(CUM, MODE, TYPE, NAMED) */
2115
2116 /* A C type for declaring a variable that is used as the first argument of
2117    `FUNCTION_ARG' and other related values.  For some target machines, the type
2118    `int' suffices and can hold the number of bytes of argument so far.
2119
2120    There is no need to record in `CUMULATIVE_ARGS' anything about the arguments
2121    that have been passed on the stack.  The compiler has other variables to
2122    keep track of that.  For target machines on which all arguments are passed
2123    on the stack, there is no need to store anything in `CUMULATIVE_ARGS';
2124    however, the data structure must exist and should not be empty, so use
2125    `int'.  
2126
2127    For this platform, the value of CUMULATIVE_ARGS is the number of words
2128    of arguments that have been passed in registers so far.  */
2129 typedef int CUMULATIVE_ARGS;
2130
2131 /* A C statement (sans semicolon) for initializing the variable CUM for the
2132    state at the beginning of the argument list.  The variable has type
2133    `CUMULATIVE_ARGS'.  The value of FNTYPE is the tree node for the data type
2134    of the function which will receive the args, or 0 if the args are to a
2135    compiler support library function.  The value of INDIRECT is nonzero when
2136    processing an indirect call, for example a call through a function pointer.
2137    The value of INDIRECT is zero for a call to an explicitly named function, a
2138    library function call, or when `INIT_CUMULATIVE_ARGS' is used to find
2139    arguments for the function being compiled.
2140
2141    When processing a call to a compiler support library function, LIBNAME
2142    identifies which one.  It is a `symbol_ref' rtx which contains the name of
2143    the function, as a string.  LIBNAME is 0 when an ordinary C function call is
2144    being processed.  Thus, each time this macro is called, either LIBNAME or
2145    FNTYPE is nonzero, but never both of them at once.  */
2146 #define INIT_CUMULATIVE_ARGS(CUM, FNTYPE, LIBNAME, INDIRECT) (CUM) = 0
2147
2148 /* Like `INIT_CUMULATIVE_ARGS' but overrides it for the purposes of finding the
2149    arguments for the function being compiled.  If this macro is undefined,
2150    `INIT_CUMULATIVE_ARGS' is used instead.
2151
2152    The value passed for LIBNAME is always 0, since library routines with
2153    special calling conventions are never compiled with GNU CC.  The argument
2154    LIBNAME exists for symmetry with `INIT_CUMULATIVE_ARGS'.  */
2155 /* #define INIT_CUMULATIVE_INCOMING_ARGS(CUM, FNTYPE, LIBNAME) */
2156
2157 /* A C statement (sans semicolon) to update the summarizer variable CUM to
2158    advance past an argument in the argument list.  The values MODE, TYPE and
2159    NAMED describe that argument.  Once this is done, the variable CUM is
2160    suitable for analyzing the *following* argument with `FUNCTION_ARG', etc.
2161
2162    This macro need not do anything if the argument in question was passed on
2163    the stack.  The compiler knows how to track the amount of stack space used
2164    for arguments without any special help.  */
2165 #define FUNCTION_ARG_ADVANCE(CUM, MODE, TYPE, NAMED)                    \
2166   ((CUM) = stormy16_function_arg_advance (CUM, MODE, TYPE, NAMED))
2167
2168 /* If defined, a C expression which determines whether, and in which direction,
2169    to pad out an argument with extra space.  The value should be of type `enum
2170    direction': either `upward' to pad above the argument, `downward' to pad
2171    below, or `none' to inhibit padding.
2172
2173    The *amount* of padding is always just enough to reach the next multiple of
2174    `FUNCTION_ARG_BOUNDARY'; this macro does not control it.
2175
2176    This macro has a default definition which is right for most systems.  For
2177    little-endian machines, the default is to pad upward.  For big-endian
2178    machines, the default is to pad downward for an argument of constant size
2179    shorter than an `int', and upward otherwise.  */
2180 /* #define FUNCTION_ARG_PADDING(MODE, TYPE) */
2181
2182 /* If defined, a C expression that gives the alignment boundary, in bits, of an
2183    argument with the specified mode and type.  If it is not defined,
2184    `PARM_BOUNDARY' is used for all arguments.  */
2185 /* #define FUNCTION_ARG_BOUNDARY(MODE, TYPE) */
2186
2187 /* A C expression that is nonzero if REGNO is the number of a hard register in
2188    which function arguments are sometimes passed.  This does *not* include
2189    implicit arguments such as the static chain and the structure-value address.
2190    On many machines, no registers can be used for this purpose since all
2191    function arguments are pushed on the stack.  */
2192 #define FUNCTION_ARG_REGNO_P(REGNO)                                     \
2193   ((REGNO) >= FIRST_ARGUMENT_REGISTER                                   \
2194    && (REGNO) < FIRST_ARGUMENT_REGISTER + NUM_ARGUMENT_REGISTERS)
2195
2196 \f
2197 /* How Scalar Function Values are Returned */
2198
2199 /* The number of the hard register that is used to return a scalar value from a
2200    function call.  */
2201 #define RETURN_VALUE_REGNUM     FIRST_ARGUMENT_REGISTER
2202      
2203 /* Define this macro if `-traditional' should not cause functions declared to
2204    return `float' to convert the value to `double'.  */
2205 /* #define TRADITIONAL_RETURN_FLOAT */
2206
2207 /* A C expression to create an RTX representing the place where a function
2208    returns a value of data type VALTYPE.  VALTYPE is a tree node representing a
2209    data type.  Write `TYPE_MODE (VALTYPE)' to get the machine mode used to
2210    represent that type.  On many machines, only the mode is relevant.
2211    (Actually, on most machines, scalar values are returned in the same place
2212    regardless of mode).
2213
2214    If `PROMOTE_FUNCTION_RETURN' is defined, you must apply the same promotion
2215    rules specified in `PROMOTE_MODE' if VALTYPE is a scalar type.
2216
2217    If the precise function being called is known, FUNC is a tree node
2218    (`FUNCTION_DECL') for it; otherwise, FUNC is a null pointer.  This makes it
2219    possible to use a different value-returning convention for specific
2220    functions when all their calls are known.
2221
2222    `FUNCTION_VALUE' is not used for return vales with aggregate data types,
2223    because these are returned in another way.  See `STRUCT_VALUE_REGNUM' and
2224    related macros, below.  */
2225 #define FUNCTION_VALUE(VALTYPE, FUNC) \
2226   stormy16_function_value (VALTYPE, FUNC)
2227
2228
2229 /* Define this macro if the target machine has "register windows" so that the
2230    register in which a function returns its value is not the same as the one in
2231    which the caller sees the value.
2232
2233    For such machines, `FUNCTION_VALUE' computes the register in which the
2234    caller will see the value.  `FUNCTION_OUTGOING_VALUE' should be defined in a
2235    similar fashion to tell the function where to put the value.
2236
2237    If `FUNCTION_OUTGOING_VALUE' is not defined, `FUNCTION_VALUE' serves both
2238    purposes.
2239
2240    `FUNCTION_OUTGOING_VALUE' is not used for return vales with aggregate data
2241    types, because these are returned in another way.  See `STRUCT_VALUE_REGNUM'
2242    and related macros, below.  */
2243 /* #define FUNCTION_OUTGOING_VALUE(VALTYPE, FUNC) */
2244
2245 /* A C expression to create an RTX representing the place where a library
2246    function returns a value of mode MODE.
2247
2248    Note that "library function" in this context means a compiler support
2249    routine, used to perform arithmetic, whose name is known specially by the
2250    compiler and was not mentioned in the C code being compiled.
2251
2252    The definition of `LIBRARY_VALUE' need not be concerned aggregate data
2253    types, because none of the library functions returns such types.  */
2254 #define LIBCALL_VALUE(MODE) gen_rtx_REG (MODE, RETURN_VALUE_REGNUM)
2255
2256 /* A C expression that is nonzero if REGNO is the number of a hard register in
2257    which the values of called function may come back.
2258
2259    A register whose use for returning values is limited to serving as the
2260    second of a pair (for a value of type `double', say) need not be recognized
2261    by this macro.  So for most machines, this definition suffices:
2262
2263         #define FUNCTION_VALUE_REGNO_P(N) ((N) == RETURN)
2264
2265    If the machine has register windows, so that the caller and the called
2266    function use different registers for the return value, this macro should
2267    recognize only the caller's register numbers.  */
2268 #define FUNCTION_VALUE_REGNO_P(REGNO) ((REGNO) == RETURN_VALUE_REGNUM)
2269
2270 /* Define this macro if `untyped_call' and `untyped_return' need more space
2271    than is implied by `FUNCTION_VALUE_REGNO_P' for saving and restoring an
2272    arbitrary return value.  */
2273 /* #define APPLY_RESULT_SIZE */
2274
2275 \f
2276 /* How Large Values are Returned */
2277
2278 /* A C expression which can inhibit the returning of certain function values in
2279    registers, based on the type of value.  A nonzero value says to return the
2280    function value in memory, just as large structures are always returned.
2281    Here TYPE will be a C expression of type `tree', representing the data type
2282    of the value.
2283
2284    Note that values of mode `BLKmode' must be explicitly handled by this macro.
2285    Also, the option `-fpcc-struct-return' takes effect regardless of this
2286    macro.  On most systems, it is possible to leave the macro undefined; this
2287    causes a default definition to be used, whose value is the constant 1 for
2288    `BLKmode' values, and 0 otherwise.
2289
2290    Do not use this macro to indicate that structures and unions should always
2291    be returned in memory.  You should instead use `DEFAULT_PCC_STRUCT_RETURN'
2292    to indicate this.  */
2293 #define RETURN_IN_MEMORY(TYPE) \
2294   (int_size_in_bytes (TYPE) > UNITS_PER_WORD * NUM_ARGUMENT_REGISTERS)
2295
2296 /* Define this macro to be 1 if all structure and union return values must be
2297    in memory.  Since this results in slower code, this should be defined only
2298    if needed for compatibility with other compilers or with an ABI.  If you
2299    define this macro to be 0, then the conventions used for structure and union
2300    return values are decided by the `RETURN_IN_MEMORY' macro.
2301
2302    If not defined, this defaults to the value 1.  */
2303 /* #define DEFAULT_PCC_STRUCT_RETURN 0 */
2304
2305 /* If the structure value address is passed in a register, then
2306    `STRUCT_VALUE_REGNUM' should be the number of that register.  */
2307 /* #define STRUCT_VALUE_REGNUM */
2308
2309 /* If the structure value address is not passed in a register, define
2310    `STRUCT_VALUE' as an expression returning an RTX for the place where the
2311    address is passed.  If it returns 0, the address is passed as an "invisible"
2312    first argument.  */
2313 #define STRUCT_VALUE 0
2314
2315 /* On some architectures the place where the structure value address is found
2316    by the called function is not the same place that the caller put it.  This
2317    can be due to register windows, or it could be because the function prologue
2318    moves it to a different place.
2319
2320    If the incoming location of the structure value address is in a register,
2321    define this macro as the register number.  */
2322 /* #define STRUCT_VALUE_INCOMING_REGNUM */
2323
2324 /* If the incoming location is not a register, then you should define
2325    `STRUCT_VALUE_INCOMING' as an expression for an RTX for where the called
2326    function should find the value.  If it should find the value on the stack,
2327    define this to create a `mem' which refers to the frame pointer.  A
2328    definition of 0 means that the address is passed as an "invisible" first
2329    argument.  */
2330 /* #define STRUCT_VALUE_INCOMING */
2331
2332 /* Define this macro if the usual system convention on the target machine for
2333    returning structures and unions is for the called function to return the
2334    address of a static variable containing the value.
2335
2336    Do not define this if the usual system convention is for the caller to pass
2337    an address to the subroutine.
2338
2339    This macro has effect in `-fpcc-struct-return' mode, but it does nothing
2340    when you use `-freg-struct-return' mode.  */
2341 /* #define PCC_STATIC_STRUCT_RETURN */
2342
2343 \f
2344 /* Caller-Saves Register Allocation */
2345
2346 /* Define this macro if function calls on the target machine do not preserve
2347    any registers; in other words, if `CALL_USED_REGISTERS' has 1 for all
2348    registers.  This macro enables `-fcaller-saves' by default.  Eventually that
2349    option will be enabled by default on all machines and both the option and
2350    this macro will be eliminated.  */
2351 /* #define DEFAULT_CALLER_SAVES */
2352
2353 /* A C expression to determine whether it is worthwhile to consider placing a
2354    pseudo-register in a call-clobbered hard register and saving and restoring
2355    it around each function call.  The expression should be 1 when this is worth
2356    doing, and 0 otherwise.
2357
2358    If you don't define this macro, a default is used which is good on most
2359    machines: `4 * CALLS < REFS'.  */
2360 /* #define CALLER_SAVE_PROFITABLE(REFS, CALLS) */
2361
2362 \f
2363 /* Function Entry and Exit */
2364
2365 /* Define this macro as a C expression that is nonzero if the return
2366    instruction or the function epilogue ignores the value of the stack pointer;
2367    in other words, if it is safe to delete an instruction to adjust the stack
2368    pointer before a return from the function.
2369
2370    Note that this macro's value is relevant only for functions for which frame
2371    pointers are maintained.  It is never safe to delete a final stack
2372    adjustment in a function that has no frame pointer, and the compiler knows
2373    this regardless of `EXIT_IGNORE_STACK'.  */
2374 /* #define EXIT_IGNORE_STACK */
2375
2376 /* Define this macro as a C expression that is nonzero for registers
2377    are used by the epilogue or the `return' pattern.  The stack and
2378    frame pointer registers are already be assumed to be used as
2379    needed.  */
2380 #define EPILOGUE_USES(REGNO) \
2381   stormy16_epilogue_uses (REGNO)
2382
2383 /* Define this macro if the function epilogue contains delay slots to which
2384    instructions from the rest of the function can be "moved".  The definition
2385    should be a C expression whose value is an integer representing the number
2386    of delay slots there.  */
2387 /* #define DELAY_SLOTS_FOR_EPILOGUE */
2388
2389 /* A C expression that returns 1 if INSN can be placed in delay slot number N
2390    of the epilogue.
2391
2392    The argument N is an integer which identifies the delay slot now being
2393    considered (since different slots may have different rules of eligibility).
2394    It is never negative and is always less than the number of epilogue delay
2395    slots (what `DELAY_SLOTS_FOR_EPILOGUE' returns).  If you reject a particular
2396    insn for a given delay slot, in principle, it may be reconsidered for a
2397    subsequent delay slot.  Also, other insns may (at least in principle) be
2398    considered for the so far unfilled delay slot.
2399
2400    The insns accepted to fill the epilogue delay slots are put in an
2401    RTL list made with `insn_list' objects, stored in the variable
2402    `current_function_epilogue_delay_list'.  The insn for the first
2403    delay slot comes first in the list.  Your definition of the macro
2404    `FUNCTION_EPILOGUE' should fill the delay slots by outputting the
2405    insns in this list, usually by calling `final_scan_insn'.
2406
2407    You need not define this macro if you did not define
2408    `DELAY_SLOTS_FOR_EPILOGUE'.  */
2409 /* #define ELIGIBLE_FOR_EPILOGUE_DELAY(INSN, N) */
2410
2411 /* A C compound statement that outputs the assembler code for a thunk function,
2412    used to implement C++ virtual function calls with multiple inheritance.  The
2413    thunk acts as a wrapper around a virtual function, adjusting the implicit
2414    object parameter before handing control off to the real function.
2415
2416    First, emit code to add the integer DELTA to the location that contains the
2417    incoming first argument.  Assume that this argument contains a pointer, and
2418    is the one used to pass the `this' pointer in C++.  This is the incoming
2419    argument *before* the function prologue, e.g. `%o0' on a sparc.  The
2420    addition must preserve the values of all other incoming arguments.
2421
2422    After the addition, emit code to jump to FUNCTION, which is a
2423    `FUNCTION_DECL'.  This is a direct pure jump, not a call, and does not touch
2424    the return address.  Hence returning from FUNCTION will return to whoever
2425    called the current `thunk'.
2426
2427    The effect must be as if @var{function} had been called directly
2428    with the adjusted first argument.  This macro is responsible for
2429    emitting all of the code for a thunk function;
2430    TARGET_ASM_FUNCTION_PROLOGUE and TARGET_ASM_FUNCTION_EPILOGUE are
2431    not invoked.
2432
2433    The THUNK_FNDECL is redundant.  (DELTA and FUNCTION have already been
2434    extracted from it.)  It might possibly be useful on some targets, but
2435    probably not.
2436
2437    If you do not define this macro, the target-independent code in the C++
2438    frontend will generate a less efficient heavyweight thunk that calls
2439    FUNCTION instead of jumping to it.  The generic approach does not support
2440    varargs.  */
2441 #define ASM_OUTPUT_MI_THUNK(FILE, THUNK_FNDECL, DELTA, FUNCTION)        \
2442 {                                                                       \
2443   fprintf (FILE, "\tadd r2,#0x%x\n", (DELTA) & 0xFFFF);                 \
2444   fputs ("\tjmpf ", FILE);                                              \
2445   assemble_name (FILE, XSTR (XEXP (DECL_RTL (function), 0), 0));        \
2446   putc ('\n', FILE);                                                    \
2447 }  
2448
2449 \f
2450 /* Generating Code for Profiling.  */
2451
2452 /* A C statement or compound statement to output to FILE some assembler code to
2453    call the profiling subroutine `mcount'.  Before calling, the assembler code
2454    must load the address of a counter variable into a register where `mcount'
2455    expects to find the address.  The name of this variable is `LP' followed by
2456    the number LABELNO, so you would generate the name using `LP%d' in a
2457    `fprintf'.
2458
2459    The details of how the address should be passed to `mcount' are determined
2460    by your operating system environment, not by GNU CC.  To figure them out,
2461    compile a small program for profiling using the system's installed C
2462    compiler and look at the assembler code that results.
2463
2464    This declaration must be present, but it can be an abort if profiling is
2465    not implemented.  */
2466      
2467 #define FUNCTION_PROFILER(FILE, LABELNO) abort ()
2468
2469 /* Define this macro if the code for function profiling should come before the
2470    function prologue.  Normally, the profiling code comes after.  */
2471 /* #define PROFILE_BEFORE_PROLOGUE */
2472
2473 /* A C statement or compound statement to output to FILE some assembler code to
2474    initialize basic-block profiling for the current object module.  The global
2475    compile flag `profile_block_flag' distingishes two profile modes.
2476
2477    profile_block_flag != 2'
2478         Output code to call the subroutine `__bb_init_func' once per
2479         object module, passing it as its sole argument the address of
2480         a block allocated in the object module.
2481
2482         The name of the block is a local symbol made with this
2483         statement:
2484
2485              ASM_GENERATE_INTERNAL_LABEL (BUFFER, "LPBX", 0);
2486
2487         Of course, since you are writing the definition of
2488         `ASM_GENERATE_INTERNAL_LABEL' as well as that of this macro,
2489         you can take a short cut in the definition of this macro and
2490         use the name that you know will result.
2491
2492         The first word of this block is a flag which will be nonzero
2493         if the object module has already been initialized.  So test
2494         this word first, and do not call `__bb_init_func' if the flag
2495         is nonzero.  BLOCK_OR_LABEL contains a unique number which
2496         may be used to generate a label as a branch destination when
2497         `__bb_init_func' will not be called.
2498
2499         Described in assembler language, the code to be output looks
2500         like:
2501
2502                cmp (LPBX0),0
2503                bne local_label
2504                parameter1 <- LPBX0
2505                call __bb_init_func
2506              local_label:
2507
2508    profile_block_flag == 2'
2509         Output code to call the subroutine `__bb_init_trace_func' and
2510         pass two parameters to it.  The first parameter is the same as
2511         for `__bb_init_func'.  The second parameter is the number of
2512         the first basic block of the function as given by
2513         BLOCK_OR_LABEL.  Note that `__bb_init_trace_func' has to be
2514         called, even if the object module has been initialized
2515         already.
2516
2517         Described in assembler language, the code to be output looks
2518         like:
2519              parameter1 <- LPBX0
2520              parameter2 <- BLOCK_OR_LABEL
2521              call __bb_init_trace_func  */
2522 /* #define FUNCTION_BLOCK_PROFILER (FILE, LABELNO) */
2523
2524 /* A C statement or compound statement to output to FILE some assembler code to
2525    increment the count associated with the basic block number BLOCKNO.  The
2526    global compile flag `profile_block_flag' distingishes two profile modes.
2527
2528    profile_block_flag != 2'
2529         Output code to increment the counter directly.  Basic blocks
2530         are numbered separately from zero within each compilation.
2531         The count associated with block number BLOCKNO is at index
2532         BLOCKNO in a vector of words; the name of this array is a
2533         local symbol made with this statement:
2534
2535              ASM_GENERATE_INTERNAL_LABEL (BUFFER, "LPBX", 2);
2536
2537         Of course, since you are writing the definition of
2538         `ASM_GENERATE_INTERNAL_LABEL' as well as that of this macro,
2539         you can take a short cut in the definition of this macro and
2540         use the name that you know will result.
2541
2542         Described in assembler language, the code to be output looks
2543         like:
2544
2545              inc (LPBX2+4*BLOCKNO)
2546
2547    profile_block_flag == 2'
2548         Output code to initialize the global structure `__bb' and
2549         call the function `__bb_trace_func', which will increment the
2550         counter.
2551
2552         `__bb' consists of two words.  In the first word, the current
2553         basic block number, as given by BLOCKNO, has to be stored.  In
2554         the second word, the address of a block allocated in the
2555         object module has to be stored.  The address is given by the
2556         label created with this statement:
2557
2558              ASM_GENERATE_INTERNAL_LABEL (BUFFER, "LPBX", 0);
2559
2560         Described in assembler language, the code to be output looks
2561         like:
2562              move BLOCKNO -> (__bb)
2563              move LPBX0 -> (__bb+4)
2564              call __bb_trace_func  */
2565 /* #define BLOCK_PROFILER(FILE, BLOCKNO) */
2566
2567 /* A C statement or compound statement to output to FILE assembler
2568    code to call function `__bb_trace_ret'.  The assembler code should
2569    only be output if the global compile flag `profile_block_flag' ==
2570    2.  This macro has to be used at every place where code for
2571    returning from a function is generated
2572    (e.g. `TARGET_ASM_FUNCTION_EPILOGUE').  Although you have to write
2573    the definition of `TARGET_ASM_FUNCTION_EPILOGUE' as well, you have
2574    to define this macro to tell the compiler, that the proper call to
2575    `__bb_trace_ret' is produced.  */
2576 /* #define FUNCTION_BLOCK_PROFILER_EXIT(FILE) */
2577
2578 /* A C statement or compound statement to save all registers, which may be
2579    clobbered by a function call, including condition codes.  The `asm'
2580    statement will be mostly likely needed to handle this task.  Local labels in
2581    the assembler code can be concatenated with the string ID, to obtain a
2582    unique lable name.
2583
2584    Registers or condition codes clobbered by
2585    `TARGET_ASM_FUNCTION_PROLOGUE' or `TARGET_ASM_FUNCTION_EPILOGUE'
2586    must be saved in the macros `FUNCTION_BLOCK_PROFILER',
2587    `FUNCTION_BLOCK_PROFILER_EXIT' and `BLOCK_PROFILER' prior calling
2588    `__bb_init_trace_func', `__bb_trace_ret' and `__bb_trace_func'
2589    respectively.  */
2590 /* #define MACHINE_STATE_SAVE(ID) */
2591
2592 /* A C statement or compound statement to restore all registers, including
2593    condition codes, saved by `MACHINE_STATE_SAVE'.
2594
2595    Registers or condition codes clobbered by `TARGET_ASM_FUNCTION_PROLOGUE' or
2596    `TARGET_ASM_FUNCTION_EPILOGUE' must be restored in the macros
2597    `FUNCTION_BLOCK_PROFILER', `FUNCTION_BLOCK_PROFILER_EXIT' and
2598    `BLOCK_PROFILER' after calling `__bb_init_trace_func', `__bb_trace_ret' and
2599    `__bb_trace_func' respectively.  */
2600 /* #define MACHINE_STATE_RESTORE(ID) */
2601
2602 /* A C function or functions which are needed in the library to support block
2603    profiling.  */
2604 /* #define BLOCK_PROFILER_CODE */
2605
2606 \f
2607 /* If the target has particular reasons why a function cannot be inlined,
2608    it may define the TARGET_CANNOT_INLINE_P.  This macro takes one argument,
2609    the DECL describing the function.  The function should NULL if the function
2610    *can* be inlined.  Otherwise it should return a pointer to a string containing
2611    a message describing why the function could not be inlined.  The message will
2612    displayed if the '-Winline' command line switch has been given.  If the message
2613    contains a '%s' sequence, this will be replaced by the name of the function.  */
2614 /* #define TARGET_CANNOT_INLINE_P(FN_DECL) stormy16_cannot_inline_p (FN_DECL) */
2615 \f
2616 /* Implementing the Varargs Macros.  */
2617
2618 /* If defined, is a C expression that produces the machine-specific code for a
2619    call to `__builtin_saveregs'.  This code will be moved to the very beginning
2620    of the function, before any parameter access are made.  The return value of
2621    this function should be an RTX that contains the value to use as the return
2622    of `__builtin_saveregs'.
2623
2624    If this macro is not defined, the compiler will output an ordinary call to
2625    the library function `__builtin_saveregs'.  */
2626 /* #define EXPAND_BUILTIN_SAVEREGS() */
2627
2628 /* This macro offers an alternative to using `__builtin_saveregs' and defining
2629    the macro `EXPAND_BUILTIN_SAVEREGS'.  Use it to store the anonymous register
2630    arguments into the stack so that all the arguments appear to have been
2631    passed consecutively on the stack.  Once this is done, you can use the
2632    standard implementation of varargs that works for machines that pass all
2633    their arguments on the stack.
2634
2635    The argument ARGS_SO_FAR is the `CUMULATIVE_ARGS' data structure, containing
2636    the values that obtain after processing of the named arguments.  The
2637    arguments MODE and TYPE describe the last named argument--its machine mode
2638    and its data type as a tree node.
2639
2640    The macro implementation should do two things: first, push onto the stack
2641    all the argument registers *not* used for the named arguments, and second,
2642    store the size of the data thus pushed into the `int'-valued variable whose
2643    name is supplied as the argument PRETEND_ARGS_SIZE.  The value that you
2644    store here will serve as additional offset for setting up the stack frame.
2645
2646    Because you must generate code to push the anonymous arguments at compile
2647    time without knowing their data types, `SETUP_INCOMING_VARARGS' is only
2648    useful on machines that have just a single category of argument register and
2649    use it uniformly for all data types.
2650
2651    If the argument SECOND_TIME is nonzero, it means that the arguments of the
2652    function are being analyzed for the second time.  This happens for an inline
2653    function, which is not actually compiled until the end of the source file.
2654    The macro `SETUP_INCOMING_VARARGS' should not generate any instructions in
2655    this case.  */
2656 #define SETUP_INCOMING_VARARGS(ARGS_SO_FAR, MODE, TYPE, PRETEND_ARGS_SIZE, SECOND_TIME) \
2657   if (! SECOND_TIME) \
2658     stormy16_setup_incoming_varargs (ARGS_SO_FAR, MODE, TYPE, & PRETEND_ARGS_SIZE)
2659
2660 /* Define this macro if the location where a function argument is passed
2661    depends on whether or not it is a named argument.
2662
2663    This macro controls how the NAMED argument to `FUNCTION_ARG' is set for
2664    varargs and stdarg functions.  With this macro defined, the NAMED argument
2665    is always true for named arguments, and false for unnamed arguments.  If
2666    this is not defined, but `SETUP_INCOMING_VARARGS' is defined, then all
2667    arguments are treated as named.  Otherwise, all named arguments except the
2668    last are treated as named.  */
2669 /* #define STRICT_ARGUMENT_NAMING  1 */
2670
2671 /* Build up the stdarg/varargs va_list type tree, assinging it to NODE.  If not
2672    defined, it is assumed that va_list is a void * pointer.  */
2673 #define BUILD_VA_LIST_TYPE(NODE) \
2674   ((NODE) = stormy16_build_va_list ())
2675
2676 /* Implement the stdarg/varargs va_start macro.  STDARG_P is non-zero if this
2677    is stdarg.h instead of varargs.h.  VALIST is the tree of the va_list
2678    variable to initialize.  NEXTARG is the machine independent notion of the
2679    'next' argument after the variable arguments.  If not defined, a standard
2680    implementation will be defined that works for arguments passed on the stack.  */
2681 #define EXPAND_BUILTIN_VA_START(STDARG_P, VALIST, NEXTARG) \
2682   stormy16_expand_builtin_va_start (STDARG_P, VALIST, NEXTARG)
2683
2684 /* Implement the stdarg/varargs va_arg macro.  VALIST is the variable of type
2685    va_list as a tree, TYPE is the type passed to va_arg.  */
2686 #define EXPAND_BUILTIN_VA_ARG(VALIST, TYPE) \
2687   stormy16_expand_builtin_va_arg (VALIST, TYPE)
2688
2689 /* Implement the stdarg/varargs va_end macro.  VALIST is the variable of type
2690    va_list as a tree.  */
2691 /* #define EXPAND_BUILTIN_VA_END(VALIST) */
2692
2693 \f
2694 /* Trampolines for Nested Functions.  */
2695
2696 /* A C statement to output, on the stream FILE, assembler code for a block of
2697    data that contains the constant parts of a trampoline.  This code should not
2698    include a label--the label is taken care of automatically.  */
2699 /* #define TRAMPOLINE_TEMPLATE(FILE) */
2700
2701 /* The name of a subroutine to switch to the section in which the trampoline
2702    template is to be placed.  The default is a value of `readonly_data_section',
2703    which places the trampoline in the section containing read-only data.  */
2704 /* #define TRAMPOLINE_SECTION */
2705
2706 /* A C expression for the size in bytes of the trampoline, as an integer.  */
2707 #define TRAMPOLINE_SIZE 8
2708
2709 /* Alignment required for trampolines, in bits.
2710
2711    If you don't define this macro, the value of `BIGGEST_ALIGNMENT' is used for
2712    aligning trampolines.  */
2713 #define TRAMPOLINE_ALIGNMENT 16
2714
2715 /* A C statement to initialize the variable parts of a trampoline.  ADDR is an
2716    RTX for the address of the trampoline; FNADDR is an RTX for the address of
2717    the nested function; STATIC_CHAIN is an RTX for the static chain value that
2718    should be passed to the function when it is called.  */
2719 #define INITIALIZE_TRAMPOLINE(ADDR, FNADDR, STATIC_CHAIN) \
2720   stormy16_initialize_trampoline (ADDR, FNADDR, STATIC_CHAIN)
2721
2722 /* A C expression to allocate run-time space for a trampoline.  The expression
2723    value should be an RTX representing a memory reference to the space for the
2724    trampoline.
2725
2726    If this macro is not defined, by default the trampoline is allocated as a
2727    stack slot.  This default is right for most machines.  The exceptions are
2728    machines where it is impossible to execute instructions in the stack area.
2729    On such machines, you may have to implement a separate stack, using this
2730    macro in conjunction with `TARGET_ASM_FUNCTION_PROLOGUE' and
2731    `TARGET_ASM_FUNCTION_EPILOGUE'.
2732
2733    FP points to a data structure, a `struct function', which describes the
2734    compilation status of the immediate containing function of the function
2735    which the trampoline is for.  Normally (when `ALLOCATE_TRAMPOLINE' is not
2736    defined), the stack slot for the trampoline is in the stack frame of this
2737    containing function.  Other allocation strategies probably must do something
2738    analogous with this information.  */
2739 /* #define ALLOCATE_TRAMPOLINE(FP) */
2740
2741 /* Implementing trampolines is difficult on many machines because they have
2742    separate instruction and data caches.  Writing into a stack location fails
2743    to clear the memory in the instruction cache, so when the program jumps to
2744    that location, it executes the old contents.
2745
2746    Here are two possible solutions.  One is to clear the relevant parts of the
2747    instruction cache whenever a trampoline is set up.  The other is to make all
2748    trampolines identical, by having them jump to a standard subroutine.  The
2749    former technique makes trampoline execution faster; the latter makes
2750    initialization faster.
2751
2752    To clear the instruction cache when a trampoline is initialized, define the
2753    following macros which describe the shape of the cache.  */
2754
2755 /* The total size in bytes of the cache.  */
2756 /* #define INSN_CACHE_SIZE */
2757
2758 /* The length in bytes of each cache line.  The cache is divided into cache
2759    lines which are disjoint slots, each holding a contiguous chunk of data
2760    fetched from memory.  Each time data is brought into the cache, an entire
2761    line is read at once.  The data loaded into a cache line is always aligned
2762    on a boundary equal to the line size.  */
2763 /* #define INSN_CACHE_LINE_WIDTH */
2764
2765 /* The number of alternative cache lines that can hold any particular memory
2766    location.  */
2767 /* #define INSN_CACHE_DEPTH */
2768
2769 /* Alternatively, if the machine has system calls or instructions to clear the
2770    instruction cache directly, you can define the following macro.  */
2771
2772 /* If defined, expands to a C expression clearing the *instruction cache* in
2773    the specified interval.  If it is not defined, and the macro INSN_CACHE_SIZE
2774    is defined, some generic code is generated to clear the cache.  The
2775    definition of this macro would typically be a series of `asm' statements.
2776    Both BEG and END are both pointer expressions.  */
2777 /* #define CLEAR_INSN_CACHE (BEG, END) */
2778
2779 /* To use a standard subroutine, define the following macro.  In addition, you
2780    must make sure that the instructions in a trampoline fill an entire cache
2781    line with identical instructions, or else ensure that the beginning of the
2782    trampoline code is always aligned at the same point in its cache line.  Look
2783    in `m68k.h' as a guide.  */
2784
2785 /* Define this macro if trampolines need a special subroutine to do their work.
2786    The macro should expand to a series of `asm' statements which will be
2787    compiled with GNU CC.  They go in a library function named
2788    `__transfer_from_trampoline'.
2789
2790    If you need to avoid executing the ordinary prologue code of a compiled C
2791    function when you jump to the subroutine, you can do so by placing a special
2792    label of your own in the assembler code.  Use one `asm' statement to
2793    generate an assembler label, and another to make the label global.  Then
2794    trampolines can use that label to jump directly to your special assembler
2795    code.  */
2796 /* #define TRANSFER_FROM_TRAMPOLINE */
2797
2798 \f
2799 /* Implicit Calls to Library Routines */
2800
2801 /* A C string constant giving the name of the function to call for
2802    multiplication of one signed full-word by another.  If you do not define
2803    this macro, the default name is used, which is `__mulsi3', a function
2804    defined in `libgcc.a'.  */
2805 /* #define MULSI3_LIBCALL */
2806
2807 /* A C string constant giving the name of the function to call for division of
2808    one signed full-word by another.  If you do not define this macro, the
2809    default name is used, which is `__divsi3', a function defined in `libgcc.a'.  */
2810 /* #define DIVSI3_LIBCALL */
2811
2812 /* A C string constant giving the name of the function to call for division of
2813    one unsigned full-word by another.  If you do not define this macro, the
2814    default name is used, which is `__udivsi3', a function defined in
2815    `libgcc.a'.  */
2816 /* #define UDIVSI3_LIBCALL */
2817
2818 /* A C string constant giving the name of the function to call for the
2819    remainder in division of one signed full-word by another.  If you do not
2820    define this macro, the default name is used, which is `__modsi3', a function
2821    defined in `libgcc.a'.  */
2822 /* #define MODSI3_LIBCALL */
2823
2824 /* A C string constant giving the name of the function to call for the
2825    remainder in division of one unsigned full-word by another.  If you do not
2826    define this macro, the default name is used, which is `__umodsi3', a
2827    function defined in `libgcc.a'.  */
2828 /* #define UMODSI3_LIBCALL */
2829
2830 /* A C string constant giving the name of the function to call for
2831    multiplication of one signed double-word by another.  If you do not define
2832    this macro, the default name is used, which is `__muldi3', a function
2833    defined in `libgcc.a'.  */
2834 /* #define MULDI3_LIBCALL */
2835
2836 /* A C string constant giving the name of the function to call for division of
2837    one signed double-word by another.  If you do not define this macro, the
2838    default name is used, which is `__divdi3', a function defined in `libgcc.a'.  */
2839 /* #define DIVDI3_LIBCALL */
2840
2841 /* A C string constant giving the name of the function to call for division of
2842    one unsigned full-word by another.  If you do not define this macro, the
2843    default name is used, which is `__udivdi3', a function defined in
2844    `libgcc.a'.  */
2845 /* #define UDIVDI3_LIBCALL */
2846
2847 /* A C string constant giving the name of the function to call for the
2848    remainder in division of one signed double-word by another.  If you do not
2849    define this macro, the default name is used, which is `__moddi3', a function
2850    defined in `libgcc.a'.  */
2851 /* #define MODDI3_LIBCALL */
2852
2853 /* A C string constant giving the name of the function to call for the
2854    remainder in division of one unsigned full-word by another.  If you do not
2855    define this macro, the default name is used, which is `__umoddi3', a
2856    function defined in `libgcc.a'.  */
2857 /* #define UMODDI3_LIBCALL */
2858
2859 /* Define this macro as a C statement that declares additional library routines
2860    renames existing ones. `init_optabs' calls this macro after initializing all
2861    the normal library routines.  */
2862 /* #define INIT_TARGET_OPTABS */
2863
2864 /* The value of `EDOM' on the target machine, as a C integer constant
2865    expression.  If you don't define this macro, GNU CC does not attempt to
2866    deposit the value of `EDOM' into `errno' directly.  Look in
2867    `/usr/include/errno.h' to find the value of `EDOM' on your system.
2868
2869    If you do not define `TARGET_EDOM', then compiled code reports domain errors
2870    by calling the library function and letting it report the error.  If
2871    mathematical functions on your system use `matherr' when there is an error,
2872    then you should leave `TARGET_EDOM' undefined so that `matherr' is used
2873    normally.  */
2874 /* #define TARGET_EDOM */
2875
2876 /* Define this macro as a C expression to create an rtl expression that refers
2877    to the global "variable" `errno'.  (On certain systems, `errno' may not
2878    actually be a variable.)  If you don't define this macro, a reasonable
2879    default is used.  */
2880 /* #define GEN_ERRNO_RTX */
2881
2882 /* Define this macro if GNU CC should generate calls to the System V (and ANSI
2883    C) library functions `memcpy' and `memset' rather than the BSD functions
2884    `bcopy' and `bzero'.
2885
2886    Defined in svr4.h.  */
2887 #define TARGET_MEM_FUNCTIONS
2888
2889 /* Define this macro if only `float' arguments cannot be passed to library
2890    routines (so they must be converted to `double').  This macro affects both
2891    how library calls are generated and how the library routines in `libgcc1.c'
2892    accept their arguments.  It is useful on machines where floating and fixed
2893    point arguments are passed differently, such as the i860.  */
2894 /* #define LIBGCC_NEEDS_DOUBLE */
2895
2896 /* Define this macro to override the type used by the library routines to pick
2897    up arguments of type `float'.  (By default, they use a union of `float' and
2898    `int'.)
2899
2900    The obvious choice would be `float'--but that won't work with traditional C
2901    compilers that expect all arguments declared as `float' to arrive as
2902    `double'.  To avoid this conversion, the library routines ask for the value
2903    as some other type and then treat it as a `float'.
2904
2905    On some systems, no other type will work for this.  For these systems, you
2906    must use `LIBGCC_NEEDS_DOUBLE' instead, to force conversion of the values
2907    `double' before they are passed.  */
2908 /* #define FLOAT_ARG_TYPE */
2909
2910 /* Define this macro to override the way library routines redesignate a `float'
2911    argument as a `float' instead of the type it was passed as.  The default is
2912    an expression which takes the `float' field of the union.  */
2913 /* #define FLOATIFY(PASSED_VALUE) */
2914
2915 /* Define this macro to override the type used by the library routines to
2916    return values that ought to have type `float'.  (By default, they use
2917    `int'.)
2918
2919    The obvious choice would be `float'--but that won't work with traditional C
2920    compilers gratuitously convert values declared as `float' into `double'.  */
2921 /* #define FLOAT_VALUE_TYPE */
2922
2923 /* Define this macro to override the way the value of a `float'-returning
2924    library routine should be packaged in order to return it.  These functions
2925    are actually declared to return type `FLOAT_VALUE_TYPE' (normally `int').
2926
2927    These values can't be returned as type `float' because traditional C
2928    compilers would gratuitously convert the value to a `double'.
2929
2930    A local variable named `intify' is always available when the macro `INTIFY'
2931    is used.  It is a union of a `float' field named `f' and a field named `i'
2932    whose type is `FLOAT_VALUE_TYPE' or `int'.
2933
2934    If you don't define this macro, the default definition works by copying the
2935    value through that union.  */
2936 /* #define INTIFY(FLOAT_VALUE) */
2937
2938 /* Define this macro as the name of the data type corresponding to `SImode' in
2939    the system's own C compiler.
2940
2941    You need not define this macro if that type is `long int', as it usually is.  */
2942 /* #define nongcc_SI_type */
2943
2944 /* Define this macro as the name of the data type corresponding to the
2945    word_mode in the system's own C compiler.
2946
2947    You need not define this macro if that type is `long int', as it usually is.  */
2948 /* #define nongcc_word_type */
2949
2950 /* Define these macros to supply explicit C statements to carry out various
2951    arithmetic operations on types `float' and `double' in the library routines
2952    in `libgcc1.c'.  See that file for a full list of these macros and their
2953    arguments.
2954
2955    On most machines, you don't need to define any of these macros, because the
2956    C compiler that comes with the system takes care of doing them.  */
2957 /* #define perform_... */
2958
2959 /* Define this macro to generate code for Objective C message sending using the
2960    calling convention of the NeXT system.  This calling convention involves
2961    passing the object, the selector and the method arguments all at once to the
2962    method-lookup library function.
2963
2964    The default calling convention passes just the object and the selector to
2965    the lookup function, which returns a pointer to the method.  */
2966 /* #define NEXT_OBJC_RUNTIME */
2967
2968 \f
2969 /* Addressing Modes */
2970
2971 /* Define this macro if the machine supports post-increment addressing.  */
2972 #define HAVE_POST_INCREMENT 1
2973
2974 /* Similar for other kinds of addressing.  */
2975 /* #define HAVE_PRE_INCREMENT 1 */
2976 /* #define HAVE_POST_DECREMENT 1 */
2977 #define HAVE_PRE_DECREMENT 1
2978
2979 /* A C expression that is 1 if the RTX X is a constant which is a valid
2980    address.  On most machines, this can be defined as `CONSTANT_P (X)', but a
2981    few machines are more restrictive in which constant addresses are supported.
2982
2983    `CONSTANT_P' accepts integer-values expressions whose values are not
2984    explicitly known, such as `symbol_ref', `label_ref', and `high' expressions
2985    and `const' arithmetic expressions, in addition to `const_int' and
2986    `const_double' expressions.  */
2987 #define CONSTANT_ADDRESS_P(X) CONSTANT_P (X)
2988
2989 /* A number, the maximum number of registers that can appear in a valid memory
2990    address.  Note that it is up to you to specify a value equal to the maximum
2991    number that `GO_IF_LEGITIMATE_ADDRESS' would ever accept.  */
2992 #define MAX_REGS_PER_ADDRESS 1
2993
2994 /* A C compound statement with a conditional `goto LABEL;' executed if X (an
2995    RTX) is a legitimate memory address on the target machine for a memory
2996    operand of mode MODE.
2997
2998    It usually pays to define several simpler macros to serve as subroutines for
2999    this one.  Otherwise it may be too complicated to understand.
3000
3001    This macro must exist in two variants: a strict variant and a non-strict
3002    one.  The strict variant is used in the reload pass.  It must be defined so
3003    that any pseudo-register that has not been allocated a hard register is
3004    considered a memory reference.  In contexts where some kind of register is
3005    required, a pseudo-register with no hard register must be rejected.
3006
3007    The non-strict variant is used in other passes.  It must be defined to
3008    accept all pseudo-registers in every context where some kind of register is
3009    required.
3010
3011    Compiler source files that want to use the strict variant of this macro
3012    define the macro `REG_OK_STRICT'.  You should use an `#ifdef REG_OK_STRICT'
3013    conditional to define the strict variant in that case and the non-strict
3014    variant otherwise.
3015
3016    Subroutines to check for acceptable registers for various purposes (one for
3017    base registers, one for index registers, and so on) are typically among the
3018    subroutines used to define `GO_IF_LEGITIMATE_ADDRESS'.  Then only these
3019    subroutine macros need have two variants; the higher levels of macros may be
3020    the same whether strict or not.
3021
3022    Normally, constant addresses which are the sum of a `symbol_ref' and an
3023    integer are stored inside a `const' RTX to mark them as constant.
3024    Therefore, there is no need to recognize such sums specifically as
3025    legitimate addresses.  Normally you would simply recognize any `const' as
3026    legitimate.
3027
3028    Usually `PRINT_OPERAND_ADDRESS' is not prepared to handle constant sums that
3029    are not marked with `const'.  It assumes that a naked `plus' indicates
3030    indexing.  If so, then you *must* reject such naked constant sums as
3031    illegitimate addresses, so that none of them will be given to
3032    `PRINT_OPERAND_ADDRESS'.
3033
3034    On some machines, whether a symbolic address is legitimate depends on the
3035    section that the address refers to.  On these machines, define the macro
3036    `ENCODE_SECTION_INFO' to store the information into the `symbol_ref', and
3037    then check for it here.  When you see a `const', you will have to look
3038    inside it to find the `symbol_ref' in order to determine the section.
3039
3040    The best way to modify the name string is by adding text to the beginning,
3041    with suitable punctuation to prevent any ambiguity.  Allocate the new name
3042    in `saveable_obstack'.  You will have to modify `ASM_OUTPUT_LABELREF' to
3043    remove and decode the added text and output the name accordingly, and define
3044    `STRIP_NAME_ENCODING' to access the original name string.
3045
3046    You can check the information stored here into the `symbol_ref' in the
3047    definitions of the macros `GO_IF_LEGITIMATE_ADDRESS' and
3048    `PRINT_OPERAND_ADDRESS'.  */
3049 #ifdef REG_OK_STRICT
3050 #define GO_IF_LEGITIMATE_ADDRESS(MODE, X, LABEL)        \
3051 do {                                                    \
3052   if (stormy16_legitimate_address_p (MODE, X, 1))       \
3053     goto LABEL;                                         \
3054 } while (0)
3055 #else
3056 #define GO_IF_LEGITIMATE_ADDRESS(MODE, X, LABEL)        \
3057 do {                                                    \
3058   if (stormy16_legitimate_address_p (MODE, X, 0))       \
3059     goto LABEL;                                         \
3060 } while (0)
3061 #endif
3062 /* A C expression that is nonzero if X (assumed to be a `reg' RTX) is valid for
3063    use as a base register.  For hard registers, it should always accept those
3064    which the hardware permits and reject the others.  Whether the macro accepts
3065    or rejects pseudo registers must be controlled by `REG_OK_STRICT' as
3066    described above.  This usually requires two variant definitions, of which
3067    `REG_OK_STRICT' controls the one actually used.  */
3068 #ifdef REG_OK_STRICT
3069 #define REG_OK_FOR_BASE_P(X)                                               \
3070   (REGNO_OK_FOR_BASE_P (REGNO (X)) && (REGNO (X) < FIRST_PSEUDO_REGISTER))
3071 #else
3072 #define REG_OK_FOR_BASE_P(X) REGNO_OK_FOR_BASE_P (REGNO (X))
3073 #endif
3074
3075 /* A C expression that is nonzero if X (assumed to be a `reg' RTX) is valid for
3076    use as an index register.
3077
3078    The difference between an index register and a base register is that the
3079    index register may be scaled.  If an address involves the sum of two
3080    registers, neither one of them scaled, then either one may be labeled the
3081    "base" and the other the "index"; but whichever labeling is used must fit
3082    the machine's constraints of which registers may serve in each capacity.
3083    The compiler will try both labelings, looking for one that is valid, and
3084    will reload one or both registers only if neither labeling works.  */
3085 #define REG_OK_FOR_INDEX_P(X) REG_OK_FOR_BASE_P (X)
3086
3087 /* A C compound statement that attempts to replace X with a valid memory
3088    address for an operand of mode MODE.  WIN will be a C statement label
3089    elsewhere in the code; the macro definition may use
3090
3091         GO_IF_LEGITIMATE_ADDRESS (MODE, X, WIN);
3092
3093    to avoid further processing if the address has become legitimate.
3094
3095    X will always be the result of a call to `break_out_memory_refs', and OLDX
3096    will be the operand that was given to that function to produce X.
3097
3098    The code generated by this macro should not alter the substructure of X.  If
3099    it transforms X into a more legitimate form, it should assign X (which will
3100    always be a C variable) a new value.
3101
3102    It is not necessary for this macro to come up with a legitimate address.
3103    The compiler has standard ways of doing so in all cases.  In fact, it is
3104    safe for this macro to do nothing.  But often a machine-dependent strategy
3105    can generate better code.  */
3106 #define LEGITIMIZE_ADDRESS(X, OLDX, MODE, WIN)
3107
3108 /* A C statement or compound statement with a conditional `goto LABEL;'
3109    executed if memory address X (an RTX) can have different meanings depending
3110    on the machine mode of the memory reference it is used for or if the address
3111    is valid for some modes but not others.
3112
3113    Autoincrement and autodecrement addresses typically have mode-dependent
3114    effects because the amount of the increment or decrement is the size of the
3115    operand being addressed.  Some machines have other mode-dependent addresses.
3116    Many RISC machines have no mode-dependent addresses.
3117
3118    You may assume that ADDR is a valid address for the machine.  
3119    
3120    On this chip, this is true if the address is valid with an offset
3121    of 0 but not of 6, because in that case it cannot be used as an
3122    address for DImode or DFmode, or if the address is a post-increment
3123    or pre-decrement address.
3124 */
3125 #define GO_IF_MODE_DEPENDENT_ADDRESS(ADDR,LABEL)                        \
3126   if (stormy16_mode_dependent_address_p (ADDR))                         \
3127     goto LABEL
3128
3129 /* A C expression that is nonzero if X is a legitimate constant for an
3130    immediate operand on the target machine.  You can assume that X satisfies
3131    `CONSTANT_P', so you need not check this.  In fact, `1' is a suitable
3132    definition for this macro on machines where anything `CONSTANT_P' is valid.  */
3133 #define LEGITIMATE_CONSTANT_P(X) 1
3134
3135 \f
3136 /* Condition Code Status */
3137
3138 /* C code for a data type which is used for declaring the `mdep' component of
3139    `cc_status'.  It defaults to `int'.
3140
3141    This macro is not used on machines that do not use `cc0'.  */
3142 /* #define CC_STATUS_MDEP */
3143
3144 /* A C expression to initialize the `mdep' field to "empty".  The default
3145    definition does nothing, since most machines don't use the field anyway.  If
3146    you want to use the field, you should probably define this macro to
3147    initialize it.
3148
3149    This macro is not used on machines that do not use `cc0'.  */
3150 /* #define CC_STATUS_MDEP_INIT */
3151
3152 /* A C compound statement to set the components of `cc_status' appropriately
3153    for an insn INSN whose body is EXP.  It is this macro's responsibility to
3154    recognize insns that set the condition code as a byproduct of other activity
3155    as well as those that explicitly set `(cc0)'.
3156
3157    This macro is not used on machines that do not use `cc0'.
3158
3159    If there are insns that do not set the condition code but do alter other
3160    machine registers, this macro must check to see whether they invalidate the
3161    expressions that the condition code is recorded as reflecting.  For example,
3162    on the 68000, insns that store in address registers do not set the condition
3163    code, which means that usually `NOTICE_UPDATE_CC' can leave `cc_status'
3164    unaltered for such insns.  But suppose that the previous insn set the
3165    condition code based on location `a4@(102)' and the current insn stores a
3166    new value in `a4'.  Although the condition code is not changed by this, it
3167    will no longer be true that it reflects the contents of `a4@(102)'.
3168    Therefore, `NOTICE_UPDATE_CC' must alter `cc_status' in this case to say
3169    that nothing is known about the condition code value.
3170
3171    The definition of `NOTICE_UPDATE_CC' must be prepared to deal with the
3172    results of peephole optimization: insns whose patterns are `parallel' RTXs
3173    containing various `reg', `mem' or constants which are just the operands.
3174    The RTL structure of these insns is not sufficient to indicate what the
3175    insns actually do.  What `NOTICE_UPDATE_CC' should do when it sees one is
3176    just to run `CC_STATUS_INIT'.
3177
3178    A possible definition of `NOTICE_UPDATE_CC' is to call a function that looks
3179    at an attribute named, for example, `cc'.  This avoids having detailed
3180    information about patterns in two places, the `md' file and in
3181    `NOTICE_UPDATE_CC'.  */
3182 /* #define NOTICE_UPDATE_CC(EXP, INSN) */
3183
3184 /* A list of names to be used for additional modes for condition code values in
3185    registers.  These names are added to `enum machine_mode' and all have class
3186    `MODE_CC'.  By convention, they should start with `CC' and end with `mode'.
3187
3188    You should only define this macro if your machine does not use `cc0' and
3189    only if additional modes are required.  */
3190 /* #define EXTRA_CC_MODES */
3191
3192 /* Returns a mode from class `MODE_CC' to be used when comparison operation
3193    code OP is applied to rtx X and Y.  For example, on the Sparc,
3194    `SELECT_CC_MODE' is defined as (see *note Jump Patterns::.  for a
3195    description of the reason for this definition)
3196
3197         #define SELECT_CC_MODE(OP,X,Y) \
3198           (GET_MODE_CLASS (GET_MODE (X)) == MODE_FLOAT          \
3199            ? ((OP == EQ || OP == NE) ? CCFPmode : CCFPEmode)    \
3200            : ((GET_CODE (X) == PLUS || GET_CODE (X) == MINUS    \
3201                || GET_CODE (X) == NEG) \
3202               ? CC_NOOVmode : CCmode))
3203
3204    You need not define this macro if `EXTRA_CC_MODES' is not defined.  */
3205 /* #define SELECT_CC_MODE(OP, X, Y) */
3206
3207 /* One some machines not all possible comparisons are defined, but you can
3208    convert an invalid comparison into a valid one.  For example, the Alpha does
3209    not have a `GT' comparison, but you can use an `LT' comparison instead and
3210    swap the order of the operands.
3211
3212    On such machines, define this macro to be a C statement to do any required
3213    conversions.  CODE is the initial comparison code and OP0 and OP1 are the
3214    left and right operands of the comparison, respectively.  You should modify
3215    CODE, OP0, and OP1 as required.
3216
3217    GNU CC will not assume that the comparison resulting from this macro is
3218    valid but will see if the resulting insn matches a pattern in the `md' file.
3219
3220    You need not define this macro if it would never change the comparison code
3221    or operands.  */
3222 /* #define CANONICALIZE_COMPARISON(CODE, OP0, OP1) */
3223
3224 /* A C expression whose value is one if it is always safe to reverse a
3225    comparison whose mode is MODE.  If `SELECT_CC_MODE' can ever return MODE for
3226    a floating-point inequality comparison, then `REVERSIBLE_CC_MODE (MODE)'
3227    must be zero.
3228
3229    You need not define this macro if it would always returns zero or if the
3230    floating-point format is anything other than `IEEE_FLOAT_FORMAT'.  For
3231    example, here is the definition used on the Sparc, where floating-point
3232    inequality comparisons are always given `CCFPEmode':
3233
3234         #define REVERSIBLE_CC_MODE(MODE)  ((MODE) != CCFPEmode)  */
3235 /* #define REVERSIBLE_CC_MODE(MODE) */
3236
3237 \f
3238 /* Describing Relative Costs of Operations */
3239
3240 /* A part of a C `switch' statement that describes the relative costs of
3241    constant RTL expressions.  It must contain `case' labels for expression
3242    codes `const_int', `const', `symbol_ref', `label_ref' and `const_double'.
3243    Each case must ultimately reach a `return' statement to return the relative
3244    cost of the use of that kind of constant value in an expression.  The cost
3245    may depend on the precise value of the constant, which is available for
3246    examination in X, and the rtx code of the expression in which it is
3247    contained, found in OUTER_CODE.
3248
3249    CODE is the expression code--redundant, since it can be obtained with
3250    `GET_CODE (X)'.  */
3251 /* #define CONST_COSTS(X, CODE, OUTER_CODE)  */     
3252
3253 /* Like `CONST_COSTS' but applies to nonconstant RTL expressions.  This can be
3254    used, for example, to indicate how costly a multiply instruction is.  In
3255    writing this macro, you can use the construct `COSTS_N_INSNS (N)' to specify
3256    a cost equal to N fast instructions.  OUTER_CODE is the code of the
3257    expression in which X is contained.
3258
3259    This macro is optional; do not define it if the default cost assumptions are
3260    adequate for the target machine.  */
3261 /* #define RTX_COSTS(X, CODE, OUTER_CODE) */
3262
3263 /* An expression giving the cost of an addressing mode that contains ADDRESS.
3264    If not defined, the cost is computed from the ADDRESS expression and the
3265    `CONST_COSTS' values.
3266
3267    For most CISC machines, the default cost is a good approximation of the true
3268    cost of the addressing mode.  However, on RISC machines, all instructions
3269    normally have the same length and execution time.  Hence all addresses will
3270    have equal costs.
3271
3272    In cases where more than one form of an address is known, the form with the
3273    lowest cost will be used.  If multiple forms have the same, lowest, cost,
3274    the one that is the most complex will be used.
3275
3276    For example, suppose an address that is equal to the sum of a register and a
3277    constant is used twice in the same basic block.  When this macro is not
3278    defined, the address will be computed in a register and memory references
3279    will be indirect through that register.  On machines where the cost of the
3280    addressing mode containing the sum is no higher than that of a simple
3281    indirect reference, this will produce an additional instruction and possibly
3282    require an additional register.  Proper specification of this macro
3283    eliminates this overhead for such machines.
3284
3285    Similar use of this macro is made in strength reduction of loops.
3286
3287    ADDRESS need not be valid as an address.  In such a case, the cost is not
3288    relevant and can be any value; invalid addresses need not be assigned a
3289    different cost.
3290
3291    On machines where an address involving more than one register is as cheap as
3292    an address computation involving only one register, defining `ADDRESS_COST'
3293    to reflect this can cause two registers to be live over a region of code
3294    where only one would have been if `ADDRESS_COST' were not defined in that
3295    manner.  This effect should be considered in the definition of this macro.
3296    Equivalent costs should probably only be given to addresses with different
3297    numbers of registers on machines with lots of registers.
3298
3299    This macro will normally either not be defined or be defined as a constant.  */
3300 /* #define ADDRESS_COST(ADDRESS) */
3301
3302 /* A C expression for the cost of moving data of mode MODE from a
3303    register in class FROM to one in class TO.  The classes are
3304    expressed using the enumeration values such as `GENERAL_REGS'.  A
3305    value of 4 is the default; other values are interpreted relative to
3306    that.
3307
3308    It is not required that the cost always equal 2 when FROM is the same as TO;
3309    on some machines it is expensive to move between registers if they are not
3310    general registers.
3311
3312    If reload sees an insn consisting of a single `set' between two hard
3313    registers, and if `REGISTER_MOVE_COST' applied to their classes returns a
3314    value of 2, reload does not check to ensure that the constraints of the insn
3315    are met.  Setting a cost of other than 2 will allow reload to verify that
3316    the constraints are met.  You should do this if the `movM' pattern's
3317    constraints do not allow such copying.  */
3318 #define REGISTER_MOVE_COST(MODE, FROM, TO) 2
3319
3320 /* A C expression for the cost of moving data of mode M between a register and
3321    memory.  A value of 2 is the default; this cost is relative to those in
3322    `REGISTER_MOVE_COST'.
3323
3324    If moving between registers and memory is more expensive than between two
3325    registers, you should define this macro to express the relative cost.  */
3326 #define MEMORY_MOVE_COST(M,C,I) 5
3327
3328 /* A C expression for the cost of a branch instruction.  A value of 1 is the
3329    default; other values are interpreted relative to that.  */
3330
3331 #define BRANCH_COST 5
3332
3333 /* Here are additional macros which do not specify precise relative costs, but
3334    only that certain actions are more expensive than GNU CC would ordinarily
3335    expect.  */
3336
3337 /* Define this macro as a C expression which is nonzero if accessing less than
3338    a word of memory (i.e. a `char' or a `short') is no faster than accessing a
3339    word of memory, i.e., if such access require more than one instruction or if
3340    there is no difference in cost between byte and (aligned) word loads.
3341
3342    When this macro is not defined, the compiler will access a field by finding
3343    the smallest containing object; when it is defined, a fullword load will be
3344    used if alignment permits.  Unless bytes accesses are faster than word
3345    accesses, using word accesses is preferable since it may eliminate
3346    subsequent memory access if subsequent accesses occur to other fields in the
3347    same word of the structure, but to different bytes.  */
3348 #define SLOW_BYTE_ACCESS 0
3349
3350 /* Define this macro if zero-extension (of a `char' or `short' to an `int') can
3351    be done faster if the destination is a register that is known to be zero.
3352
3353    If you define this macro, you must have instruction patterns that recognize
3354    RTL structures like this:
3355
3356         (set (strict_low_part (subreg:QI (reg:SI ...) 0)) ...)
3357
3358    and likewise for `HImode'.  */
3359 #define SLOW_ZERO_EXTEND 0
3360
3361 /* Define this macro to be the value 1 if unaligned accesses have a cost many
3362    times greater than aligned accesses, for example if they are emulated in a
3363    trap handler.
3364
3365    When this macro is non-zero, the compiler will act as if `STRICT_ALIGNMENT'
3366    were non-zero when generating code for block moves.  This can cause
3367    significantly more instructions to be produced.  Therefore, do not set this
3368    macro non-zero if unaligned accesses only add a cycle or two to the time for
3369    a memory access.
3370
3371    If the value of this macro is always zero, it need not be defined.  */
3372 /* #define SLOW_UNALIGNED_ACCESS */
3373
3374 /* Define this macro to inhibit strength reduction of memory addresses.  (On
3375    some machines, such strength reduction seems to do harm rather than good.)  */
3376 /* #define DONT_REDUCE_ADDR */
3377
3378 /* The number of scalar move insns which should be generated instead of a
3379    string move insn or a library call.  Increasing the value will always make
3380    code faster, but eventually incurs high cost in increased code size.
3381
3382    If you don't define this, a reasonable default is used.  */
3383 /* #define MOVE_RATIO */
3384
3385 /* Define this macro if it is as good or better to call a constant function
3386    address than to call an address kept in a register.  */
3387 #define NO_FUNCTION_CSE
3388
3389 /* Define this macro if it is as good or better for a function to call itself
3390    with an explicit address than to call an address kept in a register.  */
3391 #define NO_RECURSIVE_FUNCTION_CSE
3392
3393 /* A C statement (sans semicolon) to update the integer variable COST based on
3394    the relationship between INSN that is dependent on DEP_INSN through the
3395    dependence LINK.  The default is to make no adjustment to COST.  This can be
3396    used for example to specify to the scheduler that an output- or
3397    anti-dependence does not incur the same cost as a data-dependence.  */
3398 /* #define ADJUST_COST(INSN, LINK, DEP_INSN, COST) */
3399
3400 /* A C statement (sans semicolon) to update the integer scheduling
3401    priority `INSN_PRIORITY(INSN)'.  Reduce the priority to execute
3402    the INSN earlier, increase the priority to execute INSN later.
3403    Do not define this macro if you do not need to adjust the
3404    scheduling priorities of insns.  */
3405 /* #define ADJUST_PRIORITY (INSN) */
3406
3407 \f
3408 /* Dividing the output into sections.  */
3409
3410 /* A C expression whose value is a string containing the assembler operation
3411    that should precede instructions and read-only data.  Normally `".text"' is
3412    right.  */
3413 #define TEXT_SECTION_ASM_OP ".text"
3414
3415 /* A C expression whose value is a string containing the assembler operation to
3416    identify the following data as writable initialized data.  Normally
3417    `".data"' is right.  */
3418 #define DATA_SECTION_ASM_OP ".data"
3419
3420 /* if defined, a C expression whose value is a string containing the assembler
3421    operation to identify the following data as shared data.  If not defined,
3422    `DATA_SECTION_ASM_OP' will be used.  */
3423 /* #define SHARED_SECTION_ASM_OP */
3424
3425 /* If defined, a C expression whose value is a string containing the
3426    assembler operation to identify the following data as
3427    uninitialized global data.  If not defined, and neither
3428    `ASM_OUTPUT_BSS' nor `ASM_OUTPUT_ALIGNED_BSS' are defined,
3429    uninitialized global data will be output in the data section if
3430    `-fno-common' is passed, otherwise `ASM_OUTPUT_COMMON' will be
3431    used.  */
3432 #define BSS_SECTION_ASM_OP ".bss"
3433
3434 /* If defined, a C expression whose value is a string containing the
3435    assembler operation to identify the following data as
3436    uninitialized global shared data.  If not defined, and
3437    `BSS_SECTION_ASM_OP' is, the latter will be used.  */
3438 /* #define SHARED_BSS_SECTION_ASM_OP */
3439
3440 /* Define the pseudo-ops used to switch to the .ctors and .dtors sections.
3441    There are no shared libraries on this target so these sections need
3442    not be writable.
3443
3444    Defined in elfos.h.  */
3445
3446 #undef CTORS_SECTION_ASM_OP
3447 #undef DTORS_SECTION_ASM_OP
3448 #define CTORS_SECTION_ASM_OP    "\t.section\t.ctors,\"a\""
3449 #define DTORS_SECTION_ASM_OP    "\t.section\t.dtors,\"a\""
3450
3451 /* A list of names for sections other than the standard two, which are
3452    `in_text' and `in_data'.  You need not define this macro on a system with no
3453    other sections (that GCC needs to use).
3454
3455    Defined in svr4.h.  */
3456 /* #define EXTRA_SECTIONS */
3457
3458 /* One or more functions to be defined in `varasm.c'.  These functions should
3459    do jobs analogous to those of `text_section' and `data_section', for your
3460    additional sections.  Do not define this macro if you do not define
3461    `EXTRA_SECTIONS'.
3462
3463    Defined in svr4.h.  */
3464 /* #define EXTRA_SECTION_FUNCTIONS */
3465
3466 /* On most machines, read-only variables, constants, and jump tables are placed
3467    in the text section.  If this is not the case on your machine, this macro
3468    should be defined to be the name of a function (either `data_section' or a
3469    function defined in `EXTRA_SECTIONS') that switches to the section to be
3470    used for read-only items.
3471
3472    If these items should be placed in the text section, this macro should not
3473    be defined.  */
3474 /* #define READONLY_DATA_SECTION */
3475
3476 /* A C statement or statements to switch to the appropriate section for output
3477    of EXP.  You can assume that EXP is either a `VAR_DECL' node or a constant
3478    of some sort.  RELOC indicates whether the initial value of EXP requires
3479    link-time relocations.  Select the section by calling `text_section' or one
3480    of the alternatives for other sections.
3481
3482    Do not define this macro if you put all read-only variables and constants in
3483    the read-only data section (usually the text section).
3484
3485    Defined in svr4.h.  */
3486 /* #define SELECT_SECTION(EXP, RELOC, ALIGN) */
3487
3488 /* A C statement or statements to switch to the appropriate section for output
3489    of RTX in mode MODE.  You can assume that RTX is some kind of constant in
3490    RTL.  The argument MODE is redundant except in the case of a `const_int'
3491    rtx.  Select the section by calling `text_section' or one of the
3492    alternatives for other sections.
3493
3494    Do not define this macro if you put all constants in the read-only data
3495    section.
3496
3497    Defined in svr4.h.  */
3498 /* #define SELECT_RTX_SECTION(MODE, RTX, ALIGN) */
3499
3500 /* Define this macro if jump tables (for `tablejump' insns) should be output in
3501    the text section, along with the assembler instructions.  Otherwise, the
3502    readonly data section is used.
3503
3504    This macro is irrelevant if there is no separate readonly data section.  */
3505 #define JUMP_TABLES_IN_TEXT_SECTION 1
3506
3507 /* Define this macro if references to a symbol must be treated differently
3508    depending on something about the variable or function named by the symbol
3509    (such as what section it is in).
3510
3511    The macro definition, if any, is executed immediately after the rtl for DECL
3512    has been created and stored in `DECL_RTL (DECL)'.  The value of the rtl will
3513    be a `mem' whose address is a `symbol_ref'.
3514
3515    The usual thing for this macro to do is to record a flag in the `symbol_ref'
3516    (such as `SYMBOL_REF_FLAG') or to store a modified name string in the
3517    `symbol_ref' (if one bit is not enough information).  */
3518 #define ENCODE_SECTION_INFO(DECL)  stormy16_encode_section_info(DECL)
3519
3520 /* Decode SYM_NAME and store the real name part in VAR, sans the characters
3521    that encode section info.  Define this macro if `ENCODE_SECTION_INFO' alters
3522    the symbol's name string.  */
3523 /* #define STRIP_NAME_ENCODING(VAR, SYM_NAME) */
3524
3525 /* A C statement to build up a unique section name, expressed as a
3526    STRING_CST node, and assign it to `DECL_SECTION_NAME (DECL)'.
3527    RELOC indicates whether the initial value of EXP requires
3528    link-time relocations.  If you do not define this macro, GNU CC
3529    will use the symbol name prefixed by `.' as the section name.
3530
3531    Defined in svr4.h.  */
3532 /* #define UNIQUE_SECTION(DECL, RELOC) */
3533
3534 \f
3535 /* Position Independent Code.  */
3536
3537 /* The register number of the register used to address a table of static data
3538    addresses in memory.  In some cases this register is defined by a
3539    processor's "application binary interface" (ABI).  When this macro is
3540    defined, RTL is generated for this register once, as with the stack pointer
3541    and frame pointer registers.  If this macro is not defined, it is up to the
3542    machine-dependent files to allocate such a register (if necessary).  */
3543 /* #define PIC_OFFSET_TABLE_REGNUM */
3544
3545 /* Define this macro if the register defined by `PIC_OFFSET_TABLE_REGNUM' is
3546    clobbered by calls.  Do not define this macro if `PPIC_OFFSET_TABLE_REGNUM'
3547    is not defined.  */
3548 /* #define PIC_OFFSET_TABLE_REG_CALL_CLOBBERED */
3549
3550 /* By generating position-independent code, when two different programs (A and
3551    B) share a common library (libC.a), the text of the library can be shared
3552    whether or not the library is linked at the same address for both programs.
3553    In some of these environments, position-independent code requires not only
3554    the use of different addressing modes, but also special code to enable the
3555    use of these addressing modes.
3556
3557    The `FINALIZE_PIC' macro serves as a hook to emit these special codes once
3558    the function is being compiled into assembly code, but not before.  (It is
3559    not done before, because in the case of compiling an inline function, it
3560    would lead to multiple PIC prologues being included in functions which used
3561    inline functions and were compiled to assembly language.)  */
3562 /* #define FINALIZE_PIC */
3563
3564 /* A C expression that is nonzero if X is a legitimate immediate operand on the
3565    target machine when generating position independent code.  You can assume
3566    that X satisfies `CONSTANT_P', so you need not check this.  You can also
3567    assume FLAG_PIC is true, so you need not check it either.  You need not
3568    define this macro if all constants (including `SYMBOL_REF') can be immediate
3569    operands when generating position independent code.  */
3570 /* #define LEGITIMATE_PIC_OPERAND_P(X) */
3571
3572 \f
3573 /* The Overall Framework of an Assembler File.  */
3574
3575 /* A C expression which outputs to the stdio stream STREAM some appropriate
3576    text to go at the start of an assembler file.
3577
3578    Normally this macro is defined to output a line containing `#NO_APP', which
3579    is a comment that has no effect on most assemblers but tells the GNU
3580    assembler that it can save time by not checking for certain assembler
3581    constructs.
3582
3583    On systems that use SDB, it is necessary to output certain commands; see
3584    `attasm.h'.
3585
3586    Defined in svr4.h.  */
3587 /* #define ASM_FILE_START(STREAM) */
3588
3589 /* A C expression which outputs to the stdio stream STREAM some appropriate
3590    text to go at the end of an assembler file.
3591
3592    If this macro is not defined, the default is to output nothing special at
3593    the end of the file.  Most systems don't require any definition.
3594
3595    On systems that use SDB, it is necessary to output certain commands; see
3596    `attasm.h'.
3597
3598    Defined in svr4.h.  */
3599 /* #define ASM_FILE_END(STREAM) */
3600
3601 /* A C statement to output assembler commands which will identify the object
3602    file as having been compiled with GNU CC (or another GNU compiler).
3603
3604    If you don't define this macro, the string `gcc_compiled.:' is output.  This
3605    string is calculated to define a symbol which, on BSD systems, will never be
3606    defined for any other reason.  GDB checks for the presence of this symbol
3607    when reading the symbol table of an executable.
3608
3609    On non-BSD systems, you must arrange communication with GDB in some other
3610    fashion.  If GDB is not used on your system, you can define this macro with
3611    an empty body.
3612
3613    Defined in svr4.h.  */
3614 /* #define ASM_IDENTIFY_GCC(FILE) */
3615
3616 /* Like ASM_IDENTIFY_GCC, but used when dbx debugging is selected to emit
3617    a stab the debugger uses to identify gcc as the compiler that is emitted
3618    after the stabs for the filename, which makes it easier for GDB to parse.
3619
3620    Defined in svr4.h.  */
3621 /* #define ASM_IDENTIFY_GCC_AFTER_SOURCE(FILE) */
3622
3623 /* A C string constant describing how to begin a comment in the target
3624    assembler language.  The compiler assumes that the comment will end at the
3625    end of the line.  */
3626 #define ASM_COMMENT_START ";"
3627
3628 /* A C string constant for text to be output before each `asm' statement or
3629    group of consecutive ones.  Normally this is `"#APP"', which is a comment
3630    that has no effect on most assemblers but tells the GNU assembler that it
3631    must check the lines that follow for all valid assembler constructs.  */
3632 #define ASM_APP_ON "#APP\n"
3633
3634 /* A C string constant for text to be output after each `asm' statement or
3635    group of consecutive ones.  Normally this is `"#NO_APP"', which tells the
3636    GNU assembler to resume making the time-saving assumptions that are valid
3637    for ordinary compiler output.  */
3638 #define ASM_APP_OFF "#NO_APP\n"
3639
3640 /* A C statement to output COFF information or DWARF debugging information
3641    which indicates that filename NAME is the current source file to the stdio
3642    stream STREAM.
3643
3644    This macro need not be defined if the standard form of output for the file
3645    format in use is appropriate.  */
3646 /* #define ASM_OUTPUT_SOURCE_FILENAME(STREAM, NAME) */
3647
3648 /* A C statement to output DBX or SDB debugging information before code for
3649    line number LINE of the current source file to the stdio stream STREAM.
3650
3651    This macro need not be defined if the standard form of debugging information
3652    for the debugger in use is appropriate.
3653
3654    Defined in svr4.h.  */
3655 /* #define ASM_OUTPUT_SOURCE_LINE(STREAM, LINE) */
3656
3657 /* A C statement to output something to the assembler file to handle a `#ident'
3658    directive containing the text STRING.  If this macro is not defined, nothing
3659    is output for a `#ident' directive.
3660
3661    Defined in svr4.h.  */
3662 /* #define ASM_OUTPUT_IDENT(STREAM, STRING) */
3663
3664 /* A C statement to output something to the assembler file to switch to section
3665    NAME for object DECL which is either a `FUNCTION_DECL', a `VAR_DECL' or
3666    `NULL_TREE'.  Some target formats do not support arbitrary sections.  Do not
3667    define this macro in such cases.
3668
3669    At present this macro is only used to support section attributes.  When this
3670    macro is undefined, section attributes are disabled.
3671
3672    Defined in svr4.h.  */
3673 /* #define ASM_OUTPUT_SECTION_NAME(STREAM, DECL, NAME) */
3674
3675 /* A C statement to output any assembler statements which are required to
3676    precede any Objective C object definitions or message sending.  The
3677    statement is executed only when compiling an Objective C program.  */
3678 /* #define OBJC_PROLOGUE */
3679
3680 \f
3681 /* Output of Data.  */
3682
3683 /* A C statement to output to the stdio stream STREAM an assembler instruction
3684    to assemble a floating-point constant of `TFmode', `DFmode', `SFmode',
3685    `TQFmode', `HFmode', or `QFmode', respectively, whose value is VALUE.  VALUE
3686    will be a C expression of type `REAL_VALUE_TYPE'.  Macros such as
3687    `REAL_VALUE_TO_TARGET_DOUBLE' are useful for writing these definitions.  */
3688
3689 /* This is how to output an assembler line defining a `double'.  */
3690 #define ASM_OUTPUT_DOUBLE(STREAM,VALUE)                   \
3691 do { char dstr[30];                                     \
3692      REAL_VALUE_TO_DECIMAL ((VALUE), "%.20e", dstr);    \
3693      fprintf ((STREAM), "\t.double %s\n", dstr);          \
3694    } while (0)
3695
3696 /* This is how to output an assembler line defining a `float' constant.  */
3697 #define ASM_OUTPUT_FLOAT(STREAM,VALUE)                    \
3698 do { char dstr[30];                                     \
3699      REAL_VALUE_TO_DECIMAL ((VALUE), "%.20e", dstr);    \
3700      fprintf ((STREAM), "\t.float %s\n", dstr);           \
3701    } while (0)
3702
3703 /* #define ASM_OUTPUT_LONG_DOUBLE(STREAM, VALUE) */
3704 /* #define ASM_OUTPUT_THREE_QUARTER_FLOAT(STREAM, VALUE) */
3705 /* #define ASM_OUTPUT_SHORT_FLOAT(STREAM, VALUE) */
3706 /* #define ASM_OUTPUT_BYTE_FLOAT(STREAM, VALUE) */
3707
3708 /* A C statement to output to the stdio stream STREAM an assembler instruction
3709    to assemble an integer of 16, 8, 4, 2 or 1 bytes, respectively, whose value
3710    is VALUE.  The argument EXP will be an RTL expression which represents a
3711    constant value.  Use `output_addr_const (STREAM, EXP)' to output this value
3712    as an assembler expression.
3713
3714    For sizes larger than `UNITS_PER_WORD', if the action of a macro would be
3715    identical to repeatedly calling the macro corresponding to a size of
3716    `UNITS_PER_WORD', once for each word, you need not define the macro.  */
3717 /* #define ASM_OUTPUT_QUADRUPLE_INT(STREAM, EXP) */
3718 /* #define ASM_OUTPUT_DOUBLE_INT(STREAM, EXP) */
3719
3720 /* This is how to output an assembler line defining a `char' constant.  */
3721 #define ASM_OUTPUT_CHAR(FILE, VALUE)                                    \
3722 do {                                                                    \
3723   fprintf (FILE, "\t.byte\t");                                          \
3724   output_addr_const (FILE, (VALUE));                                    \
3725   fprintf (FILE, "\n");                                                 \
3726 } while (0)
3727
3728 /* This is how to output an assembler line defining a `short' constant.  */
3729 #define ASM_OUTPUT_SHORT(FILE, VALUE)                                   \
3730 do {                                                                    \
3731   fprintf (FILE, "\t.hword\t");                                         \
3732   output_addr_const (FILE, (VALUE));                                    \
3733   fprintf (FILE, "\n");                                                 \
3734 } while (0)
3735
3736 /* This is how to output an assembler line defining an `int' constant.
3737    We also handle symbol output here.  */
3738 #define ASM_OUTPUT_INT(FILE, VALUE)                                     \
3739 do {                                                                    \
3740   fprintf (FILE, "\t.word\t");                                          \
3741   output_addr_const (FILE, (VALUE));                                    \
3742   fprintf (FILE, "\n");                                                 \
3743 } while (0)
3744
3745 /* A C statement to output to the stdio stream STREAM an assembler instruction
3746    to assemble a single byte containing the number VALUE.
3747
3748    This declaration must be present.  */
3749 #define ASM_OUTPUT_BYTE(STREAM, VALUE) \
3750   fprintf (STREAM, "\t%s\t0x%x\n", ASM_BYTE_OP, (VALUE))
3751
3752 /* A C string constant giving the pseudo-op to use for a sequence of
3753    single-byte constants.  If this macro is not defined, the default
3754    is `"byte"'.
3755
3756    Defined in svr4.h.  */
3757 /* #define ASM_BYTE_OP */
3758
3759 /* A C statement to output to the stdio stream STREAM an assembler instruction
3760    to assemble a string constant containing the LEN bytes at PTR.  PTR will be
3761    a C expression of type `char *' and LEN a C expression of type `int'.
3762
3763    If the assembler has a `.ascii' pseudo-op as found in the Berkeley Unix
3764    assembler, do not define the macro `ASM_OUTPUT_ASCII'.
3765
3766    Defined in svr4.h.  */
3767 /* #define ASM_OUTPUT_ASCII(STREAM, PTR, LEN) */
3768
3769 /* You may define this macro as a C expression.  You should define the
3770    expression to have a non-zero value if GNU CC should output the
3771    constant pool for a function before the code for the function, or
3772    a zero value if GNU CC should output the constant pool after the
3773    function.  If you do not define this macro, the usual case, GNU CC
3774    will output the constant pool before the function.  */
3775 /* #define CONSTANT_POOL_BEFORE_FUNCTION */
3776
3777 /* A C statement to output assembler commands to define the start of the
3778    constant pool for a function.  FUNNAME is a string giving the name of the
3779    function.  Should the return type of the function be required, it can be
3780    obtained via FUNDECL.  SIZE is the size, in bytes, of the constant pool that
3781    will be written immediately after this call.
3782
3783    If no constant-pool prefix is required, the usual case, this macro need not
3784    be defined.  */
3785 /* #define ASM_OUTPUT_POOL_PROLOGUE(FILE FUNNAME FUNDECL SIZE) */
3786
3787 /* A C statement (with or without semicolon) to output a constant in the
3788    constant pool, if it needs special treatment.  (This macro need not do
3789    anything for RTL expressions that can be output normally.)
3790
3791    The argument FILE is the standard I/O stream to output the assembler code
3792    on.  X is the RTL expression for the constant to output, and MODE is the
3793    machine mode (in case X is a `const_int').  ALIGN is the required alignment
3794    for the value X; you should output an assembler directive to force this much
3795    alignment.
3796
3797    The argument LABELNO is a number to use in an internal label for the address
3798    of this pool entry.  The definition of this macro is responsible for
3799    outputting the label definition at the proper place.  Here is how to do
3800    this:
3801
3802         ASM_OUTPUT_INTERNAL_LABEL (FILE, "LC", LABELNO);
3803
3804    When you output a pool entry specially, you should end with a `goto' to the
3805    label JUMPTO.  This will prevent the same pool entry from being output a
3806    second time in the usual manner.
3807
3808    You need not define this macro if it would do nothing.  */
3809 /* #define ASM_OUTPUT_SPECIAL_POOL_ENTRY(FILE, X, MODE, ALIGN, LABELNO, JUMPTO) */
3810
3811 /* Define this macro as a C expression which is nonzero if the constant EXP, of
3812    type `tree', should be output after the code for a function.  The compiler
3813    will normally output all constants before the function; you need not define
3814    this macro if this is OK.  */
3815 /* #define CONSTANT_AFTER_FUNCTION_P(EXP) */
3816
3817 /* A C statement to output assembler commands to at the end of the constant
3818    pool for a function.  FUNNAME is a string giving the name of the function.
3819    Should the return type of the function be required, you can obtain it via
3820    FUNDECL.  SIZE is the size, in bytes, of the constant pool that GNU CC wrote
3821    immediately before this call.
3822
3823    If no constant-pool epilogue is required, the usual case, you need not
3824    define this macro.  */
3825 /* #define ASM_OUTPUT_POOL_EPILOGUE (FILE FUNNAME FUNDECL SIZE) */
3826
3827 /* Define this macro as a C expression which is nonzero if C is used as a
3828    logical line separator by the assembler.
3829
3830    If you do not define this macro, the default is that only the character `;'
3831    is treated as a logical line separator.  */
3832 #define IS_ASM_LOGICAL_LINE_SEPARATOR(C) ((C) == '|')
3833
3834 /* These macros are provided by `real.h' for writing the definitions of
3835    `ASM_OUTPUT_DOUBLE' and the like: */
3836
3837 /* These translate X, of type `REAL_VALUE_TYPE', to the target's floating point
3838    representation, and store its bit pattern in the array of `long int' whose
3839    address is L.  The number of elements in the output array is determined by
3840    the size of the desired target floating point data type: 32 bits of it go in
3841    each `long int' array element.  Each array element holds 32 bits of the
3842    result, even if `long int' is wider than 32 bits on the host machine.
3843
3844    The array element values are designed so that you can print them out using
3845    `fprintf' in the order they should appear in the target machine's memory.  */
3846 /* #define REAL_VALUE_TO_TARGET_SINGLE(X, L) */
3847 /* #define REAL_VALUE_TO_TARGET_DOUBLE(X, L) */
3848 /* #define REAL_VALUE_TO_TARGET_LONG_DOUBLE(X, L) */
3849
3850 /* This macro converts X, of type `REAL_VALUE_TYPE', to a decimal number and
3851    stores it as a string into STRING.  You must pass, as STRING, the address of
3852    a long enough block of space to hold the result.
3853
3854    The argument FORMAT is a `printf'-specification that serves as a suggestion
3855    for how to format the output string.  */
3856 /* #define REAL_VALUE_TO_DECIMAL(X, FORMAT, STRING) */
3857
3858 \f
3859 /* Output of Uninitialized Variables.  */
3860
3861 /* A C statement (sans semicolon) to output to the stdio stream STREAM the
3862    assembler definition of a common-label named NAME whose size is SIZE bytes.
3863    The variable ROUNDED is the size rounded up to whatever alignment the caller
3864    wants.
3865
3866    Use the expression `assemble_name (STREAM, NAME)' to output the name itself;
3867    before and after that, output the additional assembler syntax for defining
3868    the name, and a newline.
3869
3870    This macro controls how the assembler definitions of uninitialized global
3871    variables are output.  */
3872 /* #define ASM_OUTPUT_COMMON(STREAM, NAME, SIZE, ROUNDED) */
3873
3874 /* Like `ASM_OUTPUT_COMMON' except takes the required alignment as a separate,
3875    explicit argument.  If you define this macro, it is used in place of
3876    `ASM_OUTPUT_COMMON', and gives you more flexibility in handling the required
3877    alignment of the variable.  The alignment is specified as the number of
3878    bits.
3879
3880    Defined in svr4.h.  */
3881 /* #define ASM_OUTPUT_ALIGNED_COMMON(STREAM, NAME, SIZE, ALIGNMENT) */
3882
3883 /* Like ASM_OUTPUT_ALIGNED_COMMON except that it takes an additional argument -
3884    the DECL of the variable to be output, if there is one.  This macro can be
3885    called with DECL == NULL_TREE.  If you define this macro, it is used in
3886    place of both ASM_OUTPUT_COMMON and ASM_OUTPUT_ALIGNED_COMMON, and gives you
3887    more flexibility in handling the destination of the variable.  */
3888 /* #define ASM_OUTPUT_DECL_COMMON (STREAM, DECL, NAME, SIZE, ALIGNMENT) */
3889
3890 /* If defined, it is similar to `ASM_OUTPUT_COMMON', except that it is used
3891    when NAME is shared.  If not defined, `ASM_OUTPUT_COMMON' will be used.  */
3892 /* #define ASM_OUTPUT_SHARED_COMMON(STREAM, NAME, SIZE, ROUNDED) */
3893
3894 /* A C statement (sans semicolon) to output to the stdio stream STREAM the
3895    assembler definition of uninitialized global DECL named NAME whose size is
3896    SIZE bytes.  The variable ROUNDED is the size rounded up to whatever
3897    alignment the caller wants.
3898
3899    Try to use function `asm_output_bss' defined in `varasm.c' when defining
3900    this macro.  If unable, use the expression `assemble_name (STREAM, NAME)' to
3901    output the name itself; before and after that, output the additional
3902    assembler syntax for defining the name, and a newline.
3903
3904    This macro controls how the assembler definitions of uninitialized global
3905    variables are output.  This macro exists to properly support languages like
3906    `c++' which do not have `common' data.  However, this macro currently is not
3907    defined for all targets.  If this macro and `ASM_OUTPUT_ALIGNED_BSS' are not
3908    defined then `ASM_OUTPUT_COMMON' or `ASM_OUTPUT_ALIGNED_COMMON' or
3909    `ASM_OUTPUT_DECL_COMMON' is used.  */
3910 /* #define ASM_OUTPUT_BSS(STREAM, DECL, NAME, SIZE, ROUNDED) */
3911
3912 /* Like `ASM_OUTPUT_BSS' except takes the required alignment as a separate,
3913    explicit argument.  If you define this macro, it is used in place of
3914    `ASM_OUTPUT_BSS', and gives you more flexibility in handling the required
3915    alignment of the variable.  The alignment is specified as the number of
3916    bits.
3917
3918    Try to use function `asm_output_aligned_bss' defined in file `varasm.c' when
3919    defining this macro.  */
3920 /* #define ASM_OUTPUT_ALIGNED_BSS(STREAM, DECL, NAME, SIZE, ALIGNMENT) */
3921
3922 /* If defined, it is similar to `ASM_OUTPUT_BSS', except that it is used when
3923    NAME is shared.  If not defined, `ASM_OUTPUT_BSS' will be used.  */
3924 /* #define ASM_OUTPUT_SHARED_BSS(STREAM, DECL, NAME, SIZE, ROUNDED) */
3925
3926 /* A C statement (sans semicolon) to output to the stdio stream STREAM the
3927    assembler definition of a local-common-label named NAME whose size is SIZE
3928    bytes.  The variable ROUNDED is the size rounded up to whatever alignment
3929    the caller wants.
3930
3931    Use the expression `assemble_name (STREAM, NAME)' to output the name itself;
3932    before and after that, output the additional assembler syntax for defining
3933    the name, and a newline.
3934
3935    This macro controls how the assembler definitions of uninitialized static
3936    variables are output.  */
3937 /* #define ASM_OUTPUT_LOCAL(STREAM, NAME, SIZE, ROUNDED) */
3938
3939 /* Like `ASM_OUTPUT_LOCAL' except takes the required alignment as a separate,
3940    explicit argument.  If you define this macro, it is used in place of
3941    `ASM_OUTPUT_LOCAL', and gives you more flexibility in handling the required
3942    alignment of the variable.  The alignment is specified as the number of
3943    bits.
3944
3945    Defined in svr4.h.  */
3946 /* #define ASM_OUTPUT_ALIGNED_LOCAL(STREAM, NAME, SIZE, ALIGNMENT) */
3947
3948 /* Like `ASM_OUTPUT_ALIGNED_LOCAL' except that it takes an additional
3949    parameter - the DECL of variable to be output, if there is one.
3950    This macro can be called with DECL == NULL_TREE.  If you define
3951    this macro, it is used in place of `ASM_OUTPUT_LOCAL' and
3952    `ASM_OUTPUT_ALIGNED_LOCAL', and gives you more flexibility in
3953    handling the destination of the variable.  */
3954 /* #define ASM_OUTPUT_DECL_LOCAL(STREAM, DECL, NAME, SIZE, ALIGNMENT) */
3955
3956 /* If defined, it is similar to `ASM_OUTPUT_LOCAL', except that it is used when
3957    NAME is shared.  If not defined, `ASM_OUTPUT_LOCAL' will be used.  */
3958 /* #define ASM_OUTPUT_SHARED_LOCAL (STREAM, NAME, SIZE, ROUNDED) */
3959
3960 \f
3961 /* Output and Generation of Labels.  */
3962
3963 /* A C statement (sans semicolon) to output to the stdio stream STREAM the
3964    assembler definition of a label named NAME.  Use the expression
3965    `assemble_name (STREAM, NAME)' to output the name itself; before and after
3966    that, output the additional assembler syntax for defining the name, and a
3967    newline.  */
3968 #define ASM_OUTPUT_LABEL(STREAM, NAME)                                  \
3969 do {                                                                    \
3970   assemble_name (STREAM, NAME);                                         \
3971   fputs (":\n", STREAM);                                                \
3972 } while (0)
3973
3974 /* A C statement to output to the stdio stream STREAM the assembler
3975    definition of a symbol named SYMBOL.  */
3976 #define ASM_OUTPUT_SYMBOL_REF(STREAM, SYMBOL)                           \
3977   do {                                                                  \
3978     if (SYMBOL_REF_FLAG (SYMBOL))                                       \
3979       {                                                                 \
3980         fputs ("@fptr(", STREAM);                                       \
3981         assemble_name (STREAM, XSTR (SYMBOL, 0));                       \
3982         fputc (')', STREAM);                                            \
3983       }                                                                 \
3984     else                                                                \
3985       assemble_name (STREAM, XSTR (SYMBOL, 0));                         \
3986   } while (0)
3987
3988 /* A C statement (sans semicolon) to output to the stdio stream STREAM any text
3989    necessary for declaring the name NAME of a function which is being defined.
3990    This macro is responsible for outputting the label definition (perhaps using
3991    `ASM_OUTPUT_LABEL').  The argument DECL is the `FUNCTION_DECL' tree node
3992    representing the function.
3993
3994    If this macro is not defined, then the function name is defined in the usual
3995    manner as a label (by means of `ASM_OUTPUT_LABEL').
3996
3997    Defined in svr4.h.  */
3998 /* #define ASM_DECLARE_FUNCTION_NAME(STREAM, NAME, DECL) */
3999
4000 /* A C statement (sans semicolon) to output to the stdio stream STREAM any text
4001    necessary for declaring the size of a function which is being defined.  The
4002    argument NAME is the name of the function.  The argument DECL is the
4003    `FUNCTION_DECL' tree node representing the function.
4004
4005    If this macro is not defined, then the function size is not defined.
4006
4007    Defined in svr4.h.  */
4008 /* #define ASM_DECLARE_FUNCTION_SIZE(STREAM, NAME, DECL) */
4009
4010 /* A C statement (sans semicolon) to output to the stdio stream STREAM any text
4011    necessary for declaring the name NAME of an initialized variable which is
4012    being defined.  This macro must output the label definition (perhaps using
4013    `ASM_OUTPUT_LABEL').  The argument DECL is the `VAR_DECL' tree node
4014    representing the variable.
4015
4016    If this macro is not defined, then the variable name is defined in the usual
4017    manner as a label (by means of `ASM_OUTPUT_LABEL').
4018
4019    Defined in svr4.h.  */
4020 /* #define ASM_DECLARE_OBJECT_NAME(STREAM, NAME, DECL) */
4021
4022 /* A C statement (sans semicolon) to finish up declaring a variable name once
4023    the compiler has processed its initializer fully and thus has had a chance
4024    to determine the size of an array when controlled by an initializer.  This
4025    is used on systems where it's necessary to declare something about the size
4026    of the object.
4027
4028    If you don't define this macro, that is equivalent to defining it to do
4029    nothing.
4030
4031    Defined in svr4.h.  */
4032 /* #define ASM_FINISH_DECLARE_OBJECT(STREAM, DECL, TOPLEVEL, ATEND) */
4033
4034 /* A C statement (sans semicolon) to output to the stdio stream STREAM some
4035    commands that will make the label NAME global; that is, available for
4036    reference from other files.  Use the expression `assemble_name (STREAM,
4037    NAME)' to output the name itself; before and after that, output the
4038    additional assembler syntax for making that name global, and a newline.  */
4039 #define ASM_GLOBALIZE_LABEL(STREAM,NAME)                                \
4040 do {                                                                    \
4041   fputs ("\t.globl ", STREAM);                                          \
4042   assemble_name (STREAM, NAME);                                         \
4043   fputs ("\n", STREAM);                                                 \
4044 } while (0)
4045
4046 /* A C statement (sans semicolon) to output to the stdio stream STREAM some
4047    commands that will make the label NAME weak; that is, available for
4048    reference from other files but only used if no other definition is
4049    available.  Use the expression `assemble_name (STREAM, NAME)' to output the
4050    name itself; before and after that, output the additional assembler syntax
4051    for making that name weak, and a newline.
4052
4053    If you don't define this macro, GNU CC will not support weak symbols and you
4054    should not define the `SUPPORTS_WEAK' macro.
4055
4056    Defined in svr4.h.  */
4057 /* #define ASM_WEAKEN_LABEL */
4058
4059 /* A C expression which evaluates to true if the target supports weak symbols.
4060
4061    If you don't define this macro, `defaults.h' provides a default definition.
4062    If `ASM_WEAKEN_LABEL' is defined, the default definition is `1'; otherwise,
4063    it is `0'.  Define this macro if you want to control weak symbol support
4064    with a compiler flag such as `-melf'.  */
4065 /* #define SUPPORTS_WEAK */
4066
4067 /* A C statement (sans semicolon) to mark DECL to be emitted as a
4068    public symbol such that extra copies in multiple translation units
4069    will be discarded by the linker.  Define this macro if your object
4070    file format provides support for this concept, such as the `COMDAT'
4071    section flags in the Microsoft Windows PE/COFF format, and this
4072    support requires changes to DECL, such as putting it in a separate
4073    section.
4074
4075    Defined in svr4.h.  */
4076 /* #define MAKE_DECL_ONE_ONLY */
4077
4078 /* A C expression which evaluates to true if the target supports one-only
4079    semantics.
4080
4081    If you don't define this macro, `varasm.c' provides a default definition.
4082    If `MAKE_DECL_ONE_ONLY' is defined, the default definition is `1';
4083    otherwise, it is `0'.  Define this macro if you want to control one-only
4084    symbol support with a compiler flag, or if setting the `DECL_ONE_ONLY' flag
4085    is enough to mark a declaration to be emitted as one-only.  */
4086 /* #define SUPPORTS_ONE_ONLY */
4087
4088 /* A C statement (sans semicolon) to output to the stdio stream STREAM any text
4089    necessary for declaring the name of an external symbol named NAME which is
4090    referenced in this compilation but not defined.  The value of DECL is the
4091    tree node for the declaration.
4092
4093    This macro need not be defined if it does not need to output anything.  The
4094    GNU assembler and most Unix assemblers don't require anything.  */
4095 /* #define ASM_OUTPUT_EXTERNAL(STREAM, DECL, NAME) */
4096
4097 /* A C statement (sans semicolon) to output on STREAM an assembler pseudo-op to
4098    declare a library function name external.  The name of the library function
4099    is given by SYMREF, which has type `rtx' and is a `symbol_ref'.
4100
4101    This macro need not be defined if it does not need to output anything.  The
4102    GNU assembler and most Unix assemblers don't require anything.
4103
4104    Defined in svr4.h.  */
4105 /* #define ASM_OUTPUT_EXTERNAL_LIBCALL(STREAM, SYMREF) */
4106
4107 /* A C statement (sans semicolon) to output to the stdio stream STREAM a
4108    reference in assembler syntax to a label named NAME.  This should add `_' to
4109    the front of the name, if that is customary on your operating system, as it
4110    is in most Berkeley Unix systems.  This macro is used in `assemble_name'.  */
4111 /* #define ASM_OUTPUT_LABELREF(STREAM, NAME) */
4112
4113 /* A C statement to output to the stdio stream STREAM a label whose name is
4114    made from the string PREFIX and the number NUM.
4115
4116    It is absolutely essential that these labels be distinct from the labels
4117    used for user-level functions and variables.  Otherwise, certain programs
4118    will have name conflicts with internal labels.
4119
4120    It is desirable to exclude internal labels from the symbol table of the
4121    object file.  Most assemblers have a naming convention for labels that
4122    should be excluded; on many systems, the letter `L' at the beginning of a
4123    label has this effect.  You should find out what convention your system
4124    uses, and follow it.
4125
4126    The usual definition of this macro is as follows:
4127
4128         fprintf (STREAM, "L%s%d:\n", PREFIX, NUM)
4129
4130    Defined in svr4.h.  */
4131 /* #define ASM_OUTPUT_INTERNAL_LABEL(STREAM, PREFIX, NUM) */
4132
4133 /* A C statement to store into the string STRING a label whose name is made
4134    from the string PREFIX and the number NUM.
4135
4136    This string, when output subsequently by `assemble_name', should produce the
4137    output that `ASM_OUTPUT_INTERNAL_LABEL' would produce with the same PREFIX
4138    and NUM.
4139
4140    If the string begins with `*', then `assemble_name' will output the rest of
4141    the string unchanged.  It is often convenient for
4142    `ASM_GENERATE_INTERNAL_LABEL' to use `*' in this way.  If the string doesn't
4143    start with `*', then `ASM_OUTPUT_LABELREF' gets to output the string, and
4144    may change it.  (Of course, `ASM_OUTPUT_LABELREF' is also part of your
4145    machine description, so you should know what it does on your machine.)
4146
4147    Defined in svr4.h.  */
4148 /* #define ASM_GENERATE_INTERNAL_LABEL(LABEL, PREFIX, NUM) */
4149
4150 /* A C expression to assign to OUTVAR (which is a variable of type `char *') a
4151    newly allocated string made from the string NAME and the number NUMBER, with
4152    some suitable punctuation added.  Use `alloca' to get space for the string.
4153
4154    The string will be used as an argument to `ASM_OUTPUT_LABELREF' to produce
4155    an assembler label for an internal static variable whose name is NAME.
4156    Therefore, the string must be such as to result in valid assembler code.
4157    The argument NUMBER is different each time this macro is executed; it
4158    prevents conflicts between similarly-named internal static variables in
4159    different scopes.
4160
4161    Ideally this string should not be a valid C identifier, to prevent any
4162    conflict with the user's own symbols.  Most assemblers allow periods or
4163    percent signs in assembler symbols; putting at least one of these between
4164    the name and the number will suffice.  */
4165 #define ASM_FORMAT_PRIVATE_NAME(OUTVAR, NAME, NUMBER)                   \
4166 do {                                                                    \
4167   (OUTVAR) = (char *) alloca (strlen ((NAME)) + 12);                    \
4168   sprintf ((OUTVAR), "%s.%ld", (NAME), (long)(NUMBER));                 \
4169 } while (0)
4170
4171 /* A C statement to output to the stdio stream STREAM assembler code which
4172    defines (equates) the symbol NAME to have the value VALUE.
4173
4174    If SET_ASM_OP is defined, a default definition is provided which is correct
4175    for most systems.
4176
4177    Defined in svr4.h.  */
4178 /* #define ASM_OUTPUT_DEF(STREAM, NAME, VALUE) */
4179
4180 /* A C statement to output to the stdio stream STREAM assembler code which
4181    defines (equates) the weak symbol NAME to have the value VALUE.
4182
4183    Define this macro if the target only supports weak aliases; define
4184    ASM_OUTPUT_DEF instead if possible.  */
4185 /* #define ASM_OUTPUT_WEAK_ALIAS (STREAM, NAME, VALUE) */
4186
4187 /* Define this macro to override the default assembler names used for Objective
4188    C methods.
4189
4190    The default name is a unique method number followed by the name of the class
4191    (e.g. `_1_Foo').  For methods in categories, the name of the category is
4192    also included in the assembler name (e.g.  `_1_Foo_Bar').
4193
4194    These names are safe on most systems, but make debugging difficult since the
4195    method's selector is not present in the name.  Therefore, particular systems
4196    define other ways of computing names.
4197
4198    BUF is an expression of type `char *' which gives you a buffer in which to
4199    store the name; its length is as long as CLASS_NAME, CAT_NAME and SEL_NAME
4200    put together, plus 50 characters extra.
4201
4202    The argument IS_INST specifies whether the method is an instance method or a
4203    class method; CLASS_NAME is the name of the class; CAT_NAME is the name of
4204    the category (or NULL if the method is not in a category); and SEL_NAME is
4205    the name of the selector.
4206
4207    On systems where the assembler can handle quoted names, you can use this
4208    macro to provide more human-readable names.  */
4209 /* #define OBJC_GEN_METHOD_LABEL(BUF, IS_INST, CLASS_NAME, CAT_NAME, SEL_NAME) */
4210
4211 \f
4212 /* Macros Controlling Initialization Routines.  */
4213
4214 /* If defined, a C string constant for the assembler operation to identify the
4215    following data as initialization code.  If not defined, GNU CC will assume
4216    such a section does not exist.  When you are using special sections for
4217    initialization and termination functions, this macro also controls how
4218    `crtstuff.c' and `libgcc2.c' arrange to run the initialization functions.
4219
4220    Defined in svr4.h.  */
4221 /* #define INIT_SECTION_ASM_OP */
4222
4223 /* If defined, `main' will not call `__main' as described above.  This macro
4224    should be defined for systems that control the contents of the init section
4225    on a symbol-by-symbol basis, such as OSF/1, and should not be defined
4226    explicitly for systems that support `INIT_SECTION_ASM_OP'.  */
4227 /* #define HAS_INIT_SECTION */
4228
4229 /* If defined, a C string constant for a switch that tells the linker that the
4230    following symbol is an initialization routine.  */
4231 /* #define LD_INIT_SWITCH */
4232
4233 /* If defined, a C string constant for a switch that tells the linker that the
4234    following symbol is a finalization routine.  */
4235 /* #define LD_FINI_SWITCH */
4236
4237 /* If defined, `main' will call `__main' despite the presence of
4238    `INIT_SECTION_ASM_OP'.  This macro should be defined for systems where the
4239    init section is not actually run automatically, but is still useful for
4240    collecting the lists of constructors and destructors.  */
4241 /* #define INVOKE__main */
4242
4243 /* Define this macro as a C statement to output on the stream STREAM the
4244    assembler code to arrange to call the function named NAME at initialization
4245    time.
4246
4247    Assume that NAME is the name of a C function generated automatically by the
4248    compiler.  This function takes no arguments.  Use the function
4249    `assemble_name' to output the name NAME; this performs any system-specific
4250    syntactic transformations such as adding an underscore.
4251
4252    If you don't define this macro, nothing special is output to arrange to call
4253    the function.  This is correct when the function will be called in some
4254    other manner--for example, by means of the `collect2' program, which looks
4255    through the symbol table to find these functions by their names.
4256
4257    Defined in svr4.h.  */
4258 /* #define ASM_OUTPUT_CONSTRUCTOR(STREAM, NAME) */
4259
4260 /* This is like `ASM_OUTPUT_CONSTRUCTOR' but used for termination functions
4261    rather than initialization functions.
4262
4263    Defined in svr4.h.  */
4264 /* #define ASM_OUTPUT_DESTRUCTOR(STREAM, NAME) */
4265
4266 /* If your system uses `collect2' as the means of processing constructors, then
4267    that program normally uses `nm' to scan an object file for constructor
4268    functions to be called.  On certain kinds of systems, you can define these
4269    macros to make `collect2' work faster (and, in some cases, make it work at
4270    all): */
4271
4272 /* Define this macro if the system uses COFF (Common Object File Format) object
4273    files, so that `collect2' can assume this format and scan object files
4274    directly for dynamic constructor/destructor functions.  */
4275 /* #define OBJECT_FORMAT_COFF */
4276
4277 /* Define this macro if the system uses ROSE format object files, so that
4278    `collect2' can assume this format and scan object files directly for dynamic
4279    constructor/destructor functions.
4280
4281    These macros are effective only in a native compiler; `collect2' as
4282    part of a cross compiler always uses `nm' for the target machine.  */
4283 /* #define OBJECT_FORMAT_ROSE */
4284
4285 /* Define this macro if the system uses ELF format object files.
4286
4287    Defined in svr4.h.  */
4288 /* #define OBJECT_FORMAT_ELF */
4289
4290 /* Define this macro as a C string constant containing the file name to use to
4291    execute `nm'.  The default is to search the path normally for `nm'.
4292
4293    If your system supports shared libraries and has a program to list the
4294    dynamic dependencies of a given library or executable, you can define these
4295    macros to enable support for running initialization and termination
4296    functions in shared libraries: */
4297 /* #define REAL_NM_FILE_NAME */
4298
4299 /* Define this macro to a C string constant containing the name of the program
4300    which lists dynamic dependencies, like `"ldd"' under SunOS 4.  */
4301 /* #define LDD_SUFFIX */
4302
4303 /* Define this macro to be C code that extracts filenames from the output of
4304    the program denoted by `LDD_SUFFIX'.  PTR is a variable of type `char *'
4305    that points to the beginning of a line of output from `LDD_SUFFIX'.  If the
4306    line lists a dynamic dependency, the code must advance PTR to the beginning
4307    of the filename on that line.  Otherwise, it must set PTR to `NULL'.  */
4308 /* #define PARSE_LDD_OUTPUT (PTR) */
4309
4310 \f
4311 /* Output of Assembler Instructions.  */
4312
4313 /* A C initializer containing the assembler's names for the machine registers,
4314    each one as a C string constant.  This is what translates register numbers
4315    in the compiler into assembler language.  */
4316 #define REGISTER_NAMES                                                  \
4317 { "r0", "r1", "r2", "r3", "r4", "r5", "r6", "r7", "r8", "r9", "r10",    \
4318   "r11", "r12", "r13", "psw", "sp", "carry", "fp", "ap" }
4319
4320 /* If defined, a C initializer for an array of structures containing a name and
4321    a register number.  This macro defines additional names for hard registers,
4322    thus allowing the `asm' option in declarations to refer to registers using
4323    alternate names.  */
4324 #define ADDITIONAL_REGISTER_NAMES               \
4325   { { "r14", 14 },                              \
4326     { "r15", 15 } }
4327
4328 /* Define this macro if you are using an unusual assembler that requires
4329    different names for the machine instructions.
4330
4331    The definition is a C statement or statements which output an assembler
4332    instruction opcode to the stdio stream STREAM.  The macro-operand PTR is a
4333    variable of type `char *' which points to the opcode name in its "internal"
4334    form--the form that is written in the machine description.  The definition
4335    should output the opcode name to STREAM, performing any translation you
4336    desire, and increment the variable PTR to point at the end of the opcode so
4337    that it will not be output twice.
4338
4339    In fact, your macro definition may process less than the entire opcode name,
4340    or more than the opcode name; but if you want to process text that includes
4341    `%'-sequences to substitute operands, you must take care of the substitution
4342    yourself.  Just be sure to increment PTR over whatever text should not be
4343    output normally.
4344
4345    If you need to look at the operand values, they can be found as the elements
4346    of `recog_data.operand'.
4347
4348    If the macro definition does nothing, the instruction is output in the usual
4349    way.  */
4350 /* #define ASM_OUTPUT_OPCODE(STREAM, PTR) */
4351
4352 /* If defined, a C statement to be executed just prior to the output of
4353    assembler code for INSN, to modify the extracted operands so they will be
4354    output differently.
4355
4356    Here the argument OPVEC is the vector containing the operands extracted from
4357    INSN, and NOPERANDS is the number of elements of the vector which contain
4358    meaningful data for this insn.  The contents of this vector are what will be
4359    used to convert the insn template into assembler code, so you can change the
4360    assembler output by changing the contents of the vector.
4361
4362    This macro is useful when various assembler syntaxes share a single file of
4363    instruction patterns; by defining this macro differently, you can cause a
4364    large class of instructions to be output differently (such as with
4365    rearranged operands).  Naturally, variations in assembler syntax affecting
4366    individual insn patterns ought to be handled by writing conditional output
4367    routines in those patterns.
4368
4369    If this macro is not defined, it is equivalent to a null statement.  */
4370 /* #define FINAL_PRESCAN_INSN(INSN, OPVEC, NOPERANDS) */
4371
4372 /* If defined, `FINAL_PRESCAN_INSN' will be called on each
4373    `CODE_LABEL'.  In that case, OPVEC will be a null pointer and
4374    NOPERANDS will be zero.  */
4375 /* #define FINAL_PRESCAN_LABEL */
4376
4377 /* A C compound statement to output to stdio stream STREAM the assembler syntax
4378    for an instruction operand X.  X is an RTL expression.
4379
4380    CODE is a value that can be used to specify one of several ways of printing
4381    the operand.  It is used when identical operands must be printed differently
4382    depending on the context.  CODE comes from the `%' specification that was
4383    used to request printing of the operand.  If the specification was just
4384    `%DIGIT' then CODE is 0; if the specification was `%LTR DIGIT' then CODE is
4385    the ASCII code for LTR.
4386
4387    If X is a register, this macro should print the register's name.  The names
4388    can be found in an array `reg_names' whose type is `char *[]'.  `reg_names'
4389    is initialized from `REGISTER_NAMES'.
4390
4391    When the machine description has a specification `%PUNCT' (a `%' followed by
4392    a punctuation character), this macro is called with a null pointer for X and
4393    the punctuation character for CODE.  */
4394 #define PRINT_OPERAND(STREAM, X, CODE) stormy16_print_operand (STREAM, X, CODE)
4395
4396 /* A C expression which evaluates to true if CODE is a valid punctuation
4397    character for use in the `PRINT_OPERAND' macro.  If
4398    `PRINT_OPERAND_PUNCT_VALID_P' is not defined, it means that no punctuation
4399    characters (except for the standard one, `%') are used in this way.  */
4400 /* #define PRINT_OPERAND_PUNCT_VALID_P(CODE) */
4401
4402 /* A C compound statement to output to stdio stream STREAM the assembler syntax
4403    for an instruction operand that is a memory reference whose address is X.  X
4404    is an RTL expression.
4405
4406    On some machines, the syntax for a symbolic address depends on the section
4407    that the address refers to.  On these machines, define the macro
4408    `ENCODE_SECTION_INFO' to store the information into the `symbol_ref', and
4409    then check for it here.
4410
4411    This declaration must be present.  */
4412 #define PRINT_OPERAND_ADDRESS(STREAM, X) stormy16_print_operand_address (STREAM, X)
4413
4414 /* A C statement, to be executed after all slot-filler instructions have been
4415    output.  If necessary, call `dbr_sequence_length' to determine the number of
4416    slots filled in a sequence (zero if not currently outputting a sequence), to
4417    decide how many no-ops to output, or whatever.
4418
4419    Don't define this macro if it has nothing to do, but it is helpful in
4420    reading assembly output if the extent of the delay sequence is made explicit
4421    (e.g. with white space).
4422
4423    Note that output routines for instructions with delay slots must be prepared
4424    to deal with not being output as part of a sequence (i.e.  when the
4425    scheduling pass is not run, or when no slot fillers could be found.)  The
4426    variable `final_sequence' is null when not processing a sequence, otherwise
4427    it contains the `sequence' rtx being output.  */
4428 /* #define DBR_OUTPUT_SEQEND(FILE) */
4429
4430 /* If defined, C string expressions to be used for the `%R', `%L', `%U', and
4431    `%I' options of `asm_fprintf' (see `final.c').  These are useful when a
4432    single `md' file must support multiple assembler formats.  In that case, the
4433    various `tm.h' files can define these macros differently.
4434
4435    USER_LABEL_PREFIX is defined in svr4.h.  */
4436 #define REGISTER_PREFIX ""
4437 #define LOCAL_LABEL_PREFIX "."
4438 #define USER_LABEL_PREFIX ""
4439 #define IMMEDIATE_PREFIX "#"
4440
4441 /* If your target supports multiple dialects of assembler language (such as
4442    different opcodes), define this macro as a C expression that gives the
4443    numeric index of the assembler language dialect to use, with zero as the
4444    first variant.
4445
4446    If this macro is defined, you may use `{option0|option1|option2...}'
4447    constructs in the output templates of patterns or in the first argument of
4448    `asm_fprintf'.  This construct outputs `option0', `option1' or `option2',
4449    etc., if the value of `ASSEMBLER_DIALECT' is zero, one or two, etc.  Any
4450    special characters within these strings retain their usual meaning.
4451
4452    If you do not define this macro, the characters `{', `|' and `}' do not have
4453    any special meaning when used in templates or operands to `asm_fprintf'.
4454
4455    Define the macros `REGISTER_PREFIX', `LOCAL_LABEL_PREFIX',
4456    `USER_LABEL_PREFIX' and `IMMEDIATE_PREFIX' if you can express the variations
4457    in assemble language syntax with that mechanism.  Define `ASSEMBLER_DIALECT'
4458    and use the `{option0|option1}' syntax if the syntax variant are larger and
4459    involve such things as different opcodes or operand order.  */
4460 /* #define ASSEMBLER_DIALECT */
4461
4462 /* A C expression to output to STREAM some assembler code which will push hard
4463    register number REGNO onto the stack.  The code need not be optimal, since
4464    this macro is used only when profiling.  */
4465 #define ASM_OUTPUT_REG_PUSH(STREAM, REGNO) \
4466   fprintf (STREAM, "\tpush %d\n", REGNO)
4467
4468 /* A C expression to output to STREAM some assembler code which will pop hard
4469    register number REGNO off of the stack.  The code need not be optimal, since
4470    this macro is used only when profiling.  */
4471 #define ASM_OUTPUT_REG_POP(STREAM, REGNO) \
4472   fprintf (STREAM, "\tpop %d\n", REGNO)
4473
4474 \f
4475 /* Output of dispatch tables.  */
4476
4477 /* This port does not use the ASM_OUTPUT_ADDR_VEC_ELT macro, because
4478    this could cause label alignment to appear between the 'br' and the table,
4479    which would be bad.  Instead, it controls the output of the table
4480    itself.  */
4481 #define ASM_OUTPUT_ADDR_VEC(LABEL, BODY) \
4482   stormy16_output_addr_vec (file, LABEL, BODY)
4483
4484 /* Alignment for ADDR_VECs is the same as for code.  */
4485 #define ADDR_VEC_ALIGN(ADDR_VEC) 1
4486
4487 \f
4488 /* Assembler Commands for Exception Regions.  */
4489
4490 /* A C expression to output text to mark the start of an exception region.
4491
4492    This macro need not be defined on most platforms.  */
4493 /* #define ASM_OUTPUT_EH_REGION_BEG() */
4494
4495 /* A C expression to output text to mark the end of an exception region.
4496
4497    This macro need not be defined on most platforms.  */
4498 /* #define ASM_OUTPUT_EH_REGION_END() */
4499
4500 /* A C expression to switch to the section in which the main exception table is
4501    to be placed.  The default is a section named `.gcc_except_table' on machines
4502    that support named sections via `ASM_OUTPUT_SECTION_NAME', otherwise if `-fpic'
4503    or `-fPIC' is in effect, the `data_section', otherwise the
4504    `readonly_data_section'.  */
4505 /* #define EXCEPTION_SECTION() */
4506
4507 /* If defined, a C string constant for the assembler operation to switch to the
4508    section for exception handling frame unwind information.  If not defined,
4509    GNU CC will provide a default definition if the target supports named
4510    sections.  `crtstuff.c' uses this macro to switch to the appropriate
4511    section.
4512
4513    You should define this symbol if your target supports DWARF 2 frame unwind
4514    information and the default definition does not work.  */
4515 /* #define EH_FRAME_SECTION_ASM_OP */
4516
4517 /* A C expression that is nonzero if the normal exception table output should
4518    be omitted.
4519
4520    This macro need not be defined on most platforms.  */
4521 /* #define OMIT_EH_TABLE() */
4522
4523 /* Alternate runtime support for looking up an exception at runtime and finding
4524    the associated handler, if the default method won't work.
4525
4526    This macro need not be defined on most platforms.  */
4527 /* #define EH_TABLE_LOOKUP() */
4528
4529 /* A C expression that decides whether or not the current function needs to
4530    have a function unwinder generated for it.  See the file `except.c' for
4531    details on when to define this, and how.  */
4532 /* #define DOESNT_NEED_UNWINDER */
4533
4534 /* An rtx used to mask the return address found via RETURN_ADDR_RTX, so that it
4535    does not contain any extraneous set bits in it.  */
4536 /* #define MASK_RETURN_ADDR */
4537
4538 /* Define this macro to 0 if your target supports DWARF 2 frame unwind
4539    information, but it does not yet work with exception handling.  Otherwise,
4540    if your target supports this information (if it defines
4541    `INCOMING_RETURN_ADDR_RTX' and either `UNALIGNED_INT_ASM_OP' or
4542    `OBJECT_FORMAT_ELF'), GCC will provide a default definition of 1.
4543
4544    If this macro is defined to 1, the DWARF 2 unwinder will be the default
4545    exception handling mechanism; otherwise, setjmp/longjmp will be used by
4546    default.
4547
4548    If this macro is defined to anything, the DWARF 2 unwinder will be used
4549    instead of inline unwinders and __unwind_function in the non-setjmp case.  */
4550 #define DWARF2_UNWIND_INFO 0
4551
4552 /* Don't use __builtin_setjmp for unwinding, since it's tricky to get
4553    at the high 16 bits of an address.  */
4554 #define DONT_USE_BUILTIN_SETJMP
4555 #define JMP_BUF_SIZE  8
4556 \f
4557 /* Assembler Commands for Alignment.  */
4558
4559 /* The alignment (log base 2) to put in front of LABEL, which follows
4560    a BARRIER.
4561
4562    This macro need not be defined if you don't want any special alignment to be
4563    done at such a time.  Most machine descriptions do not currently define the
4564    macro.  */
4565 /* #define LABEL_ALIGN_AFTER_BARRIER(LABEL) */
4566
4567 /* The desired alignment for the location counter at the beginning
4568    of a loop.
4569
4570    This macro need not be defined if you don't want any special alignment to be
4571    done at such a time.  Most machine descriptions do not currently define the
4572    macro.  */
4573 /* #define LOOP_ALIGN(LABEL) */
4574
4575 /* A C statement to output to the stdio stream STREAM an assembler instruction
4576    to advance the location counter by NBYTES bytes.  Those bytes should be zero
4577    when loaded.  NBYTES will be a C expression of type `int'.
4578
4579    Defined in elfos.h.  */
4580 /* #define ASM_OUTPUT_SKIP(STREAM, NBYTES) */
4581
4582 /* Define this macro if `ASM_OUTPUT_SKIP' should not be used in the text
4583    section because it fails put zeros in the bytes that are skipped.  This is
4584    true on many Unix systems, where the pseudo-op to skip bytes produces no-op
4585    instructions rather than zeros when used in the text section.  */
4586 /* #define ASM_NO_SKIP_IN_TEXT */
4587
4588 /* A C statement to output to the stdio stream STREAM an assembler command to
4589    advance the location counter to a multiple of 2 to the POWER bytes.  POWER
4590    will be a C expression of type `int'.  */
4591 #define ASM_OUTPUT_ALIGN(STREAM, POWER) \
4592   fprintf ((STREAM), "\t.p2align %d\n", (POWER))
4593
4594 \f
4595 /* Macros Affecting all Debug Formats.  */
4596
4597 /* A C expression that returns the DBX register number for the compiler
4598    register number REGNO.  In simple cases, the value of this expression may be
4599    REGNO itself.  But sometimes there are some registers that the compiler
4600    knows about and DBX does not, or vice versa.  In such cases, some register
4601    may need to have one number in the compiler and another for DBX.
4602
4603    If two registers have consecutive numbers inside GNU CC, and they can be
4604    used as a pair to hold a multiword value, then they *must* have consecutive
4605    numbers after renumbering with `DBX_REGISTER_NUMBER'.  Otherwise, debuggers
4606    will be unable to access such a pair, because they expect register pairs to
4607    be consecutive in their own numbering scheme.
4608
4609    If you find yourself defining `DBX_REGISTER_NUMBER' in way that does not
4610    preserve register pairs, then what you must do instead is redefine the
4611    actual register numbering scheme.
4612
4613    This declaration is required.  */
4614 #define DBX_REGISTER_NUMBER(REGNO) (REGNO)
4615
4616 /* A C expression that returns the integer offset value for an automatic
4617    variable having address X (an RTL expression).  The default computation
4618    assumes that X is based on the frame-pointer and gives the offset from the
4619    frame-pointer.  This is required for targets that produce debugging output
4620    for DBX or COFF-style debugging output for SDB and allow the frame-pointer
4621    to be eliminated when the `-g' options is used.  */
4622 /* #define DEBUGGER_AUTO_OFFSET(X) */
4623
4624 /* A C expression that returns the integer offset value for an argument having
4625    address X (an RTL expression).  The nominal offset is OFFSET.  */
4626 /* #define DEBUGGER_ARG_OFFSET(OFFSET, X) */
4627
4628 /* A C expression that returns the type of debugging output GNU CC produces
4629    when the user specifies `-g' or `-ggdb'.  Define this if you have arranged
4630    for GNU CC to support more than one format of debugging output.  Currently,
4631    the allowable values are `DBX_DEBUG', `SDB_DEBUG', `DWARF_DEBUG',
4632    `DWARF2_DEBUG', and `XCOFF_DEBUG'.
4633
4634    The value of this macro only affects the default debugging output; the user
4635    can always get a specific type of output by using `-gstabs', `-gcoff',
4636    `-gdwarf-1', `-gdwarf-2', or `-gxcoff'.
4637
4638    Defined in svr4.h.  */
4639 #undef PREFERRED_DEBUGGING_TYPE
4640 #define PREFERRED_DEBUGGING_TYPE DWARF2_DEBUG
4641
4642 \f
4643 /* Specific Options for DBX Output.  */
4644
4645 /* Define this macro if GNU CC should produce debugging output for DBX in
4646    response to the `-g' option.
4647
4648    Defined in svr4.h.  */
4649 /* #define DBX_DEBUGGING_INFO */
4650
4651 /* Define this macro if GNU CC should produce XCOFF format debugging output in
4652    response to the `-g' option.  This is a variant of DBX format.  */
4653 /* #define XCOFF_DEBUGGING_INFO */
4654
4655 /* Define this macro to control whether GNU CC should by default generate GDB's
4656    extended version of DBX debugging information (assuming DBX-format debugging
4657    information is enabled at all).  If you don't define the macro, the default
4658    is 1: always generate the extended information if there is any occasion to.  */
4659 /* #define DEFAULT_GDB_EXTENSIONS */
4660
4661 /* Define this macro if all `.stabs' commands should be output while in the
4662    text section.  */
4663 /* #define DEBUG_SYMS_TEXT */
4664
4665 /* A C string constant naming the assembler pseudo op to use instead of
4666    `.stabs' to define an ordinary debugging symbol.  If you don't define this
4667    macro, `.stabs' is used.  This macro applies only to DBX debugging
4668    information format.  */
4669 /* #define ASM_STABS_OP */
4670
4671 /* A C string constant naming the assembler pseudo op to use instead of
4672    `.stabd' to define a debugging symbol whose value is the current location.
4673    If you don't define this macro, `.stabd' is used.  This macro applies only
4674    to DBX debugging information format.  */
4675 /* #define ASM_STABD_OP */
4676
4677 /* A C string constant naming the assembler pseudo op to use instead of
4678    `.stabn' to define a debugging symbol with no name.  If you don't define
4679    this macro, `.stabn' is used.  This macro applies only to DBX debugging
4680    information format.  */
4681 /* #define ASM_STABN_OP */
4682
4683 /* Define this macro if DBX on your system does not support the construct
4684    `xsTAGNAME'.  On some systems, this construct is used to describe a forward
4685    reference to a structure named TAGNAME.  On other systems, this construct is
4686    not supported at all.  */
4687 /* #define DBX_NO_XREFS */
4688
4689 /* A symbol name in DBX-format debugging information is normally continued
4690    (split into two separate `.stabs' directives) when it exceeds a certain
4691    length (by default, 80 characters).  On some operating systems, DBX requires
4692    this splitting; on others, splitting must not be done.  You can inhibit
4693    splitting by defining this macro with the value zero.  You can override the
4694    default splitting-length by defining this macro as an expression for the
4695    length you desire.  */
4696 /* #define DBX_CONTIN_LENGTH */
4697
4698 /* Normally continuation is indicated by adding a `\' character to the end of a
4699    `.stabs' string when a continuation follows.  To use a different character
4700    instead, define this macro as a character constant for the character you
4701    want to use.  Do not define this macro if backslash is correct for your
4702    system.  */
4703 /* #define DBX_CONTIN_CHAR */
4704
4705 /* Define this macro if it is necessary to go to the data section before
4706    outputting the `.stabs' pseudo-op for a non-global static variable.  */
4707 /* #define DBX_STATIC_STAB_DATA_SECTION */
4708
4709 /* The value to use in the "code" field of the `.stabs' directive for a
4710    typedef.  The default is `N_LSYM'.  */
4711 /* #define DBX_TYPE_DECL_STABS_CODE */
4712
4713 /* The value to use in the "code" field of the `.stabs' directive for a static
4714    variable located in the text section.  DBX format does not provide any
4715    "right" way to do this.  The default is `N_FUN'.  */
4716 /* #define DBX_STATIC_CONST_VAR_CODE */
4717
4718 /* The value to use in the "code" field of the `.stabs' directive for a
4719    parameter passed in registers.  DBX format does not provide any "right" way
4720    to do this.  The default is `N_RSYM'.  */
4721 /* #define DBX_REGPARM_STABS_CODE */
4722
4723 /* The letter to use in DBX symbol data to identify a symbol as a parameter
4724    passed in registers.  DBX format does not customarily provide any way to do
4725    this.  The default is `'P''.  */
4726 /* #define DBX_REGPARM_STABS_LETTER */
4727
4728 /* The letter to use in DBX symbol data to identify a symbol as a stack
4729    parameter.  The default is `'p''.  */
4730 /* #define DBX_MEMPARM_STABS_LETTER */
4731
4732 /* Define this macro if the DBX information for a function and its arguments
4733    should precede the assembler code for the function.  Normally, in DBX
4734    format, the debugging information entirely follows the assembler code.
4735
4736    Defined in svr4.h.  */
4737 /* #define DBX_FUNCTION_FIRST */
4738
4739 /* Define this macro if the `N_LBRAC' symbol for a block should precede the
4740    debugging information for variables and functions defined in that block.
4741    Normally, in DBX format, the `N_LBRAC' symbol comes first.  */
4742 /* #define DBX_LBRAC_FIRST */
4743
4744 /* Define this macro if the value of a symbol describing the scope of a block
4745    (`N_LBRAC' or `N_RBRAC') should be relative to the start of the enclosing
4746    function.  Normally, GNU C uses an absolute address.
4747
4748    Defined in svr4.h.  */
4749 /* #define DBX_BLOCKS_FUNCTION_RELATIVE */
4750
4751 /* Define this macro if GNU C should generate `N_BINCL' and `N_EINCL'
4752    stabs for included header files, as on Sun systems.  This macro
4753    also directs GNU C to output a type number as a pair of a file
4754    number and a type number within the file.  Normally, GNU C does not
4755    generate `N_BINCL' or `N_EINCL' stabs, and it outputs a single
4756    number for a type number.  */
4757 /* #define DBX_USE_BINCL */
4758
4759 \f
4760 /* Open ended Hooks for DBX Output.  */
4761
4762 /* Define this macro to say how to output to STREAM the debugging information
4763    for the start of a scope level for variable names.  The argument NAME is the
4764    name of an assembler symbol (for use with `assemble_name') whose value is
4765    the address where the scope begins.  */
4766 /* #define DBX_OUTPUT_LBRAC(STREAM, NAME) */
4767
4768 /* Like `DBX_OUTPUT_LBRAC', but for the end of a scope level.  */
4769 /* #define DBX_OUTPUT_RBRAC(STREAM, NAME) */
4770
4771 /* Define this macro if the target machine requires special handling to output
4772    an enumeration type.  The definition should be a C statement (sans
4773    semicolon) to output the appropriate information to STREAM for the type
4774    TYPE.  */
4775 /* #define DBX_OUTPUT_ENUM(STREAM, TYPE) */
4776
4777 /* Define this macro if the target machine requires special output at the end
4778    of the debugging information for a function.  The definition should be a C
4779    statement (sans semicolon) to output the appropriate information to STREAM.
4780    FUNCTION is the `FUNCTION_DECL' node for the function.  */
4781 /* #define DBX_OUTPUT_FUNCTION_END(STREAM, FUNCTION) */
4782
4783 /* Define this macro if you need to control the order of output of the standard
4784    data types at the beginning of compilation.  The argument SYMS is a `tree'
4785    which is a chain of all the predefined global symbols, including names of
4786    data types.
4787
4788    Normally, DBX output starts with definitions of the types for integers and
4789    characters, followed by all the other predefined types of the particular
4790    language in no particular order.
4791
4792    On some machines, it is necessary to output different particular types
4793    first.  To do this, define `DBX_OUTPUT_STANDARD_TYPES' to output those
4794    symbols in the necessary order.  Any predefined types that you don't
4795    explicitly output will be output afterward in no particular order.
4796
4797    Be careful not to define this macro so that it works only for C.  There are
4798    no global variables to access most of the built-in types, because another
4799    language may have another set of types.  The way to output a particular type
4800    is to look through SYMS to see if you can find it.  Here is an example:
4801
4802         {
4803           tree decl;
4804           for (decl = syms; decl; decl = TREE_CHAIN (decl))
4805             if (!strcmp (IDENTIFIER_POINTER (DECL_NAME (decl)),
4806                          "long int"))
4807               dbxout_symbol (decl);
4808           ...
4809         }
4810
4811    This does nothing if the expected type does not exist.
4812
4813    See the function `init_decl_processing' in `c-decl.c' to find the names to
4814    use for all the built-in C types. */
4815 /* #define DBX_OUTPUT_STANDARD_TYPES(SYMS) */
4816
4817 /* Some stabs encapsulation formats (in particular ECOFF), cannot
4818    handle the `.stabs "",N_FUN,,0,0,Lscope-function-1' gdb dbx
4819    extention construct.  On those machines, define this macro to turn
4820    this feature off without disturbing the rest of the gdb extensions.  */
4821 /* #define NO_DBX_FUNCTION_END */
4822
4823 \f
4824 /* File names in DBX format.  */
4825
4826 /* Define this if DBX wants to have the current directory recorded in each
4827    object file.
4828
4829    Note that the working directory is always recorded if GDB extensions are
4830    enabled.  */
4831 /* #define DBX_WORKING_DIRECTORY */
4832
4833 /* A C statement to output DBX debugging information to the stdio stream STREAM
4834    which indicates that file NAME is the main source file--the file specified
4835    as the input file for compilation.  This macro is called only once, at the
4836    beginning of compilation.
4837
4838    This macro need not be defined if the standard form of output for DBX
4839    debugging information is appropriate.
4840
4841    Defined in svr4.h.  */
4842 /* #define DBX_OUTPUT_MAIN_SOURCE_FILENAME(STREAM, NAME) */
4843
4844 /* A C statement to output DBX debugging information to the stdio stream STREAM
4845    which indicates that the current directory during compilation is named NAME.
4846
4847    This macro need not be defined if the standard form of output for DBX
4848    debugging information is appropriate.  */
4849 /* #define DBX_OUTPUT_MAIN_SOURCE_DIRECTORY(STREAM, NAME) */
4850
4851 /* A C statement to output DBX debugging information at the end of compilation
4852    of the main source file NAME.
4853
4854    If you don't define this macro, nothing special is output at the end of
4855    compilation, which is correct for most machines.  */
4856 /* #define DBX_OUTPUT_MAIN_SOURCE_FILE_END(STREAM, NAME) */
4857
4858 /* A C statement to output DBX debugging information to the stdio stream STREAM
4859    which indicates that file NAME is the current source file.  This output is
4860    generated each time input shifts to a different source file as a result of
4861    `#include', the end of an included file, or a `#line' command.
4862
4863    This macro need not be defined if the standard form of output for DBX
4864    debugging information is appropriate.  */
4865 /* #define DBX_OUTPUT_SOURCE_FILENAME(STREAM, NAME) */
4866
4867 \f
4868 /* Macros for SDB and Dwarf Output.  */
4869
4870 /* Define this macro if GNU CC should produce COFF-style debugging output for
4871    SDB in response to the `-g' option.  */
4872 /* #define SDB_DEBUGGING_INFO */
4873
4874 /* Define this macro if GNU CC should produce dwarf format debugging output in
4875    response to the `-g' option.
4876
4877    Defined in svr4.h.  */
4878 /* #define DWARF_DEBUGGING_INFO */
4879
4880 /* Define this macro if GNU CC should produce dwarf version 2 format debugging
4881    output in response to the `-g' option.
4882
4883    To support optional call frame debugging information, you must also define
4884    `INCOMING_RETURN_ADDR_RTX' and either set `RTX_FRAME_RELATED_P' on the
4885    prologue insns if you use RTL for the prologue, or call `dwarf2out_def_cfa'
4886    and `dwarf2out_reg_save' as appropriate from `TARGET_ASM_FUNCTION_PROLOGUE'
4887    if you don't.
4888
4889    Defined in svr4.h.  */
4890 /* #define DWARF2_DEBUGGING_INFO */
4891
4892 /* Define this macro if GNU CC should produce dwarf version 2-style
4893    line numbers.  This usually requires extending the assembler to
4894    support them, and #defining DWARF2_LINE_MIN_INSN_LENGTH in the
4895    assembler configuration header files.  */
4896 /* #define DWARF2_ASM_LINE_DEBUG_INFO 1 */
4897
4898 /* Define this macro if addresses in Dwarf 2 debugging info should not
4899    be the same size as pointers on the target architecture.  The
4900    macro's value should be the size, in bytes, to use for addresses in
4901    the debugging info.
4902
4903    Some architectures use word addresses to refer to code locations,
4904    but Dwarf 2 info always uses byte addresses.  On such machines,
4905    Dwarf 2 addresses need to be larger than the architecture's
4906    pointers.  */
4907 #define DWARF2_ADDR_SIZE 4
4908
4909 /* Define these macros to override the assembler syntax for the special SDB
4910    assembler directives.  See `sdbout.c' for a list of these macros and their
4911    arguments.  If the standard syntax is used, you need not define them
4912    yourself.  */
4913 /* #define PUT_SDB_... */
4914
4915 /* Some assemblers do not support a semicolon as a delimiter, even between SDB
4916    assembler directives.  In that case, define this macro to be the delimiter
4917    to use (usually `\n').  It is not necessary to define a new set of
4918    `PUT_SDB_OP' macros if this is the only change required.  */
4919 /* #define SDB_DELIM */
4920
4921 /* Define this macro to override the usual method of constructing a dummy name
4922    for anonymous structure and union types.  See `sdbout.c' for more
4923    information.  */
4924 /* #define SDB_GENERATE_FAKE */
4925
4926 /* Define this macro to allow references to unknown structure, union, or
4927    enumeration tags to be emitted.  Standard COFF does not allow handling of
4928    unknown references, MIPS ECOFF has support for it.  */
4929 /* #define SDB_ALLOW_UNKNOWN_REFERENCES */
4930
4931 /* Define this macro to allow references to structure, union, or enumeration
4932    tags that have not yet been seen to be handled.  Some assemblers choke if
4933    forward tags are used, while some require it.  */
4934 /* #define SDB_ALLOW_FORWARD_REFERENCES */
4935
4936 \f
4937 /* Miscellaneous Parameters.  */
4938
4939 /* Define REAL_ARITHMETIC to use a software emulator for the target floating
4940    point mode.  Otherwise the host floating point mode is used.  */
4941 #define REAL_ARITHMETIC
4942
4943 /* Define this if you have defined special-purpose predicates in the file
4944    `MACHINE.c'.  This macro is called within an initializer of an array of
4945    structures.  The first field in the structure is the name of a predicate and
4946    the second field is an array of rtl codes.  For each predicate, list all rtl
4947    codes that can be in expressions matched by the predicate.  The list should
4948    have a trailing comma.  Here is an example of two entries in the list for a
4949    typical RISC machine:
4950
4951         #define PREDICATE_CODES \
4952           {"gen_reg_rtx_operand", {SUBREG, REG}},  \
4953           {"reg_or_short_cint_operand", {SUBREG, REG, CONST_INT}},
4954
4955    Defining this macro does not affect the generated code (however, incorrect
4956    definitions that omit an rtl code that may be matched by the predicate can
4957    cause the compiler to malfunction).  Instead, it allows the table built by
4958    `genrecog' to be more compact and efficient, thus speeding up the compiler.
4959    The most important predicates to include in the list specified by this macro
4960    are thoses used in the most insn patterns.  */
4961 #define PREDICATE_CODES                                 \
4962   {"shift_operator", {ASHIFT, ASHIFTRT, LSHIFTRT }},    \
4963   {"equality_operator", {EQ, NE }},                     \
4964   {"inequality_operator", {GE, GT, LE, LT, GEU, GTU, LEU, LTU }}, \
4965   {"stormy16_ineqsi_operator", {LT, GE, LTU, GEU }},
4966
4967 /* An alias for a machine mode name.  This is the machine mode that elements of
4968    a jump-table should have.  */
4969 #define CASE_VECTOR_MODE SImode
4970
4971 /* Define as C expression which evaluates to nonzero if the tablejump
4972    instruction expects the table to contain offsets from the address of the
4973    table.
4974    Do not define this if the table should contain absolute addresses. */
4975 /* #define CASE_VECTOR_PC_RELATIVE 1 */
4976
4977 /* Define this if control falls through a `case' insn when the index value is
4978    out of range.  This means the specified default-label is actually ignored by
4979    the `case' insn proper.  */
4980 /* #define CASE_DROPS_THROUGH */
4981
4982 /* Define this to be the smallest number of different values for which it is
4983    best to use a jump-table instead of a tree of conditional branches.  The
4984    default is four for machines with a `casesi' instruction and five otherwise.
4985    This is best for most machines.  */
4986 /* #define CASE_VALUES_THRESHOLD */
4987
4988 /* Define this macro if operations between registers with integral mode smaller
4989    than a word are always performed on the entire register.  Most RISC machines
4990    have this property and most CISC machines do not.  */
4991 #define WORD_REGISTER_OPERATIONS
4992
4993 /* Define this macro to be a C expression indicating when insns that read
4994    memory in MODE, an integral mode narrower than a word, set the bits outside
4995    of MODE to be either the sign-extension or the zero-extension of the data
4996    read.  Return `SIGN_EXTEND' for values of MODE for which the insn
4997    sign-extends, `ZERO_EXTEND' for which it zero-extends, and `NIL' for other
4998    modes.
4999
5000    This macro is not called with MODE non-integral or with a width greater than
5001    or equal to `BITS_PER_WORD', so you may return any value in this case.  Do
5002    not define this macro if it would always return `NIL'.  On machines where
5003    this macro is defined, you will normally define it as the constant
5004    `SIGN_EXTEND' or `ZERO_EXTEND'.  */
5005 #define LOAD_EXTEND_OP(MODE) ZERO_EXTEND
5006
5007 /* Define if loading short immediate values into registers sign extends.  */
5008 /* #define SHORT_IMMEDIATES_SIGN_EXTEND */
5009
5010 /* An alias for a tree code that should be used by default for conversion of
5011    floating point values to fixed point.  Normally, `FIX_ROUND_EXPR' is used.  */
5012 /* #define IMPLICIT_FIX_EXPR */
5013
5014 /* Define this macro if the same instructions that convert a floating point
5015    number to a signed fixed point number also convert validly to an unsigned
5016    one.  */
5017 /* #define FIXUNS_TRUNC_LIKE_FIX_TRUNC */
5018
5019 /* An alias for a tree code that is the easiest kind of division to compile
5020    code for in the general case.  It may be `TRUNC_DIV_EXPR', `FLOOR_DIV_EXPR',
5021    `CEIL_DIV_EXPR' or `ROUND_DIV_EXPR'.  These four division operators differ
5022    in how they round the result to an integer.  `EASY_DIV_EXPR' is used when it
5023    is permissible to use any of those kinds of division and the choice should
5024    be made on the basis of efficiency.  */
5025 #define EASY_DIV_EXPR TRUNC_DIV_EXPR
5026
5027 /* The maximum number of bytes that a single instruction can move quickly from
5028    memory to memory.  */
5029 #define MOVE_MAX 2
5030
5031 /* The maximum number of bytes that a single instruction can move quickly from
5032    memory to memory.  If this is undefined, the default is `MOVE_MAX'.
5033    Otherwise, it is the constant value that is the largest value that
5034    `MOVE_MAX' can have at run-time.  */
5035 /* #define MAX_MOVE_MAX */
5036
5037 /* A C expression that is nonzero if on this machine the number of bits
5038    actually used for the count of a shift operation is equal to the number of
5039    bits needed to represent the size of the object being shifted.  When this
5040    macro is non-zero, the compiler will assume that it is safe to omit a
5041    sign-extend, zero-extend, and certain bitwise `and' instructions that
5042    truncates the count of a shift operation.  On machines that have
5043    instructions that act on bitfields at variable positions, which may include
5044    `bit test' instructions, a nonzero `SHIFT_COUNT_TRUNCATED' also enables
5045    deletion of truncations of the values that serve as arguments to bitfield
5046    instructions.
5047
5048    If both types of instructions truncate the count (for shifts) and position
5049    (for bitfield operations), or if no variable-position bitfield instructions
5050    exist, you should define this macro.
5051
5052    However, on some machines, such as the 80386 and the 680x0, truncation only
5053    applies to shift operations and not the (real or pretended) bitfield
5054    operations.  Define `SHIFT_COUNT_TRUNCATED' to be zero on such machines.
5055    Instead, add patterns to the `md' file that include the implied truncation
5056    of the shift instructions.
5057
5058    You need not define this macro if it would always have the value of zero.  */
5059 #define SHIFT_COUNT_TRUNCATED 1
5060
5061 /* A C expression which is nonzero if on this machine it is safe to "convert"
5062    an integer of INPREC bits to one of OUTPREC bits (where OUTPREC is smaller
5063    than INPREC) by merely operating on it as if it had only OUTPREC bits.
5064
5065    On many machines, this expression can be 1.
5066
5067    When `TRULY_NOOP_TRUNCATION' returns 1 for a pair of sizes for modes for
5068    which `MODES_TIEABLE_P' is 0, suboptimal code can result.  If this is the
5069    case, making `TRULY_NOOP_TRUNCATION' return 0 in such cases may improve
5070    things.  */
5071 #define TRULY_NOOP_TRUNCATION(OUTPREC, INPREC) 1
5072
5073 /* A C expression describing the value returned by a comparison operator with
5074    an integral mode and stored by a store-flag instruction (`sCOND') when the
5075    condition is true.  This description must apply to *all* the `sCOND'
5076    patterns and all the comparison operators whose results have a `MODE_INT'
5077    mode.
5078
5079    A value of 1 or -1 means that the instruction implementing the comparison
5080    operator returns exactly 1 or -1 when the comparison is true and 0 when the
5081    comparison is false.  Otherwise, the value indicates which bits of the
5082    result are guaranteed to be 1 when the comparison is true.  This value is
5083    interpreted in the mode of the comparison operation, which is given by the
5084    mode of the first operand in the `sCOND' pattern.  Either the low bit or the
5085    sign bit of `STORE_FLAG_VALUE' be on.  Presently, only those bits are used
5086    by the compiler.
5087
5088    If `STORE_FLAG_VALUE' is neither 1 or -1, the compiler will generate code
5089    that depends only on the specified bits.  It can also replace comparison
5090    operators with equivalent operations if they cause the required bits to be
5091    set, even if the remaining bits are undefined.  For example, on a machine
5092    whose comparison operators return an `SImode' value and where
5093    `STORE_FLAG_VALUE' is defined as `0x80000000', saying that just the sign bit
5094    is relevant, the expression
5095
5096         (ne:SI (and:SI X (const_int POWER-OF-2)) (const_int 0))
5097
5098    can be converted to
5099
5100         (ashift:SI X (const_int N))
5101
5102    where N is the appropriate shift count to move the bit being tested into the
5103    sign bit.
5104
5105    There is no way to describe a machine that always sets the low-order bit for
5106    a true value, but does not guarantee the value of any other bits, but we do
5107    not know of any machine that has such an instruction.  If you are trying to
5108    port GNU CC to such a machine, include an instruction to perform a
5109    logical-and of the result with 1 in the pattern for the comparison operators
5110    and let us know.
5111
5112    Often, a machine will have multiple instructions that obtain a value from a
5113    comparison (or the condition codes).  Here are rules to guide the choice of
5114    value for `STORE_FLAG_VALUE', and hence the instructions to be used:
5115
5116       * Use the shortest sequence that yields a valid definition for
5117         `STORE_FLAG_VALUE'.  It is more efficient for the compiler to
5118         "normalize" the value (convert it to, e.g., 1 or 0) than for
5119         the comparison operators to do so because there may be
5120         opportunities to combine the normalization with other
5121         operations.
5122
5123       * For equal-length sequences, use a value of 1 or -1, with -1
5124         being slightly preferred on machines with expensive jumps and
5125         1 preferred on other machines.
5126
5127       * As a second choice, choose a value of `0x80000001' if
5128         instructions exist that set both the sign and low-order bits
5129         but do not define the others.
5130
5131       * Otherwise, use a value of `0x80000000'.
5132
5133    Many machines can produce both the value chosen for `STORE_FLAG_VALUE' and
5134    its negation in the same number of instructions.  On those machines, you
5135    should also define a pattern for those cases, e.g., one matching
5136
5137         (set A (neg:M (ne:M B C)))
5138
5139    Some machines can also perform `and' or `plus' operations on condition code
5140    values with less instructions than the corresponding `sCOND' insn followed
5141    by `and' or `plus'.  On those machines, define the appropriate patterns.
5142    Use the names `incscc' and `decscc', respectively, for the the patterns
5143    which perform `plus' or `minus' operations on condition code values.  See
5144    `rs6000.md' for some examples.  The GNU Superoptizer can be used to find
5145    such instruction sequences on other machines.
5146
5147    You need not define `STORE_FLAG_VALUE' if the machine has no store-flag
5148    instructions.  */
5149 /* #define STORE_FLAG_VALUE */
5150
5151 /* A C expression that gives a non-zero floating point value that is returned
5152    when comparison operators with floating-point results are true.  Define this
5153    macro on machine that have comparison operations that return floating-point
5154    values.  If there are no such operations, do not define this macro.  */
5155 /* #define FLOAT_STORE_FLAG_VALUE */
5156
5157 /* An alias for the machine mode for pointers.  On most machines, define this
5158    to be the integer mode corresponding to the width of a hardware pointer;
5159    `SImode' on 32-bit machine or `DImode' on 64-bit machines.  On some machines
5160    you must define this to be one of the partial integer modes, such as
5161    `PSImode'.
5162
5163    The width of `Pmode' must be at least as large as the value of
5164    `POINTER_SIZE'.  If it is not equal, you must define the macro
5165    `POINTERS_EXTEND_UNSIGNED' to specify how pointers are extended to `Pmode'.  */
5166 #define Pmode HImode
5167
5168 /* An alias for the machine mode used for memory references to functions being
5169    called, in `call' RTL expressions.  On most machines this should be
5170    `QImode'.  */
5171 #define FUNCTION_MODE HImode
5172
5173 /* A C expression for the maximum number of instructions above which the
5174    function DECL should not be inlined.  DECL is a `FUNCTION_DECL' node.
5175
5176    The default definition of this macro is 64 plus 8 times the number of
5177    arguments that the function accepts.  Some people think a larger threshold
5178    should be used on RISC machines.  */
5179 /* #define INTEGRATE_THRESHOLD(DECL) */
5180
5181 /* Define this if the preprocessor should ignore `#sccs' directives and print
5182    no error message.
5183
5184    Defined in svr4.h.  */
5185 /* #define SCCS_DIRECTIVE */
5186
5187 /* Define this macro if the system header files support C++ as well as C.  This
5188    macro inhibits the usual method of using system header files in C++, which
5189    is to pretend that the file's contents are enclosed in `extern "C" {...}'.  */
5190 #define NO_IMPLICIT_EXTERN_C
5191
5192 /* Define this macro if you want to implement any pragmas.  If defined, it
5193    should be a C expression to be executed when #pragma is seen.  The
5194    argument GETC is a function which will return the next character in the
5195    input stream, or EOF if no characters are left.  The argument UNGETC is
5196    a function which will push a character back into the input stream.  The
5197    argument NAME is the word following #pragma in the input stream.  The input
5198    stream pointer will be pointing just beyond the end of this word.  The
5199    expression should return true if it handled the pragma, false otherwise.
5200    The input stream should be left undistrubed if false is returned, otherwise
5201    it should be pointing at the next character after the end of the pragma.
5202    Any characters left between the end of the pragma and the end of the line will
5203    be ignored.
5204    
5205    It is generally a bad idea to implement new uses of `#pragma'.  The only
5206    reason to define this macro is for compatibility with other compilers that
5207    do support `#pragma' for the sake of any user programs which already use it.  */
5208 /* #define HANDLE_PRAGMA(GETC, UNGETC, NAME) handle_pragma (GETC, UNGETC, NAME) */
5209
5210 /* Define this macro to handle System V style pragmas: #pragma pack and
5211    #pragma weak.  Note, #pragma weak will only be supported if SUPPORT_WEAK is
5212    defined.
5213
5214    Defined in svr4.h.  */
5215 #define HANDLE_SYSV_PRAGMA
5216
5217 /* Define this macro if you want to support the Win32 style pragmas
5218    #pragma pack(push,<n>) and #pragma pack(pop). */
5219 /* HANDLE_PRAGMA_PACK_PUSH_POP 1 */
5220    
5221 /* Define this macro to control use of the character `$' in identifier names.
5222    The value should be 0, 1, or 2.  0 means `$' is not allowed by default; 1
5223    means it is allowed by default if `-traditional' is used; 2 means it is
5224    allowed by default provided `-ansi' is not used.  1 is the default; there is
5225    no need to define this macro in that case.  */
5226 /* #define DOLLARS_IN_IDENTIFIERS */
5227
5228 /* Define this macro if the assembler does not accept the character `$' in
5229    label names.  By default constructors and destructors in G++ have `$' in the
5230    identifiers.  If this macro is defined, `.' is used instead.
5231
5232    Defined in svr4.h.  */
5233 /* #define NO_DOLLAR_IN_LABEL */
5234
5235 /* Define this macro if the assembler does not accept the character `.' in
5236    label names.  By default constructors and destructors in G++ have names that
5237    use `.'.  If this macro is defined, these names are rewritten to avoid `.'.  */
5238 /* #define NO_DOT_IN_LABEL */
5239
5240 /* Define this macro if the target system expects every program's `main'
5241    function to return a standard "success" value by default (if no other value
5242    is explicitly returned).
5243
5244    The definition should be a C statement (sans semicolon) to generate the
5245    appropriate rtl instructions.  It is used only when compiling the end of
5246    `main'.  */
5247 /* #define DEFAULT_MAIN_RETURN */
5248
5249 /* Define this if the target system supports the function `atexit' from the
5250    ANSI C standard.  If this is not defined, and `INIT_SECTION_ASM_OP' is not
5251    defined, a default `exit' function will be provided to support C++.
5252
5253    Defined by svr4.h */
5254 /* #define HAVE_ATEXIT */
5255
5256 /* Define this if your `exit' function needs to do something besides calling an
5257    external function `_cleanup' before terminating with `_exit'.  The
5258    `EXIT_BODY' macro is only needed if netiher `HAVE_ATEXIT' nor
5259    `INIT_SECTION_ASM_OP' are defined.  */
5260 /* #define EXIT_BODY */
5261
5262 /* Define this macro as a C expression that is nonzero if it is safe for the
5263    delay slot scheduler to place instructions in the delay slot of INSN, even
5264    if they appear to use a resource set or clobbered in INSN.  INSN is always a
5265    `jump_insn' or an `insn'; GNU CC knows that every `call_insn' has this
5266    behavior.  On machines where some `insn' or `jump_insn' is really a function
5267    call and hence has this behavior, you should define this macro.
5268
5269    You need not define this macro if it would always return zero.  */
5270 /* #define INSN_SETS_ARE_DELAYED(INSN) */
5271
5272 /* Define this macro as a C expression that is nonzero if it is safe for the
5273    delay slot scheduler to place instructions in the delay slot of INSN, even
5274    if they appear to set or clobber a resource referenced in INSN.  INSN is
5275    always a `jump_insn' or an `insn'.  On machines where some `insn' or
5276    `jump_insn' is really a function call and its operands are registers whose
5277    use is actually in the subroutine it calls, you should define this macro.
5278    Doing so allows the delay slot scheduler to move instructions which copy
5279    arguments into the argument registers into the delay slot of INSN.
5280
5281    You need not define this macro if it would always return zero.  */
5282 /* #define INSN_REFERENCES_ARE_DELAYED(INSN) */
5283
5284 /* In rare cases, correct code generation requires extra machine dependent
5285    processing between the second jump optimization pass and delayed branch
5286    scheduling.  On those machines, define this macro as a C statement to act on
5287    the code starting at INSN.  */
5288 /* #define MACHINE_DEPENDENT_REORG(INSN) */
5289
5290 /* Define this macro if in some cases global symbols from one translation unit
5291    may not be bound to undefined symbols in another translation unit without
5292    user intervention.  For instance, under Microsoft Windows symbols must be
5293    explicitly imported from shared libraries (DLLs).  */
5294 /* #define MULTIPLE_SYMBOL_SPACES */
5295
5296 /* A C expression for the maximum number of instructions to execute via
5297    conditional execution instructions instead of a branch.  A value of
5298    BRANCH_COST+1 is the default if the machine does not use
5299    cc0, and 1 if it does use cc0.  */
5300 /* #define MAX_CONDITIONAL_EXECUTE */
5301
5302 /* A C statement that adds to tree CLOBBERS a set of STRING_CST trees for any
5303    hard regs the port wishes to automatically clobber for all asms. */
5304 /* #define MD_ASM_CLOBBERS(CLOBBERS) */
5305
5306 /* Indicate how many instructions can be issued at the same time.  */
5307 /* #define ISSUE_RATE */
5308
5309 /* A C statement which is executed by the Haifa scheduler at the beginning of
5310    each block of instructions that are to be scheduled.  FILE is either a null
5311    pointer, or a stdio stream to write any debug output to.  VERBOSE is the
5312    verbose level provided by -fsched-verbose-<n>. */
5313 /* #define MD_SCHED_INIT (FILE, VERBOSE) */
5314
5315 /* A C statement which is executed by the Haifa scheduler after it has scheduled
5316    the ready list to allow the machine description to reorder it (for example to
5317    combine two small instructions together on VLIW machines).  FILE is either a
5318    null pointer, or a stdio stream to write any debug output to.  VERBOSE is the
5319    verbose level provided by -fsched-verbose-=<n>.  READY is a pointer to the
5320    ready list of instructions that are ready to be scheduled.  N_READY is the
5321    number of elements in the ready list.  The scheduler reads the ready list in
5322    reverse order, starting with READY[N_READY-1] and going to READY[0].  CLOCK
5323    is the timer tick of the scheduler.  CAN_ISSUE_MORE is an output parameter that
5324    is set to the number of insns that can issue this clock; normally this is just
5325    'issue_rate'  */
5326 /* #define  MD_SCHED_REORDER (FILE, VERBOSE, READY, N_READY, CLOCK, CAN_ISSUE_MORE) */
5327
5328 /* A C statement which is executed by the Haifa scheduler after it has scheduled
5329    an insn from the ready list.  FILE is either a null pointer, or a stdio stream
5330    to write any debug output to.  VERBOSE is the verbose level provided by
5331    -fsched-verbose-<n>.  INSN is the instruction that was scheduled.  MORE is the
5332    number of instructions that can be issued in the current cycle.  This macro
5333    is responsible for updating the value of MORE (typically by (MORE)--). */
5334 /* #define MD_SCHED_VARIABLE_ISSUE (FILE, VERBOSE, INSN, MORE) */
5335
5336 /* Define this to the largest integer machine mode which can be used for
5337    operations other than load, store and copy operations.  You need only define
5338    this macro if the target holds values larger than word_mode in general purpose
5339    registers.  Most targets should not define this macro.  */
5340 /* #define MAX_INTEGER_COMPUTATION_MODE */
5341
5342 /* Define this macro as a C string constant for the linker argument to link in the
5343    system math library, or "" if the target does not have a separate math library.
5344    You need only define this macro if the default of "-lm" is wrong. */
5345 /* #define  MATH_LIBRARY */
5346 \f
5347 /* Define the information needed to generate branch and scc insns.  This is
5348    stored from the compare operation.  Note that we can't use "rtx" here
5349    since it hasn't been defined!  */
5350
5351 extern struct rtx_def *stormy16_compare_op0, *stormy16_compare_op1;
5352
5353 /* End of stormy16.h */