Annotation of libwww/Library/src/HTReader.html, revision 2.3

2.1       frystyk     1: <HTML>
                      2: <HEAD>
2.3     ! frystyk     3:   <!-- Changed by: Henrik Frystyk Nielsen, 12-Apr-1996 -->
        !             4:   <NEXTID N="z18">
        !             5:   <TITLE>W3C Reference Library Socket Reader Stream</TITLE>
2.1       frystyk     6: </HEAD>
                      7: <BODY>
2.3     ! frystyk     8: <H1>
        !             9:   Socket Reader Stream
        !            10: </H1>
2.1       frystyk    11: <PRE>
                     12: /*
                     13: **     (c) COPYRIGHT MIT 1995.
                     14: **     Please first read the full copyright statement in the file COPYRIGH.
                     15: */
                     16: </PRE>
2.3     ! frystyk    17: <P>
        !            18: The Socket Reader Stream is an <A HREF="HTIOStream.html">input stream
        !            19: </A>&nbsp;which knows how to read from&nbsp;a BSD type socket. It is part
        !            20: of the <A HREF="WWWTrans.html">Transport interface </A>and may be registered
        !            21: as part of a <A HREF="HTTrans.html">Transport Object</A>. The application
        !            22: can&nbsp;initialize this stream together with the
        !            23: <A HREF="HTWriter.html">HTWriter stream</A>, for example. In the
        !            24: <A HREF="HTInit.html">default initialization module</A>, you can find the
        !            25: <CODE>HTTransportInit()</CODE> function which sets up this stream as a default
        !            26: transport for handling socket read operations.
        !            27: <P>
        !            28: This module is implemented by <A HREF="HTReader.c">HTReader.c</A>, and it
        !            29: is a part of the <A HREF="http://www.w3.org/pub/WWW/Library/"> W3C Reference
        !            30: Library</A>.
2.1       frystyk    31: <PRE>
                     32: #ifndef HTREADER_H
                     33: #define HTREADER_H
                     34: 
                     35: #include <A HREF="HTIOStream.html">"HTIOStream.h"</A>
                     36: </PRE>
2.3     ! frystyk    37: <H2>
        !            38:   Input Buffering
        !            39: </H2>
        !            40: <P>
        !            41: In order to optimize reading a channel, we bind a buffer to each channel
        !            42: object. The size of this buffer is a compromise between speed and memory.
        !            43: Here it is chosen as the default TCP High Water Mark (sb_hiwat) for receiving
        !            44: data. By default, we have chosen a value that equals the normal TCP High
        !            45: Water Mark (sb_hiwat) for receiving data.
2.1       frystyk    46: <PRE>
                     47: #define INPUT_BUFFER_SIZE 8192
                     48: </PRE>
2.3     ! frystyk    49: <H2>
        !            50:   Read Stream
        !            51: </H2>
2.1       frystyk    52: <PRE>
                     53: extern HTInput_new HTReader_new;
                     54: </PRE>
                     55: <PRE>
                     56: #endif
                     57: </PRE>
2.2       frystyk    58: <P>
2.3     ! frystyk    59:   <HR>
2.2       frystyk    60: <ADDRESS>
2.3     ! frystyk    61:   @(#) $Id: HTReader.html,v 2.2 1996/04/14 01:23:20 frystyk Exp $
2.2       frystyk    62: </ADDRESS>
2.3     ! frystyk    63: </BODY></HTML>

Webmaster