
Make::Cache::Runtime - Simple database of completion times

$string = format_time($seconds, $true_to_including_hours);
Make::Cache::Runtime::write (key=>$key,
persist=>{testing_persistence=>1},
);
my $persistref = Make::Cache::Runtime::read (key=>'make::runtime testing',);

Make::Cache::Runtime allows for storing and retrieving persistent state, namely expected runtime of gcc and tests.
Data is stored in a global directory, presumably under NFS mount across all systems. While this does not allow atomic access to files, it does provide fast, catchable access to the database.

Return the default directory name for the cache. With optional argument, set the cache directory name. Defaults to OBJCACHE_RUNTIME_DIR.
Return the time in seconds as a string in MM:SS format. With true second argument, return as HH:MM:SS.
Hash the key, and write a database entry file with a copy of the data in the persist reference. With dir=> named parameter, use database in that directory. Note to prevent problems between different versions of perl, you may want to include the Perl version number in the key hash.
Return a object reference for the data stored under the given key, or undef if not found. With dir=> named parameter, use database in that directory.
Print a summary of the runtime database for debugging. With dir=> named parameter, use database in that directory.

/usr/local/common/lib/runtime Default for cache_dir()

Specifies the directory containing the runtime database. Defaults to /usr/local/common/lib/runtime.

The latest version is available from CPAN and from http://www.veripool.org/.
Copyright 2000-2009 by Wilson Snyder. This package is free software; you can redistribute it and/or modify it under the terms of either the GNU Lesser General Public License Version 3 or the Perl Artistic License Version 2.0.

Wilson Snyder <wsnyder@wsnyder.org>
