GnuPG::Tie(3pm)

GnuPG::Tie3pm

Tied filehandle interface to encryption with the gnu privacy guard. gnupg::tie::decrypt - tied filehandle interface to decryption with the gnu privacy guard.

Usage

    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;

Overview

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 everything 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.

Releases

12 releases since Debian 3.0 (Woody); the text changed 6 times.

  1. 3.0
  2. 3.1
  3. 4.0–5.0
  4. 6.0
  5. 7–8
  6. 9–11
  7. 12–13

Author

Francis J. Lacoste <[email protected]>

From libgnupg-perl 0.19-5 in Debian 13 (Trixie). Parsed by carta from the page's man source.