PGPPIPE(1)

NAME
pgppipe - decrypt PGP messages

SYNOPSIS
pgppipe [ -binary ] [ -force ]

DESCRIPTION
The pgppipe programme will decrypt ASCII armour PGP messages, without the need for a passphrase. It uses PGPdaemon to actually perform the decryption. pgppipe is simply a front-end to PGPdaemon. PGPdaemon is part of the PGPsendmail/Unix Suite. pgppipe will read the standard input for the encrypted message and will write the decrypted message to the standard output. pgppipe is able to cope with multiple encrypted messages within the input.

OPTIONS

-binary
    Decrypt a binary PGP file. The entire input file must be a PGP message: multiple PGP messages are not supported. The default is to decrypt ASCII armour files, which does support multiple PGP messages.

-force
    If there any errors with decrypting, force pgppipe to keep going by simply copying the remaining data to the standard output and return success. This can lose data, since a certain quantity of data may have been written to PGPdaemon before an error was detected. The default is to return a failure code upon error (this is much better for mail filters).

DIAGNOSTICS
Normally, exit status is 0 if no errors were detected, otherwise some other error code is returned.

FILES
$PGPPATH/secring.pgp
    the users' secret keyring file
pgpsendmail/doc/README.PGPdaemon
    distribution README (has more info.)

BUGS
pgppipe does not cope with improperly terminated PGP message blocks. Any data after an unterminated message block is lost.

SEE ALSO
sendmail(8), pgp(1), pgpsendmail(1), pgpdaemon(1), sendpgppass(1), pgpsign(1)

AUTHOR
Richard Gooch (rgooch@atnf.csiro.au)

AVAILABILITY
The PGPsendmail/Unix Suite is available for anonymous ftp from: ftp.atnf.csiro.au:pub/people/rgooch ftp.dhp.com:pub/crypto/pgp/PGPsendmail ftp.ox.ac.uk:pub/crypto/pgp/utils linux.nrao.edu:pub/src/pgp/PGPsendmail