doc/html/ref/net-httpd-configuration.html

   1 <!-- Copyright (C) 2003 Red Hat, Inc.                                -->
   2 <!-- This material may be distributed only subject to the terms      -->
   3 <!-- and conditions set forth in the Open Publication License, v1.0  -->
   4 <!-- or later (the latest version is presently available at          -->
   5 <!-- http://www.opencontent.org/openpub/).                           -->
   6 <!-- Distribution of the work or derivative of the work in any       -->
   7 <!-- standard (paper) book form is prohibited unless prior           -->
   8 <!-- permission is obtained from the copyright holder.               -->
   9 <HTML
  10 ><HEAD
  11 ><TITLE
  12 >Server Configuration</TITLE
  13 ><meta name="MSSmartTagsPreventParsing" content="TRUE">
  14 <META
  15 NAME="GENERATOR"
  16 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
  17 "><LINK
  18 REL="HOME"
  19 TITLE="eCos Reference Manual"
  20 HREF="ecos-ref.html"><LINK
  21 REL="UP"
  22 TITLE="Embedded HTTP Server"
  23 HREF="net-httpd-chapter.html"><LINK
  24 REL="PREVIOUS"
  25 TITLE="Server Organization"
  26 HREF="net-httpd-organization.html"><LINK
  27 REL="NEXT"
  28 TITLE="Support Functions and Macros"
  29 HREF="net-httpd-html.html"></HEAD
  30 ><BODY
  31 CLASS="SECT1"
  32 BGCOLOR="#FFFFFF"
  33 TEXT="#000000"
  34 LINK="#0000FF"
  35 VLINK="#840084"
  36 ALINK="#0000FF"
  37 ><DIV
  38 CLASS="NAVHEADER"
  39 ><TABLE
  40 SUMMARY="Header navigation table"
  41 WIDTH="100%"
  42 BORDER="0"
  43 CELLPADDING="0"
  44 CELLSPACING="0"
  45 ><TR
  46 ><TH
  47 COLSPAN="3"
  48 ALIGN="center"
  49 >eCos Reference Manual</TH
  50 ></TR
  51 ><TR
  52 ><TD
  53 WIDTH="10%"
  54 ALIGN="left"
  55 VALIGN="bottom"
  56 ><A
  57 HREF="net-httpd-organization.html"
  58 ACCESSKEY="P"
  59 >Prev</A
  60 ></TD
  61 ><TD
  62 WIDTH="80%"
  63 ALIGN="center"
  64 VALIGN="bottom"
  65 >Chapter 48. Embedded HTTP Server</TD
  66 ><TD
  67 WIDTH="10%"
  68 ALIGN="right"
  69 VALIGN="bottom"
  70 ><A
  71 HREF="net-httpd-html.html"
  72 ACCESSKEY="N"
  73 >Next</A
  74 ></TD
  75 ></TR
  76 ></TABLE
  77 ><HR
  78 ALIGN="LEFT"
  79 WIDTH="100%"></DIV
  80 ><DIV
  81 CLASS="SECT1"
  82 ><H1
  83 CLASS="SECT1"
  84 ><A
  85 NAME="NET-HTTPD-CONFIGURATION">Server Configuration</H1
  86 ><P
  87 >The HTTP server has a number of configuration options:</P
  88 ><DIV
  89 CLASS="SECT2"
  90 ><H2
  91 CLASS="SECT2"
  92 ><A
  93 NAME="AEN15263"><TT
  94 CLASS="LITERAL"
  95 >CYGNUM_HTTPD_SERVER_PORT</TT
  96 ></H2
  97 ><P
  98 >This option defines the TCP port that the server will listen on. It
  99 defaults to the standard HTTP port number 80. It may be changed to a
 100 different number if, for example, another HTTP server is using the
 101 main HTTP port.</P
 102 ></DIV
 103 ><DIV
 104 CLASS="SECT2"
 105 ><H2
 106 CLASS="SECT2"
 107 ><A
 108 NAME="AEN15267"><TT
 109 CLASS="LITERAL"
 110 >CYGDAT_HTTPD_SERVER_ID</TT
 111 ></H2
 112 ><P
 113 >This is the string that is reported to the client in the
 114 &quot;Server:&quot; field of the HTTP header. </P
 115 ></DIV
 116 ><DIV
 117 CLASS="SECT2"
 118 ><H2
 119 CLASS="SECT2"
 120 ><A
 121 NAME="AEN15271"><TT
 122 CLASS="LITERAL"
 123 >CYGNUM_HTTPD_THREAD_COUNT</TT
 124 ></H2
 125 ><P
 126 >The HTTP server can be configured to use more than one thread to
 127 service HTTP requests. If you expect to serve complex pages with many
 128 images or other components that are fetched separately, or if any
 129 pages may take a long time to send, then it may be useful to increase
 130 the number of server threads. For most uses, however, the connection
 131 queuing in the TCP/IP stack and the speed with which each page is
 132 generated, means that a single thread is usually adequate.</P
 133 ></DIV
 134 ><DIV
 135 CLASS="SECT2"
 136 ><H2
 137 CLASS="SECT2"
 138 ><A
 139 NAME="AEN15275"><TT
 140 CLASS="LITERAL"
 141 >CYGNUM_HTTPD_THREAD_PRIORITY</TT
 142 ></H2
 143 ><P
 144 >The HTTP server threads can be run at any priority. The exact priority
 145 depends on the importance of the server relative to the rest of the
 146 system. The default is to put them in the middle of the priority range
 147 to provide reasonable response without impacting genuine high priority
 148 threads.</P
 149 ></DIV
 150 ><DIV
 151 CLASS="SECT2"
 152 ><H2
 153 CLASS="SECT2"
 154 ><A
 155 NAME="AEN15279"><TT
 156 CLASS="LITERAL"
 157 >CYGNUM_HTTPD_THREAD_STACK_SIZE</TT
 158 ></H2
 159 ><P
 160 >This is the amount of stack to be allocated for each of the HTTPD
 161 threads. The actual stack size allocated will be this value plus the
 162 values of <TT
 163 CLASS="LITERAL"
 164 >CYGNUM_HAL_STACK_SIZE_MINIMUM</TT
 165 > and
 166 <TT
 167 CLASS="LITERAL"
 168 >CYGNUM_HTTPD_SERVER_BUFFER_SIZE</TT
 169 >.</P
 170 ></DIV
 171 ><DIV
 172 CLASS="SECT2"
 173 ><H2
 174 CLASS="SECT2"
 175 ><A
 176 NAME="AEN15285"><TT
 177 CLASS="LITERAL"
 178 >CYGNUM_HTTPD_SERVER_BUFFER_SIZE</TT
 179 ></H2
 180 ><P
 181 >This defines the size of the buffer used to receive the first line of
 182 each HTTP request. If you expect to use particularly long URLs or have
 183 very complex forms, this should be increased.</P
 184 ></DIV
 185 ><DIV
 186 CLASS="SECT2"
 187 ><H2
 188 CLASS="SECT2"
 189 ><A
 190 NAME="AEN15289"><TT
 191 CLASS="LITERAL"
 192 >CYGNUM_HTTPD_SERVER_DELAY</TT
 193 ></H2
 194 ><P
 195 >This defines the number of system clock ticks that the HTTP server
 196 will wait before initializing itself and spawning any extra server
 197 threads. This is to give the application a chance to initialize
 198 properly without any interference from the HTTPD.</P
 199 ></DIV
 200 ></DIV
 201 ><DIV
 202 CLASS="NAVFOOTER"
 203 ><HR
 204 ALIGN="LEFT"
 205 WIDTH="100%"><TABLE
 206 SUMMARY="Footer navigation table"
 207 WIDTH="100%"
 208 BORDER="0"
 209 CELLPADDING="0"
 210 CELLSPACING="0"
 211 ><TR
 212 ><TD
 213 WIDTH="33%"
 214 ALIGN="left"
 215 VALIGN="top"
 216 ><A
 217 HREF="net-httpd-organization.html"
 218 ACCESSKEY="P"
 219 >Prev</A
 220 ></TD
 221 ><TD
 222 WIDTH="34%"
 223 ALIGN="center"
 224 VALIGN="top"
 225 ><A
 226 HREF="ecos-ref.html"
 227 ACCESSKEY="H"
 228 >Home</A
 229 ></TD
 230 ><TD
 231 WIDTH="33%"
 232 ALIGN="right"
 233 VALIGN="top"
 234 ><A
 235 HREF="net-httpd-html.html"
 236 ACCESSKEY="N"
 237 >Next</A
 238 ></TD
 239 ></TR
 240 ><TR
 241 ><TD
 242 WIDTH="33%"
 243 ALIGN="left"
 244 VALIGN="top"
 245 >Server Organization</TD
 246 ><TD
 247 WIDTH="34%"
 248 ALIGN="center"
 249 VALIGN="top"
 250 ><A
 251 HREF="net-httpd-chapter.html"
 252 ACCESSKEY="U"
 253 >Up</A
 254 ></TD
 255 ><TD
 256 WIDTH="33%"
 257 ALIGN="right"
 258 VALIGN="top"
 259 >Support Functions and Macros</TD
 260 ></TR
 261 ></TABLE
 262 ></DIV
 263 ></BODY
 264 ></HTML
 265 >