~ubuntu-branches/ubuntu/intrepid/apache2/intrepid

« back to all changes in this revision

Viewing changes to debian/apache2.8

  • Committer: Bazaar Package Importer
  • Author(s): Stefan Fritsch, Stefan Fritsch, Peter Samuelson
  • Date: 2007-07-01 19:57:51 UTC
  • mfrom: (0.8.1 upstream)
  • Revision ID: james.westby@ubuntu.com-20070701195751-kcags6dpm5up3li5
Tags: 2.2.4-1
[ Stefan Fritsch ]
* Urgency medium for security fix
* Fix CVE-2007-1863: DoS in mod_cache
* New upstream version (Closes: #427050)
  - Fixes "proxy: error reading status line from remote server"
    (Closes: #410331)
* Fix CVE-2007-1862: mod_mem_cache DoS (introduced in 2.2.4)
* Change logrotate script to use reload instead of restart.
  (Closes: #298689)
* chmod o-rx /var/log/apache2 (Closes: #291841)
* chmod o-x suexec (Closes: #431048)
* Update patch for truncated mod_cgi 500 responses from upstream SVN
  (Closes: #412580)
* Don't use AddDefaultCharset for our docs (Closes: #414429)
* fix options syntax in sites-available/default (Closes: #419539)
* Move conf.d include to the end of apache2.conf (Closes: #305933)
* Remove log, cache, and lock files on purge (Closes: #428887)
* Ship /usr/lib/cgi-bin (Closes: #415698)
* Add note to README.Debian how to read docs (Closes: #350822)
* Document pid file name (Closes: #350286)
* Update Standards-Version (no changes needed)
* Fix some lintian warnings, add some overrides
* Start apache when doing a "restart" even if it was not running
  (Closes: #384682)
* reload config in apache2-doc postinst (Closes: #289289)
* don't fail in prerm if apache is not running (Closes: #418536)
* Suggest apache2-doc and www-browser (Closes: #399056)
* Make init script always display a warning if NO_START=1 since
  VERBOSE=yes is not the default anymore (Closes: #430116)
* Replace apache2(8) man page with a more current version
* Add httxt2dbm(8) man page
* Show -X option in help message (Closes: #391817)
* remove sick-hack-to-update-modules
* don't depend on procps on hurd (Closes: #431125)

[ Peter Samuelson ]
* Add shlibs:Depends to apache2.2-common.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.TH apache2 8 "February 1997"
2
 
.\" The Apache Software License, Version 1.1
3
 
.\"
4
 
.\" Copyright (c) 2000-2002 The Apache Software Foundation.  All rights
5
 
.\" reserved.
6
 
.\"
7
 
.\" Redistribution and use in source and binary forms, with or without
8
 
.\" modification, are permitted provided that the following conditions
9
 
.\" are met:
10
 
.\"
11
 
.\" 1. Redistributions of source code must retain the above copyright
12
 
.\"    notice, this list of conditions and the following disclaimer.
13
 
.\"
14
 
.\" 2. Redistributions in binary form must reproduce the above copyright
15
 
.\"    notice, this list of conditions and the following disclaimer in
16
 
.\"    the documentation and/or other materials provided with the
17
 
.\"    distribution.
18
 
.\"
19
 
.\" 3. The end-user documentation included with the redistribution,
20
 
.\"    if any, must include the following acknowledgment:
21
 
.\"       "This product includes software developed by the
22
 
.\"        Apache Software Foundation (http://www.apache.org/)."
23
 
.\"    Alternately, this acknowledgment may appear in the software itself,
24
 
.\"    if and wherever such third-party acknowledgments normally appear.
25
 
.\"
26
 
.\" 4. The names "Apache" and "Apache Software Foundation" must
27
 
.\"    not be used to endorse or promote products derived from this
28
 
.\"    software without prior written permission. For written
29
 
.\"    permission, please contact apache@apache.org.
30
 
.\"
31
 
.\" 5. Products derived from this software may not be called "Apache",
32
 
.\"    nor may "Apache" appear in their name, without prior written
33
 
.\"    permission of the Apache Software Foundation.
34
 
.\"
35
 
.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
36
 
.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
37
 
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
38
 
.\" DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
39
 
.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40
 
.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
41
 
.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
42
 
.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
43
 
.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
44
 
.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
45
 
.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
46
 
.\" SUCH DAMAGE.
47
 
.\"
48
 
.\" This software consists of voluntary contributions made by many
49
 
.\" individuals on behalf of the Apache Software Foundation.  For more
50
 
.\" information on the Apache Software Foundation, please see
51
 
.\" <http://www.apache.org/>.
52
 
.\"
 
1
.TH "APACHE2" 8 "2005-09-20" "Apache HTTP Server" "apache2"
 
2
 
53
3
.SH NAME
54
 
apache2 \- Apache hypertext transfer protocol server
55
 
.SH SYNOPSIS
56
 
.B apache2 
57
 
[
58
 
.BI \-d " serverroot"
59
 
] [
60
 
.BI \-f " config"
61
 
] [
62
 
.BI \-C " directive"
63
 
] [
64
 
.BI \-c " directive"
65
 
] [
66
 
.BI \-D " parameter"
67
 
]
68
 
 
69
 
.B apache2 
70
 
[
71
 
.B \-h
72
 
73
 
[
74
 
.B \-l
75
 
76
 
[
77
 
.B \-L
78
 
79
 
[
80
 
.B \-v
81
 
82
 
[
83
 
.B \-V
84
 
85
 
[
86
 
.B \-t
87
 
88
 
[
89
 
.B \-X
90
 
]
91
 
 
92
 
.SH DESCRIPTION
93
 
.B apache2
94
 
is the Apache HyperText Transfer Protocol (HTTP) server program. It is
95
 
designed to be run as a standalone daemon process. When used like this
96
 
it will create a pool of child processes to handle requests. To stop
97
 
it, send a TERM signal to the initial (parent) process. The PID of
98
 
this process is written to a file as given in the configuration file.
99
 
.PP
100
 
This manual page only lists the command line arguments. For details
101
 
of the directives necessary to configure 
102
 
.B apache2
103
 
see the Apache manual,
104
 
which is part of the Apache distribution or can be found at
105
 
http://httpd.apache.org/. Paths in this manual may not reflect those
106
 
compiled into 
107
 
.B apache2.
108
 
.SH OPTIONS
109
 
.TP 12
110
 
.BI \-d " serverroot"
111
 
Set the initial value for the ServerRoot directive to \fIserverroot\fP. This
112
 
can be overridden by the ServerRoot command in the configuration file. The
113
 
default is \fB/usr/local/apache2\fP.
114
 
.TP
115
 
.BI \-f " config"
116
 
Execute the commands in the file \fIconfig\fP on startup. If \fIconfig\fP
117
 
does not begin with a /, then it is taken to be a path relative to
118
 
the ServerRoot. The default is \fBconf/apache2.conf\fP.
119
 
.TP
120
 
.BI \-C " directive"
121
 
Process the configuration \fIdirective\fP before reading config files.
122
 
.TP
123
 
.BI \-c " directive"
124
 
Process the configuration \fIdirective\fP after reading config files.
125
 
.TP
126
 
.BI \-D " parameter"
127
 
Sets a configuration \fIparameter\fP which can be used with
128
 
<IfDefine>...</IfDefine> sections in the configuration files
129
 
to conditionally skip or process commands.
130
 
.TP
131
 
.B \-h
132
 
Output a short summary of available command line options.
133
 
.TP
134
 
.B \-l
135
 
Output a list of modules compiled into the server.
136
 
.TP
137
 
.B \-L
138
 
Output a list of directives together with expected arguments and
139
 
places where the directive is valid.
140
 
.TP
141
 
.B \-S
142
 
Show the settings as parsed from the config file (currently only shows the
143
 
virtualhost settings).
144
 
.TP
145
 
.B \-t
146
 
Run syntax tests for configuration files only. The program immediately exits
147
 
after these syntax parsing with either a return code of 0 (Syntax OK) or
148
 
return code not equal to 0 (Syntax Error).  If 
149
 
.BI \-D " DUMP_VHOSTS"
150
 
is also set, details of the virtual host configuration will be printed.
151
 
.TP
152
 
.B \-v
153
 
Print the version of 
154
 
.B apache2
155
 
, and then exit.
156
 
.TP
157
 
.B \-V
158
 
Print the version and build parameters of 
159
 
.B apache2
160
 
, and then exit.
161
 
.TP
162
 
.B \-X
163
 
Run
164
 
.B apache2
165
 
in debug mode.  Only one worker will be started and the server will not detach
166
 
from the console.
167
 
.SH FILES
168
 
.PD 0
169
 
.B /usr/local/apache2/conf/apache2.conf
170
 
.br
171
 
.B /usr/local/apache2/conf/mime.types
172
 
.br
173
 
.B /usr/local/apache2/conf/magic
174
 
.br
175
 
.B /usr/local/apache2/logs/error_log
176
 
.br
177
 
.B /usr/local/apache2/logs/access_log
178
 
.br
179
 
.B /usr/local/apache2/logs/apache2.pid
 
4
apache2 \- Apache Hypertext Transfer Protocol Server
 
5
 
 
6
.SH "SYNOPSIS"
 
7
 
 
8
.PP
 
9
\fBapache2\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 ]
 
10
 
 
11
 
 
12
.SH "SUMMARY"
 
13
 
 
14
.PP
 
15
apache2 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\&.
 
16
 
 
17
.PP
 
18
In general, apache2 should not be invoked directly, but rather should be invoked via /etc/init.d/apache2\&.
 
19
 
 
20
.PP
 
21
The full documentation is available in the apache2-doc package or at http://httpd.apache.org/docs/2.2/
 
22
 
 
23
 
 
24
.SH "OPTIONS"
 
25
 
 
26
 
 
27
.TP
 
28
-d \fIserverroot\fR
 
29
Set the initial value for the ServerRoot directive to \fIserverroot\fR\&. This can be overridden by the ServerRoot directive in the configuration file\&.
 
30
.TP
 
31
-f \fIconfig\fR
 
32
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 /etc/apache2/apache2\&.conf\&.  
 
33
.TP
 
34
-k start|restart|graceful|stop|graceful-stop
 
35
Signals apache2 to start, restart, or stop\&. See Stopping Apache for more information\&.  
 
36
.TP
 
37
-C \fIdirective\fR
 
38
Process the configuration \fIdirective\fR before reading config files\&.  
 
39
.TP
 
40
-c \fIdirective\fR
 
41
Process the configuration \fIdirective\fR after reading config files\&.  
 
42
.TP
 
43
-D \fIparameter\fR
 
44
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\&.  
 
45
.TP
 
46
-e \fIlevel\fR
 
47
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\&.  
 
48
.TP
 
49
-E \fIfile\fR
 
50
Send error messages during server startup to \fIfile\fR\&.  
 
51
.TP
 
52
-R \fIdirectory\fR
 
53
When the server is compiled using the SHARED_CORE rule, this specifies the \fIdirectory\fR for the shared object files\&.  
 
54
.TP
 
55
-h
 
56
Output a short summary of available command line options\&.  
 
57
.TP
 
58
-l
 
59
Output a list of modules compiled into the server\&. This will \fBnot\fR list dynamically loaded modules included using the LoadModule directive\&.  
 
60
.TP
 
61
-L
 
62
Output a list of directives together with expected arguments and places where the directive is valid\&.  
 
63
.TP
 
64
-M
 
65
Dump a list of loaded Static and Shared Modules\&.  
 
66
.TP
 
67
-S
 
68
Show the settings as parsed from the config file (currently only shows the virtualhost settings)\&.  
 
69
.TP
 
70
-t
 
71
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\&.  
 
72
.TP
 
73
-v
 
74
Print the version of apache2, and then exit\&.  
 
75
.TP
 
76
-V
 
77
Print the version and build parameters of apache2, and then exit\&.  
 
78
.TP
 
79
-X
 
80
Run apache2 in debug mode\&. Only one worker will be started and the server will not detach from the console\&.  
 
81