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  -  MAIL::EZMLM::GPGKEYRING (3)

.ds Aq ’

NAME

Mail::Ezmlm::GpgKeyRing - Object Methods for gnupg keyring management

CONTENTS

SYNOPSIS



 use Mail::Ezmlm::GpgKeyRing;
 $keyring = new Mail::Ezmlm::GpgKeyRing(DIRNAME);



The rest is a bit complicated for a Synopsis, see the description.

DESCRIPTION

Mail::Ezmlm::GpgKeyRing is a Perl module that is designed to provide an object interface to GnuPG keyrings for encrypted mailing lists.

    Setting up a new Mail::Ezmlm::GpgKeyRing object:



   use Mail::Ezmlm::GpgKeyRing;
   $keyring = new Mail::Ezmlm::GpgKeyRing(/home/user/lists/foolist/.gnupg);



new() returns the new instance for success, undefined if there was a problem.

    Determining the location of the configured keyring.



   $whichkeyring = $keyring->get_location();
   print $keyring->get_location();



    Changing which keyring the Mail::Ezmlm::GpgKeyRing object points at:



   $keyring->set_location(/home/user/lists/foolist/.gnupg);



    Export a key:

You may export public keys of the keyring.

The key can be identified by its id or other (unique) patterns (like the gnupg program).



        $keyring->export_key($key_id);
        $keyring->export_key($email_address);



The return value is a string containing the ascii armored key data.

    Import a key:

You can import public or secret keys into the keyring.

The key should be ascii armored.



        $keyring->import_key($ascii_armored_key_data);



    Delete a key:

Remove a public key (and the matching secret key if it exists) from the keyring.

The argument is the id of the key or any other unique pattern.



        $keyring->delete_key($keyid);



    Generate a new key:



        $keyring->generate_key($name, $comment, $email_address, $keysize, $expire);



Refer to the documentation of gnupg for the format of the arguments.

    Getting public keys:

Return an array of key hashes each containing the following elements:
o name
o email
o id
o expires


        $keyring->get_public_keys();
        $keyring->get_secret_keys();



AUTHOR



 Lars Kruse <devel@sumpfralle.de>



BUGS



 There are no known bugs.

 Please report bugs to the author or use the bug tracking system at
 https://systemausfall.org/trac/ezmlm-web.



SEE ALSO



 gnupg(7), gpg(1), gpg2(1), Crypt::GPG(3pm)

 https://systemausfall.org/toolforge/ezmlm-web/
 http://www.ezmlm.org/



Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 EZMLM::GPGKEYRING (3) 2008-10-02

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