Commit | Line | Data |
---|---|---|
a258c17c | 1 | Storable 3.05c |
7a6a85bf | 2 | Copyright (c) 1995-2000, Raphael Manfredi |
dcf2e277 | 3 | Copyright (c) 2001-2004, Larry Wall |
a258c17c | 4 | Copyright (c) 2016,2017 cPanel Inc |
7a6a85bf RG |
5 | |
6 | ------------------------------------------------------------------------ | |
7 | This program is free software; you can redistribute it and/or modify | |
9e21b3d0 | 8 | it under the same terms as Perl 5 itself. |
7a6a85bf RG |
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 | |
9e21b3d0 | 13 | Perl 5 License schemes for more details. |
7a6a85bf RG |
14 | ------------------------------------------------------------------------ |
15 | ||
7a6a85bf | 16 | +======================================================================= |
9e21b3d0 | 17 | | Storable is distributed as a module, but is also part of the official |
0ba8809e | 18 | | Perl core distribution, as of perl 5.8. |
1cb8a344 RU |
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. | |
7a6a85bf RG |
21 | +======================================================================= |
22 | ||
c4a6f826 | 23 | The Storable extension brings persistence to your data. |
7a6a85bf RG |
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 | ||
c4a6f826 | 48 | There is an embedded POD manual page in Storable.pm. |
7a6a85bf | 49 | |
0ba8809e | 50 | Storable was written by Raphael Manfredi <Raphael_Manfredi@pobox.com> |
dd7f75e0 RU |
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. | |
0ba8809e NC |
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. | |
7a6a85bf RG |
60 | |
61 | ------------------------------------------------------------------------ | |
9e21b3d0 | 62 | Thanks to (in chronological order): |
7a6a85bf RG |
63 | |
64 | Jarkko Hietaniemi <jhi@iki.fi> | |
65 | Ulrich Pfeifer <pfeifer@charly.informatik.uni-dortmund.de> | |
51f77169 | 66 | Benjamin A. Holzman <bholzman@earthlink.net> |
7a6a85bf RG |
67 | Andrew Ford <A.Ford@ford-mason.co.uk> |
68 | Gisle Aas <gisle@aas.no> | |
69 | Jeff Gresham <gresham_jeffrey@jpmorgan.com> | |
70 | Murray Nesbitt <murray@activestate.com> | |
71 | Albert N. Micheev <Albert.N.Micheev@f80.n5049.z2.fidonet.org> | |
72 | Marc Lehmann <pcg@opengroup.org> | |
25f64a11 AMS |
73 | Justin Banks <justinb@wamnet.com> |
74 | Jarkko Hietaniemi <jhi@iki.fi> (AGAIN, as perl 5.7.0 Pumpkin!) | |
a258c17c RU |
75 | Todd Rinaldo <toddr@cpanel.net> and JD Lightsey <jd@cpanel.net> |
76 | for optional disabling tie and bless for increased security. | |
dd7f75e0 | 77 | Reini Urban <rurban@cpanel.net> for the 3.0x >2G support and rewrite |
a258c17c | 78 | JD Lightsey <jd@cpanel.net> |
7a6a85bf RG |
79 | |
80 | for their contributions. | |
81 | ||
7c89f822 KT |
82 | A Japanese translation of this man page is available at the Japanized |
83 | Perl Resources Project <https://sourceforge.jp/projects/perldocjp/>. | |
7a6a85bf | 84 | ------------------------------------------------------------------------ |
0ba8809e NC |
85 | |
86 | The perl5-porters would like to thank | |
87 | ||
88 | Raphael Manfredi <Raphael_Manfredi@pobox.com> | |
89 | ||
83046dfb | 90 | According to the perl5.8 Changes file, the following people have helped |
0ba8809e NC |
91 | bring you this Storable release: |
92 | ||
93 | Abhijit Menon-Sen <ams@wiw.org> | |
94 | Andreas J. Koenig <andreas.koenig@anima.de> | |
95 | Archer Sully <archer@meer.net> | |
96 | Craig A. Berry <craig.berry@psinetcs.com> | |
97 | Dan Kogai <dankogai@dan.co.jp> | |
98 | Doug MacEachern <dougm@covalent.net> | |
99 | Gurusamy Sarathy <gsar@ActiveState.com> | |
3bd76f0a | 100 | H.Merijn Brand <h.m.brand@xs4all.nl> |
0ba8809e NC |
101 | Jarkko Hietaniemi <jhi@iki.fi> |
102 | Mark Bixby | |
103 | Michael Stevens <michael@etla.org> | |
104 | Mike Guy <mjtg@cam.ac.uk> | |
105 | Nicholas Clark <nick@unfortu.net> | |
106 | Peter J. Farley III <pjfarley@banet.net> | |
107 | Peter Prymmer <pvhp@forte.com> | |
83046dfb | 108 | Philip Newton <pne@cpan.org> |
0ba8809e NC |
109 | Raphael Manfredi <Raphael_Manfredi@pobox.com> |
110 | Robin Barker <rmb1@cise.npl.co.uk> | |
111 | Radu Greab <radu@netsoft.ro> | |
112 | Tim Bunce <Tim.Bunce@pobox.com> | |
113 | VMSperlers | |
114 | Yitzchak Scott-Thoennes <sthoenna@efn.org> |