1 .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
2 .\" DO NOT EDIT! Generated from XML source.
3 .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
12 .de Sp \" Vertical space (when we can't use .PP)
18 .ie \\n(.$>=3 .ne \\$3
22 .TH "HTTPD" 8 "2014-01-20" "Apache HTTP Server" "httpd"
25 httpd \- Apache Hypertext Transfer Protocol Server
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 ] [ -\fBh\fR ] [ -\fBl\fR ] [ -\fBL\fR ] [ -\fBS\fR ] [ -\fBt\fR ] [ -\fBv\fR ] [ -\fBV\fR ] [ -\fBX\fR ] [ -\fBM\fR ] [ -\fBT\fR ]
33 On Windows systems, the following additional arguments are available:
36 \fBhttpd\fR [ -\fBk\fR install|config|uninstall ] [ -\fBn\fR \fIname\fR ] [ -\fBw\fR ]
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\&.
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\&.
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\&.
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\&.
58 -k start|restart|graceful|stop|graceful-stop
59 Signals httpd to start, restart, or stop\&. See Stopping Apache httpd for more information\&.
62 Process the configuration \fIdirective\fR before reading config files\&.
65 Process the configuration \fIdirective\fR after reading config files\&.
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\&. Also can be used to set certain less-common startup parameters including -DNO_DETACH (prevent the parent from forking) and -DFOREGROUND (prevent the parent from calling setsid() et al)\&.
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\&.
74 Send error messages during server startup to \fIfile\fR\&.
77 Output a short summary of available command line options\&.
80 Output a list of modules compiled into the server\&. This will \fBnot\fR list dynamically loaded modules included using the LoadModule directive\&.
83 Output a list of directives provided by static modules, together with expected arguments and places where the directive is valid\&. Directives provided by shared modules are not listed\&.
86 Dump a list of loaded Static and Shared Modules\&.
89 Show the settings as parsed from the config file (currently only shows the virtualhost settings)\&.
91 -T (Available in 2\&.3\&.8 and later)
92 Skip document root check at startup/restart\&.
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\&. If -D \fIDUMP\fR_\fICERTS \fR is set and mod_ssl is used, configured SSL certificates will be printed\&. If -D \fIDUMP\fR_\fICA\fR_\fI_CERTS \fR is set and mod_ssl is used, configured SSL CA certificates and configured directories containing SSL CA certificates will be printed\&.
98 Print the version of httpd, and then exit\&.
101 Print the version and build parameters of httpd, and then exit\&.
104 Run httpd in debug mode\&. Only one worker will be started and the server will not detach from the console\&.
107 The following arguments are available only on the Windows platform:
111 -k install|config|uninstall
112 Install Apache httpd as a Windows NT service; change startup options for the Apache httpd service; and uninstall the Apache httpd service\&.
115 The \fIname\fR of the Apache httpd service to signal\&.
118 Keep the console window open on error so that the error message can be read\&.