summaryrefslogtreecommitdiff
path: root/APACHE_1_3_42/htdocs/manual/mod/mod_dld.html
blob: 2d7f9c1ddd6d8f6a07b2451a015c04580ac5e94f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta name="generator" content="HTML Tidy, see www.w3.org" />

    <title>Apache module mod_dld</title>
  </head>
  <!-- Background white, links blue (unvisited), navy (visited), red (active) -->

  <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
  vlink="#000080" alink="#FF0000">
    <!--#include virtual="header.html" -->

    <h1 align="CENTER">Module mod_dld</h1>
    <strong><font color="red">This module is obsolete. As of
    version 1.3 of Apache, it has been replaced with <a
    href="mod_so.html">mod_so</a>.</font></strong> This module is
    contained in the <code>mod_dld.c</code> file, and is not
    compiled in by default. It provides for loading of executable
    code and modules into the server at start-up time, using the
    GNU dld library. 

    <h2>Summary</h2>
    The optional dld module is a proof-of-concept piece of code
    which loads other modules into the server as it is configuring
    itself (the first time only; for now, rereading the config
    files cannot affect the state of loaded modules), using the GNU
    dynamic linking library, DLD. It isn't compiled into the server
    by default, since not everyone has DLD, but it works when I try
    it. (Famous last words.) 

    <p>Note that for some reason, <code>LoadFile /lib/libc.a</code>
    seems to be required for just about everything.</p>

    <p>Note: that DLD needs to read the symbol table out of the
    server binary when starting up; these commands will fail if the
    server can't find its own binary when it starts up, or if that
    binary is stripped.</p>

    <h2>Directives</h2>

    <ul>
      <li><a href="#loadfile">LoadFile</a></li>

      <li><a href="#loadmodule">LoadModule</a></li>
    </ul>
    <hr />

    <h2><a id="loadfile" name="loadfile">LoadFile</a></h2>

    <a href="directive-dict.html#Syntax"
    rel="Help"><strong>Syntax:</strong></a> LoadFile <em>filename
    filename ...</em><br />
     <a href="directive-dict.html#Context"
    rel="Help"><strong>Context:</strong></a> server config<br />
     <a href="directive-dict.html#Status"
    rel="Help"><strong>Status:</strong></a> Experimental<br />
     <a href="directive-dict.html#Module"
    rel="Help"><strong>Module:</strong></a> mod_dld 

    <p>The LoadFile directive links in the named object files or
    libraries when the server is started; this is used to load
    additional code which may be required for some module to work.
    <em>Filename</em> is relative to <a
    href="core.html#serverroot">ServerRoot</a>.</p>
    <hr />

    <h2><a id="loadmodule" name="loadmodule">LoadModule</a></h2>

    <a href="directive-dict.html#Syntax"
    rel="Help"><strong>Syntax:</strong></a> LoadModule <em>module
    filename</em><br />
     <a href="directive-dict.html#Context"
    rel="Help"><strong>Context:</strong></a> server config<br />
     <a href="directive-dict.html#Status"
    rel="Help"><strong>Status:</strong></a> Experimental<br />
     <a href="directive-dict.html#Module"
    rel="Help"><strong>Module:</strong></a> mod_dld 

    <p>The LoadModule directive links in the object file or library
    <em>filename</em> and adds the module structure named
    <em>module</em> to the list of active modules. <em>Module</em>
    is the name of the external variable of type
    <code>module</code> in the file. Example:</p>

    <blockquote>
      <code>LoadModule ai_backcompat_module
      modules/mod_ai_backcompat.o<br />
       LoadFile /lib/libc.a</code>
    </blockquote>
    loads the module in the modules subdirectory of the ServerRoot.
    

    <p><!--#include virtual="footer.html" -->
    </p>
  </body>
</html>