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