ebook img

LocalSystem - The Apache Software Foundation! PDF

799 Pages·2014·2.49 MB·English
Save to my drive
Quick download
Download
Most books are stored in the elastic cloud where traffic is expensive. For this reason, we have a limit on daily download.

Preview LocalSystem - The Apache Software Foundation!

Apache 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:
Aug 23, 2014 This version of the Apache HTTP Server Documentation is converted from XML source files to LATEX using XSLT with the help of Apache Ant,
See more

The list of books you might like

Most books are stored in the elastic cloud where traffic is expensive. For this reason, we have a limit on daily download.