apache_eng.pdf

APACHE

An HTTP Server

Reference Manual

David Robinson and the Apache Group, 1995.

http://www.apache.org/

licences restricting its use, copying, distribution and decompilation. See the Apache licence for details.

The copyright owner gives no warranties and makes no representations about the contents of this

manual and specically disclaims warranties of merchantability or tness for any purpose.

The copyright owner reserves the right to revise this manual and to make changes from time to time

in its contents without notifying any person of such revision or changes.

TRADEMARKS

Unix is a registered trademark of UNIX System Laboratories, Inc. Sun and SunOS are trademarks

of Sun Microsystems, Inc. Netscape is a trademark of Netscape Communications Corporation. All

other product names mentioned herein are the trademarks of their respective owners.

Contents

Preface

1 Compiling and Installing Apache 1

1.1 Downloading Apache : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 1

1.2 Compiling Apache : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 1

1.3 Installing Apache : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 2

2 Starting Apache 3

2.1 Invoking Apache : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 3

2.2 Command line options : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 3

2.3 Conguration les : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 4

2.4 Log les : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 4

2.4.1 pid le : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 4

2.4.2 Error log : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 4

2.4.3 Transfer log : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 4

3 Apache Core Features 5

3.1 AccessCong directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 5

3.2 AccessFileName directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 5

3.3 AllowOverride directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 6

3.4 AuthName directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 6

3.5 AuthType directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 7

3.6 BindAddress directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 7

3.7 DefaultType directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 7

3.8 < Directory > directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 8

3.9 DocumentRoot directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 9

3.10 ErrorDocument directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 9

3.11 ErrorLog directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 10

3.12 Group directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 10

3.13 IdentityCheck directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 10

3.14 < Limit > directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 11

3.15 MaxClients directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 11

3.16 MaxRequestsPerChild directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 11

3.17 MaxSpareServers directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 12

3.18 MinSpareServers directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 12

3.19 Options directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 12

3.20 PidFile directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 13

3.21 Port directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 14

3.22 require directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 14

3.23 ResourceCong directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 15

iii

CONTENTS

3.24 ServerAdmin directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 15

3.25 ServerName directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 16

3.26 ServerRoot directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 16

3.27 ServerType directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 16

3.28 StartServers directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 17

3.29 TimeOut directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 17

3.30 User directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 17

3.31 < VirtualHost > directive : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 18

4 Apache Standard Modules 19

4.1 Module mod access : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 19

4.1.1 allow : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 19

4.1.2 deny : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 20

4.1.3 order : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 20

4.2 Module mod alias : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 21

4.2.1 Alias : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 21

4.2.2 Redirect : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 21

4.2.3 ScriptAlias : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 22

4.3 Module mod asis : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 22

4.3.1 Purpose : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 22

4.3.2 Usage : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 22

4.4 Module mod auth : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 23

4.4.1 AuthGroupFile : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 23

4.4.2 AuthUserFile : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 24

4.5 Module mod cgi : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 24

4.5.1 Summary : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 24

4.5.2 CGI Environment variables : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 25

4.6 Module mod dir : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 25

4.6.1 Summary : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 25

4.6.2 AddDescription : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 25

4.6.3 AddIcon : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 26

4.6.4 AddIconByEncoding : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 26

4.6.5 AddIconByType : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 26

4.6.6 DefaultIcon : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 27

4.6.7 DirectoryIndex : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 27

4.6.8 FancyIndexing : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 28

4.6.9 HeaderName : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 28

4.6.10 IndexIgnore : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 28

4.6.11 IndexOptions : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 29

4.6.12 ReadmeName : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 29

4.7 Module mod imap : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 30

4.7.1 Summary : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 30

4.7.2 New Features : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 30

4.8 Module mod include : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 31

4.8.1 SPML { Include le Format : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 31

4.8.2 Include variables : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 33

4.8.3 XBitHack : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 33

4.9 Module mod log common : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 34

4.9.1 Log le format : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 34

4.9.2 TransferLog : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 35

4.10 Module mod mime : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 35

CONTENTS

4.10.1 Summary : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 35

4.10.2 AddEncoding : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 36

4.10.3 AddLanguage : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 36

4.10.4 AddType : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 37

4.10.5 TypesCong : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 37

4.11 Module mod negotiation : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 37

4.11.1 Summary : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 38

4.11.2 LanguagePriority : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 39

4.12 Module mod userdir : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 39

4.12.1 UserDir : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 39

5 Apache Extension Modules 41

5.1 Module mod auth dbm : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 41

5.1.1 AuthDbmGroupFile : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 41

5.1.2 AuthDBMUserFile : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 41

5.2 Module mod cookies : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 42

5.2.1 CookieLog : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 42

5.3 Module mod dld : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 42

5.3.1 Summary : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 42

5.3.2 LoadFile : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 43

5.3.3 LoadModule : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 43

5.4 Module mod log agent : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 43

5.4.1 AgentLog : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 43

5.5 Module mod log cong : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 44

5.5.1 Summary : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 44

5.5.2 LogFormat : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 45

5.5.3 TransferLog : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 45

5.6 Module mod log referer : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 46

5.6.1 Log le format : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 46

5.6.2 RefererIgnore : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 46

5.6.3 RefererLog : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 46

6 Apache API notes 49

6.1 Basic concepts. : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 50

6.1.1 Handlers, Modules, and Requests : : : : : : : : : : : : : : : : : : : : : : : : : : 50

6.1.2 A brief tour of a module : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 51

6.2 How handlers work : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 52

6.2.1 A brief tour of the request rec : : : : : : : : : : : : : : : : : : : : : : : : : : 52

6.2.2 Where request rec structures come from : : : : : : : : : : : : : : : : : : : : : : 54

6.2.3 Handling requests, declining, and returning error codes : : : : : : : : : : : : : 54

6.2.4 Special considerations for response handlers : : : : : : : : : : : : : : : : : : : : 55

6.2.5 Special considerations for authentication handlers : : : : : : : : : : : : : : : : : 56

6.2.6 Special considerations for logging handlers : : : : : : : : : : : : : : : : : : : : : 56

6.3 Resource allocation and resource pools : : : : : : : : : : : : : : : : : : : : : : : : : : : 56

6.3.1 Allocation of memory in pools : : : : : : : : : : : : : : : : : : : : : : : : : : : 57

6.3.2 Allocating initialized memory : : : : : : : : : : : : : : : : : : : : : : : : : : : : 58

6.3.3 Tracking open les, etc. : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : : 58

6.3.4 Other sorts of resources | cleanup functions : : : : : : : : : : : : : : : : : : : 58

6.3.5 Fine control | creating and dealing with sub-pools, with a note on sub-requests 59

6.4 Conguration, commands and the like : : : : : : : : : : : : : : : : : : : : : : : : : : : 59

6.4.1 Per-directory conguration structures : : : : : : : : : : : : : : : : : : : : : : : 60

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: