Annotation of libwww/Library/src/HTTP.html, revision 2.10
2.6 timbl 1: <HTML>
2: <HEAD>
2.9 frystyk 3: <TITLE>HTTP module for libwww</TITLE></HEAD>
2.6 timbl 4: <BODY>
2.9 frystyk 5: <H1>HyperText Tranfer Protocol Module</H1>
6:
2.10 ! frystyk 7: This is the module that handles all communication with HTTP servers. The module
! 8: is a part of the <A HREF="Overview.html">CERN Common WWW Library</A>.
2.9 frystyk 9:
10: <PRE>
11: #ifndef HTTP_H
2.1 timbl 12: #define HTTP_H
2.9 frystyk 13: #include "HTAccess.h"
14: </PRE>
2.1 timbl 15:
2.9 frystyk 16: <H2>Public Functions</H2>
17:
18: Theese are the public functions...
19:
20: <H3>Accessing HTTP-Server</H3>
2.1 timbl 21:
2.9 frystyk 22: <PRE>
23: extern int HTLoadHTTP PARAMS((HTRequest * request));
2.7 timbl 24: </PRE>
2.9 frystyk 25:
26: <H2>Controlling Flags</H2>
27:
28: The following variables can change the behaviour of the module.
29:
30: <H3>Cache control flag</H3>
31:
32: <EM>Note: This variable is now replaced by the (char *) HTCacheDir in
2.10 ! frystyk 33: <A HREF="HTAccess.html">HTAccess Module</A></EM> <P>
2.9 frystyk 34:
35: Turn this off if you don't want HTTP protocol fetches to leave cache files.
2.8 frystyk 36: extern BOOL HTCacheHTTP;
2.1 timbl 37:
2.9 frystyk 38: <H3>Redirections</H3>
2.7 timbl 39:
2.9 frystyk 40: The maximum number of redirections is pr. default 10 and is set in the module.
41: This prevents the library from going into an infinite loop.
42:
43: <PRE>
44: extern int HTMaxRedirections;
2.10 ! frystyk 45: </PRE>
! 46:
! 47: <H3>Disable/Enable User Identification in HTTP Request</H3>
! 48:
! 49: If a client want the user's email address to be send in the HTTP request
! 50: as a <A HREF="http://info.cern.ch/hypertext/WWW/Protocols/HTTP/HTRQ_Headers.html#from">From field</A>
! 51: then turn this flag on. The default is off because it might cause security
! 52: problems from within a firewall. When enabled, the format used is
! 53: <EM>user@host.domain</EM>. The value can be changed, see <A HREF="HTTCP.html#Mailaddress">HTTCP Module</A>.
! 54:
! 55: <PRE>
! 56: extern BOOL HTEnableFrom;
2.9 frystyk 57: </PRE>
58:
59: <PRE>
2.6 timbl 60: #endif /* HTTP_H */
2.9 frystyk 61: </PRE>
2.1 timbl 62:
2.9 frystyk 63: End of HTTP module definition.
64: </BODY>
2.6 timbl 65: </HTML>
Webmaster