| 1 |
Storable 3.05c |
| 2 |
Copyright (c) 1995-2000, Raphael Manfredi |
| 3 |
Copyright (c) 2001-2004, Larry Wall |
| 4 |
Copyright (c) 2016,2017 cPanel Inc |
| 5 |
|
| 6 |
------------------------------------------------------------------------ |
| 7 |
This program is free software; you can redistribute it and/or modify |
| 8 |
it under the same terms as Perl 5 itself. |
| 9 |
|
| 10 |
This program is distributed in the hope that it will be useful, |
| 11 |
but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 12 |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 13 |
Perl 5 License schemes for more details. |
| 14 |
------------------------------------------------------------------------ |
| 15 |
|
| 16 |
+======================================================================= |
| 17 |
| Storable is distributed as a module, but is also part of the official |
| 18 |
| Perl core distribution, as of perl 5.8. |
| 19 |
| Maintenance is partially done by the perl5-porters, and for cperl by cPanel. |
| 20 |
| We thank Raphael Manfredi for providing us with this very useful module. |
| 21 |
+======================================================================= |
| 22 |
|
| 23 |
The Storable extension brings persistence to your data. |
| 24 |
|
| 25 |
You may recursively store to disk any data structure, no matter how |
| 26 |
complex and circular it is, provided it contains only SCALAR, ARRAY, |
| 27 |
HASH (possibly tied) and references (possibly blessed) to those items. |
| 28 |
|
| 29 |
At a later stage, or in another program, you may retrieve data from |
| 30 |
the stored file and recreate the same hiearchy in memory. If you |
| 31 |
had blessed references, the retrieved references are blessed into |
| 32 |
the same package, so you must make sure you have access to the |
| 33 |
same perl class than the one used to create the relevant objects. |
| 34 |
|
| 35 |
There is also a dclone() routine which performs an optimized mirroring |
| 36 |
of any data structure, preserving its topology. |
| 37 |
|
| 38 |
Objects (blessed references) may also redefine the way storage and |
| 39 |
retrieval is performed, and/or what deep cloning should do on those |
| 40 |
objects. |
| 41 |
|
| 42 |
To compile this extension, run: |
| 43 |
|
| 44 |
perl Makefile.PL [PERL_SRC=...where you put perl sources...] |
| 45 |
make |
| 46 |
make install |
| 47 |
|
| 48 |
There is an embedded POD manual page in Storable.pm. |
| 49 |
|
| 50 |
Storable was written by Raphael Manfredi <[email protected]> |
| 51 |
Maintenance is now done by cperl, https://github.com/rurban/Storable/ |
| 52 |
Note that p5p still ships an old broken version, without stack overflow |
| 53 |
protection and large object support. As long as you don't store overlarge |
| 54 |
objects, they are compatible. |
| 55 |
|
| 56 |
Please e-mail us with problems, bug fixes, comments and complaints, |
| 57 |
although if you have complements you should send them to Raphael. |
| 58 |
Please don't e-mail Raphael with problems, as he no longer works on |
| 59 |
Storable, and your message will be delayed while he forwards it to us. |
| 60 |
|
| 61 |
------------------------------------------------------------------------ |
| 62 |
Thanks to (in chronological order): |
| 63 |
|
| 64 |
Jarkko Hietaniemi <[email protected]> |
| 65 |
Ulrich Pfeifer <[email protected]> |
| 66 |
Benjamin A. Holzman <[email protected]> |
| 67 |
Andrew Ford <[email protected]> |
| 68 |
Gisle Aas <[email protected]> |
| 69 |
Jeff Gresham <[email protected]> |
| 70 |
Murray Nesbitt <[email protected]> |
| 71 |
Albert N. Micheev <[email protected]> |
| 72 |
Marc Lehmann <[email protected]> |
| 73 |
Justin Banks <[email protected]> |
| 74 |
Jarkko Hietaniemi <[email protected]> (AGAIN, as perl 5.7.0 Pumpkin!) |
| 75 |
Todd Rinaldo <[email protected]> and JD Lightsey <[email protected]> |
| 76 |
for optional disabling tie and bless for increased security. |
| 77 |
Reini Urban <[email protected]> for the 3.0x >2G support and rewrite |
| 78 |
JD Lightsey <[email protected]> |
| 79 |
|
| 80 |
for their contributions. |
| 81 |
|
| 82 |
A Japanese translation of this man page is available at the Japanized |
| 83 |
Perl Resources Project <https://sourceforge.jp/projects/perldocjp/>. |
| 84 |
------------------------------------------------------------------------ |
| 85 |
|
| 86 |
The perl5-porters would like to thank |
| 87 |
|
| 88 |
Raphael Manfredi <[email protected]> |
| 89 |
|
| 90 |
According to the perl5.8 Changes file, the following people have helped |
| 91 |
bring you this Storable release: |
| 92 |
|
| 93 |
Abhijit Menon-Sen <[email protected]> |
| 94 |
Andreas J. Koenig <[email protected]> |
| 95 |
Archer Sully <[email protected]> |
| 96 |
Craig A. Berry <[email protected]> |
| 97 |
Dan Kogai <[email protected]> |
| 98 |
Doug MacEachern <[email protected]> |
| 99 |
Gurusamy Sarathy <[email protected]> |
| 100 |
H.Merijn Brand <[email protected]> |
| 101 |
Jarkko Hietaniemi <[email protected]> |
| 102 |
Mark Bixby |
| 103 |
Michael Stevens <[email protected]> |
| 104 |
Mike Guy <[email protected]> |
| 105 |
Nicholas Clark <[email protected]> |
| 106 |
Peter J. Farley III <[email protected]> |
| 107 |
Peter Prymmer <[email protected]> |
| 108 |
Philip Newton <[email protected]> |
| 109 |
Raphael Manfredi <[email protected]> |
| 110 |
Robin Barker <[email protected]> |
| 111 |
Radu Greab <[email protected]> |
| 112 |
Tim Bunce <[email protected]> |
| 113 |
VMSperlers |
| 114 |
Yitzchak Scott-Thoennes <[email protected]> |