Annotation of libwww/Library/src/WWWCache.html, revision 2.5

2.1       frystyk     1: <HTML>
                      2: <HEAD>
2.5     ! frystyk     3:   <TITLE>W3C Reference Library libwww Persistent Cache Manager</TITLE>
2.1       frystyk     4: </HEAD>
                      5: <BODY>
2.5     ! frystyk     6: <H1>
        !             7:   Declaration of W3C Reference Persistent Cache Manager
        !             8: </H1>
2.1       frystyk     9: <PRE>
                     10: /*
                     11: **     (c) COPYRIGHT MIT 1995.
                     12: **     Please first read the full copyright statement in the file COPYRIGH.
                     13: */
                     14: </PRE>
2.5     ! frystyk    15: <P>
        !            16: Caching is a required part of any efficient Internet access applications
        !            17: as it saves bandwidth and improves access performance significantly in almost
        !            18: all types of accesses. The Library supports two different types of cache:
        !            19: The memory cache and the file cache. The two types differ in several ways
        !            20: which reflects their two main purposes: The memory cache is for short term
        !            21: storage of graphic objects whereas the file cache is for intermediate term
        !            22: storage of data objects. Often it is desirable to have both a memory and
        !            23: a file version of a cached document, so the two types do not exclude each
        !            24: other.
        !            25: <P>
        !            26: The cache contains details of persietent files which contain the contents
        !            27: of remote documents. The existing cache manager is somewhat naive - especially
        !            28: in its garbage collection but it is just an example of how it can be done.
        !            29: More advanced implementations are welcome!
        !            30: <P>
        !            31: There are various ways of handling the <CODE>Expires</CODE> header when met
        !            32: in a history list. Either it can be ignored all together, the user can be
        !            33: notified with a warning, or the document can be reloaded automatically. This
        !            34: flag decides what action to be taken. The default action is
        !            35: <CODE>HT_EXPIRES_IGNORE</CODE>. In <CODE>HT_EXPIRES_NOTIFY</CODE> mode we
        !            36: push a message on to the <A HREF="HTError.html">Error stack</A> which is
        !            37: presented to the user.
2.1       frystyk    38: <PRE>
                     39: #ifndef WWWCACHE_H
                     40: #define WWWCACHE_H
                     41: </PRE>
                     42: <PRE>
                     43: #ifdef __cplusplus
                     44: extern "C" { 
                     45: #endif
                     46: </PRE>
2.5     ! frystyk    47: <H3>
        !            48:   System dependencies
        !            49: </H3>
        !            50: <P>
2.4       frystyk    51: The <A HREF="sysdep.html">sysdep.h</A> file includes system-specific include
2.5     ! frystyk    52: files and flags for I/O to network and disk. The only reason for this file
        !            53: is that the Internet world is more complicated than Posix and ANSI.
2.1       frystyk    54: <PRE>
2.5     ! frystyk    55: #include "<A HREF="sysdep.html">sysdep.h</A>"
2.4       frystyk    56: </PRE>
2.5     ! frystyk    57: <H3>
        !            58:   Caching Manager
        !            59: </H3>
        !            60: <P>
        !            61: The cache interface is currently quite simple but at least it shows that
        !            62: it can be done!
        !            63: <PRE>#include "<A HREF="HTCache.html">HTCache.h</A>"
2.1       frystyk    64: </PRE>
                     65: <PRE>
                     66: #ifdef __cplusplus
                     67: } /* end extern C definitions */
                     68: #endif
                     69: 
                     70: #endif
                     71: </PRE>
2.5     ! frystyk    72: <P>
        !            73:   <HR>
2.3       frystyk    74: <ADDRESS>
2.5     ! frystyk    75:   @(#) $Id: WWWCache.html,v 2.4 1996/04/16 16:23:23 frystyk Exp $
2.3       frystyk    76: </ADDRESS>
2.5     ! frystyk    77: </BODY></HTML>

Webmaster