Crypt::OpenPGP::UserID.3pm

Langue: en

Version: 2001-08-10 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

NAME

Crypt::OpenPGP::UserID - PGP User ID packet

SYNOPSIS

     use Crypt::OpenPGP::UserID;
 
 
     my $uid = Crypt::OpenPGP::UserID->new( Identity => 'Foo' );
     my $serialized = $uid->save;
 
 
     my $uid = Crypt::OpenPGP::UserID->parse($buffer);
     my $identity = $uid->id;
 
 

DESCRIPTION

Crypt::OpenPGP::UserID is a PGP User ID packet. Such a packet is used to represent the name and email address of the key holder, and typically contains an RFC822 mail name like
     Foo Bar <foo@bar.com>
 
 

USAGE


Crypt::OpenPGP::UserID->new( [ Identity => $identity ] )


Crypt::OpenPGP::UserID->new( [ Identity => $identity ] )

Creates a new User ID packet object and returns that object. If you do not supply an identity, the object is created empty; this is used, for example, in parse (below), to create an empty packet which is then filled from the data in the buffer.

If you wish to initialize a non-empty object, supply new with the Identity parameter along with a value $identity which should generally be in RFC822 form (above).

$uid->save

Returns the text of the user ID packet; this is the string passed to new (above) as $identity, for example.

Crypt::OpenPGP::UserID->parse($buffer)

Given $buffer, a Crypt::OpenPGP::Buffer object holding (or with offset pointing to) a User ID packet, returns a new <Crypt::OpenPGP::UserID> object, initialized with the user ID data in the buffer.

$uid->id

Returns the user ID data (eg. the string passed as $identity to new, above).

AUTHOR & COPYRIGHTS

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