digest::whirlpool(3pm) [debian man page]
Whirlpool(3pm) User Contributed Perl Documentation Whirlpool(3pm) NAME
Digest::Whirlpool - A 512-bit, collision-resistant, one-way hash function ABSTRACT
WHIRLPOOL is a 512-bit, collision-resistant, one-way hash function developed by Paulo S. L. M. Barreto and Vincent Rijmen. It has been recommended by the NESSIE project (along with SHA-256/384/512) and adopted as ISO/IEC 10118-3. SYNOPSIS
In programs: # Using L<Digest> (recommended) use Digest; my $whirlpool = Digest->new( 'Whirlpool' ); # Get a hash and reset the object $whirlpool->add( "hash this" ); my $hexdigest = $whirlpool->hexdigest; # Populate the object again, and clone it before getting the # digest to avoid resetting $whirlpool->add( "hash this" ); my $b64digest = $whirlpool->clone->b64digest; $whirlpool->add( "add this to the hash" ); # Using this module directly (same interface) use Digest::Whirlpool; my $whirlpool = Digest->new( 'Whirlpool' ); $whirlpool->add( ... ); .... From the command line: whirlpoolsum files whirlpoolsum --help DESCRIPTION
Provides an interface to the WHIRLPOOL hash algorithm. This module subclasses Digest::base and can be used either directly or through the Digest meta-module. Using the latter is recommended. EXPORT
None. METHODS
Since this module implements the standard Digest interface and should be used through the Digest module you should look at that documentation for the general interface, below is a description of methods that differ. clone Copy the internal state of the current object into a new object and return it. reset Resets the object to the same internal state it was in when it was constructed. This works exactly like "new" except it doesn't allocate new memory for its internal state. base64digest An legacy alias for the b64digest method which should be used instead. hashsize Returns the size (in bits) of a WHIRLPOOL hash, i.e. 512. SEE ALSO
o NESSIE consortium, Portfolio of recommended cryptographic primitives, February 27, 2003. o <http://paginas.terra.com.br/informatica/paulobarreto/WhirlpoolPage.html> AUTHORS &; HISTORY The original version of this package was written by Julius C. Duque in 2003. It was rewritten by var Arnfjoer` Bjarmason <avar@cpan.org> in January 2007 who added compatability with the Digest interface, improved documentation and a whirlpoolsum(1) command-line utility amongst other things. BUGS
Please report any bugs that aren't already listed at http://rt.cpan.org/Dist/Display.html?Queue=Digest-Whirlpool <http://rt.cpan.org/Dist/Display.html?Queue=Digest-Whirlpool> to http://rt.cpan.org/Public/Bug/Report.html?Queue=Digest-Whirlpool <http://rt.cpan.org/Public/Bug/Report.html?Queue=Digest-Whirlpool> LICENSE
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Copyright 2003 Julius C. Duque and 2007 and 2009 var Arnfjoer` Bjarmason. perl v5.14.2 2009-10-19 Whirlpool(3pm)
Check Out this Related Man Page
DBIx::Class::EncodedColumn::Digest(3pm) User Contributed Perl Documentation DBIx::Class::EncodedColumn::Digest(3pm) NAME
DBIx::Class::EncodedColumn::Digest - Digest backend SYNOPSYS
#SHA-1 / hex encoding / generate check method __PACKAGE__->add_columns( 'password' => { data_type => 'CHAR', size => 40 + 10, encode_column => 1, encode_class => 'Digest', encode_args => {algorithm => 'SHA-1', format => 'hex', salt_length => 10}, encode_check_method => 'check_password', } #SHA-256 / base64 encoding / generate check method __PACKAGE__->add_columns( 'password' => { data_type => 'CHAR', size => 40, encode_column => 1, encode_class => 'Digest', encode_check_method => 'check_password', #no encode_args necessary because these are the defaults ... } DESCRIPTION
ACCEPTED ARGUMENTS
format The encoding to use for the digest. Valid values are 'binary', 'hex', and 'base64'. Will default to 'base64' if not specified. algorithm The digest algorithm to use for the digest. You may specify any valid Digest algorithm. Examples are MD5, SHA-1, Whirlpool etc. Will default to 'SHA-256' if not specified. See Digest for supported digest algorithms. salt_length If you would like to use randomly generated salts to encode values make sure this option is set to > 0. Salts will be automatically generated at encode time and will be appended to the end of the digest. Please make sure that you remember to make sure that to expand the size of your db column to have enough space to store both the digest AND the salt. Please see list below for common digest lengths. METHODS
make_encode_sub $column_name, \%encode_args Returns a coderef that takes two arguments, a plaintext value and an optional salt and returns the encoded value with the salt appended to the end of the digest. If a salt is not provided and the salt_length option was greater than zero it will be randomly generated. make_check_sub $column_name, \%encode_args Returns a coderef that takes the row object and a plaintext value and will return a boolean if the plaintext matches the encoded value. This is typically used for password authentication. COMMON DIGEST LENGTHS
CIPHER | Binary | Base64 | Hex --------------------------------------- | MD2 | 16 | 22 | 32 | | MD4 | 16 | 22 | 32 | | MD5 | 16 | 22 | 32 | | SHA-1 | 20 | 27 | 40 | | SHA-256 | 32 | 43 | 64 | | SHA-384 | 48 | 64 | 96 | | SHA-512 | 64 | 86 | 128 | | CRC-CCITT | 3 | 2 | 3 | | CRC-16 | 5 | 6 | 4 | | CRC-32 | 10 | 14 | 8 | | Adler-32 | 4 | 6 | 8 | | Whirlpool | 64 | 86 | 128 | | Haval-256 | 32 | 44 | 64 | --------------------------------------- SEE ALSO
DBIx::Class::EncodedColumn::Crypt::Eksblowfish::Bcrypt, DBIx::Class::EncodedColumn, Digest AUTHOR
Guillermo Roditi (groditi) <groditi@cpan.org> Based on the Vienna WoC ToDo manager code by Matt S trout (mst) CONTRIBUTORS
See DBIx::Class::EncodedColumn LICENSE
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. perl v5.10.1 2011-04-24 DBIx::Class::EncodedColumn::Digest(3pm)