MPGP(1)

NAME
mpgp - Mixmaster OpenPGP Module

SYNOPSIS
mpgp -e [-b] keyname [filename]

mpgp -s [-b] [keyname [filename]]

mpgp -c [-b] [filename]

mpgp -C [-b] [filename]

mpgp -d [-b] [passphrase [filename]]

mpgp -g[r] keyname [bits]

mpgp -a[+-] [-b] [filename]

DESCRIPTION
Mixmaster is an anonymous remailer. mpgp is a light-weight OpenPGP implementation, primarily used to diagnose issues with OpenPGP keys and messages handled by the Mixmaster remailer software.

mpgp can encrypt, decrypt and sign a message using the Mixmaster OpenPGP library. The message is read from the standard input or the specified filename. The output will be written to the standard output. When called without arguments mpgp decrypts from the standard input. It asks for a passphrase when needed.

OPTIONS

-h  Print a summary of command line options.

-e  Encrypt a message with the first OpenPGP key from the public key ring whose contains keyname as a substring.

-s  Make a signature of the message with the first OpenPGP key from the secret key ring, or the first key whose contains keyname as a substring if specified.

-c  Encrypt with symmetric cipher only.

-C  Encrypt with symmetric cipher only using the new OpenPGP format.

-d  Decrypt a message using passphrase if specified or asking for it if needed. It also verifies its signature.

-g[r]
    Generate new OpenPGP key pair with the given keyname as user ID. If r is specified the OpenPGP key will be created using the RSA algorithm, otherwise the ElGamal algorithm will be used. bits is the key length and its default value is 1024.

-a[+-]
    Create an ASCII OpenPGP armored message. If - is specified mpgp will remove ASCII armor.

-b  Specifies that the message is in binary format.

CONFIGURATION
The Mixmaster OpenPGP module reads its configuration from the file mix.cfg in its working directory. The configuration file consists of lines of the type

VARIABLE values

and of comments, which begin with a # character.

PGPPUBRING
    Path to your public OpenPGP key ring. Default: ~/.pgp/pubring.pgp. (Windows default: PGP registry value.)

PGPSECRING
    Path to your secret OpenPGP key ring. Default: ~/.pgp/secring.pgp. (Windows default: PGP registry value.)

FILES
These filenames can be overridden by setting the corresponding configuration option (given in parentheses).

mix.cfg
    Mixmaster configuration file.

pubring.pgp
    OpenPGP public keys (PGPPUBRING).

secring.pgp
    OpenPGP secret keys (PGPSECRING).

SEE ALSO
mixmaster(1), pgp(1), gpg(1).

HISTORY
The mpgp command was written by Ulf Moeller as a test suite for Mixmaster 2.9's internal OpenPGP support. It was enhanced and debugged primarily by Janis Jagars for use as a light-weight stand-alone OpenPGP application.

COPYRIGHT
(C) 1999-2004 Ulf Moeller and others. Mixmaster and mpgp may be redistributed and modified under certain conditions. This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the file COPYRIGHT for details.