1HTTPD(8) httpd HTTPD(8)
2
6 httpd - Apache Hypertext Transfer Protocol Server
7
10 httpd [ -d serverroot ] [ -f config ] [ -C directive ] [ -c directive ]
11 [ -D parameter ] [ -e level ] [ -E file ] [ -k start|restart|grace‐
12 ful|stop|graceful-stop ] [ -R directory ] [ -h ] [ -l ] [ -L ] [ -S ] [
13 -t ] [ -v ] [ -V ] [ -X ] [ -M ] [ -T ]
14 On Windows systems, the following additional arguments are available:
17 httpd [ -k install|config|uninstall ] [ -n name ] [ -w ]
20
24 httpd is the Apache HyperText Transfer Protocol (HTTP) server program.
25 It is designed to be run as a standalone daemon process. When used like
26 this it will create a pool of child processes or threads to handle
27 requests.
28 In general, httpd should not be invoked directly, but rather should be
31 invoked via apachectl on Unix-based systems or as a service on Windows
32 NT, 2000 and XP and as a console application on Windows 9x and ME.
33
37 -d serverroot
38 Set the initial value for the ServerRoot directive to server‐
39 root. This can be overridden by the ServerRoot directive in the
40 configuration file. The default is /etc/httpd.
41 -f config
43 Uses the directives in the file config on startup. If config
44 does not begin with a /, then it is taken to be a path relative
45 to the ServerRoot. The default is conf/httpd.conf.
46 -k start|restart|graceful|stop|graceful-stop
48 Signals httpd to start, restart, or stop. See Stopping Apache
49 for more information.
50 -C directive
52 Process the configuration directive before reading config files.
53 -c directive
55 Process the configuration directive after reading config files.
56 -D parameter
58 Sets a configuration parameter which can be used with <IfDefine>
59 sections in the configuration files to conditionally skip or
60 process commands at server startup and restart. Also can be used
61 to set certain less-common startup parameters including
62 -DNO_DETACH (prevent the parent from forking) and -DFOREGROUND
63 (prevent the parent from calling setsid() et al).
64 -e level
66 Sets the LogLevel to level during server startup. This is useful
67 for temporarily increasing the verbosity of the error messages
68 to find problems during startup.
69 -E file
71 Send error messages during server startup to file.
72 -R directory
74 When the server is compiled using the SHARED_CORE rule, this
75 specifies the directory for the shared object files.
76 -h Output a short summary of available command line options.
78 -l Output a list of modules compiled into the server. This will not
80 list dynamically loaded modules included using the LoadModule
81 directive.
82 -L Output a list of directives together with expected arguments and
84 places where the directive is valid.
85 -M Dump a list of loaded Static and Shared Modules.
87 -S Show the settings as parsed from the config file (currently only
89 shows the virtualhost settings).
90 -T (Available in 2.2.17 and later)
92 Skip document root check at startup/restart.
93 -t Run syntax tests for configuration files only. The program imme‐
95 diately exits after these syntax parsing tests with either a
96 return code of 0 (Syntax OK) or return code not equal to 0 (Syn‐
97 tax Error). If -D DUMP_VHOSTS is also set, details of the vir‐
98 tual host configuration will be printed. If -D DUMP_MODULES is
99 set, all loaded modules will be printed.
100 -v Print the version of httpd, and then exit.
102 -V Print the version and build parameters of httpd, and then exit.
104 -X Run httpd in debug mode. Only one worker will be started and the
106 server will not detach from the console.
107 The following arguments are available only on the Windows platform:
110 -k install|config|uninstall
114 Install Apache as a Windows NT service; change startup options
115 for the Apache service; and uninstall the Apache service.
116 -n name
118 The name of the Apache service to signal.
119 -w Keep the console window open on error so that the error message
121 can be read.
122Apache HTTP Server 2010-09-28 HTTPD(8)