Table Of ContentApache HTTP Server Documentation Version 2.2
ApacheSoftwareFoundation
August23,2014
ii
About The PDF Documentation
Copyright(cid:13)c2014TheApacheSoftwareFoundation
LicensedundertheApacheLicense,Version2.0(the”License”);youmaynotusethisfileexceptincompliancewith
theLicense. YoumayobtainacopyoftheLicenseathttp://www.apache.org/licenses/LICENSE-2.0
This version of the Apache HTTP Server Documentation is converted from XML source files to LATEX using XSLT
withthehelpofApacheAnt,ApacheXMLXalan,andApacheXMLXerces.
Since the HTML version of the documentation is more commonly checked during development, the PDF ver-
sion may contain some errors and inconsistencies, especially in formatting. If you have difficulty reading a
part of this file, please consult the HTML version of the documentation on the Apache HTTP Server website at
http://httpd.apache.org/docs/2.2/
TheApacheHTTPServerDocumentationismaintainedbytheApacheHTTPServerDocumentationProject. More
informationisavailableathttp://httpd.apache.org/docs-project/
Contents
1 ReleaseNotes 1
1.1 Upgradingto2.2from2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 OverviewofnewfeaturesinApache2.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.3 OverviewofnewfeaturesinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
1.4 TheApacheLicense,Version2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
2 UsingtheApacheHTTPServer 13
2.1 CompilingandInstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
2.2 StartingApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
2.3 StoppingandRestarting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
2.4 ConfigurationFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.5 ConfigurationSections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
2.6 CachingGuide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.7 Server-WideConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
2.8 LogFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.9 MappingURLstoFilesystemLocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
2.10 DynamicSharedObject(DSO)Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
2.11 ContentNegotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
2.12 CustomErrorResponses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2.13 Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
2.14 Multi-ProcessingModules(MPMs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
2.15 EnvironmentVariablesinApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
2.16 Apache’sHandlerUse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76
2.17 Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
2.18 suEXECSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
2.19 IssuesRegardingDNSandApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
3 ApacheVirtualHostdocumentation 91
3.1 ApacheVirtualHostdocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
iii
iv CONTENTS
3.2 Name-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
3.3 ApacheIP-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
3.4 Dynamicallyconfiguredmassvirtualhosting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
3.5 VirtualHostExamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
3.6 AnIn-DepthDiscussionofVirtualHostMatching . . . . . . . . . . . . . . . . . . . . . . . . . . 111
3.7 FileDescriptorLimits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 115
4 URLRewritingGuide 117
4.1 Apachemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
4.2 Apachemod rewriteIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
4.3 RedirectingandRemappingwithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
4.4 Usingmod rewritetocontrolaccess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
4.5 Dynamicmassvirtualhostswithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
4.6 Usingmod rewriteforProxying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
4.7 UsingRewriteMap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
4.8 AdvancedTechniqueswithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
4.9 Whennottousemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
4.10 RewriteRuleFlags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
4.11 Apachemod rewriteTechnicalDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
5 ApacheSSL/TLSEncryption 165
5.1 ApacheSSL/TLSEncryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 166
5.2 SSL/TLSStrongEncryption: AnIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 167
5.3 SSL/TLSStrongEncryption: Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
5.4 SSL/TLSStrongEncryption: How-To . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 180
5.5 SSL/TLSStrongEncryption: FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 185
6 Guides,Tutorials,andHowTos 201
6.1 How-To/Tutorials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
6.2 AuthenticationandAuthorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
6.3 AccessControl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
6.4 ApacheTutorial: DynamicContentwithCGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
6.5 ApacheTutorial: IntroductiontoServerSideIncludes . . . . . . . . . . . . . . . . . . . . . . . . 217
6.6 ApacheHTTPServerTutorial: .htaccessfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.7 Per-userwebdirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 228
7 Platform-specificNotes 231
7.1 PlatformSpecificNotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
7.2 UsingApacheHTTPServeronMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . 233
CONTENTS v
7.3 CompilingApacheforMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
7.4 UsingApacheWithNovellNetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 248
7.5 RunningaHigh-PerformanceWebServeronHPUX . . . . . . . . . . . . . . . . . . . . . . . . . 256
7.6 TheApacheEBCDICPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
8 ApacheHTTPServerandSupportingPrograms 261
8.1 ServerandSupportingPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 262
8.2 httpd-ApacheHypertextTransferProtocolServer . . . . . . . . . . . . . . . . . . . . . . . . . . 263
8.3 ab-ApacheHTTPserverbenchmarkingtool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 265
8.4 apachectl-ApacheHTTPServerControlInterface. . . . . . . . . . . . . . . . . . . . . . . . . . 268
8.5 apxs-APacheeXtenSiontool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 270
8.6 configure-Configurethesourcetree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
8.7 dbmmanage-ManageuserauthenticationfilesinDBMformat . . . . . . . . . . . . . . . . . . . 284
8.8 htcacheclean-Cleanupthediskcache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
8.9 htdbm-ManipulateDBMpassworddatabases . . . . . . . . . . . . . . . . . . . . . . . . . . . . 287
8.10 htdigest-manageuserfilesfordigestauthentication . . . . . . . . . . . . . . . . . . . . . . . . . 290
8.11 htpasswd-Manageuserfilesforbasicauthentication . . . . . . . . . . . . . . . . . . . . . . . . 291
8.12 httxt2dbm-GeneratedbmfilesforusewithRewriteMap . . . . . . . . . . . . . . . . . . . . . . 294
8.13 logresolve-ResolveIP-addressestohostnamesinApachelogfiles . . . . . . . . . . . . . . . . . 295
8.14 rotatelogs-PipedloggingprogramtorotateApachelogs . . . . . . . . . . . . . . . . . . . . . . 296
8.15 suexec-Switchuserbeforeexecutingexternalprograms. . . . . . . . . . . . . . . . . . . . . . . 298
8.16 OtherPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 299
9 ApacheMiscellaneousDocumentation 301
9.1 ApacheMiscellaneousDocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 302
9.2 ApachePerformanceTuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
9.3 SecurityTips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 315
9.4 RelevantStandards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 319
9.5 PasswordFormats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 321
10 Apachemodules 325
10.1 TermsUsedtoDescribeModules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
10.2 TermsUsedtoDescribeDirectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 327
10.3 ApacheModulecore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 330
10.4 ApacheModulemod actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 375
10.5 ApacheModulemod alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 377
10.6 ApacheModulemod asis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 384
10.7 ApacheModulemod auth basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 386
10.8 ApacheModulemod auth digest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 388
vi CONTENTS
10.9 ApacheModulemod authn alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
10.10 ApacheModulemod authn anon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 394
10.11 ApacheModulemod authn dbd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
10.12 ApacheModulemod authn dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
10.13 ApacheModulemod authn default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 402
10.14 ApacheModulemod authn file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 403
10.15 ApacheModulemod authnz ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
10.16 ApacheModulemod authz dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 417
10.17 ApacheModulemod authz default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
10.18 ApacheModulemod authz groupfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 420
10.19 ApacheModulemod authz host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 422
10.20 ApacheModulemod authz owner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 426
10.21 ApacheModulemod authz user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428
10.22 ApacheModulemod autoindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 429
10.23 ApacheModulemod cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 441
10.24 ApacheModulemod cern meta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 451
10.25 ApacheModulemod cgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
10.26 ApacheModulemod cgid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 456
10.27 ApacheModulemod charset lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 458
10.28 ApacheModulemod dav . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 461
10.29 ApacheModulemod dav fs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 465
10.30 ApacheModulemod dav lock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 466
10.31 ApacheModulemod dbd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467
10.32 ApacheModulemod deflate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 472
10.33 ApacheModulemod dir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
10.34 ApacheModulemod disk cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 481
10.35 ApacheModulemod dumpio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 484
10.36 ApacheModulemod echo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 486
10.37 ApacheModulemod env . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 487
10.38 ApacheModulemod example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 489
10.39 ApacheModulemod expires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 491
10.40 ApacheModulemod ext filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 494
10.41 ApacheModulemod file cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 500
10.42 ApacheModulemod filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 503
10.43 ApacheModulemod headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
10.44 ApacheModulemod ident . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 515
10.45 ApacheModulemod imagemap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 517
CONTENTS vii
10.46 ApacheModulemod include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 521
10.47 ApacheModulemod info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
10.48 ApacheModulemod isapi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
10.49 ApacheModulemod ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 539
10.50 ApacheModulemod log config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 548
10.51 ApacheModulemod log forensic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 554
10.52 ApacheModulemod logio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 556
10.53 ApacheModulemod mem cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 557
10.54 ApacheModulemod mime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 561
10.55 ApacheModulemod mime magic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 574
10.56 ApacheModulemod negotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 578
10.57 ApacheModulemod nw ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
10.58 ApacheModulemod proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 583
10.59 ApacheModulemod proxy ajp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 607
10.60 ApacheModulemod proxy balancer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 616
10.61 ApacheModulemod proxy connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622
10.62 ApacheModulemod proxy ftp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 623
10.63 ApacheModulemod proxy http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625
10.64 ApacheModulemod proxy scgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627
10.65 ApacheModulemod reqtimeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629
10.66 ApacheModulemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631
10.67 ApacheModulemod setenvif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 648
10.68 ApacheModulemod so . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 652
10.69 ApacheModulemod speling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
10.70 ApacheModulemod ssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656
10.71 ApacheModulemod status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685
10.72 ApacheModulemod substitute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 687
10.73 ApacheModulemod suexec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689
10.74 ApacheModulemod unique id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 690
10.75 ApacheModulemod userdir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 692
10.76 ApacheModulemod usertrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 694
10.77 ApacheModulemod version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 698
10.78 ApacheModulemod vhost alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 700
10.79 ApacheModulebeos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 704
10.80 ApacheModulempm common . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 706
10.81 ApacheModuleevent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 719
10.82 ApacheModulempm netware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 721
viii CONTENTS
10.83 ApacheModulempmt os2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 723
10.84 ApacheModuleprefork . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 724
10.85 ApacheModulempm winnt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 727
10.86 ApacheModuleworker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 729
11 DeveloperDocumentation 731
11.1 DeveloperDocumentationforApache2.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 732
11.2 Apache1.3APInotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733
11.3 DebuggingMemoryAllocationinAPR . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 749
11.4 DocumentingApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750
11.5 Apache2.0HookFunctions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 751
11.6 ConvertingModulesfromApache1.3toApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . 754
11.7 RequestProcessingintheApacheHTTPServer2.x . . . . . . . . . . . . . . . . . . . . . . . . . 758
11.8 HowfiltersworkinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 762
11.9 Apache2.0ThreadSafetyIssues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 765
12 GlossaryandIndex 769
12.1 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 770
12.2 ModuleIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 775
12.3 DirectiveQuickReference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778
Chapter 1
Release Notes
1
2 CHAPTER1. RELEASENOTES
1.1 Upgrading to 2.2 from 2.0
Inordertoassistfolksupgrading, wemaintainadocumentdescribinginformationcriticaltoexistingApacheusers.
Theseareintendedtobebriefnotes,andyoushouldbeabletofindmoreinformationineithertheNewFeatures(p.4)
document,orinthesrc/CHANGESfile.
This document describes only the changes from 2.0 to 2.2. If you are upgrading from version 1.3, you should also
consultthe1.3to2.0upgradingdocument.1
Seealso
• OverviewofnewfeaturesinApache2.2(p.4)
Compile-TimeConfigurationChanges
The compilation process is very similar to the one used in version 2.0. Your old configure command line (as
foundinbuild/config.niceintheinstalledserverdirectory)canbeusedinsomecases. Themostsignificant
changerequiredwillbetoaccountforchangesinmodulenames,inparticularfortheauthenticationandauthorization
modules. Somedetailsofchanges:
• mod imaphasbeenrenamedtoMOD IMAGEMAP
• mod auth has been split up into MOD AUTH BASIC, MOD AUTHN FILE, MOD AUTHZ USER, and
MOD AUTHZ GROUPFILE
• mod accesshasbeenrenamedtoMOD AUTHZ HOST
• mod auth ldaphasbeenrenamedtoMOD AUTHNZ LDAP
• UpgradedtorequiretheAPR1.0API.
• UpdatedbundledPCREversionto5.0
Run-TimeConfigurationChanges
Your existing version 2.0 config files and startup scripts can usually be used unchanged in version 2.2. Some small
adjustmentsmaybenecessaryforparticularconfigurationsasdiscussedbelow. Inaddition,ifyoudynamicallyload
thestandardmodulesusingtheLOADMODULEdirective,thenyouwillneedtoaccountforthemodulenamechanges
mentionedabove.
Ifyouchoosetousethenewdefaultconfigurationfileforversion2.2,youwillfindthatithasbeengreatlysimplifiedby
removingallbutthemostessentialconfigurationsettings. Asetofexampleconfigurationsettingsformoreadvanced
featuresispresentintheconf/extra/directoryoftheinstalledserver. Defaultconfigurationfilesareinstalledin
theconf/originaldirectory.
Someruntimeconfigurationchangesthatyoumaynotice:
• The apachectl option startssl is no longer available. To enable SSL support, you should edit
httpd.conftoincludetherelevantMOD SSLdirectivesandthenuseapachectl starttostarttheserver.
AnexampleconfigurationtoactivateMOD SSLhasbeenincludedinconf/extra/httpd-ssl.conf.
• ThedefaultsettingofUSECANONICALNAMEisnowOff. Ifyoudidnothavethisdirectiveinyourconfigfile,
youcanaddUseCanonicalName Ontoretaintheoldbehavior.
• The module MOD USERDIR will no longer act on requests unless a USERDIR directive specifying a direc-
tory name is present in the config file. To restore the old default behavior, place the directive UserDir
public htmlinyourconfigfile.
1http://httpd.apache.org/docs/2.0/upgrading.html
Description:Apache Tutorial: Introduction to Server Side Includes . 751. 11.6. Converting Modules from Apache 1.3 to Apache 2.0 used to generate dbm files from text input, for use in REWRITEMAP with the dbm map type They may be customized by the administrator to achieve a consistent look and feel.