gnupg::tie(3pm) [debian man page]

GnuPG::Tie(3pm) 					User Contributed Perl Documentation					   GnuPG::Tie(3pm)

NAME

       GnuPG::Tie::Encrypt - Tied filehandle interface to encryption with the GNU Privacy Guard.

       GnuPG::Tie::Decrypt - Tied filehandle interface to decryption with the GNU Privacy Guard.

SYNOPSIS

	   use GnuPG::Tie::Encrypt;
	   use GnuPG::Tie::Decrypt;

	   tie *CIPHER, 'GnuPG::Tie::Encrypt', armor => 1, recipient => 'User';
	   print CIPHER <<EOF;
       This is a secret
       EOF
	   local $/ = undef;
	   my $ciphertext = <CIPHER>;
	   close CIPHER;
	   untie *CIPHER;

	   tie *PLAINTEXT, 'GnuPG::Tie::Decrypt', passphrase => 'secret';
	   print PLAINTEXT $ciphertext;
	   my $plaintext = <PLAINTEXT>;

	   # $plaintext should now contains 'This is a secret'
	   close PLAINTEXT;
	   untie *PLAINTEXT;

DESCRIPTION

       GnuPG::Tie::Encrypt and GnuPG::Tie::Decrypt provides a tied  file handle interface to encryption/decryption facilities of the GNU Privacy
       guard.

       With GnuPG::Tie::Encrypt everyting you write to the file handle will be encrypted. You can read the ciphertext from the same file handle.

       With GnuPG::Tie::Decrypt you may read the plaintext equivalent of a ciphertext. This is one can have been written to file handle.

       All options given to the tie constructor will be passed on to the underlying GnuPG object. You can use a mix of options to output directly
       to a file or to read directly from a file, only remember than once you start reading from the file handle you can't write to it anymore.

AUTHOR

       Francis J. Lacoste <francis.lacoste@Contre.COM>

COPYRIGHT

       Copyright (c) 1999, 2000 iNsu Innovations Inc.  Copyright (c) 2001 Francis J. Lacoste

       This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by
       the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

SEE ALSO

       gpg(1) GnuPG(3)

perl v5.14.2							    2011-11-22							   GnuPG::Tie(3pm)

GnuPG::Revoker(3pm)					User Contributed Perl Documentation				       GnuPG::Revoker(3pm)

NAME

       GnuPG::Revoker - GnuPG Key Revoker Objects

SYNOPSIS

	 # assumes a GnuPG::PrimaryKey object in $key
	 my $revokerfpr = $key->revokers->[0]->fingerprint();

DESCRIPTION

       GnuPG::Revoker objects are generally not instantiated on their own, but rather as part of GnuPG::Key objects.  They represent a statement
       that another key is designated to revoke certifications made by the key in question.

OBJECT METHODS

       new( %initialization_args )
	   This methods creates a new object.  The optional arguments are initialization of data members.

       is_sensitive()
	   Returns 0 if the revoker information can be freely distributed.  If this is non-zero, the information should be treated as "sensitive".

	   Please see http://tools.ietf.org/html/rfc4880#section-5.2.3.15 for more explanation.

       compare( $other, $deep )
	   Returns non-zero only when this designated revoker is identical to the other GnuPG::Revoker.  If $deep is present and non-zero, the
	   revokers' signatures will also be compared.

OBJECT DATA MEMBERS

       fingerprint
	   A GnuPG::Fingerprint object indicating the fingerprint of the specified revoking key.  (Note that this is *not* the fingerprint of the
	   key whose signatures can be revoked by this revoker).

       algo_num
	   The numeric identifier of the algorithm of the revoker's key.

       signatures
	   A list of GnuPG::Signature objects which cryptographically bind the designated revoker to the primary key.  If the material was
	   instantiated using the *_with_sigs() functions from GnuPG::Interface, then a valid revoker designation should have a valid signature
	   associated with it from the relevant key doing the designation (not from the revoker's key).

	   Note that designated revoker certifications are themselves irrevocable, so there is no analogous list of revocations in a
	   GnuPG::Revoker object.

SEE ALSO

       GnuPG::Interface, GnuPG::Fingerprint, GnuPG::Key, GnuPG::Signature, http://tools.ietf.org/html/rfc4880#section-5.2.3.15
       <http://tools.ietf.org/html/rfc4880#section-5.2.3.15>

perl v5.12.4							    2010-06-07						       GnuPG::Revoker(3pm)