bfd/reloc.c

   1 /* BFD support for handling relocation entries.
   2    Copyright (C) 1990-1991 Free Software Foundation, Inc.
   3    Written by Cygnus Support.
   4
   5 This file is part of BFD, the Binary File Descriptor library.
   6
   7 This program is free software; you can redistribute it and/or modify
   8 it under the terms of the GNU General Public License as published by
   9 the Free Software Foundation; either version 2 of the License, or
  10 (at your option) any later version.
  11
  12 This program is distributed in the hope that it will be useful,
  13 but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 GNU General Public License for more details.
  16
  17 You should have received a copy of the GNU General Public License
  18 along with this program; if not, write to the Free Software
  19 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.  */
  20
  21 /*
  22 SECTION
  23         Relocations
  24
  25         BFD maintains relocations in much the same was as it maintains
  26         symbols; they are left alone until required, then read in
  27         en-mass and traslated into an internal form. There is a common
  28         routine <<bfd_perform_relocation>> which acts upon the
  29         canonical form to to the actual fixup.
  30
  31         Note that relocations are maintained on a per section basis,
  32         whilst symbols are maintained on a per BFD basis.
  33
  34         All a back end has to do to fit the BFD interface is to create
  35         as many <<struct reloc_cache_entry>> as there are relocations
  36         in a particuar section, and fill in the right bits:
  37
  38 @menu
  39 @* typedef arelent::
  40 @* howto manager::
  41 @end menu
  42
  43 */
  44 #include "bfd.h"
  45 #include "sysdep.h"
  46 #include "libbfd.h"
  47 #include "seclet.h"
  48 /*doc*
  49 INODE
  50         typedef arelent, howto manager, Relocations, Relocations
  51
  52 SUBSECTION
  53         typedef arelent
  54
  55         This is the structure of a relocation entry:
  56
  57 CODE_FRAGMENT
  58 .
  59 .typedef enum bfd_reloc_status
  60 .{
  61 .       {* No errors detected *}
  62 .  bfd_reloc_ok,
  63 .
  64 .       {* The relocation was performed, but there was an overflow. *}
  65 .  bfd_reloc_overflow,
  66 .
  67 .       {* The address to relocate was not within the section supplied*}
  68 .  bfd_reloc_outofrange,
  69 .
  70 .       {* Used by special functions *}
  71 .  bfd_reloc_continue,
  72 .
  73 .       {* Unused *}
  74 .  bfd_reloc_notsupported,
  75 .
  76 .       {* Unsupported relocation size requested.  *}
  77 .  bfd_reloc_other,
  78 .
  79 .       {* The symbol to relocate against was undefined.*}
  80 .  bfd_reloc_undefined,
  81 .
  82 .       {* The relocation was performed, but may not be ok - presently
  83 .          generated only when linking i960 coff files with i960 b.out
  84 .          symbols. *}
  85 .  bfd_reloc_dangerous
  86 . }
  87 . bfd_reloc_status_type;
  88 .
  89 .
  90 .typedef struct reloc_cache_entry
  91 .{
  92 .       {* A pointer into the canonical table of pointers  *}
  93 .  struct symbol_cache_entry **sym_ptr_ptr;
  94 .
  95 .       {* offset in section *}
  96 .  rawdata_offset address;
  97 .
  98 .       {* addend for relocation value *}
  99 .  bfd_vma addend;
 100 .
 101 .       {* Pointer to how to perform the required relocation *}
 102 .  CONST struct reloc_howto_struct *howto;
 103 .
 104 .} arelent;
 105
 106 */
 107
 108 /*
 109 DESCRIPTION
 110
 111         Here is a description of each of the fields within a relent:
 112
 113         o sym_ptr_ptr
 114
 115         The symbol table pointer points to a pointer to the symbol
 116         associated with the relocation request. This would naturally
 117         be the pointer into the table returned by the back end's
 118         get_symtab action. @xref{Symbols}. The symbol is referenced
 119         through a pointer to a pointer so that tools like the linker
 120         can fix up all the symbols of the same name by modifying only
 121         one pointer. The relocation routine looks in the symbol and
 122         uses the base of the section the symbol is attached to and the
 123         value of the symbol as the initial relocation offset. If the
 124         symbol pointer is zero, then the section provided is looked up.
 125
 126         o address
 127
 128         The address field gives the offset in bytes from the base of
 129         the section data which owns the relocation record to the first
 130         byte of relocatable information. The actual data relocated
 131         will be relative to this point - for example, a relocation
 132         type which modifies the bottom two bytes of a four byte word
 133         would not touch the first byte pointed to in a big endian
 134         world. @item addend The addend is a value provided by the back
 135         end to be added (!) to the relocation offset. Its
 136         interpretation is dependent upon the howto. For example, on
 137         the 68k the code:
 138
 139
 140 |        char foo[];
 141 |        main()
 142 |                {
 143 |                return foo[0x12345678];
 144 |                }
 145
 146         Could be compiled into:
 147
 148 |        linkw fp,#-4
 149 |        moveb @@#12345678,d0
 150 |        extbl d0
 151 |        unlk fp
 152 |        rts
 153
 154
 155         This could create a reloc pointing to foo, but leave the
 156         offset in the data (something like)
 157
 158
 159 |RELOCATION RECORDS FOR [.text]:
 160 |offset   type      value
 161 |00000006 32        _foo
 162 |
 163 |00000000 4e56 fffc          ; linkw fp,#-4
 164 |00000004 1039 1234 5678     ; moveb @@#12345678,d0
 165 |0000000a 49c0               ; extbl d0
 166 |0000000c 4e5e               ; unlk fp
 167 |0000000e 4e75               ; rts
 168
 169
 170         Using coff and an 88k, some instructions don't have enough
 171         space in them to represent the full address range, and
 172         pointers have to be loaded in two parts. So you'd get something like:
 173
 174
 175 |        or.u     r13,r0,hi16(_foo+0x12345678)
 176 |        ld.b     r2,r13,lo16(_foo+0x12345678)
 177 |        jmp      r1
 178
 179
 180         This whould create two relocs, both pointing to _foo, and with
 181         0x12340000 in their addend field. The data would consist of:
 182
 183
 184 |RELOCATION RECORDS FOR [.text]:
 185 |offset   type      value
 186 |00000002 HVRT16    _foo+0x12340000
 187 |00000006 LVRT16    _foo+0x12340000
 188
 189 |00000000 5da05678           ; or.u r13,r0,0x5678
 190 |00000004 1c4d5678           ; ld.b r2,r13,0x5678
 191 |00000008 f400c001           ; jmp r1
 192
 193
 194         The relocation routine digs out the value from the data, adds
 195         it to the addend to get the original offset and then adds the
 196         value of _foo. Note that all 32 bits have to be kept around
 197         somewhere, to cope with carry from bit 15 to bit 16.
 198
 199         On further example is the sparc and the a.out format. The
 200         sparc has a similar problem to the 88k, in that some
 201         instructions don't have room for an entire offset, but on the
 202         sparc the parts are created odd sized lumps. The designers of
 203         the a.out format chose not to use the data within the section
 204         for storing part of the offset; all the offset is kept within
 205         the reloc. Any thing in the data should be ignored.
 206
 207 |        save %sp,-112,%sp
 208 |        sethi %hi(_foo+0x12345678),%g2
 209 |        ldsb [%g2+%lo(_foo+0x12345678)],%i0
 210 |        ret
 211 |        restore
 212
 213         Both relocs contains a pointer to foo, and the offsets would
 214         contain junk.
 215
 216
 217 |RELOCATION RECORDS FOR [.text]:
 218 |offset   type      value
 219 |00000004 HI22      _foo+0x12345678
 220 |00000008 LO10      _foo+0x12345678
 221
 222 |00000000 9de3bf90     ; save %sp,-112,%sp
 223 |00000004 05000000     ; sethi %hi(_foo+0),%g2
 224 |00000008 f048a000     ; ldsb [%g2+%lo(_foo+0)],%i0
 225 |0000000c 81c7e008     ; ret
 226 |00000010 81e80000     ; restore
 227
 228
 229         o howto
 230
 231         The howto field can be imagined as a
 232         relocation instruction. It is a pointer to a struct which
 233         contains information on what to do with all the other
 234         information in the reloc record and data section. A back end
 235         would normally have a relocation instruction set and turn
 236         relocations into pointers to the correct structure on input -
 237         but it would be possible to create each howto field on demand.
 238
 239 */
 240
 241
 242 /*
 243 SUBSUBSECTION
 244         <<reloc_howto_type>>
 245
 246         The <<reloc_howto_type>> is a structure which contains all the
 247         information that BFD needs to know to tie up a back end's data.
 248
 249 CODE_FRAGMENT
 250 .struct symbol_cache_entry;             {* Forward declaration *}
 251 .
 252 .typedef CONST struct reloc_howto_struct
 253 .{
 254 .       {*  The type field has mainly a documetary use - the back end can
 255 .           to what it wants with it, though the normally the back end's
 256 .           external idea of what a reloc number would be would be stored
 257 .           in this field. For example, the a PC relative word relocation
 258 .           in a coff environment would have the type 023 - because that's
 259 .           what the outside world calls a R_PCRWORD reloc. *}
 260 .  unsigned int type;
 261 .
 262 .       {*  The value the final relocation is shifted right by. This drops
 263 .           unwanted data from the relocation.  *}
 264 .  unsigned int rightshift;
 265 .
 266 .       {*  The size of the item to be relocated - 0, is one byte, 1 is 2
 267 .           bytes, 3 is four bytes. *}
 268 .  unsigned int size;
 269 .
 270 .       {*  Now obsolete *}
 271 .  unsigned int bitsize;
 272 .
 273 .       {*  Notes that the relocation is relative to the location in the
 274 .           data section of the addend. The relocation function will
 275 .           subtract from the relocation value the address of the location
 276 .           being relocated. *}
 277 .  boolean pc_relative;
 278 .
 279 .       {*  Now obsolete *}
 280 .  unsigned int bitpos;
 281 .
 282 .       {*  Now obsolete *}
 283 .  boolean absolute;
 284 .
 285 .       {* Causes the relocation routine to return an error if overflow
 286 .          is detected when relocating. *}
 287 .  boolean complain_on_overflow;
 288 .
 289 .       {* If this field is non null, then the supplied function is
 290 .          called rather than the normal function. This allows really
 291 .          strange relocation methods to be accomodated (eg, i960 callj
 292 .          instructions). *}
 293 .  bfd_reloc_status_type EXFUN ((*special_function),
 294 .                                           (bfd *abfd,
 295 .                                            arelent *reloc_entry,
 296 .                                            struct symbol_cache_entry *symbol,
 297 .                                            PTR data,
 298 .                                            asection *input_section,
 299 .                                            bfd *output_bfd     ));
 300 .
 301 .       {* The textual name of the relocation type. *}
 302 .  char *name;
 303 .
 304 .       {* When performing a partial link, some formats must modify the
 305 .          relocations rather than the data - this flag signals this.*}
 306 .  boolean partial_inplace;
 307 .
 308 .       {* The src_mask is used to select what parts of the read in data
 309 .          are to be used in the relocation sum. Eg, if this was an 8 bit
 310 .          bit of data which we read and relocated, this would be
 311 .          0x000000ff. When we have relocs which have an addend, such as
 312 .          sun4 extended relocs, the value in the offset part of a
 313 .          relocating field is garbage so we never use it. In this case
 314 .          the mask would be 0x00000000. *}
 315 .  bfd_word src_mask;
 316 .
 317 .       {* The dst_mask is what parts of the instruction are replaced
 318 .          into the instruction. In most cases src_mask == dst_mask,
 319 .          except in the above special case, where dst_mask would be
 320 .          0x000000ff, and src_mask would be 0x00000000.   *}
 321 .  bfd_word dst_mask;
 322 .
 323 .       {* When some formats create PC relative instructions, they leave
 324 .          the value of the pc of the place being relocated in the offset
 325 .          slot of the instruction, so that a PC relative relocation can
 326 .          be made just by adding in an ordinary offset (eg sun3 a.out).
 327 .          Some formats leave the displacement part of an instruction
 328 .          empty (eg m88k bcs), this flag signals the fact.*}
 329 .  boolean pcrel_offset;
 330 .
 331 .} reloc_howto_type;
 332
 333 */
 334
 335 /*
 336 FUNCTION
 337         the HOWTO macro
 338
 339 DESCRIPTION
 340         The HOWTO define is horrible and will go away.
 341
 342
 343 .#define HOWTO(C, R,S,B, P, BI, ABS, O, SF, NAME, INPLACE, MASKSRC, MASKDST, PC) \
 344 .  {(unsigned)C,R,S,B, P, BI, ABS,O,SF,NAME,INPLACE,MASKSRC,MASKDST,PC}
 345
 346 DESCRIPTION
 347         And will be replaced with the totally magic way. But for the
 348         moment, we are compatible, so do it this way..
 349
 350
 351 .#define NEWHOWTO( FUNCTION, NAME,SIZE,REL,IN) HOWTO(0,0,SIZE,0,REL,0,false,false,FUNCTION, NAME,false,0,0,IN)
 352 .
 353 DESCRIPTION
 354         Helper routine to turn a symbol into a relocation value.
 355
 356 .#define HOWTO_PREPARE(relocation, symbol)      \
 357 .  {                                            \
 358 .  if (symbol != (asymbol *)NULL) {             \
 359 .    if (symbol->section == &bfd_com_section) { \
 360 .      relocation = 0;                          \
 361 .    }                                          \
 362 .    else {                                     \
 363 .      relocation = symbol->value;              \
 364 .    }                                          \
 365 .  }                                            \
 366 .}
 367
 368 */
 369
 370 /*
 371 TYPEDEF
 372         reloc_chain
 373
 374 DESCRIPTION
 375
 376         How relocs are tied together
 377
 378 .typedef unsigned char bfd_byte;
 379 .
 380 .typedef struct relent_chain {
 381 .  arelent relent;
 382 .  struct   relent_chain *next;
 383 .} arelent_chain;
 384
 385 */
 386
 387
 388
 389 /*
 390 FUNCTION
 391         bfd_perform_relocation
 392
 393 SYNOPSIS
 394         bfd_reloc_status_type
 395                 bfd_perform_relocation
 396                         (bfd * abfd,
 397                         arelent *reloc_entry,
 398                         PTR data,
 399                         asection *input_section,
 400                         bfd *output_bfd);
 401
 402 DESCRIPTION
 403         If an output_bfd is supplied to this function the generated
 404         image will be relocatable, the relocations are copied to the
 405         output file after they have been changed to reflect the new
 406         state of the world. There are two ways of reflecting the
 407         results of partial linkage in an output file; by modifying the
 408         output data in place, and by modifying the relocation record.
 409         Some native formats (eg basic a.out and basic coff) have no
 410         way of specifying an addend in the relocation type, so the
 411         addend has to go in the output data.  This is no big deal
 412         since in these formats the output data slot will always be big
 413         enough for the addend. Complex reloc types with addends were
 414         invented to solve just this problem.
 415
 416 */
 417
 418
 419 bfd_reloc_status_type
 420 DEFUN(bfd_perform_relocation,(abfd,
 421                               reloc_entry,
 422                               data,
 423                               input_section,
 424                               output_bfd),
 425       bfd *abfd AND
 426       arelent *reloc_entry AND
 427       PTR data AND
 428       asection *input_section AND
 429       bfd *output_bfd)
 430 {
 431   bfd_vma relocation;
 432   bfd_reloc_status_type flag = bfd_reloc_ok;
 433   bfd_vma addr = reloc_entry->address ;
 434   bfd_vma output_base = 0;
 435   reloc_howto_type *howto = reloc_entry->howto;
 436   asection *reloc_target_output_section ;
 437
 438   asymbol *symbol;
 439
 440   symbol = *( reloc_entry->sym_ptr_ptr);
 441   if ((symbol->section == &bfd_abs_section)
 442       && output_bfd != (bfd *)NULL)
 443   {
 444     reloc_entry->address += input_section->output_offset;
 445
 446     return bfd_reloc_ok;
 447
 448   }
 449
 450   if ((symbol->section == &bfd_und_section) && output_bfd == (bfd *)NULL) {
 451     flag = bfd_reloc_undefined;
 452   }
 453
 454   if (howto->special_function) {
 455     bfd_reloc_status_type cont;
 456     cont = howto->special_function(abfd,
 457                                    reloc_entry,
 458                                    symbol,
 459                                    data,
 460                                    input_section,
 461                                    output_bfd);
 462     if (cont != bfd_reloc_continue) return cont;
 463   }
 464
 465   /*
 466     Work out which section the relocation is targetted at and the
 467     initial relocation command value.
 468     */
 469
 470
 471   if (symbol->section == &bfd_com_section) {
 472     relocation = 0;
 473   }
 474   else {
 475     relocation = symbol->value;
 476   }
 477
 478
 479   reloc_target_output_section = symbol->section->output_section;
 480
 481   if (output_bfd && howto->partial_inplace==false) {
 482     output_base = 0;
 483   }
 484   else {
 485     output_base = reloc_target_output_section->vma;
 486
 487   }
 488
 489   relocation += output_base +   symbol->section->output_offset;
 490
 491
 492   relocation += reloc_entry->addend ;
 493
 494
 495   if(reloc_entry->address > input_section->_cooked_size)
 496   {
 497     return bfd_reloc_outofrange;
 498   }
 499
 500
 501   if (howto->pc_relative == true)
 502   {
 503     /*
 504       Anything which started out as pc relative should end up that
 505       way too.
 506
 507       There are two ways we can see a pcrel instruction. Sometimes
 508       the pcrel displacement has been partially calculated, it
 509       includes the distance from the start of the section to the
 510       instruction in it (eg sun3), and sometimes the field is
 511       totally blank - eg m88kbcs.
 512       */
 513
 514
 515     relocation -=
 516      input_section->output_section->vma + input_section->output_offset;
 517
 518     if (howto->pcrel_offset == true) {
 519       relocation -= reloc_entry->address;
 520     }
 521
 522   }
 523
 524   if (output_bfd!= (bfd *)NULL) {
 525     if ( howto->partial_inplace == false)  {
 526       /*
 527         This is a partial relocation, and we want to apply the relocation
 528         to the reloc entry rather than the raw data. Modify the reloc
 529         inplace to reflect what we now know.
 530         */
 531       reloc_entry->addend = relocation  ;
 532       reloc_entry->address +=  input_section->output_offset;
 533       return flag;
 534     }
 535     else
 536     {
 537       /* This is a partial relocation, but inplace, so modify the
 538          reloc record a bit.
 539
 540          If we've relocated with a symbol with a section, change
 541          into a ref to  the section belonging to the symbol
 542          */
 543       reloc_entry->addend = relocation  ;
 544       reloc_entry->address +=  input_section->output_offset;
 545
 546
 547     }
 548   }
 549   else
 550   {
 551
 552     reloc_entry->addend = 0;
 553   }
 554
 555
 556
 557   /*
 558     Either we are relocating all the way, or we don't want to apply
 559     the relocation to the reloc entry (probably because there isn't
 560     any room in the output format to describe addends to relocs)
 561     */
 562   relocation >>= howto->rightshift;
 563
 564   /* Shift everything up to where it's going to be used */
 565
 566   relocation <<= howto->bitpos;
 567
 568   /* Wait for the day when all have the mask in them */
 569
 570   /* What we do:
 571      i instruction to be left alone
 572      o offset within instruction
 573      r relocation offset to apply
 574      S src mask
 575      D dst mask
 576      N ~dst mask
 577      A part 1
 578      B part 2
 579      R result
 580
 581      Do this:
 582      i i i i i o o o o o        from bfd_get<size>
 583      and           S S S S S    to get the size offset we want
 584      +   r r r r r r r r r r  to get the final value to place
 585      and           D D D D D  to chop to right size
 586      -----------------------
 587      A A A A A
 588      And this:
 589      ...   i i i i i o o o o o  from bfd_get<size>
 590      and   N N N N N            get instruction
 591      -----------------------
 592      ...   B B B B B
 593
 594      And then:
 595      B B B B B
 596      or              A A A A A
 597      -----------------------
 598      R R R R R R R R R R        put into bfd_put<size>
 599      */
 600
 601 #define DOIT(x) \
 602   x = ( (x & ~howto->dst_mask) | (((x & howto->src_mask) +  relocation) & howto->dst_mask))
 603
 604    switch (howto->size)
 605    {
 606     case 0:
 607     {
 608       char x = bfd_get_8(abfd, (char *)data + addr);
 609       DOIT(x);
 610       bfd_put_8(abfd,x, (unsigned char *) data + addr);
 611     }
 612      break;
 613
 614     case 1:
 615     {
 616       short x = bfd_get_16(abfd, (bfd_byte *)data + addr);
 617       DOIT(x);
 618       bfd_put_16(abfd, x,   (unsigned char *)data + addr);
 619     }
 620      break;
 621     case 2:
 622     {
 623       long  x = bfd_get_32(abfd, (bfd_byte *) data + addr);
 624       DOIT(x);
 625       bfd_put_32(abfd,x,    (bfd_byte *)data + addr);
 626     }
 627      break;
 628     case 3:
 629
 630      /* Do nothing */
 631      break;
 632     default:
 633      return bfd_reloc_other;
 634    }
 635
 636   return flag;
 637 }
 638
 639
 640
 641 /*
 642 INODE
 643         howto manager,  , typedef arelent, Relocations
 644
 645 SECTION
 646         The howto manager
 647
 648         When an application wants to create a relocation, but doesn't
 649         know what the target machine might call it, it can find out by
 650         using this bit of code.
 651
 652 */
 653
 654 /*
 655 TYPEDEF
 656         bfd_reloc_code_type
 657
 658 DESCRIPTION
 659         The insides of a reloc code
 660
 661 CODE_FRAGMENT
 662 .
 663 .typedef enum bfd_reloc_code_real
 664 .{
 665 .       {* 16 bits wide, simple reloc *}
 666 .  BFD_RELOC_16,
 667 .
 668 .       {* 8 bits wide, but used to form an address like 0xffnn *}
 669 .  BFD_RELOC_8_FFnn,
 670 .
 671 .       {* 8 bits wide, simple *}
 672 .  BFD_RELOC_8,
 673 .
 674 .       {* 8 bits wide, pc relative *}
 675 .  BFD_RELOC_8_PCREL,
 676 .
 677 .       {* The type of reloc used to build a contructor table - at the
 678 .          moment probably a 32 bit wide abs address, but the cpu can
 679 .          choose. *}
 680 .
 681 .  BFD_RELOC_CTOR,
 682 .
 683 .       {* 32 bits wide, simple reloc *}
 684 .  BFD_RELOC_32,
 685 .       {* 32 bits, PC-relative *}
 686 .  BFD_RELOC_32_PCREL,
 687 .
 688 .       {* High 22 bits of 32-bit value; simple reloc.  *}
 689 .  BFD_RELOC_HI22,
 690 .       {* Low 10 bits.  *}
 691 .  BFD_RELOC_LO10,
 692 .
 693 .       {* Reloc types used for i960/b.out.  *}
 694 .  BFD_RELOC_24_PCREL,
 695 .  BFD_RELOC_I960_CALLJ,
 696 .
 697 .  BFD_RELOC_16_PCREL,
 698 .       {* 32-bit pc-relative, shifted right 2 bits (i.e., 30-bit
 699 .          word displacement, e.g. for SPARC) *}
 700 .  BFD_RELOC_32_PCREL_S2,
 701 .
 702 .  {* now for the sparc/elf codes *}
 703 .  BFD_RELOC_NONE,              {* actually used *}
 704 .  BFD_RELOC_SPARC_WDISP22,
 705 .  BFD_RELOC_SPARC22,
 706 .  BFD_RELOC_SPARC13,
 707 .  BFD_RELOC_SPARC_BASE13,
 708 .  BFD_RELOC_SPARC_GOT10,
 709 .  BFD_RELOC_SPARC_GOT13,
 710 .  BFD_RELOC_SPARC_GOT22,
 711 .  BFD_RELOC_SPARC_PC10,
 712 .  BFD_RELOC_SPARC_PC22,
 713 .  BFD_RELOC_SPARC_WPLT30,
 714 .  BFD_RELOC_SPARC_COPY,
 715 .  BFD_RELOC_SPARC_GLOB_DAT,
 716 .  BFD_RELOC_SPARC_JMP_SLOT,
 717 .  BFD_RELOC_SPARC_RELATIVE,
 718 .  BFD_RELOC_SPARC_UA32,
 719 .
 720 .  {* this one is a.out specific? *}
 721 .  BFD_RELOC_SPARC_BASE22,
 722 .
 723 .  {* this must be the highest numeric value *}
 724 .  BFD_RELOC_UNUSED
 725 . } bfd_reloc_code_real_type;
 726 */
 727
 728
 729
 730 /*
 731 SECTION
 732         bfd_reloc_type_lookup
 733
 734 SYNOPSIS
 735         CONST struct reloc_howto_struct *
 736         bfd_reloc_type_lookup (bfd *abfd, bfd_reloc_code_real_type code);
 737
 738 DESCRIPTION
 739         This routine returns a pointer to a howto struct which when
 740         invoked, will perform the supplied relocation on data from the
 741         architecture noted.
 742
 743 */
 744
 745
 746 CONST struct reloc_howto_struct *
 747 DEFUN(bfd_reloc_type_lookup,(abfd, code),
 748       bfd *abfd AND
 749       bfd_reloc_code_real_type code)
 750 {
 751   return BFD_SEND (abfd, reloc_type_lookup, (abfd, code));
 752 }
 753
 754 static reloc_howto_type bfd_howto_32 =
 755  HOWTO(0, 00,2,32,false,0,false,true,0,"VRT32", false,0xffffffff,0xffffffff,true);
 756
 757
 758 /*
 759 INTERNAL_FUNCTION
 760         bfd_default_reloc_type_lookup
 761
 762 SYNOPSIS
 763         CONST struct reloc_howto_struct *bfd_default_reloc_type_lookup
 764         (CONST struct bfd_arch_info *,
 765          bfd_reloc_code_real_type  code);
 766
 767 DESCRIPTION
 768         Provides a default relocation lookuperer for any architectue
 769
 770
 771 */
 772 CONST struct reloc_howto_struct *
 773 DEFUN(bfd_default_reloc_type_lookup,(arch,  code),
 774      CONST struct bfd_arch_info *arch AND
 775       bfd_reloc_code_real_type  code)
 776 {
 777     switch (code)
 778     {
 779        case BFD_RELOC_CTOR:
 780         /* The type of reloc used in a ctor, which will be as wide as the
 781            address - so either a 64, 32, or 16 bitter.. */
 782         switch (arch->bits_per_address) {
 783            case 64:
 784             BFD_FAIL();
 785            case 32:
 786             return &bfd_howto_32;
 787            case 16:
 788             BFD_FAIL();
 789            default:
 790             BFD_FAIL();
 791         }
 792        default:
 793         BFD_FAIL();
 794     }
 795 return (struct reloc_howto_struct *)NULL;
 796 }
 797
 798
 799 /*
 800 INTERNAL_FUNCTION
 801         bfd_generic_relax_section
 802
 803 SYNOPSIS
 804         boolean bfd_generic_relax_section
 805          (bfd *abfd,
 806           asection *section,
 807           asymbol **symbols);
 808
 809 DESCRIPTION
 810         Provides default handling for relaxing for back ends which
 811         don't do relaxing -- i.e., does nothing.
 812 */
 813
 814 boolean
 815 DEFUN(bfd_generic_relax_section,(abfd, section, symbols),
 816       bfd *abfd AND
 817       asection *section AND
 818       asymbol **symbols)
 819 {
 820
 821   return false;
 822
 823 }
 824
 825
 826 /*
 827 INTERNAL_FUNCTION
 828         bfd_generic_get_relocated_section_contents
 829
 830 SYNOPSIS
 831         bfd_byte *
 832            bfd_generic_get_relocated_section_contents(bfd *abfd,
 833              struct bfd_seclet_struct  *seclet,
 834              bfd_byte *data)
 835
 836 DESCRIPTION
 837         Provides default handling of relocation effort for back ends
 838         which can't be bothered to do it efficiently.
 839
 840 */
 841
 842 bfd_byte *
 843 DEFUN(bfd_generic_get_relocated_section_contents,(abfd, seclet, data),
 844       bfd *abfd AND
 845       struct bfd_seclet_struct *seclet AND
 846       bfd_byte *data)
 847 {
 848   extern bfd_error_vector_type bfd_error_vector;
 849
 850   /* Get enough memory to hold the stuff */
 851   bfd *input_bfd = seclet->u.indirect.section->owner;
 852   asection *input_section = seclet->u.indirect.section;
 853
 854
 855
 856   bfd_size_type reloc_size = bfd_get_reloc_upper_bound(input_bfd,
 857                                                        input_section);
 858   arelent **reloc_vector = (arelent **) alloca(reloc_size);
 859
 860   /* read in the section */
 861   bfd_get_section_contents(input_bfd,
 862                            input_section,
 863                            data,
 864                            0,
 865                            input_section->_raw_size);
 866
 867 /* We're not relaxing the section, so just copy the size info */
 868   input_section->_cooked_size = input_section->_raw_size;
 869   input_section->reloc_done = true;
 870
 871
 872   if (bfd_canonicalize_reloc(input_bfd,
 873                              input_section,
 874                              reloc_vector,
 875                              seclet->u.indirect.symbols) )
 876   {
 877     arelent **parent;
 878     for (parent = reloc_vector;  * parent != (arelent *)NULL;
 879          parent++)
 880     {
 881       bfd_reloc_status_type r=
 882        bfd_perform_relocation(input_bfd,
 883                               *parent,
 884                               data,
 885                               input_section, 0);
 886
 887
 888       if (r != bfd_reloc_ok)
 889       {
 890         switch (r)
 891         {
 892         case bfd_reloc_undefined:
 893           bfd_error_vector.undefined_symbol(*parent, seclet);
 894           break;
 895         case bfd_reloc_dangerous:
 896           bfd_error_vector.reloc_dangerous(*parent, seclet);
 897           break;
 898         case bfd_reloc_outofrange:
 899         case bfd_reloc_overflow:
 900           bfd_error_vector.reloc_value_truncated(*parent, seclet);
 901           break;
 902         default:
 903           abort();
 904           break;
 905         }
 906
 907       }
 908     }
 909   }
 910
 911
 912   return data;
 913
 914
 915 }
 916