| <!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="ROBOTS" CONTENT="NOINDEX, NOFOLLOW"> |
| <meta name="generator" content="HTML Tidy, see www.w3.org" /> |
| |
| <title>Apache module mod_dld</title> |
| |
| <style> |
| .obsolete |
| { |
| margin: 0; |
| padding: 8px 10px; |
| padding-left: 50px; |
| padding-bottom: 10px; |
| line-height: 1.4em; |
| background: #f99 url(../images/warning.png) no-repeat 0px 0px; |
| margin-left: auto; |
| margin-right: auto; |
| width: 35em; |
| } |
| |
| .currentdocs |
| { |
| background: #f99; |
| } |
| |
| </style> |
| |
| </head> |
| <!-- Background white, links blue (unvisited), navy (visited), red (active) --> |
| |
| <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" |
| vlink="#000080" alink="#FF0000"> |
| |
| <div align="CENTER"> |
| <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" /> |
| |
| <h3>Apache HTTP Server Version 1.3</h3> |
| <div class="obsolete"><p>You are looking at the documentation for the |
| 1.3 version of the Apache HTTP Server, which is no longer |
| maintained, and has been declared "end of life". If you are in |
| fact still using the 1.3 version, <strong style="font-weight: inherit;">please consider upgrading</strong>. |
| The current version of the server is <a |
| href="http://httpd.apache.org/docs/2.4/">2.4</a>.</p> |
| <p>This module is obsolete. As of version 1.3 of Apache, it has been replaced with |
| <a |
| href="http://httpd.apache.org/docs/2.4/mod/mod_so.html" |
| >mod_so</a>.</p> |
| |
| </div> |
| |
| </div> |
| |
| <h1 align="CENTER">Module mod_dld</h1> |
| 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> |
| |