httpd - Apache Hypertext Transfer Protocol Server
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.
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.
Synopsis
httpd [ -d serverroot ] [ -f config ] [ -C directive ] [ -c directive ] [ -D parameter ] [ -e level ] [ -E file ] [ -k start|restart|graceful|stop|graceful-stop ] [ -R directory ] [ -h ] [ -l ] [ -L ] [ -S ] [ -t ] [ -v ] [ -V ] [ -X ] [ -M ]
On Windows systems, the following additional arguments are available:
httpd [ -k install|config|uninstall ] [ -n name ] [ -w ]
Options
-d serverroot
- Set the initial value for the
ServerRoot
directive toserverroot. This can be overridden by the ServerRootdirective in the configuration file. The default is/usr/local/apache2
. -f config
- Uses the directives in the file config on startup. Ifconfig does not begin with a /, then it is taken to be apath relative to the
ServerRoot
. The default isconf/httpd.conf
. -k start|restart|graceful|stop|graceful-stop
- Signals
httpd
to start, restart, or stop. See Stopping Apache for more information. -C directive
- Process the configuration directive before readingconfig files.
-c directive
- Process the configuration directive after reading configfiles.
-D parameter
- Sets a configuration parameter which can be used with
<IfDefine>
sectionsin the configuration files to conditionally skip or process commandsat server startup and restart. Also can be used to set certainless-common startup parameters including -DNO_DETACH
(prevent the parent from forking) and -DFOREGROUND
(prevent the parent from calling setsid()
et al). -e level
- Sets the
LogLevel
tolevel during server startup. This is useful fortemporarily increasing the verbosity of the error messages to findproblems during startup. -E file
- Send error messages during server startup to file.
-R directory
- When the server is compiled using the
SHARED_CORE
rule, this specifies the directory for the sharedobject files. -h
- Output a short summary of available command line options.
-l
- Output a list of modules compiled into the server. This willnot list dynamically loaded modules included usingthe
LoadModule
directive. -L
- Output a list of directives together with expected arguments andplaces where the directive is valid.
-M
- Dump a list of loaded Static and Shared Modules.
-S
- Show the settings as parsed from the config file (currently onlyshows the virtualhost settings).
-t
- Run syntax tests for configuration files only. The programimmediately exits after these syntax parsing tests with either a return codeof 0 (Syntax OK) or return code not equal to 0 (Syntax Error). If -DDUMP_VHOSTS is also set, details of the virtual hostconfiguration will be printed. If -D DUMP_MODULES isset, all loaded modules will be printed.
-v
- Print the version of
httpd
, and then exit. -V
- Print the version and build parameters of
httpd
, andthen exit. -X
- Run httpd in debug mode. Only one worker will be started and theserver will not detach from the console.
The following arguments are available only on the Windows platform:
-k install|config|uninstall
- Install Apache as a Windows NT service; change startup options forthe Apache service; and uninstall the Apache service.
-n name
- The name of the Apache service to signal.
-w
- Keep the console window open on error so that the error message can be read.