summaryrefslogtreecommitdiffstats
path: root/docs/manual/mod/mod_so.html
blob: 9ceefee7d12f701fe747b7ff4875d2d15a04cfb9 (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
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>Apache module mod_so</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_so</H1>

This module is contained in the <CODE>mod_so.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, on Unix systems. Win32
systems use <A HREF="mod_dll.html">mod_dll</A> instead. This module is
only available in Apache 1.3 and up.

<h2>Summary</h2>

This is an experimental module. On selected operating systems it can
be used to load modules into Apache at runtime, rather than requiring
a recompilation.


<h2>Directives</h2>
<UL>
<LI><A HREF="#loadfile">LoadFile</A>
<LI><A HREF="#loadmodule">LoadModule</A>
</UL>
<HR>


<h2><A name="loadfile">LoadFile</A></h2>
<!--%plaintext &lt;?INDEX {\tt LoadFile} directive&gt; -->
<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_so<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 name="loadmodule">LoadModule</A></h2>
<!--%plaintext &lt;?INDEX {\tt LoadModule} directive&gt; -->
<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_so<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:
<BLOCKQUOTE><CODE>
LoadModule status_module modules/mod_status.so
</CODE></BLOCKQUOTE>
loads the module in the modules subdirectory of the ServerRoot.<P>


<!--#include virtual="footer.html" -->
</BODY>
</HTML>