GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  CRYPT::DIGEST::SHA384 (3)

.ds Aq ’

NAME

Crypt::Digest::SHA384 - Hash function SHA-384 [size: 384 bits]

CONTENTS

SYNOPSIS



   ### Functional interface:
   use Crypt::Digest::SHA384 qw( sha384 sha384_hex sha384_b64 sha384_b64u
                                sha384_file sha384_file_hex sha384_file_b64 sha384_file_b64u );

   # calculate digest from string/buffer
   $sha384_raw  = sha384(data string);
   $sha384_hex  = sha384_hex(data string);
   $sha384_b64  = sha384_b64(data string);
   $sha384_b64u = sha384_b64u(data string);
   # calculate digest from file
   $sha384_raw  = sha384_file(filename.dat);
   $sha384_hex  = sha384_file_hex(filename.dat);
   $sha384_b64  = sha384_file_b64(filename.dat);
   $sha384_b64u = sha384_file_b64u(filename.dat);
   # calculate digest from filehandle
   $sha384_raw  = sha384_file(*FILEHANDLE);
   $sha384_hex  = sha384_file_hex(*FILEHANDLE);
   $sha384_b64  = sha384_file_b64(*FILEHANDLE);
   $sha384_b64u = sha384_file_b64u(*FILEHANDLE);

   ### OO interface:
   use Crypt::Digest::SHA384;

   $d = Crypt::Digest::SHA384->new;
   $d->add(any data);
   $d->addfile(filename.dat);
   $d->addfile(*FILEHANDLE);
   $result_raw  = $d->digest;     # raw bytes
   $result_hex  = $d->hexdigest;  # hexadecimal form
   $result_b64  = $d->b64digest;  # Base64 form
   $result_b64u = $d->b64udigest; # Base64 URL Safe form



DESCRIPTION

Provides an interface to the SHA384 digest algorithm.

EXPORT

Nothing is exported by default.

You can export selected functions:



  use Crypt::Digest::SHA384 qw(sha384 sha384_hex sha384_b64 sha384_b64u
                                      sha384_file sha384_file_hex sha384_file_b64 sha384_file_b64u);



Or all of them at once:



  use Crypt::Digest::SHA384 :all;



FUNCTIONS

    sha384

Logically joins all arguments into a single string, and returns its SHA384 digest encoded as a binary string.



 $sha384_raw = sha384(data string);
 #or
 $sha384_raw = sha384(any data, more data, even more data);



    sha384_hex

Logically joins all arguments into a single string, and returns its SHA384 digest encoded as a hexadecimal string.



 $sha384_hex = sha384_hex(data string);
 #or
 $sha384_hex = sha384_hex(any data, more data, even more data);



    sha384_b64

Logically joins all arguments into a single string, and returns its SHA384 digest encoded as a Base64 string, <B>withB> trailing ’=’ padding.



 $sha384_b64 = sha384_b64(data string);
 #or
 $sha384_b64 = sha384_b64(any data, more data, even more data);



    sha384_b64u

Logically joins all arguments into a single string, and returns its SHA384 digest encoded as a Base64 URL Safe string (see RFC 4648 section 5).



 $sha384_b64url = sha384_b64u(data string);
 #or
 $sha384_b64url = sha384_b64u(any data, more data, even more data);



    sha384_file

Reads file (defined by filename or filehandle) content, and returns its SHA384 digest encoded as a binary string.



 $sha384_raw = sha384_file(filename.dat);
 #or
 $sha384_raw = sha384_file(*FILEHANDLE);



    sha384_file_hex

Reads file (defined by filename or filehandle) content, and returns its SHA384 digest encoded as a hexadecimal string.



 $sha384_hex = sha384_file_hex(filename.dat);
 #or
 $sha384_hex = sha384_file_hex(*FILEHANDLE);



<B>BEWARE:B> You have to make sure that the filehandle is in binary mode before you pass it as argument to the addfile() method.

    sha384_file_b64

Reads file (defined by filename or filehandle) content, and returns its SHA384 digest encoded as a Base64 string, <B>withB> trailing ’=’ padding.



 $sha384_b64 = sha384_file_b64(filename.dat);
 #or
 $sha384_b64 = sha384_file_b64(*FILEHANDLE);



    sha384_file_b64u

Reads file (defined by filename or filehandle) content, and returns its SHA384 digest encoded as a Base64 URL Safe string (see RFC 4648 section 5).



 $sha384_b64url = sha384_file_b64u(filename.dat);
 #or
 $sha384_b64url = sha384_file_b64u(*FILEHANDLE);



METHODS

The OO interface provides the same set of functions as Crypt::Digest.

    new



 $d = Crypt::Digest::SHA384->new();



    clone



 $d->clone();



    reset



 $d->reset();



    add



 $d->add(any data);
 #or
 $d->add(any data, more data, even more data);



    addfile



 $d->addfile(filename.dat);
 #or
 $d->addfile(*FILEHANDLE);



    add_bits



 $d->add_bits($bit_string);   # e.g. $d->add_bits("111100001010");
 #or
 $d->add_bits($data, $nbits); # e.g. $d->add_bits("\xF0\xA0", 16);



    hashsize



 $d->hashsize;
 #or
 Crypt::Digest::SHA384->hashsize();
 #or
 Crypt::Digest::SHA384::hashsize();



    digest



 $result_raw = $d->digest();



    hexdigest



 $result_hex = $d->hexdigest();



    b64digest



 $result_b64 = $d->b64digest();



    b64udigest



 $result_b64url = $d->b64udigest();



SEE ALSO

o CryptX, Crypt::Digest
o <http://en.wikipedia.org/wiki/SHA-2>
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CRYPT::DIGEST::SHA384 (3) 2016-01-25

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.