NAME

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

SYNOPSIS

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

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

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

   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.

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

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

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.

You can import public or secret keys into the keyring.

The key should be ascii armored.

        $keyring->import_key($ascii_armored_key_data);

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);

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

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

Return an array of key hashes each containing the following elements:

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

 Lars Kruse <devel@sumpfralle.de>

 There are no known bugs.

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