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::OPENPGP::KEYSERVER (3)

.ds Aq ’

NAME

Crypt::OpenPGP::KeyServer - Interface to HKP keyservers

CONTENTS

SYNOPSIS



    use Crypt::OpenPGP::KeyServer;

    my $key_id = ...;
    my $server = Crypt::OpenPGP::KeyServer->new(
        Server => wwwkeys.us.pgp.net
    );
    my $kb = $server->find_keyblock_by_keyid($key_id);
    print $kb->primary_uid, "\n";
    my $cert = $kb->key;

    my @kbs = $server->find_keyblock_by_uid( foo@bar.com );



DESCRIPTION

Crypt::OpenPGP::KeyServer is an interface to HKP keyservers; it provides lookup by UID and by key ID. At the moment only HKP keyservers are supported; future releases will likely support the NAI LDAP servers and the email keyservers.

USAGE

Crypt::OpenPGP::KeyServer->new( CW%arg )

Constructs a new Crypt::OpenPGP::KeyServer object and returns that object.

%arg can contain:
o Server

The hostname of the HKP keyserver. This is a required argument. You can get a list of keyservers through



    % host -l pgp.net | grep wwwkeys



o IncludeRevoked

By default, revoked keys will be skipped when calling find_keyblock_by_uid. If you set IncludeRevoked to 1, find_keyblock_by_keyid will include any revoked keys in the list of keys returned.

CW$ring->find_keyblock_by_keyid($key_id)

Looks up the key ID $key_id in the keyring $ring. For consistency with the Crypt::OpenPGP::KeyRing::find_keyblock_by_keyid interface, $key_id should be either a 4-octet or 8-octet string—it should <B>notB> be a string of hexadecimal digits. If you have the hex key ID, use pack to convert it to an octet string:



    pack H*, $hex_key_id



Returns false on failure.

CW$ring->find_keyblock_by_uid($uid)

Given a string $uid, searches the keyserver for all keyblocks matching the user ID $uid, including partial matches. Returns all of the matching keyblocks, the empty list on failure.

AUTHOR & COPYRIGHTS

Please see the Crypt::OpenPGP manpage for author, copyright, and license information.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 CRYPT::OPENPGP::KEYSERVER (3) 2009-12-11

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