/ 
Crypt-OpenPGP-0.17
River stage one • 4 direct dependents • 4 total dependents
/ Crypt::OpenPGP::Message

NAME

Crypt::OpenPGP::Message - Sequence of PGP packets

SYNOPSIS

use Crypt::OpenPGP::Message;

my $msg = Crypt::OpenPGP::Message->new( Data => $packets );
my @pieces = $msg->pieces;

DESCRIPTION

Crypt::OpenPGP::Message provides a container for a sequence of PGP packets. It transparently handles ASCII-armoured messages, as well as cleartext signatures.

USAGE

Crypt::OpenPGP::Message->new( %arg )

Constructs a new Crypt::OpenPGP::Message object, presumably to be filled with some data, where the data is a serialized stream of PGP packets.

Reads the packets into in-memory packet objects.

Returns the new Message object on success, undef on failure.

%arg can contain:

  • Data

    A scalar string containing the serialized packets.

    This argument is optional, but either this argument or Filename must be provided.

  • Filename

    The path to a file that contains a serialized stream of packets.

    This argument is optional, but either this argument or Data must be provided.

$msg->pieces

Returns an array containing packet objects. For example, if the packet stream contains a public key packet, a user ID packet, and a signature packet, the array will contain three objects: a Crypt::OpenPGP::Certificate object; a Crypt::OpenPGP::UserID object; and a Crypt::OpenPGP::Signature object, in that order.

AUTHOR & COPYRIGHTS

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