1
<?xml version="1.0" encoding="ISO8859-1"?>
5
$Id: dxeload.xml,v 1.2 2004/10/16 16:12:36 michael Exp $
6
This file is part of the FPC documentation.
7
Copyright (C) 1997, by Michael Van Canneyt
9
The FPC documentation is free text; you can redistribute it and/or
10
modify it under the terms of the GNU Library General Public License as
11
published by the Free Software Foundation; either version 2 of the
12
License, or (at your option) any later version.
14
The FPC Documentation is distributed in the hope that it will be useful,
15
but WITHOUT ANY WARRANTY; without even the implied warranty of
16
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
17
Library General Public License for more details.
19
You should have received a copy of the GNU Library General Public
20
License along with the FPC documentation; see the file COPYING.LIB. If not,
21
write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
22
Boston, MA 02111-1307, USA.
25
<module name="dxeload">
26
<short>Load DXE file in to memory</short>
29
The <file>dxeload</file> unit was implemented by Pierre Mueller for dos,
30
it allows to load a DXE file (an object file with 1 entry point)
31
into memory and return a pointer to the entry point.
34
It exists only for dos.
38
<element name="DXE_MAGIC">
39
<short> Magic number, found in the header of a DXE file.</short>>
42
<element name="dxe_header">
43
<short>Record with header of DXE file</short>
45
The <var>dxe_header</var> record describes the header of a DXE file. It is used to
46
determine the magic number of the DXE file and number of relocations that
47
must be done when the object file is loaded in memory.
51
<element name="dxe_load">
52
<short>Load DXE file in memory</short>
55
<var>dxe_load</var> loads the contents of the file <var>filename</var> into memory.
56
It performs the necessary relocations in the object code, and returns then
57
a pointer to the entry point of the code.
60
For an example, see the <link id="#rtl.emu387">emu387</link> unit in the RTL.
64
If an error occurs during the load or relocations, <var>Nil</var> is returned.