2 * \file ConverterCache.cpp
3 * This file is part of LyX, the document processor.
4 * Licence details can be found in the file COPYING.
7 * \author Angus Leeming
10 * Full author contact details are available in file CREDITS.
15 #include "ConverterCache.h"
22 #include "support/convert.h"
23 #include "support/debug.h"
24 #include "support/filetools.h"
25 #include "support/lyxtime.h"
26 #include "support/Package.h"
28 #include "support/lassert.h"
29 #include <boost/crc.hpp>
38 using namespace lyx::support;
44 unsigned long do_crc(string const & s)
46 boost::crc_32_type crc;
47 crc = for_each(s.begin(), s.end(), crc);
48 return crc.checksum();
53 // This should be OK because it is only assigned during init()
54 static FileName cache_dir;
59 CacheItem() : timestamp(0), checksum(0) {}
60 CacheItem(FileName const & orig_from, string const & to_format,
61 time_t t, unsigned long c)
62 : timestamp(t), checksum(c)
65 os << setw(10) << setfill('0') << do_crc(orig_from.absFileName())
67 cache_name = FileName(addName(cache_dir.absFileName(), os.str()));
68 LYXERR(Debug::FILES, "Add file cache item " << orig_from
69 << ' ' << to_format << ' ' << cache_name
70 << ' ' << long(timestamp) << ' ' << checksum << '.');
76 unsigned long checksum;
82 /** The cache contains one item per orig file and target format, so use a
83 * nested map to find the cache item quickly by filename and format.
85 typedef map<string, CacheItem> FormatCacheType;
88 /// Format of the source file
90 /// Cache target format -> item to quickly find the item by format
91 FormatCacheType cache;
93 typedef map<FileName, FormatCache> CacheType;
96 class ConverterCache::Impl {
103 CacheItem * find(FileName const & from, string const & format);
108 void ConverterCache::Impl::readIndex()
110 time_t const now = current_time();
111 FileName const index(addName(cache_dir.absFileName(), "index"));
112 ifstream is(index.toFilesystemEncoding().c_str());
118 string const orig_from = lex.getString();
121 string const to_format = lex.getString();
124 time_t const timestamp =
125 convert<unsigned long>(lex.getString());
128 unsigned long const checksum =
129 convert<unsigned long>(lex.getString());
130 FileName const orig_from_name(orig_from);
131 CacheItem item(orig_from_name, to_format, timestamp, checksum);
133 // Don't cache files that do not exist anymore
134 if (!orig_from_name.exists()) {
135 LYXERR(Debug::FILES, "Not caching file `"
136 << orig_from << "' (does not exist anymore).");
137 item.cache_name.removeFile();
141 // Don't add items that are not in the cache anymore
142 // This can happen if two instances of LyX are running
143 // at the same time and update the index file independantly.
144 if (!item.cache_name.exists()) {
145 LYXERR(Debug::FILES, "Not caching file `" << orig_from
146 << "' (cached copy does not exist anymore).");
150 // Delete the cached file if it is too old
151 if (difftime(now, item.cache_name.lastModified())
152 > lyxrc.converter_cache_maxage) {
153 LYXERR(Debug::FILES, "Not caching file `"
154 << orig_from << "' (too old).");
155 item.cache_name.removeFile();
159 FormatCache & format_cache = cache[orig_from_name];
160 if (format_cache.from_format.empty())
161 format_cache.from_format =
162 formats.getFormatFromFile(orig_from_name);
163 format_cache.cache[to_format] = item;
169 void ConverterCache::Impl::writeIndex()
171 FileName const index(addName(cache_dir.absFileName(), "index"));
172 ofstream os(index.toFilesystemEncoding().c_str());
174 if (!index.changePermission(0600))
176 os.open(index.toFilesystemEncoding().c_str());
177 CacheType::iterator it1 = cache.begin();
178 CacheType::iterator const end1 = cache.end();
179 for (; it1 != end1; ++it1) {
180 FormatCacheType const & format_cache = it1->second.cache;
181 FormatCacheType::const_iterator it2 = format_cache.begin();
182 FormatCacheType::const_iterator const end2 = format_cache.end();
183 for (; it2 != end2; ++it2)
184 os << Lexer::quoteString(it1->first.absFileName())
185 << ' ' << it2->first << ' '
186 << it2->second.timestamp << ' '
187 << it2->second.checksum << '\n';
193 CacheItem * ConverterCache::Impl::find(FileName const & from,
194 string const & format)
196 if (!lyxrc.use_converter_cache)
198 CacheType::iterator const it1 = cache.find(from);
199 if (it1 == cache.end())
201 FormatCacheType & format_cache = it1->second.cache;
202 FormatCacheType::iterator const it2 = format_cache.find(format);
203 if (it2 == format_cache.end())
205 return &(it2->second);
209 /////////////////////////////////////////////////////////////////////
213 /////////////////////////////////////////////////////////////////////
215 ConverterCache::ConverterCache()
220 ConverterCache::~ConverterCache()
227 ConverterCache & ConverterCache::get()
229 // Now return the cache
230 static ConverterCache singleton;
235 void ConverterCache::init()
237 if (!lyxrc.use_converter_cache)
239 // We do this here and not in the constructor because package() gets
240 // initialized after all static variables.
241 cache_dir = FileName(addName(package().user_support().absFileName(), "cache"));
242 if (!cache_dir.exists())
243 if (!cache_dir.createDirectory(0700)) {
244 lyxerr << "Could not create cache directory `"
245 << cache_dir << "'." << endl;
248 get().pimpl_->readIndex();
252 void ConverterCache::writeIndex() const
254 if (!lyxrc.use_converter_cache
255 || cache_dir.empty())
257 pimpl_->writeIndex();
261 void ConverterCache::add(FileName const & orig_from, string const & to_format,
262 FileName const & converted_file) const
264 if (!lyxrc.use_converter_cache || orig_from.empty() ||
265 converted_file.empty())
267 LYXERR(Debug::FILES, ' ' << orig_from
268 << ' ' << to_format << ' ' << converted_file);
270 // FIXME: Should not hardcode this (see bug 3819 for details)
271 if (to_format == "pstex") {
272 FileName const converted_eps(changeExtension(converted_file.absFileName(), "eps"));
273 add(orig_from, "eps", converted_eps);
274 } else if (to_format == "pdftex") {
275 FileName const converted_pdf(changeExtension(converted_file.absFileName(), "pdf"));
276 add(orig_from, "pdf6", converted_pdf);
279 // Is the file in the cache already?
280 CacheItem * item = pimpl_->find(orig_from, to_format);
282 time_t const timestamp = orig_from.lastModified();
283 Mover const & mover = getMover(to_format);
285 LYXERR(Debug::FILES, "ConverterCache::add(" << orig_from << "):\n"
286 "The file is already in the cache.");
287 // First test for timestamp
288 if (timestamp == item->timestamp) {
289 LYXERR(Debug::FILES, "Same timestamp.");
292 // Maybe the contents is still the same?
293 item->timestamp = timestamp;
294 unsigned long const checksum = orig_from.checksum();
295 if (checksum == item->checksum) {
296 LYXERR(Debug::FILES, "Same checksum.");
299 item->checksum = checksum;
300 if (!mover.copy(converted_file, item->cache_name,
301 onlyFileName(item->cache_name.absFileName()))) {
302 LYXERR(Debug::FILES, "Could not copy file " << orig_from << " to "
303 << item->cache_name);
304 } else if (!item->cache_name.changePermission(0600)) {
305 LYXERR(Debug::FILES, "Could not change file mode"
306 << item->cache_name);
309 CacheItem new_item(orig_from, to_format, timestamp,
310 orig_from.checksum());
311 if (mover.copy(converted_file, new_item.cache_name,
312 onlyFileName(new_item.cache_name.absFileName()))) {
313 if (!new_item.cache_name.changePermission(0600)) {
314 LYXERR(Debug::FILES, "Could not change file mode"
315 << new_item.cache_name);
317 FormatCache & format_cache = pimpl_->cache[orig_from];
318 if (format_cache.from_format.empty())
319 format_cache.from_format =
320 formats.getFormatFromFile(orig_from);
321 format_cache.cache[to_format] = new_item;
323 LYXERR(Debug::FILES, "ConverterCache::add(" << orig_from << "):\n"
324 "Could not copy file.");
329 void ConverterCache::remove(FileName const & orig_from,
330 string const & to_format) const
332 if (!lyxrc.use_converter_cache || orig_from.empty())
334 LYXERR(Debug::FILES, orig_from << ' ' << to_format);
336 CacheType::iterator const it1 = pimpl_->cache.find(orig_from);
337 if (it1 == pimpl_->cache.end())
339 FormatCacheType & format_cache = it1->second.cache;
340 FormatCacheType::iterator const it2 = format_cache.find(to_format);
341 if (it2 == format_cache.end())
344 format_cache.erase(it2);
345 if (format_cache.empty())
346 pimpl_->cache.erase(it1);
350 void ConverterCache::remove_all(string const & from_format,
351 string const & to_format) const
353 if (!lyxrc.use_converter_cache)
355 CacheType::iterator it1 = pimpl_->cache.begin();
356 while (it1 != pimpl_->cache.end()) {
357 if (it1->second.from_format != from_format) {
361 FormatCacheType & format_cache = it1->second.cache;
362 FormatCacheType::iterator it2 = format_cache.begin();
363 while (it2 != format_cache.end()) {
364 if (it2->first == to_format) {
365 LYXERR(Debug::FILES, "Removing file cache item "
366 << it1->first << ' ' << to_format);
367 it2->second.cache_name.removeFile();
368 format_cache.erase(it2);
369 // Have to start over again since items in a
370 // map are not ordered
371 it2 = format_cache.begin();
376 if (format_cache.empty()) {
377 pimpl_->cache.erase(it1);
378 // Have to start over again since items in a map are
380 it1 = pimpl_->cache.begin();
385 pimpl_->writeIndex();
389 bool ConverterCache::inCache(FileName const & orig_from,
390 string const & to_format) const
392 if (!lyxrc.use_converter_cache || orig_from.empty())
394 LYXERR(Debug::FILES, orig_from << ' ' << to_format);
396 CacheItem * const item = pimpl_->find(orig_from, to_format);
398 LYXERR(Debug::FILES, "not in cache.");
402 // Special handling of pstex and pdftex formats: These are only
403 // considered to be in the cache if the corresponding graphics
404 // fiels are there as well. Otherwise copy() of the graphics below
406 // FIXME: Should not hardcode this (see bug 3819 for details)
407 if (to_format == "pstex") {
408 if (!inCache(orig_from, "eps"))
410 } else if (to_format == "pdftex") {
411 if (!inCache(orig_from, "pdf6"))
415 time_t const timestamp = orig_from.lastModified();
416 if (item->timestamp == timestamp) {
417 LYXERR(Debug::FILES, "identical timestamp.");
420 if (item->checksum == orig_from.checksum()) {
421 item->timestamp = timestamp;
422 LYXERR(Debug::FILES, "identical checksum.");
425 LYXERR(Debug::FILES, "in cache, but too old.");
430 FileName const & ConverterCache::cacheName(FileName const & orig_from,
431 string const & to_format) const
433 LYXERR(Debug::FILES, orig_from << ' ' << to_format);
435 CacheItem * const item = pimpl_->find(orig_from, to_format);
436 LASSERT(item, { static const FileName fn; return fn; });
437 return item->cache_name;
441 bool ConverterCache::copy(FileName const & orig_from, string const & to_format,
442 FileName const & dest) const
444 if (!lyxrc.use_converter_cache || orig_from.empty() || dest.empty())
446 LYXERR(Debug::FILES, orig_from << ' ' << to_format << ' ' << dest);
448 // FIXME: Should not hardcode this (see bug 3819 for details)
449 if (to_format == "pstex") {
450 FileName const dest_eps(changeExtension(dest.absFileName(), "eps"));
451 if (!copy(orig_from, "eps", dest_eps))
453 } else if (to_format == "pdftex") {
454 FileName const dest_pdf(changeExtension(dest.absFileName(), "pdf"));
455 if (!copy(orig_from, "pdf6", dest_pdf))
459 CacheItem * const item = pimpl_->find(orig_from, to_format);
460 LASSERT(item, return false);
461 Mover const & mover = getMover(to_format);
462 return mover.copy(item->cache_name, dest,
463 onlyFileName(dest.absFileName()));