| 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. |