CHI::Driver::FastMmap(User Contributed Perl DocumentatCHI::Driver::FastMmap(3)NAMECHI::Driver::FastMmap - Persistent interprocess cache via mmap'ed files
VERSION
version 0.55
SYNOPSIS
use CHI;
my $cache = CHI->new(
driver => 'FastMmap',
root_dir => '/path/to/cache/root',
cache_size => '1m'
);
DESCRIPTION
This cache driver uses Cache::FastMmap to store data in an mmap'ed
file. It is very fast, and can be used to share data between processes
on a single host, though not between hosts.
To support namespaces, this driver takes a directory parameter rather
than a file, and creates one Cache::FastMMap file for each namespace.
Because CHI handles serialization automatically, we pass the
"raw_values" flag as 1; and to conform to the CHI API, we pass
"unlink_on_exit" as 0, so that all cache files are permanent.
REQUIREMENTS
You will need to install Cache::FastMmap from CPAN to use this driver.
CONSTRUCTOR OPTIONS
root_dir
Path to the directory that will contain the share files, one per
namespace. Defaults to a directory called 'chi-driver-fastmmap'
under the OS default temp directory (e.g. '/tmp' on UNIX).
dir_create_mode
Permissions mode to use when creating directories. Defaults to
0775.
Any other constructor options not recognized by CHI are passed along to
Cache::FastMmap->new.
METHODS
fm_cache
Returns a handle to the underlying Cache::FastMmap object. You can
use this to call FastMmap-specific methods that are not supported
by the general API, e.g.
$self->fm_cache->get_and_set("key", sub { ... });
SEE ALSO
CHI
AUTHOR
Jonathan Swartz <swartz@pobox.com>
COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Jonathan Swartz.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
perl v5.14.2 2012-07-04 CHI::Driver::FastMmap(3)