gas/config/tc-avr.h

   1 /* This file is tc-avr.h
   2    Copyright (C) 1999-2024 Free Software Foundation, Inc.
   3
   4    Contributed by Denis Chertykov <denisc@overta.ru>
   5
   6    This file is part of GAS, the GNU Assembler.
   7
   8    GAS 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 3, or (at your option)
  11    any later version.
  12
  13    GAS 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 GAS; see the file COPYING.  If not, write to the Free
  20    Software Foundation, 51 Franklin Street - Fifth Floor, Boston, MA
  21    02110-1301, USA.  */
  22
  23 /* By convention, you should define this macro in the `.h' file.  For
  24    example, `tc-m68k.h' defines `TC_M68K'.  You might have to use this
  25    if it is necessary to add CPU specific code to the object format
  26    file.  */
  27 #define TC_AVR
  28
  29 /* This macro is the BFD target name to use when creating the output
  30    file.  This will normally depend upon the `OBJ_FMT' macro.  */
  31 #define TARGET_FORMAT "elf32-avr"
  32
  33 /* This macro is the BFD architecture to pass to `bfd_set_arch_mach'.  */
  34 #define TARGET_ARCH bfd_arch_avr
  35
  36 /* This macro is the BFD machine number to pass to
  37    `bfd_set_arch_mach'.  If it is not defined, GAS will use 0.  */
  38 #define TARGET_MACH 0
  39
  40 /* You should define this macro to be non-zero if the target is big
  41    endian, and zero if the target is little endian.  */
  42 #define TARGET_BYTES_BIG_ENDIAN 0
  43
  44 /* If you define this macro, GAS will warn about the use of
  45    nonstandard escape sequences in a string.  */
  46 #define ONLY_STANDARD_ESCAPES
  47
  48 #define DIFF_EXPR_OK    /* .-foo gets turned into PC relative relocs */
  49
  50 /* GAS will call this function for any expression that can not be
  51    recognized.  When the function is called, `input_line_pointer'
  52    will point to the start of the expression.  */
  53 #define md_operand(x)
  54
  55 typedef struct
  56 {
  57   /* Name of the expression modifier allowed with .byte, .word, etc.  */
  58   const char *name;
  59
  60   /* Only allowed with n bytes of data.  */
  61   int nbytes;
  62
  63   /* Associated RELOC.  */
  64   bfd_reloc_code_real_type reloc;
  65
  66   /* Part of the error message.  */
  67   const char *error;
  68 } exp_mod_data_t;
  69
  70 extern const exp_mod_data_t exp_mod_data[];
  71 #define TC_PARSE_CONS_RETURN_TYPE const exp_mod_data_t *
  72 #define TC_PARSE_CONS_RETURN_NONE exp_mod_data
  73
  74 /* You may define this macro to parse an expression used in a data
  75    allocation pseudo-op such as `.word'.  You can use this to
  76    recognize relocation directives that may appear in such directives.  */
  77 #define TC_PARSE_CONS_EXPRESSION(EXPR,N) avr_parse_cons_expression (EXPR, N)
  78 extern const exp_mod_data_t *avr_parse_cons_expression (expressionS *, int);
  79
  80 /* You may define this macro to generate a fixup for a data
  81    allocation pseudo-op.  */
  82 #define TC_CONS_FIX_NEW avr_cons_fix_new
  83 extern void avr_cons_fix_new (fragS *,int, int, expressionS *,
  84                               const exp_mod_data_t *);
  85
  86 /* This should just call either `number_to_chars_bigendian' or
  87    `number_to_chars_littleendian', whichever is appropriate.  On
  88    targets like the MIPS which support options to change the
  89    endianness, which function to call is a runtime decision.  On
  90    other targets, `md_number_to_chars' can be a simple macro.  */
  91 #define md_number_to_chars number_to_chars_littleendian
  92
  93 /* `md_short_jump_size'
  94    `md_long_jump_size'
  95    `md_create_short_jump'
  96    `md_create_long_jump'
  97    If `WORKING_DOT_WORD' is defined, GAS will not do broken word
  98    processing (*note Broken words::.).  Otherwise, you should set
  99    `md_short_jump_size' to the size of a short jump (a jump that is
 100    just long enough to jump around a long jmp) and
 101    `md_long_jump_size' to the size of a long jump (a jump that can go
 102    anywhere in the function), You should define
 103    `md_create_short_jump' to create a short jump around a long jump,
 104    and define `md_create_long_jump' to create a long jump.  */
 105 #define WORKING_DOT_WORD
 106
 107 /* If you define this macro, it means that `tc_gen_reloc' may return
 108    multiple relocation entries for a single fixup.  In this case, the
 109    return value of `tc_gen_reloc' is a pointer to a null terminated
 110    array.  */
 111 #undef RELOC_EXPANSION_POSSIBLE
 112
 113 /* No shared lib support, so we don't need to ensure externally
 114    visible symbols can be overridden.  */
 115 #define EXTERN_FORCE_RELOC 0
 116
 117 /* If defined, this macro allows control over whether fixups for a
 118    given section will be processed when the linkrelax variable is
 119    set. Define it to zero and handle things in md_apply_fix instead.*/
 120 #define TC_LINKRELAX_FIXUP(SEG) 0
 121
 122 /* If this macro returns non-zero, it guarantees that a relocation will be emitted
 123    even when the value can be resolved locally. Do that if linkrelax is turned on */
 124 #define TC_FORCE_RELOCATION(fix)        avr_force_relocation (fix)
 125 #define TC_FORCE_RELOCATION_SUB_SAME(fix, seg) \
 126   (GENERIC_FORCE_RELOCATION_SUB_SAME (fix, seg) \
 127    || avr_force_relocation (fix))
 128 extern int avr_force_relocation (struct fix *);
 129
 130 /* Values passed to md_apply_fix don't include the symbol value.  */
 131 #define MD_APPLY_SYM_VALUE(FIX) 0
 132
 133 /* If you define this macro, it should return the offset between the
 134    address of a PC relative fixup and the position from which the PC
 135    relative adjustment should be made.  On many processors, the base
 136    of a PC relative instruction is the next instruction, so this
 137    macro would return the length of an instruction.  */
 138 #define MD_PCREL_FROM_SECTION(FIX, SEC) md_pcrel_from_section (FIX, SEC)
 139
 140 /* The number of bytes to put into a word in a listing.  This affects
 141    the way the bytes are clumped together in the listing.  For
 142    example, a value of 2 might print `1234 5678' where a value of 1
 143    would print `12 34 56 78'.  The default value is 4.  */
 144 #define LISTING_WORD_SIZE 2
 145
 146 /* AVR port uses `$' as a logical line separator by default. */
 147 #define LEX_DOLLAR 0
 148
 149 /* An `.lcomm' directive with no explicit alignment parameter will
 150    use this macro to set P2VAR to the alignment that a request for
 151    SIZE bytes will have.  The alignment is expressed as a power of
 152    two.  If no alignment should take place, the macro definition
 153    should do nothing.  Some targets define a `.bss' directive that is
 154    also affected by this macro.  The default definition will set
 155    P2VAR to the truncated power of two of sizes up to eight bytes.  */
 156 #define TC_IMPLICIT_LCOMM_ALIGNMENT(SIZE, P2VAR) (P2VAR) = 0
 157
 158 /* We don't want gas to fixup the following program memory related relocations.
 159    We will need them in case that we want to do linker relaxation.
 160    We could in principle keep these fixups in gas when not relaxing.
 161    However, there is no serious performance penalty when making the linker
 162    make the fixup work.  Check also that fx_addsy is not NULL, in order to make
 163    sure that the fixup refers to some sort of label.  */
 164 #define TC_VALIDATE_FIX(FIXP,SEG,SKIP)                       \
 165   if (   (FIXP->fx_r_type == BFD_RELOC_AVR_7_PCREL           \
 166        || FIXP->fx_r_type == BFD_RELOC_AVR_13_PCREL          \
 167        || FIXP->fx_r_type == BFD_RELOC_AVR_LO8_LDI_PM        \
 168        || FIXP->fx_r_type == BFD_RELOC_AVR_LO8_LDI_GS        \
 169        || FIXP->fx_r_type == BFD_RELOC_AVR_HI8_LDI_PM        \
 170        || FIXP->fx_r_type == BFD_RELOC_AVR_HI8_LDI_GS        \
 171        || FIXP->fx_r_type == BFD_RELOC_AVR_HH8_LDI_PM        \
 172        || FIXP->fx_r_type == BFD_RELOC_AVR_LO8_LDI_PM_NEG    \
 173        || FIXP->fx_r_type == BFD_RELOC_AVR_HI8_LDI_PM_NEG    \
 174        || FIXP->fx_r_type == BFD_RELOC_AVR_HH8_LDI_PM_NEG    \
 175        || FIXP->fx_r_type == BFD_RELOC_AVR_8_LO              \
 176        || FIXP->fx_r_type == BFD_RELOC_AVR_8_HI              \
 177        || FIXP->fx_r_type == BFD_RELOC_AVR_8_HLO             \
 178        || FIXP->fx_r_type == BFD_RELOC_AVR_16_PM)            \
 179       && FIXP->fx_addsy != NULL                              \
 180       && FIXP->fx_subsy == NULL)                             \
 181     {                                                        \
 182       symbol_mark_used_in_reloc (FIXP->fx_addsy);            \
 183       goto SKIP;                                             \
 184     }
 185
 186 /* This macro is evaluated for any fixup with a fx_subsy that
 187    fixup_segment cannot reduce to a number.  If the macro returns
 188    false an error will be reported. */
 189 #define TC_VALIDATE_FIX_SUB(fix, seg)   avr_validate_fix_sub (fix)
 190 extern int avr_validate_fix_sub (struct fix *);
 191
 192 /* This target is buggy, and sets fix size too large.  */
 193 #define TC_FX_SIZE_SLACK(FIX) 2
 194
 195 /* AVR instructions are 2 or 4 bytes long.  */
 196 #define DWARF2_LINE_MIN_INSN_LENGTH     2
 197
 198 /* 32 bits pseudo-addresses are used on AVR.  */
 199 #define DWARF2_ADDR_SIZE(bfd) 4
 200
 201 /* Enable cfi directives.  */
 202 #define TARGET_USE_CFIPOP 1
 203
 204 /* The stack grows down, and is only byte aligned.  */
 205 #define DWARF2_CIE_DATA_ALIGNMENT -1
 206
 207 /* Define the column that represents the PC.  */
 208 #define DWARF2_DEFAULT_RETURN_COLUMN  36
 209
 210 /* Define a hook to setup initial CFI state.  */
 211 extern void tc_cfi_frame_initial_instructions (void);
 212 #define tc_cfi_frame_initial_instructions tc_cfi_frame_initial_instructions
 213
 214 /* The difference between same-section symbols may be affected by linker
 215    relaxation, so do not resolve such expressions in the assembler.  */
 216 #define md_allow_local_subtract(l,r,s) avr_allow_local_subtract (l, r, s)
 217 extern bool avr_allow_local_subtract (expressionS *, expressionS *, segT);
 218
 219 #define elf_tc_final_processing         avr_elf_final_processing
 220 extern void avr_elf_final_processing (void);
 221
 222 #define md_pre_output_hook avr_pre_output_hook ()
 223 extern void avr_pre_output_hook (void);
 224
 225 #define md_undefined_symbol avr_undefined_symbol
 226 extern symbolS* avr_undefined_symbol (char*);
 227
 228 #define md_post_relax_hook avr_post_relax_hook ()
 229 extern void avr_post_relax_hook (void);
 230
 231 #define HANDLE_ALIGN(fragP) avr_handle_align (fragP)
 232 extern void avr_handle_align (fragS *);
 233
 234 struct avr_frag_data
 235 {
 236   unsigned is_org : 1;
 237   unsigned is_align : 1;
 238   unsigned has_fill : 1;
 239
 240   char fill;
 241   offsetT alignment;
 242   unsigned int prev_opcode;
 243 };
 244 #define TC_FRAG_TYPE                    struct avr_frag_data
 245 #define TC_FRAG_INIT(frag, max_bytes)   avr_frag_init (frag)
 246 extern void avr_frag_init (fragS *);
 247
 248 #define tc_line_separator_chars avr_line_separator_chars
 249 extern const char *avr_line_separator_chars;
 250
 251 #define tc_fix_adjustable(FIX) avr_fix_adjustable (FIX)
 252 extern bool avr_fix_adjustable (struct fix *);