httpd(8)
NAME
httpd - Apache Hypertext Transfer Protocol Server
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 ]
SUMMARY
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.
OPTIONS
- -d serverroot
- Set the initial value for the ServerRoot directive to serverroot. This can be overridden by the ServerRoot directive in the configuration file. The default is /etc/httpd.
- -f config
- Uses the directives in the file config on startup. If config does not begin with a /, then it is taken to be a path relative to the ServerRoot. The default is conf/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 reading config files.
- -c directive
- Process the configuration directive after reading config files.
- -D parameter
- Sets a configuration parameter which can be used with <IfDefine> sections in the configuration files to conditionally skip or process commands at server startup and restart.
- -e level
- Sets the LogLevel to level during server startup. This is useful for temporarily increasing the verbosity of the error messages to find problems 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 shared object files.
- -h Output a short summary of available command line options.
- -l Output a list of modules compiled into the server. This will not
- list dynamically loaded modules included using the LoadModule directive.
- -L Output a list of directives together with expected arguments and
- places 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 only
- shows the virtualhost settings).
- -t Run syntax tests for configuration files only. The program imme
- diately 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 DUMP_VHOSTS is also set, details of the virtual host configuration will be printed. If -D DUMP_MODULES is set, all loaded modules will be printed.
- -v Print the version of httpd, and then exit.
- -V Print the version and build parameters of httpd, and then exit.
- -X Run httpd in debug mode. Only one worker will be started and the
- server 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 for the 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.