rdoff/doc/rdoff.texi

   1 \input texinfo @c -*-texinfo-*-
   2 @c %**start of header
   3 @setfilename rdoff.info
   4 @settitle Relocatable Dynamic Object File Format (RDOFF)
   5 @afourpaper
   6 @c %**end of header
   7
   8 @titlepage
   9 @title Relocatable Dynamic Object File Format (RDOFF)
  10 @author Yuri Zaporogets @email{yuriz@@ukr.net}
  11 @author Julian Hall @email{jules@@dsf.org.uk}
  12 @end titlepage
  13
  14 @ifinfo
  15 Copyright @copyright{} 2002 Netwide Assembler Project.
  16 Written by Yuri Zaporogets @email{yuriz@@ukr.net}
  17 Based on various sources and notes written by Julian Hall @email{jules@@dsf.org.uk}
  18 Distributed under GNU documentation license.
  19 @end ifinfo
  20
  21 @ifnottex
  22 @node Top, Overview, (dir), (dir)
  23 @top RDOFF
  24
  25 RDOFF is a Relocatable Dynamic Object File Format.
  26
  27 @end ifnottex
  28
  29 @menu
  30 * Overview::            Introduction.
  31 * Structure::           Structure of RDOFF file.
  32 * Utilities::           Description of RDOFF utilities.
  33 @end menu
  34
  35 @node Overview
  36 @chapter Introduction
  37
  38 RDOFF was designed initially to test the object-file production
  39 interface to NASM. It soon became apparent that it could be enhanced
  40 for use in serious applications due to its simplicity; code to load
  41 and execute an RDOFF object module is very simple. It also contains
  42 enhancements to allow it to be linked with a dynamic link library at
  43 either run- or load- time, depending on how complex you wish to make
  44 your loader.
  45
  46 @node Structure
  47 @chapter Structure of RDOFF file
  48
  49 RDOFF module consists of three parts:
  50
  51 @itemize
  52 @item Master header
  53 @item Header (may be omited)
  54 @item Sections
  55 @end itemize
  56
  57 @dfn{Master header} contains signature, version and size information.
  58
  59 @dfn{Header} consists of zero or more @ref{Records, records}.
  60
  61 @dfn{Sections} represent actual contents of the file. Each section is prepended
  62 by a section header.
  63
  64 @node Records, , ,Structure
  65 @section Records that may appear in RDOFF header
  66
  67 @menu
  68 * Relocation::          Relocation records.
  69 * Import::              Declaring external symbols.
  70 * Export::              Declaring public and exported symbols.
  71 * DLL::                 Specifying a run-time library name.
  72 * BSS::                 Reserving space in BSS section.
  73 * Segment relocation::  Complexity of relocation in segmented systems.
  74 * Far import::          External 'far' symbols.
  75 * Module name::         Specifying module name.
  76 * Common variable::     Declaring common variables.
  77 * Generic record::      Embedding general-purpose data into the header.
  78 @end menu
  79
  80 @node Relocation
  81 @subsection Relocation records
  82
  83 @node Import
  84 @subsection Declaring external symbols
  85
  86 @node Export
  87 @subsection Declaring public and exported symbols
  88
  89 @node DLL
  90 @subsection Specifying a run-time library name
  91
  92 @node BSS
  93 @subsection Reserving space in BSS section
  94
  95 @node Segment relocation
  96 @subsection Complexity of relocation in segmented systems
  97
  98 @node Far import
  99 @subsection External 'far' symbols.
 100
 101 @node Module name
 102 @subsection Specifying module name.
 103
 104 @node Common variable
 105 @subsection Declaring common variables.
 106
 107 @node Generic record
 108 @subsection Embedding general-purpose data into the header.
 109
 110
 111 @node Utilities
 112 @chapter RDOFF utilities
 113
 114 @menu
 115 * rdfdump::             Dump the contents of RDOFF file.
 116 * ldrdf::               RDOFF linker.
 117 * rdflib::              RDOFF librarian.
 118 * rdlar::               New RDOFF librarian/archiver.
 119 * rdx::                 Load and execute RDOFF module.
 120 @end menu
 121
 122 @node rdfdump
 123 @section @command{rdfdump} - dump the contents of RDOFF file
 124
 125 @node ldrdf
 126 @section @command{ldrdf} - RDOFF linker
 127
 128 @node rdflib
 129 @section @command{rdflib} - RDOFF librarian
 130
 131 @node rdlar
 132 @section @command{rdlar} - new RDOFF librarian/archiver
 133
 134 @node rdx
 135 @section @command{rdx} - load and execute RDOFF module
 136
 137 @bye