summaryrefslogtreecommitdiff
path: root/docs/manual/mod/module-dict.html.en
blob: 7d99828e81721b27f25ac362ca141e5c2c07dd05 (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
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
 <HEAD>
  <TITLE>Definitions of terms used to describe Apache modules
  </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">Terms Used to Describe Apache Modules</H1>

  <P>
  Each Apache module is described using a common format that looks
  like this:
  </P>
  <DL>
   <DD><A
        HREF="#Status"
        REL="Help"
       ><STRONG>Status:</STRONG></A> <EM>status</EM>
       <BR>
       <A
        HREF="#SourceFile"
        REL="Help"
       ><STRONG>Source File:</STRONG></A> <EM>source-file</EM>
       <BR>
       <A
        HREF="#ModuleIdentifier"
        REL="Help"
       ><STRONG>Module Identifier:</STRONG></A> <EM>module-identifier</EM>
       <BR>
       <A
        HREF="#Compatibility"
        REL="Help"
       ><STRONG>Compatibility:</STRONG></A> <EM>compatibility notes</EM>
   </DD>
  </DL>
  <P>
  Each of the attributes, complete with values where possible, are
  described in this document.
  </P>

  <H2>Module Terms</H2>
  <UL>
   <LI><A HREF="#Status">Status</A>
   </LI>
   <LI><A HREF="#SourceFile">Source File</A>
   </LI>
   <LI><A HREF="#ModuleIdentifier">Module Identifier</A>
   </LI>
   <LI><A HREF="#Compatibility">Compatibility</A>
   </LI>
  </UL>

  <HR>
  <H2><A NAME="Status">Status</A></H2>
  <P>
  This indicates how tightly bound into the Apache Web server the
  module is; in other words, you may need to recompile the server in
  order to gain access to the module and its functionality.  Possible
  values for this attribute are:
  </P>
  <DL>
   <DT><STRONG>MPM</STRONG>
   </DT>
   <DD>A module with status &quot;MPM&quot; is a <a
   href="../mpm.html">Multi-Processing Module</a>.  Unlike the other
   types of modules, Apache must have one and only one MPM in use at
   any time.  This type of module is responsible for basic request
   handling and dispatching.
    <P>
    </P>
   <DT><STRONG>Base</STRONG>
   </DT>
   <DD>A module labeled as having &quot;Base&quot; status is compiled
   and loaded into the server by default, and is therefore normally
   available unless you have taken steps to remove the module from your
   configuration.
    <P>
    </P>
   </DD>
   <DT><STRONG>Extension</STRONG>
   </DT>
   <DD>A module with &quot;Extension&quot; status is not normally
   compiled and loaded into the server.  To enable the module and its
   functionality, you may need to change the server build
   configuration files and re-compile Apache.
    <P>
    </P>
   </DD>
   <DT><STRONG>Experimental</STRONG>
   </DT>
   <DD>&quot;Experimental&quot; status indicates that the module is
    available as part of the Apache kit, but you are on your own if you
    try to use it.  The module is being documented for completeness,
    and is not necessarily supported.  
    <P>
    </P>
   </DD>
   <DT><STRONG>External</STRONG>
   </DT>
   <DD>Modules which are not included with the base Apache
   distribution (&quot;third-party modules&quot;) may use the
   &quot;External&quot; status.  We are not responsible for, nor do we
   support such modules.
    <P>
    </P>
   </DD>
  </DL>

  <HR>
  <H2><A NAME="SourceFile">Source File</A></H2>
  <P>
  This quite simply lists the name of the source file which contains
  the code for the module.  This is also the name used by the <A
  HREF="core.html#ifmodule"><CODE>&lt;IfModule&gt;</CODE></A>
  directive.
  </P>

  <HR>
  <H2><A NAME="ModuleIdentifier">Module Identifier</A></H2>
  <P>
  This is a string which identifies the module for use in the <A
  HREF="mod_so.html#loadmodule">LoadModule</A> directive when
  dynamically loading modules.  In particular, it is the name
  of the external variable of type module in the source file.
  </P>

  <HR>
  <H2><A NAME="Compatibility">Compatibility</A></H2>
  <P>
  If the module was not part of the original Apache version 2
  distribution, the version in which it was introduced should be listed
  here.
  </P>
<!--#include virtual="footer.html" -->
 </BODY>
</HTML>