81 lines
3.9 KiB
Groff
81 lines
3.9 KiB
Groff
.TH "APACHE2" 8 "2008-04-05" "Apache HTTP Server" "apache2"
|
|
|
|
.SH NAME
|
|
apache2 \- Apache Hypertext Transfer Protocol Server
|
|
.SH "SYNOPSIS"
|
|
.PP
|
|
\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 ]
|
|
.SH "SUMMARY"
|
|
.PP
|
|
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\&.
|
|
.PP
|
|
In general, apache2 should not be invoked directly, but rather should be
|
|
invoked via /etc/init.d/apache2 or apache2ctl\&. The default Debian
|
|
configuration requires environment variables that are defined in
|
|
/etc/apache2/envvars and are not available if apache2 is started directly.
|
|
However, apache2ctl can be used to pass arbitrary arguments to apache2.
|
|
.SH "DOCUMENTATION"
|
|
.PP
|
|
The full documentation is available in the apache2-doc package or at
|
|
http://httpd.apache.org/docs/2.2/ . Information about Debian specific changes
|
|
and configuration can be found in
|
|
/usr/share/doc/apache2/README.Debian.gz .
|
|
.SH "OPTIONS"
|
|
.TP
|
|
-d \fIserverroot\fR
|
|
Set the initial value for the ServerRoot directive to \fIserverroot\fR\&. This can be overridden by the ServerRoot directive in the configuration file\&.
|
|
.TP
|
|
-f \fIconfig\fR
|
|
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\&.
|
|
.TP
|
|
-k start|restart|graceful|stop|graceful-stop
|
|
Signals apache2 to start, restart, or stop\&. See Stopping Apache for more information\&.
|
|
.TP
|
|
-C \fIdirective\fR
|
|
Process the configuration \fIdirective\fR before reading config files\&.
|
|
.TP
|
|
-c \fIdirective\fR
|
|
Process the configuration \fIdirective\fR after reading config files\&.
|
|
.TP
|
|
-D \fIparameter\fR
|
|
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\&.
|
|
.TP
|
|
-e \fIlevel\fR
|
|
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\&.
|
|
.TP
|
|
-E \fIfile\fR
|
|
Send error messages during server startup to \fIfile\fR\&.
|
|
.TP
|
|
-R \fIdirectory\fR
|
|
When the server is compiled using the SHARED_CORE rule, this specifies the \fIdirectory\fR for the shared object files\&.
|
|
.TP
|
|
-h
|
|
Output a short summary of available command line options\&.
|
|
.TP
|
|
-l
|
|
Output a list of modules compiled into the server\&. This will \fBnot\fR list dynamically loaded modules included using the LoadModule directive\&.
|
|
.TP
|
|
-L
|
|
Output a list of directives together with expected arguments and places where the directive is valid\&.
|
|
.TP
|
|
-M
|
|
Dump a list of loaded Static and Shared Modules\&.
|
|
.TP
|
|
-S
|
|
Show the settings as parsed from the config file (currently only shows the virtualhost settings)\&.
|
|
.TP
|
|
-t
|
|
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\&.
|
|
.TP
|
|
-v
|
|
Print the version of apache2, and then exit\&.
|
|
.TP
|
|
-V
|
|
Print the version and build parameters of apache2, and then exit\&.
|
|
.TP
|
|
-X
|
|
Run apache2 in debug mode\&. Only one worker will be started and the server will not detach from the console\&.
|
|
.SH SEE ALSO
|
|
.BR apache2ctl (8),
|
|
.BR /usr/share/doc/apache2/README.Debian.gz
|
|
|