The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Crypt::OpenPGP::OnePassSig - One-Pass Signature packet

SYNOPSIS

    use Crypt::OpenPGP::OnePassSig;

    my $onepass = Crypt::OpenPGP::OnePassSig->parse($buffer);

DESCRIPTION

Crypt::OpenPGP::OnePassSig implements a PGP One-Pass Signature packet, a packet that precedes the signature data and contains enough information to allow the receiver of the signature to begin computing the hashed data. Standard signature packets always come after the signed data, which forces receivers to either read the entire block of data into memory, or to skip past the data to get to the signature, then backtrack to get back to the data.

The one-pass signature packet does not contain the actual signature on the data, but it contains, for example, the ID of the digest algorithm used to hash the data; this allows the receiver to create a digest context and start adding the data from the data packet as soon as it gets to the data packet. Thus no backtracking is necessary, nor is it necessary to save all of the data in memory.

USAGE

my $onepass = Crypt::OpenPGP::OnePassSig->parse($buffer)

Given the Crypt::OpenPGP::Buffer object buffer, which should contain a one-pass signature packet, parses the object from the buffer and returns the object.

AUTHOR & COPYRIGHTS

Please see the Crypt::OpenPGP manpage for author, copyright, and license information.