URL https://opencores.org/ocsvn/openrisc/openrisc/trunk

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [net-httpd-configuration.html] - Blame information for rev 588

Go to most recent revision | Details | Compare with Previous | View Log


<!-- Copyright (C) 2003 Red Hat, Inc.                                -->
<!-- This material may be distributed only subject to the terms      -->
<!-- and conditions set forth in the Open Publication License, v1.0  -->
<!-- or later (the latest version is presently available at          -->
<!-- http://www.opencontent.org/openpub/).                           -->
<!-- Distribution of the work or derivative of the work in any       -->
<!-- standard (paper) book form is prohibited unless prior           -->
<!-- permission is obtained from the copyright holder.               -->
<HTML
><HEAD
><TITLE
>Server Configuration</TITLE
><meta name="MSSmartTagsPreventParsing" content="TRUE">
<META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
"><LINK
REL="HOME"
TITLE="eCos Reference Manual"
HREF="ecos-ref.html"><LINK
REL="UP"
TITLE="Embedded HTTP Server"
HREF="net-httpd-chapter.html"><LINK
REL="PREVIOUS"
TITLE="Server Organization"
HREF="net-httpd-organization.html"><LINK
REL="NEXT"
TITLE="Support Functions and Macros"
HREF="net-httpd-html.html"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>eCos Reference Manual</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="net-httpd-organization.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 48. Embedded HTTP Server</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="net-httpd-html.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="NET-HTTPD-CONFIGURATION">Server Configuration</H1
><P
>The HTTP server has a number of configuration options:</P
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN15263"><TT
CLASS="LITERAL"
>CYGNUM_HTTPD_SERVER_PORT</TT
></H2
><P
>This option defines the TCP port that the server will listen on. It
defaults to the standard HTTP port number 80. It may be changed to a
different number if, for example, another HTTP server is using the
main HTTP port.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN15267"><TT
CLASS="LITERAL"
>CYGDAT_HTTPD_SERVER_ID</TT
></H2
><P
>This is the string that is reported to the client in the
&quot;Server:&quot; field of the HTTP header. </P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN15271"><TT
CLASS="LITERAL"
>CYGNUM_HTTPD_THREAD_COUNT</TT
></H2
><P
>The HTTP server can be configured to use more than one thread to
service HTTP requests. If you expect to serve complex pages with many
images or other components that are fetched separately, or if any
pages may take a long time to send, then it may be useful to increase
the number of server threads. For most uses, however, the connection
queuing in the TCP/IP stack and the speed with which each page is
generated, means that a single thread is usually adequate.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN15275"><TT
CLASS="LITERAL"
>CYGNUM_HTTPD_THREAD_PRIORITY</TT
></H2
><P
>The HTTP server threads can be run at any priority. The exact priority
depends on the importance of the server relative to the rest of the
system. The default is to put them in the middle of the priority range
to provide reasonable response without impacting genuine high priority
threads.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN15279"><TT
CLASS="LITERAL"
>CYGNUM_HTTPD_THREAD_STACK_SIZE</TT
></H2
><P
>This is the amount of stack to be allocated for each of the HTTPD
threads. The actual stack size allocated will be this value plus the
values of <TT
CLASS="LITERAL"
>CYGNUM_HAL_STACK_SIZE_MINIMUM</TT
> and
<TT
CLASS="LITERAL"
>CYGNUM_HTTPD_SERVER_BUFFER_SIZE</TT
>.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN15285"><TT
CLASS="LITERAL"
>CYGNUM_HTTPD_SERVER_BUFFER_SIZE</TT
></H2
><P
>This defines the size of the buffer used to receive the first line of
each HTTP request. If you expect to use particularly long URLs or have
very complex forms, this should be increased.</P
></DIV
><DIV
CLASS="SECT2"
><H2
CLASS="SECT2"
><A
NAME="AEN15289"><TT
CLASS="LITERAL"
>CYGNUM_HTTPD_SERVER_DELAY</TT
></H2
><P
>This defines the number of system clock ticks that the HTTP server
will wait before initializing itself and spawning any extra server
threads. This is to give the application a chance to initialize
properly without any interference from the HTTPD.</P
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="net-httpd-organization.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="ecos-ref.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="net-httpd-html.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Server Organization</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="net-httpd-chapter.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Support Functions and Macros</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>

Line No.	Rev	Author	Line
1	28	unneback	`<!-- 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			`"Server:" 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			`>`

Browse

Tools

Subversion Repositories openrisc

[/] [openrisc/] [trunk/] [rtos/] [ecos-2.0/] [doc/] [html/] [ref/] [net-httpd-configuration.html] - Blame information for rev 588