|$store = File::HStore->new($path,$digest,$prefix)||This constructor returns a new File::HFile object encapsulating a specific store. The path specifies where the HStore is located on the filesystem. If the path is not specified, the path ~/.hstore is used. The digest specifies the algorithm to be used (SHA-1 or SHA-2 or the submission date called FAT). If not specified, SHA-1 is used. Various digest can be mixed in the same path but the utility is somewhat limited. The $prefix is only an extension used for the FAT (Free Archive Format) format to specify the archive unique name.|
|$store->add($filename)||The $filename is the file to be added in the store. The return value is the hash value ($id) of the $filename stored. Return undef on error.|
Return the filesystem location of the file specified by its hash value.
Return undef on error.
The $hashvalue is the file to be removed from the store.
Return false on success and undef on error.
There is a web page for the File::HStore module at the following location : http://www.foo.be/hstore/
If you plan to use a hash-based storage (like File::HStore), dont forget to read the following paper and check the impact for your application :
An Analysis of Compare-by-hash - http://www.usenix.org/events/hotos03/tech/full_papers/henson/henson.pdf
Please also consider the security impact in your application concerning the statement made by the NIST regarding the overall security impact of the SHA-1 vulnereability. In the use of storage and unique identifier only , the impact is somewhat very limited.
Alexandre adulau Dulaunoy, <firstname.lastname@example.org>
Copyright (C) 2004-2008 by Alexandre Dulaunoy <email@example.com>
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.5 or, at your option, any later version of Perl 5 you may have available.
|perl v5.20.3||FILE::HSTORE (3)||2008-06-01|