Apache HTTP Server Documentation Version 2.4 - Ftp - / :: Oregon State University Open Source Lab

1125 Pages·2017·4.15 MB·English

by  Apache Software Foundation

Apache HTTP Server Documentation Version 2.4
ApacheSoftwareFoundation
March21,2018
ii
About The PDF Documentation
LicensedtotheApacheSoftwareFoundation(ASF)underoneormorecontributorlicenseagreements. SeetheNO-
TICEfiledistributedwiththisworkforadditionalinformationregardingcopyrightownership. TheASFlicensesthis
filetoYouundertheApacheLicense,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.4/
TheApacheHTTPServerDocumentationismaintainedbytheApacheHTTPServerDocumentationProject. More
informationisavailableathttp://httpd.apache.org/docs-project/
Contents
1 ReleaseNotes 1
1.1 Upgradingto2.4from2.2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
1.2 OverviewofnewfeaturesinApacheHTTPServer2.4 . . . . . . . . . . . . . . . . . . . . . . . . 9
1.3 OverviewofnewfeaturesinApacheHTTPServer2.2 . . . . . . . . . . . . . . . . . . . . . . . . 13
1.4 OverviewofnewfeaturesinApacheHTTPServer2.0 . . . . . . . . . . . . . . . . . . . . . . . . 16
1.5 TheApacheLicense,Version2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
2 UsingtheApacheHTTPServer 21
2.1 CompilingandInstalling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
2.2 StartingApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
2.3 StoppingandRestartingApacheHTTPServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
2.4 ConfigurationFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
2.5 ConfigurationSections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
2.6 CachingGuide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
2.7 Server-WideConfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
2.8 LogFiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
2.9 MappingURLstoFilesystemLocations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
2.10 DynamicSharedObject(DSO)Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68
2.11 ContentNegotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
2.12 CustomErrorResponses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
2.13 BindingtoAddressesandPorts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
2.14 Multi-ProcessingModules(MPMs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
2.15 EnvironmentVariablesinApache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
2.16 ExpressionsinApacheHTTPServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
2.17 Apache’sHandlerUse . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
2.18 Filters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
2.19 SharedObjectCacheinApacheHTTPServer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
2.20 suEXECSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108
2.21 IssuesRegardingDNSandApacheHTTPServer . . . . . . . . . . . . . . . . . . . . . . . . . . 114
iii
iv CONTENTS
3 ApacheVirtualHostdocumentation 117
3.1 ApacheVirtualHostdocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 118
3.2 Name-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
3.3 ApacheIP-basedVirtualHostSupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
3.4 DynamicallyConfiguredMassVirtualHosting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
3.5 VirtualHostExamples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 129
3.6 AnIn-DepthDiscussionofVirtualHostMatching . . . . . . . . . . . . . . . . . . . . . . . . . . 136
3.7 FileDescriptorLimits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
4 URLRewritingGuide 141
4.1 Apachemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
4.2 Apachemod rewriteIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 143
4.3 RedirectingandRemappingwithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
4.4 Usingmod rewritetocontrolaccess . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155
4.5 Dynamicmassvirtualhostswithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
4.6 Usingmod rewriteforProxying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
4.7 UsingRewriteMap. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
4.8 AdvancedTechniqueswithmod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 168
4.9 Whennottousemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 171
4.10 RewriteRuleFlags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 174
4.11 Apachemod rewriteTechnicalDetails . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
5 ApacheSSL/TLSEncryption 187
5.1 ApacheSSL/TLSEncryption . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 188
5.2 SSL/TLSStrongEncryption: AnIntroduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . 189
5.3 SSL/TLSStrongEncryption: Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
5.4 SSL/TLSStrongEncryption: How-To . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
5.5 SSL/TLSStrongEncryption: FAQ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 208
6 Guides,Tutorials,andHowTos 221
6.1 How-To/Tutorials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 222
6.2 AuthenticationandAuthorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
6.3 AccessControl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 230
6.4 ApacheTutorial: DynamicContentwithCGI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 232
6.5 ApachehttpdTutorial: IntroductiontoServerSideIncludes . . . . . . . . . . . . . . . . . . . . . 239
6.6 ApacheHTTPServerTutorial: .htaccessfiles . . . . . . . . . . . . . . . . . . . . . . . . . . . . 245
6.7 Per-userwebdirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
6.8 ReverseProxyGuide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 254
6.9 HTTP/2guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 261
CONTENTS v
7 Platform-specificNotes 267
7.1 PlatformSpecificNotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 268
7.2 UsingApacheHTTPServeronMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . 269
7.3 CompilingApacheforMicrosoftWindows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 277
7.4 UsingApacheWithRPMBasedSystems(Redhat/CentOS/Fedora) . . . . . . . . . . . . . . . . 283
7.5 UsingApacheWithNovellNetWare . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 286
7.6 RunningaHigh-PerformanceWebServeronHPUX . . . . . . . . . . . . . . . . . . . . . . . . . 294
7.7 TheApacheEBCDICPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 295
8 ApacheHTTPServerandSupportingPrograms 299
8.1 ServerandSupportingPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 300
8.2 httpd-ApacheHypertextTransferProtocolServer . . . . . . . . . . . . . . . . . . . . . . . . . . 301
8.3 ab-ApacheHTTPserverbenchmarkingtool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 303
8.4 apachectl-ApacheHTTPServerControlInterface. . . . . . . . . . . . . . . . . . . . . . . . . . 307
8.5 apxs-APacheeXtenSiontool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 309
8.6 configure-Configurethesourcetree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 313
8.7 dbmmanage-ManageuserauthenticationfilesinDBMformat . . . . . . . . . . . . . . . . . . . 321
8.8 fcgistarter-StartaFastCGIprogram . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 323
8.9 htcacheclean-Cleanupthediskcache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 324
8.10 htdbm-ManipulateDBMpassworddatabases . . . . . . . . . . . . . . . . . . . . . . . . . . . . 326
8.11 htdigest-manageuserfilesfordigestauthentication . . . . . . . . . . . . . . . . . . . . . . . . . 329
8.12 htpasswd-Manageuserfilesforbasicauthentication . . . . . . . . . . . . . . . . . . . . . . . . 330
8.13 httxt2dbm-GeneratedbmfilesforusewithRewriteMap . . . . . . . . . . . . . . . . . . . . . . 333
8.14 logresolve-ResolveIP-addressestohostnamesinApachelogfiles . . . . . . . . . . . . . . . . . 334
8.15 log server status-Logperiodicstatussummaries . . . . . . . . . . . . . . . . . . . . . . . . . . 335
8.16 rotatelogs-PipedloggingprogramtorotateApachelogs . . . . . . . . . . . . . . . . . . . . . . 336
8.17 split-logfile-Splitupmulti-vhostlogfiles. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 339
8.18 suexec-Switchuserbeforeexecutingexternalprograms. . . . . . . . . . . . . . . . . . . . . . . 340
8.19 OtherPrograms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 341
9 ApacheMiscellaneousDocumentation 343
9.1 ApacheMiscellaneousDocumentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 344
9.2 ApachePerformanceTuning . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
9.3 SecurityTips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 356
9.4 RelevantStandards . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 361
9.5 PasswordFormats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 363
vi CONTENTS
10 Apachemodules 367
10.1 TermsUsedtoDescribeModules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 368
10.2 TermsUsedtoDescribeDirectives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 369
10.3 ApacheModulecore. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
10.4 ApacheModulemod access compat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432
10.5 ApacheModulemod actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 437
10.6 ApacheModulemod alias. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 439
10.7 ApacheModulemod allowmethods. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 446
10.8 ApacheModulemod asis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 447
10.9 ApacheModulemod auth basic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 449
10.10 ApacheModulemod auth digest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 453
10.11 ApacheModulemod auth form . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 457
10.12 ApacheModulemod authn anon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 468
10.13 ApacheModulemod authn core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 471
10.14 ApacheModulemod authn dbd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 475
10.15 ApacheModulemod authn dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 478
10.16 ApacheModulemod authn file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 480
10.17 ApacheModulemod authn socache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 482
10.18 ApacheModulemod authnz fcgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 485
10.19 ApacheModulemod authnz ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 492
10.20 ApacheModulemod authz core . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 510
10.21 ApacheModulemod authz dbd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 518
10.22 ApacheModulemod authz dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 522
10.23 ApacheModulemod authz groupfile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 525
10.24 ApacheModulemod authz host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 527
10.25 ApacheModulemod authz owner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 530
10.26 ApacheModulemod authz user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532
10.27 ApacheModulemod autoindex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533
10.28 ApacheModulemod brotli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
10.29 ApacheModulemod buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 551
10.30 ApacheModulemod cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 552
10.31 ApacheModulemod cache disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 567
10.32 ApacheModulemod cache socache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 571
10.33 ApacheModulemod cern meta . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 575
10.34 ApacheModulemod cgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577
10.35 ApacheModulemod cgid . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
10.36 ApacheModulemod charset lite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 582
CONTENTS vii
10.37 ApacheModulemod data . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 585
10.38 ApacheModulemod dav . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 586
10.39 ApacheModulemod dav fs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 589
10.40 ApacheModulemod dav lock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
10.41 ApacheModulemod dbd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 591
10.42 ApacheModulemod deflate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 596
10.43 ApacheModulemod dialup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 602
10.44 ApacheModulemod dir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 603
10.45 ApacheModulemod dumpio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 608
10.46 ApacheModulemod echo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 610
10.47 ApacheModulemod env . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 611
10.48 ApacheModulemod example hooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 613
10.49 ApacheModulemod expires . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 615
10.50 ApacheModulemod ext filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 618
10.51 ApacheModulemod file cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622
10.52 ApacheModulemod filter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 625
10.53 ApacheModulemod headers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 633
10.54 ApacheModulemod heartbeat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 640
10.55 ApacheModulemod heartmonitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 641
10.56 ApacheModulemod http2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 643
10.57 ApacheModulemod ident . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 654
10.58 ApacheModulemod imagemap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 656
10.59 ApacheModulemod include . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 660
10.60 ApacheModulemod info . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 673
10.61 ApacheModulemod isapi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 676
10.62 ApacheModulemod lbmethod bybusyness . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 680
10.63 ApacheModulemod lbmethod byrequests . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 681
10.64 ApacheModulemod lbmethod bytraffic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 683
10.65 ApacheModulemod lbmethod heartbeat. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 684
10.66 ApacheModulemod ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 685
10.67 ApacheModulemod log config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 697
10.68 ApacheModulemod log debug. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 703
10.69 ApacheModulemod log forensic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 705
10.70 ApacheModulemod logio . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 707
10.71 ApacheModulemod lua . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 709
10.72 ApacheModulemod macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 736
10.73 ApacheModulemod md . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 740
viii CONTENTS
10.74 ApacheModulemod mime . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 750
10.75 ApacheModulemod mime magic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 763
10.76 ApacheModulemod negotiation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 767
10.77 ApacheModulemod nw ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 771
10.78 ApacheModulemod privileges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 772
10.79 ApacheModulemod proxy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 778
10.80 ApacheModulemod proxy ajp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 805
10.81 ApacheModulemod proxy balancer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 814
10.82 ApacheModulemod proxy connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 818
10.83 ApacheModulemod proxy express . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 819
10.84 ApacheModulemod proxy fcgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 822
10.85 ApacheModulemod proxy fdpass . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 827
10.86 ApacheModulemod proxy ftp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 828
10.87 ApacheModulemod proxy hcheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 831
10.88 ApacheModulemod proxy html . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 835
10.89 ApacheModulemod proxy http . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 842
10.90 ApacheModulemod proxy http2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 844
10.91 ApacheModulemod proxy scgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 846
10.92 ApacheModulemod proxy uwsgi . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 849
10.93 ApacheModulemod proxy wstunnel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 850
10.94 ApacheModulemod ratelimit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 851
10.95 ApacheModulemod reflector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 852
10.96 ApacheModulemod remoteip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 853
10.97 ApacheModulemod reqtimeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 859
10.98 ApacheModulemod request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 861
10.99 ApacheModulemod rewrite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 862
10.100 ApacheModulemod sed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 876
10.101 ApacheModulemod session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 878
10.102 ApacheModulemod session cookie . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 885
10.103 ApacheModulemod session crypto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 888
10.104 ApacheModulemod session dbd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 892
10.105 ApacheModulemod setenvif . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 897
10.106 ApacheModulemod slotmem plain . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 901
10.107 ApacheModulemod slotmem shm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 902
10.108 ApacheModulemod so . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 903
10.109 ApacheModulemod socache dbm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 905
10.110 ApacheModulemod socache dc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 906
CONTENTS ix
10.111 ApacheModulemod socache memcache. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 907
10.112 ApacheModulemod socache shmcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 908
10.113 ApacheModulemod speling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 909
10.114 ApacheModulemod ssl. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 911
10.115 ApacheModulemod status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 951
10.116 ApacheModulemod substitute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 953
10.117 ApacheModulemod suexec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 956
10.118 ApacheModulemod unique id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 957
10.119 ApacheModulemod unixd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 959
10.120 ApacheModulemod userdir . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 962
10.121 ApacheModulemod usertrack . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 964
10.122 ApacheModulemod version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 967
10.123 ApacheModulemod vhost alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 969
10.124 ApacheModulemod watchdog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 973
10.125 ApacheModulemod xml2enc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 974
10.126 ApacheModulempm common . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 977
10.127 ApacheModuleevent . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 988
10.128 ApacheModulempm netware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 994
10.129 ApacheModulempmt os2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 996
10.130 ApacheModuleprefork . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 997
10.131 ApacheModulempm winnt. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1000
10.132 ApacheModuleworker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1002
11 DeveloperDocumentation 1005
11.1 DeveloperDocumentationfortheApacheHTTPServer2.4 . . . . . . . . . . . . . . . . . . . . . 1006
11.2 Apache1.3APInotes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1007
11.3 APIChangesinApacheHTTPServer2.4since2.2 . . . . . . . . . . . . . . . . . . . . . . . . . 1023
11.4 DevelopingmodulesfortheApacheHTTPServer2.4 . . . . . . . . . . . . . . . . . . . . . . . . 1030
11.5 DocumentingcodeinApache2.4 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1058
11.6 HookFunctionsintheApacheHTTPServer2.x . . . . . . . . . . . . . . . . . . . . . . . . . . . 1059
11.7 ConvertingModulesfromApache1.3toApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . 1062
11.8 RequestProcessingintheApacheHTTPServer2.x . . . . . . . . . . . . . . . . . . . . . . . . . 1066
11.9 HowfiltersworkinApache2.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1069
11.10 Guidetowritingoutputfilters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1072
11.11 ApacheHTTPServer2.xThreadSafetyIssues . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1079
x CONTENTS
12 GlossaryandIndex 1083
12.1 Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1084
12.2 ModuleIndex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1089
12.3 DirectiveQuickReference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1094