rubbos/app/httpd-2.0.64/docs/man/httpd.8

   1 .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   2 .\" DO NOT EDIT! Generated from XML source.
   3 .\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   4 .de Sh \" Subsection
   5 .br
   6 .if t .Sp
   7 .ne 5
   8 .PP
   9 \fB\\$1\fR
  10 .PP
  11 ..
  12 .de Sp \" Vertical space (when we can't use .PP)
  13 .if t .sp .5v
  14 .if n .sp
  15 ..
  16 .de Ip \" List item
  17 .br
  18 .ie \\n(.$>=3 .ne \\$3
  19 .el .ne 3
  20 .IP "\\$1" \\$2
  21 ..
  22 .TH "HTTPD" 8 "2004-01-06" "Apache HTTP Server" "httpd"
  23
  24 .SH NAME
  25 httpd \- Apache Hypertext Transfer Protocol Server
  26
  27 .SH "SYNOPSIS"
  28
  29 .PP
  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 ] [ -\fBR\fR \fIdirectory\fR ] [ -\fBh\fR ] [ -\fBl\fR ] [ -\fBL\fR ] [ -\fBS\fR ] [ -\fBt\fR ] [ -\fBv\fR ] [ -\fBV\fR ] [ -\fBX\fR ]
  31
  32 .PP
  33 On Windows systems, the following additional arguments are available:
  34
  35 .PP
  36 \fBhttpd\fR [ -\fBk\fR install|config|uninstall ] [ -\fBn\fR \fIname\fR ] [ -\fBw\fR ]
  37
  38
  39 .SH "SUMMARY"
  40
  41 .PP
  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\&.
  43
  44 .PP
  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\&.
  46
  47
  48 .SH "OPTIONS"
  49
  50
  51 .TP
  52 -d \fIserverroot\fR
  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\&.
  54 .TP
  55 -f \fIconfig\fR
  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\&.
  57 .TP
  58 -k start|restart|graceful|stop
  59 Signals httpd to start, restart, or stop\&. See Stopping Apache for more information\&.
  60 .TP
  61 -C \fIdirective\fR
  62 Process the configuration \fIdirective\fR before reading config files\&.
  63 .TP
  64 -c \fIdirective\fR
  65 Process the configuration \fIdirective\fR after reading config files\&.
  66 .TP
  67 -D \fIparameter\fR
  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\&.
  69 .TP
  70 -e \fIlevel\fR
  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\&.
  72 .TP
  73 -E \fIfile\fR
  74 Send error messages during server startup to \fIfile\fR\&.
  75 .TP
  76 -R \fIdirectory\fR
  77 When the server is compiled using the SHARED_CORE rule, this specifies the \fIdirectory\fR for the shared object files\&.
  78 .TP
  79 -h
  80 Output a short summary of available command line options\&.
  81 .TP
  82 -l
  83 Output a list of modules compiled into the server\&. This will \fBnot\fR list dynamically loaded modules included using the LoadModule directive\&.
  84 .TP
  85 -L
  86 Output a list of directives together with expected arguments and places where the directive is valid\&.
  87 .TP
  88 -S
  89 Show the settings as parsed from the config file (currently only shows the virtualhost settings)\&.
  90 .TP
  91 -t
  92 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\&.
  93 .TP
  94 -v
  95 Print the version of httpd, and then exit\&.
  96 .TP
  97 -V
  98 Print the version and build parameters of httpd, and then exit\&.
  99 .TP
 100 -X
 101 Run httpd in debug mode\&. Only one worker will be started and the server will not detach from the console\&.
 102
 103 .PP
 104 The following arguments are available only on the Windows platform:
 105
 106
 107 .TP
 108 -k install|config|uninstall
 109 Install Apache as a Windows NT service; change startup options for the Apache service; and uninstall the Apache service\&.
 110 .TP
 111 -n \fIname\fR
 112 The \fIname\fR of the Apache service to signal\&.
 113 .TP
 114 -w
 115 Keep the console window open on error so that the error message can be read\&.
 116