typedef struct {
  unsigned long  r_vaddr;   /* address of relocation      */
  unsigned long  r_symndx;  /* symbol we're adjusting for */
  unsigned short r_type;    /* type of relocation         */
} RELOC;

Warning: This structure's size is not a multiple of four. When reading from file, it is strongly recommended that either (1) you read each entry in a loop, reading RELSZ bytes each time, or allocate a block of memory and calculate a pointer to each entry you need by multiplying by RELSZ. In no case should you assume that array addressing or sizeof(RELOC) will be useful.

There are only two types of relocations that you will encounter in a normal DJGPP COFF object.

For any relocation, you must determine the new address of the relocated symbol that we are adjusting for. If the symbol is in another object (external), the symbol table will contain a reference to that external symbol, and the relocation will refer to that symbol table entry. If the symbol is in the same object, the symbol table will have entries that refer to the sections themselves (always there and always private) that will be referred to. When you relocate the section itself, these symbols will reflect its new location.

RELOC_ADDR32

To do this relocation, you must perform the following steps:

• Get the address of the symbol referred to.
• Add the value currently stored in the location being adjusted.
• Store the value back into the location being adjusted.

RELOC_REL32

This relocation happens normally only in executable sections, and refers only to external symbols. To do this relocation, you must perform the following steps:

• Get the address of the symbol referred to.
• Add the value currently stored in the location being adjusted.
• Subtract the address of the beginning of the section.
• Add the original (unrelocated) address of the beginning of this section. Normally this is zero for DJGPP as only the _text section, which is first (and thus at unrelocated address zero), has relative relocs.
  Note: The preceeding two steps can be replaced with the single step of "subtract the amount you moved this section".
• Store the value back into the location being adjusted.