/usr/share/polipo/www/doc/Disk-format.html is in polipo 1.0.4.1-1.2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 | <html lang="en">
<head>
<title>Disk format - The Polipo Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="The Polipo Manual">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Disk-cache.html#Disk-cache" title="Disk cache">
<link rel="prev" href="Purging.html#Purging" title="Purging">
<link rel="next" href="Modifying-the-on_002ddisk-cache.html#Modifying-the-on_002ddisk-cache" title="Modifying the on-disk cache">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
Copyright (C) 2003 -- 2006 by Juliusz Chroboczek.-->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
pre.display { font-family:inherit }
pre.format { font-family:inherit }
pre.smalldisplay { font-family:inherit; font-size:smaller }
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
span.sc { font-variant:small-caps }
span.roman { font-family:serif; font-weight:normal; }
span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<div class="node">
<a name="Disk-format"></a>
<p>
Next: <a rel="next" accesskey="n" href="Modifying-the-on_002ddisk-cache.html#Modifying-the-on_002ddisk-cache">Modifying the on-disk cache</a>,
Previous: <a rel="previous" accesskey="p" href="Purging.html#Purging">Purging</a>,
Up: <a rel="up" accesskey="u" href="Disk-cache.html#Disk-cache">Disk cache</a>
<hr>
</div>
<h4 class="subsection">4.3.3 Format of the on-disk cache</h4>
<p><a name="index-DISK_005fCACHE_005fBODY_005fOFFSET-219"></a><a name="index-on_002ddisk-file-220"></a><a name="index-on_002ddisk-cache-221"></a>
The on-disk cache consists of a collection of files, one per instance.
The format of an on-disk resource is similar to that of an HTTP
message: it starts with an HTTP status line, followed by HTTP headers,
followed by a blank line (‘<samp><span class="samp">\r\n\r\n</span></samp>’). The blank line is
optionally followed by a number of binary zeroes. The body of the
instance follows.
<p>The headers of an on-disk file have a few minor differences with HTTP
messages. Obviously, there is never a ‘<samp><span class="samp">Transfer-Encoding</span></samp>’ line.
A few additional headers are used by Polipo for its internal
bookkeeping:
<ul>
<li>‘<samp><span class="samp">X-Polipo-Location</span></samp>’: this is the URL of the resource stored in this
file. This is always present.
<li>‘<samp><span class="samp">X-Polipo-Date</span></samp>’: this is Polipo's estimation of the date at which
this instance was last validated, and is used for generating the
‘<samp><span class="samp">Age</span></samp>’ header of HTTP messages. This is optional, and only stored
if different from the instance's date.
<li>‘<samp><span class="samp">X-Polipo-Access</span></samp>’: this is the date when the instance was last
accessed by Polipo, and is used for cache purging (see <a href="Purging.html#Purging">Purging</a>).
This is optional, and is absent if the instance was never accessed.
<li>‘<samp><span class="samp">X-Polipo-Body-Offset</span></samp>’: the presence of this line indicates that
the blank line following the headers is followed by a number of zero
bytes. Its value is an integer, which indicates the offset since the
beginning of the file at which the instance body actually starts.
This line is optional, and if absent the body starts immediately after
the blank line.
</ul>
</body></html>
|