Debian Codegraph @

README

raw
1 NAME
2
3 Hash::SharedMem - efficient shared mutable hash
4
5 DESCRIPTION
6
7 This module provides a facility for efficiently sharing mutable data
8 between processes on one host. Data is organised as a key/value store,
9 resembling a Perl hash. The keys and values are restricted to octet
10 (Latin-1) strings. Structured objects may be stored by serialising them
11 using a mechanism such as Sereal.
12
13 The data is represented in files that are mapped into each process's
14 memory space, which for interprocess communication amounts to the
15 processes sharing memory. Processes are never blocked waiting for each
16 other. The use of files means that there is some persistence, with the
17 data continuing to exist when there are no processes with it mapped.
18
19 The data structure is optimised for the case where all the data fits
20 into RAM. This happens either via buffering of a disk-based filesystem,
21 or as the normal operation of a memory-backed filesystem, in either case
22 as long as there isn't much swapping activity. If RAM isn't large enough,
23 such that the data has to reside mainly on disk and parts of it have to
24 be frequently reread from disk, speed will seriously suffer. The data
25 structure exhibits poor locality of reference, and is not designed to
26 play nicely with filesystem block sizes.
27
28 INSTALLATION
29
30 perl Build.PL
31 ./Build
32 ./Build test
33 ./Build install
34
35 AUTHOR
36
37 Andrew Main (Zefram) <[email protected]>
38
39 COPYRIGHT
40
41 Copyright (C) 2014, 2015 PhotoBox Ltd
42
43 Copyright (C) 2014, 2015, 2017 Andrew Main (Zefram) <[email protected]>
44
45 LICENSE
46
47 This module is free software; you can redistribute it and/or modify it
48 under the same terms as Perl itself.