]>
git.ipfire.org Git - thirdparty/squid.git/blob - src/StoreSwapLogData.h
4 * SQUID Web Proxy Cache http://www.squid-cache.org/
5 * ----------------------------------------------------------
7 * Squid is the result of efforts by numerous individuals from
8 * the Internet community; see the CONTRIBUTORS file for full
9 * details. Many organizations have provided support for Squid's
10 * development; see the SPONSORS file for full details. Squid is
11 * Copyrighted (C) 2001 by the Regents of the University of
12 * California; see the COPYRIGHT file for full details. Squid
13 * incorporates software developed and/or copyrighted by other
14 * sources; see the CREDITS file for full details.
16 * This program is free software; you can redistribute it and/or modify
17 * it under the terms of the GNU General Public License as published by
18 * the Free Software Foundation; either version 2 of the License, or
19 * (at your option) any later version.
21 * This program is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU General Public License for more details.
26 * You should have received a copy of the GNU General Public License
27 * along with this program; if not, write to the Free Software
28 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
30 * Copyright (c) 2003, Robert Collins <robertc@squid-cache.org>
33 #ifndef SQUID_STORESWAPLOGDATA_H
34 #define SQUID_STORESWAPLOGDATA_H
37 \defgroup FileFormatSwapStateAPI swap.state File Structure
39 \section ImplementationNotes Implementation Notes
41 * When writing an object to disk, we must first write the meta data.
42 * This is done with a couple of functions. First, storeSwapMetaPack()
43 * takes a StoreEntry as a parameter and returns a tlv linked
44 * list. Second, storeSwapMetaPack() converts the tlv list
45 * into a character buffer that we can write.
47 \note MemObject has a MemObject::swap_hdr_sz.
48 * This value is the size of that character buffer; the size of the
49 * swap file meta data. The StoreEntry has a member
50 * StoreEntry::swap_file_sz that represents the size of the disk file.
51 * Thus, the size of the object "content" is
52 \code StoreEntry->swap_file_sz - MemObject->swap_hdr_sz; \endcode
53 \note The swap file content includes the HTTP reply headers and the HTTP reply body (if any).
56 * When reading a swap file, there is a similar process to extract
57 * the swap meta data. First, storeSwapMetaUnpack() converts a
58 * character buffer into a tlv linked list. It also tells us
59 * the value for MemObject->swap_hdr_sz.
62 #include "squid-old.h"
64 /// maintains a 24-bit checksum over integer fields
65 class SwapChecksum24
{
67 SwapChecksum24() { raw
[0] = raw
[1] = raw
[2] = 0; }
69 bool operator ==(const SwapChecksum24
&o
) const {
70 return raw
[0] == o
.raw
[0] && raw
[1] == o
.raw
[1] && raw
[2] == o
.raw
[2];
73 bool operator !=(const SwapChecksum24
&o
) const {
77 /// compute and store checksum based on three 32bit integers
78 void set(uint32_t f1
, uint32_t f2
, uint32_t f3
);
80 /// compute and store checksum based on int32_t and uint64_t integers
81 void set(int32_t f1
, uint64_t f2
);
83 // printing for debugging
84 std::ostream
&print(std::ostream
&os
) const;
87 uint8_t raw
[3]; // designed to follow "op" members, in pading space
91 operator <<(std::ostream
&os
, const SwapChecksum24
&sum
)
97 \ingroup FielFormatSwapStateAPI
100 * Defines the structure of a binary swap.state file entry for UFS stores.
101 * TODO: Move to fs/ufs (and remove from COSS).
103 \note StoreSwapLogData entries are written in native machine byte order
104 * They are not necessarily portable across architectures.
106 class StoreSwapLogData
110 MEMPROXY_CLASS(StoreSwapLogData
);
112 /// type to use for storing time-related members; must be signed
113 typedef int64_t SwappedTime
;
117 /// consistency self-check: whether the data appears to make sense
120 /// call this before storing the log entry
124 * Either SWAP_LOG_ADD when an object is added to the disk storage,
125 * or SWAP_LOG_DEL when an object is deleted.
130 * Fingerprint to weed out bogus/corrupted swap.state entries.
132 SwapChecksum24 checksum
; // follows "op" because compiler will pad anyway
135 * The 32-bit file number which maps to a pathname.
136 * Only the low 24-bits are relevant. The high 8-bits are
137 * used as an index to an array of storage directories, and
138 * are set at run time because the order of storage directories
139 * may change over time.
144 * A Unix time value that represents the time when
145 * the origin server generated this response. If the response
146 * has a valid Date: header, this timestamp corresponds
147 * to that time. Otherwise, it is set to the Squid process time
148 * when the response is read (as soon as the end of headers are found).
150 SwappedTime timestamp
;
153 * The last time that a client requested this object.
154 * Strictly speaking, this time is set whenever the StoreEntry
155 * is locked (via storeLockObject()).
160 * The value of the response's Expires: header, if any.
161 * If the response does not have an Expires: header, this
163 * If the response has an invalid (unparseable)
164 * Expires: header, it is also set to -1. There are some cases
165 * where Squid sets expires to -2. This happens for the
166 * internal "netdb" object and for FTP URL responses.
171 * The value of the response's Last-modified: header, if any.
172 * This is set to -1 if there is no Last-modified: header,
173 * or if it is unparseable.
178 * This is the number of bytes that the object occupies on
179 * disk. It includes the Squid "swap file header".
181 uint64_t swap_file_sz
;
184 * The number of times that this object has been accessed (referenced).
185 * Since its a 16-bit quantity, it is susceptible to overflow
186 * if a single object is accessed 65,536 times before being replaced.
191 * A copy of the StoreEntry flags field. Used as a sanity
192 * check when rebuilding the cache at startup. Objects that
193 * have the KEY_PRIVATE flag set are not added back to the cache.
198 * The 128-bit MD5 hash for this object.
200 unsigned char key
[SQUID_MD5_DIGEST_LENGTH
];
203 MEMPROXY_CLASS_INLINE(StoreSwapLogData
);
205 /// \ingroup FileFormatSwapStateAPI
206 /// Swap log starts with this binary structure.
207 class StoreSwapLogHeader
210 // sets default values for this Squid version; loaded values may differ
211 StoreSwapLogHeader();
213 /// consistency self-check: whether the data appears to make sense
216 /// number of bytes after the log header before the first log entry
217 size_t gapSize() const;
220 SwapChecksum24 checksum
; // follows "op" because compiler will pad anyway
226 #endif /* SQUID_STORESWAPLOGDATA_H */