reloc(FP)                      6 January 1993                      reloc(FP)


 Name

    reloc - relocation information for a common object file

 Syntax


    #include <reloc.h>


 Description

    Object files have one relocation entry for each relocatable reference in
    the text or data.  If relocation information is present, it will be in
    the following format.

       struct  reloc
       {
               long        r_vaddr ;       /* (virtual) address of reference */
               long        r_symndx ;      /* index into symbol table */
               short       r_type ;        /* relocation type */
       } ;

       # define R_PCRLONG  024

    As the link editor reads each input section and performs relocation, the
    relocation entries are read.  They direct how references found within the
    input section are treated.

    RPCRLONG   A ``PC-relative'' 32-bit reference to the symbol's virtual
                address.

    More relocation types exist for other processors.  Equivalent relocation
    types on different processors have equal values and meanings.  New relo-
    cation types will be defined (with new values) as they are needed.

    Relocation entries are generated automatically by the assembler and auto-
    matically used by the link editor.  Link editor options exist for both
    preserving and removing the relocation entries from object files.

 See also

    a.out(FP), as(CP), ld(CP), syms(FP)