summaryrefslogtreecommitdiffstats
path: root/docs/manual/programs/httpd.html
blob: ff5a16f46235859ce23f5dbdae8111eaf5e20125 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML><HEAD><TITLE>Manual Page: httpd  - Apache HTTP Server</TITLE></HEAD>
<BODY BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF"
VLINK="#000080" ALINK="#FF0000">
<!--#include virtual="header.html" -->
<!-- This document was autogenerated from the man page -->
<pre>
<strong>NAME</strong>
     httpd - Apache hypertext transfer protocol server

<strong>SYNOPSIS</strong>
     <strong>httpd </strong>[ -<strong>X </strong>] [ -<strong>R </strong><em>libexecdir </em>] [ -<strong>d </strong><em>serverroot </em>] [ -<strong>f </strong><em>config</em>
     ] [ -<strong>C </strong><em>directive </em>] [ -<strong>c </strong><em>directive </em>] [ -<strong>D </strong><em>parameter </em>]

     <strong>httpd </strong>[ -<strong>h </strong>] [ -<strong>l </strong>] [ -<strong>L </strong>] [ -<strong>v </strong>] [ -<strong>V </strong>] [ -<strong>S </strong>] [ -<strong>t </strong>] [  -<strong>T</strong>
     ]

<strong>DESCRIPTION</strong>
     <strong>httpd </strong>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 to handle requests. To stop it, send a TERM
     signal to the initial (parent) process. The PID of this pro-
     cess  is  written  to  a  file as given in the configuration
     file.  Alternatively <strong>httpd </strong>may be invoked  by  the  Internet
     daemon  inetd(8)  each time a connection to the HTTP service
     is made.

     This manual page only lists the command line arguments.  For
     details  of  the directives necessary to configure <strong>httpd </strong>see
     the Apache manual, which is part of the Apache  distribution
     or  can  be  found  at http://www.apache.org/. Paths in this
     manual may not reflect those compiled into <strong>httpd.</strong>

<strong>OPTIONS</strong>
     -<strong>R </strong><em>libexecdir</em>
                 This option is  only  available  if  Apache  was
                 built  with  the  <em>SHARED</em>_<em>CORE </em>rule enabled which
                 forces the Apache core code to be placed into  a
                 dynamic  shared  object (DSO) file. This file is
                 searched in a hardcoded  path  under  ServerRoot
                 per  default.  Use  this  option  if you want to
                 override it.

     -<strong>d </strong><em>serverroot</em>
                 Set the initial value for the ServerRoot  direc-
                 tive  to  <em>serverroot</em>.  This can be overridden by
                 the  ServerRoot  command  in  the  configuration
                 file. The default is <strong>/usr/local/apache</strong>.

     -<strong>f </strong><em>config   </em>Execute the  commands  in  the  file  <em>config  </em>on
                 startup. If <em>config </em>does not begin with a /, then
                 it is taken to be a path relative to the Server-
                 Root. The default is <strong>conf/httpd.conf</strong>.

     -<strong>C </strong><em>directive</em>
                 Process the configuration <em>directive </em>before read-
                 ing config files.

     -<strong>c </strong><em>directive</em>
                 Process the configuration <em>directive </em>after  read-
                 ing config files.

     -<strong>D </strong><em>parameter</em>
                 Sets a configuration <em>parameter </em>which can be used
                 with  &lt;IfDefine&gt;...&lt;/IfDefine&gt;  sections  in the
                 configuration files  to  conditionally  skip  or
                 process commands.

     -<strong>h          </strong>Output a short summary of available command line
                 options.

     -<strong>l          </strong>Output a  list  of  modules  compiled  into  the
                 server.

     -<strong>L          </strong>Output  a  list  of  directives  together   with
                 expected  arguments  and places where the direc-
                 tive is valid.

     -<strong>S          </strong>Show the settings as parsed from the config file
                 (currently only shows the virtualhost settings).

     -<strong>t          </strong>Run syntax tests for configuration  files  only.
                 The program immediately exits after these syntax
                 parsing with either a return code of  0  (Syntax
                 OK)  or  return  code  not  equal  to  0 (Syntax
                 Error).

     -<strong>T          </strong>Same as option -<strong>t </strong>but does not check the config-
                 ured document roots.

     -<strong>X          </strong>Run in single-process mode, for internal  debug-
                 ging  purposes  only; the daemon does not detach
                 from the terminal or fork any children.  Do  NOT
                 use this mode to provide ordinary web service.

     -<strong>v          </strong>Print the version of <strong>httpd </strong>, and then exit.

     -<strong>V          </strong>Print the version and build parameters of  <strong>httpd</strong>
                 , and then exit.

<strong>FILES</strong>
     <strong>/usr/local/apache/conf/httpd.conf</strong>
     <strong>/usr/local/apache/conf/srm.conf</strong>
     <strong>/usr/local/apache/conf/access.conf</strong>
     <strong>/usr/local/apache/conf/mime.types</strong>
     <strong>/usr/local/apache/conf/magic</strong>
     <strong>/usr/local/apache/logs/error_log</strong>
     <strong>/usr/local/apache/logs/access_log</strong>
     <strong>/usr/local/apache/logs/httpd.pid</strong>

<strong>SEE ALSO</strong>
     <strong>inetd</strong>(8).

</pre>
<!--#include virtual="footer.html" -->
</BODY></HTML>