1 /* LBS: An LFS-inspired filesystem backup system Copyright (C) 2007 Michael
4 * To speed backups, we maintain a "stat cache" containing selected information
5 * about all regular files, including modification times and the list of blocks
6 * that comprised the file in the last backup. If the file has not changed
7 * according to a stat() call, we may re-use the information contained in the
8 * stat cache instead of re-reading the entire file. It is always safe to
9 * discard information from the stat cache; this will only cause a file to be
10 * re-read to determine that it contains the same data as before.
12 * The stat cache is stored in a file called "statcache" in the local backup
13 * directory. During a backup, a new statcache file is written out with a
14 * suffix based on the current time; at the end of a successful backup this
15 * file is renamed over the original statcache file.
17 * The information in the statcache file is stored in sorted order as we
18 * traverse the filesystem, so that we can read and write it in a purely
19 * streaming manner. (This is why we don't include the information in the
20 * SQLite local database; doing so is likely less efficient.)
35 #include "statcache.h"
44 /* Like strcmp, but sorts in the order that files will be visited in the
45 * filesystem. That is, we break paths apart at slashes, and compare path
46 * components separately. */
47 static int pathcmp(const char *path1, const char *path2)
49 /* Find the first component in each path. */
50 const char *slash1 = strchr(path1, '/');
51 const char *slash2 = strchr(path2, '/');
58 comp1 = string(path1, slash1 - path1);
63 comp2 = string(path2, slash2 - path2);
65 /* Directly compare the two components first. */
72 if (slash1 == NULL && slash2 == NULL)
79 return pathcmp(slash1 + 1, slash2 + 1);
82 void StatCache::Open(const char *path, const char *snapshot_name)
85 oldpath += "/statcache";
86 newpath = oldpath + "." + snapshot_name;
88 oldcache = new ifstream(oldpath.c_str());
89 newcache = new ofstream(newpath.c_str());
91 /* Read the first entry from the old stat cache into memory before we
96 void StatCache::Close()
103 if (rename(newpath.c_str(), oldpath.c_str()) < 0) {
104 fprintf(stderr, "Error renaming statcache from %s to %s: %m\n",
105 newpath.c_str(), oldpath.c_str());
109 /* Read the next entry from the old statcache file and cache it in memory. */
110 void StatCache::ReadNext()
112 if (oldcache == NULL) {
117 std::istream &cache = *oldcache;
118 map<string, string> fields;
124 old_contents.clear();
126 /* First, read in the filename. */
127 getline(cache, old_name);
133 /* Start reading in the fields which follow the filename. */
135 while (!cache.eof()) {
137 getline(cache, line);
138 const char *s = line.c_str();
140 /* Is the line blank? If so, we have reached the end of this entry. */
141 if (s[0] == '\0' || s[0] == '\n')
144 /* Is this a continuation line? (Does it start with whitespace?) */
145 if (isspace(s[0]) && field != "") {
146 fields[field] += line;
150 /* For lines of the form "Key: Value" look for ':' and split the line
152 const char *value = strchr(s, ':');
155 field = string(s, value - s);
158 while (isspace(*value))
161 fields[field] = value;
164 /* Parse the easy fields: mtime, ctime, inode, checksum, ... */
165 if (fields.count("mtime"))
166 old_mtime = parse_int(fields["mtime"]);
167 if (fields.count("ctime"))
168 old_ctime = parse_int(fields["ctime"]);
169 if (fields.count("inode"))
170 old_inode = parse_int(fields["inode"]);
172 old_checksum = fields["checksum"];
174 /* Parse the list of blocks. */
175 const char *s = fields["blocks"].c_str();
183 while (*s != '\0' && !isspace(*s)) {
191 ObjectReference *r = ObjectReference::parse(ref);
193 old_contents.push_back(*r);
198 end_of_cache = false;
201 /* Find information about the given filename in the old stat cache, if it
203 bool StatCache::Find(const string &path, const struct stat *stat_buf)
205 while (!end_of_cache && pathcmp(old_name.c_str(), path.c_str()) < 0)
208 /* Could the file be found at all? */
211 if (old_name != path)
214 /* Check to see if the file is unchanged. */
215 if (stat_buf->st_mtime != old_mtime)
217 if (stat_buf->st_ctime != old_ctime)
219 if ((long long)stat_buf->st_ino != old_inode)
222 /* File looks to be unchanged. */
226 /* Save stat information about a regular file for future invocations. */
227 void StatCache::Save(const string &path, struct stat *stat_buf,
228 const string &checksum, const list<string> &blocks)
230 *newcache << uri_encode(path) << "\n";
231 *newcache << "mtime: " << encode_int(stat_buf->st_mtime) << "\n"
232 << "ctime: " << encode_int(stat_buf->st_ctime) << "\n"
233 << "inode: " << encode_int(stat_buf->st_ino) << "\n"
234 << "checksum: " << checksum << "\n";
236 *newcache << "blocks:";
237 if (blocks.size() == 0)
239 for (list<string>::const_iterator i = blocks.begin();
240 i != blocks.end(); ++i) {
241 *newcache << " " << *i << "\n";