← Back to branch summary

~ubuntu-branches/ubuntu/feisty/apache2/feisty

« back to all changes in this revision

Viewing changes to docs/man/httpd.8

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Barth
  • Date: 2006-12-09 21:05:45 UTC
  • mfrom: (0.6.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20061209210545-h70s0xaqc2v8vqr2
Tags: 2.2.3-3.2
http://bugs.debian.org/396265
* Non-maintainer upload.
* 043_ajp_connection_reuse: Patch from upstream Bugzilla, fixing a critical
  issue with regard to connection reuse in mod_proxy_ajp.
  Closes: #396265

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/man/httpd.8
 
1
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
 
2
.\" DO NOT EDIT! Generated from XML source.
 
3
.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
 
4
.de Sh \" Subsection
 
5
.br
 
6
.if t .Sp
 
7
.ne 5
 
8
.PP
 
9
\fB\\$1\fR
 
10
.PP
 
11
..
 
12
.de Sp \" Vertical space (when we can't use .PP)
 
13
.if t .sp .5v
 
14
.if n .sp
 
15
..
 
16
.de Ip \" List item
 
17
.br
 
18
.ie \\n(.$>=3 .ne \\$3
 
19
.el .ne 3
 
20
.IP "\\$1" \\$2
 
21
..
 
22
.TH "HTTPD" 8 "2005-09-20" "Apache HTTP Server" "httpd"
 
23
 
 
24
.SH NAME
 
25
httpd \- Apache Hypertext Transfer Protocol Server
 
26
 
 
27
.SH "SYNOPSIS"
 
28
 
 
29
.PP
 
30
\fBhttpd\fR [ -\fBd\fR \fIserverroot\fR ] [ -\fBf\fR \fIconfig\fR ] [ -\fBC\fR \fIdirective\fR ] [ -\fBc\fR \fIdirective\fR ] [ -\fBD\fR \fIparameter\fR ] [ -\fBe\fR \fIlevel\fR ] [ -\fBE\fR \fIfile\fR ] [ \fB-k\fR start|restart|graceful|stop|graceful-stop ] [ -\fBR\fR \fIdirectory\fR ] [ -\fBh\fR ] [ -\fBl\fR ] [ -\fBL\fR ] [ -\fBS\fR ] [ -\fBt\fR ] [ -\fBv\fR ] [ -\fBV\fR ] [ -\fBX\fR ] [ -\fBM\fR ]
 
31
 
 
32
.PP
 
33
On Windows systems, the following additional arguments are available:
 
34
 
 
35
.PP
 
36
\fBhttpd\fR [ -\fBk\fR install|config|uninstall ] [ -\fBn\fR \fIname\fR ] [ -\fBw\fR ]
 
37
 
 
38
 
 
39
.SH "SUMMARY"
 
40
 
 
41
.PP
 
42
httpd is the Apache HyperText Transfer Protocol (HTTP) server program\&. It is designed to be run as a standalone daemon process\&. When used like this it will create a pool of child processes or threads to handle requests\&.
 
43
 
 
44
.PP
 
45
In general, httpd should not be invoked directly, but rather should be invoked via apachectl on Unix-based systems or as a service on Windows NT, 2000 and XP and as a console application on Windows 9x and ME\&.
 
46
 
 
47
 
 
48
.SH "OPTIONS"
 
49
 
 
50
 
 
51
.TP
 
52
-d \fIserverroot\fR
 
53
Set the initial value for the ServerRoot directive to \fIserverroot\fR\&. This can be overridden by the ServerRoot directive in the configuration file\&. The default is /usr/local/apache2\&.  
 
54
.TP
 
55
-f \fIconfig\fR
 
56
Uses the directives in the file \fIconfig\fR on startup\&. If \fIconfig\fR does not begin with a /, then it is taken to be a path relative to the ServerRoot\&. The default is conf/httpd\&.conf\&.  
 
57
.TP
 
58
-k start|restart|graceful|stop|graceful-stop
 
59
Signals httpd to start, restart, or stop\&. See Stopping Apache for more information\&.  
 
60
.TP
 
61
-C \fIdirective\fR
 
62
Process the configuration \fIdirective\fR before reading config files\&.  
 
63
.TP
 
64
-c \fIdirective\fR
 
65
Process the configuration \fIdirective\fR after reading config files\&.  
 
66
.TP
 
67
-D \fIparameter\fR
 
68
Sets a configuration \fIparameter \fRwhich can be used with <IfDefine> sections in the configuration files to conditionally skip or process commands at server startup and restart\&.  
 
69
.TP
 
70
-e \fIlevel\fR
 
71
Sets the LogLevel to \fIlevel\fR during server startup\&. This is useful for temporarily increasing the verbosity of the error messages to find problems during startup\&.  
 
72
.TP
 
73
-E \fIfile\fR
 
74
Send error messages during server startup to \fIfile\fR\&.  
 
75
.TP
 
76
-R \fIdirectory\fR
 
77
When the server is compiled using the SHARED_CORE rule, this specifies the \fIdirectory\fR for the shared object files\&.  
 
78
.TP
 
79
-h
 
80
Output a short summary of available command line options\&.  
 
81
.TP
 
82
-l
 
83
Output a list of modules compiled into the server\&. This will \fBnot\fR list dynamically loaded modules included using the LoadModule directive\&.  
 
84
.TP
 
85
-L
 
86
Output a list of directives together with expected arguments and places where the directive is valid\&.  
 
87
.TP
 
88
-M
 
89
Dump a list of loaded Static and Shared Modules\&.  
 
90
.TP
 
91
-S
 
92
Show the settings as parsed from the config file (currently only shows the virtualhost settings)\&.  
 
93
.TP
 
94
-t
 
95
Run syntax tests for configuration files only\&. The program immediately exits after these syntax parsing tests with either a return code of 0 (Syntax OK) or return code not equal to 0 (Syntax Error)\&. If -D \fIDUMP\fR_\fIVHOSTS \fRis also set, details of the virtual host configuration will be printed\&. If -D \fIDUMP\fR_\fIMODULES \fR is set, all loaded modules will be printed\&.  
 
96
.TP
 
97
-v
 
98
Print the version of httpd, and then exit\&.  
 
99
.TP
 
100
-V
 
101
Print the version and build parameters of httpd, and then exit\&.  
 
102
.TP
 
103
-X
 
104
Run httpd in debug mode\&. Only one worker will be started and the server will not detach from the console\&.  
 
105
 
 
106
.PP
 
107
The following arguments are available only on the Windows platform:
 
108
 
 
109
 
 
110
.TP
 
111
-k install|config|uninstall
 
112
Install Apache as a Windows NT service; change startup options for the Apache service; and uninstall the Apache service\&.  
 
113
.TP
 
114
-n \fIname\fR
 
115
The \fIname\fR of the Apache service to signal\&.  
 
116
.TP
 
117
-w
 
118
Keep the console window open on error so that the error message can be read\&.  
 
119