mpgp.1 (3626B)
1 .TH MPGP 1 "Mixmaster Version 3.0" 2 .\" $Id: $ 3 .SH NAME 4 mpgp \- Mixmaster OpenPGP Module 5 .SH SYNOPSIS 6 .B mpgp \fB\-e\fR [\fB\-b\fR] \fIkeyname\fR [\fIfilename\fR] 7 .PP 8 .B mpgp \fB\-s\fR [\fB\-b\fR] [\fIkeyname\fR [\fIfilename\fR]] 9 .PP 10 .B mpgp \fB\-c\fR [\fB\-b\fR] [\fIfilename\fR] 11 .PP 12 .B mpgp \fB\-C\fR [\fB\-b\fR] [\fIfilename\fR] 13 .PP 14 .B mpgp \fB\-d\fR [\fB\-b\fR] [\fIpassphrase\fR [\fIfilename\fR]] 15 .PP 16 .B mpgp \fB\-g\fR[\fBr\fR] \fIkeyname\fR [\fIbits\fR] 17 .PP 18 .B mpgp \fB\-a\fR[\fB+\-\fR] [\fB\-b\fR] [\fIfilename\fR] 19 .PP 20 .B mpgp \fB\-V\fR 21 .SH DESCRIPTION 22 Mixmaster is an anonymous remailer. mpgp is a light-weight OpenPGP 23 implementation, primarily used to diagnose issues with OpenPGP keys and 24 messages handled by the Mixmaster remailer software. 25 .PP 26 mpgp can encrypt, decrypt and sign a message using the Mixmaster 27 OpenPGP library. The message is read from the standard input or the 28 specified \fIfilename\fR. The output will be written to the standard 29 output. When called without arguments mpgp decrypts from the standard 30 input. It asks for a passphrase when needed. 31 .SH OPTIONS 32 .TP 33 .B "\-h" 34 Print a summary of command line options. 35 .TP 36 .B "\-V" 37 Print the current version, authorship and copyright information. 38 .TP 39 .B "\-e" 40 Encrypt a message with the first OpenPGP key from the public key ring 41 whose contains \fIkeyname\fR as a substring. 42 .TP 43 .B "\-s" 44 Make a signature of the message with the first OpenPGP key from the secret 45 key ring, or the first key whose contains \fIkeyname\fR as a substring if 46 specified. 47 .TP 48 .B "\-c" 49 Encrypt with symmetric cipher only. 50 .TP 51 .B "\-C" 52 Encrypt with symmetric cipher only using the new OpenPGP format. 53 .TP 54 .B "\-d" 55 Decrypt a message using \fIpassphrase\fR if specified or asking for it if 56 needed. It also verifies its signature. 57 .TP 58 .B "\-g\fR[\fBr\fR]" 59 Generate new OpenPGP key pair with the given \fIkeyname\fR as user ID. If 60 \fBr\fR is specified the OpenPGP key will be created using the RSA 61 algorithm, otherwise the ElGamal algorithm will be used. \fIbits\fR is the 62 key length and its default value is 1024. 63 .TP 64 .B "\-a\fR[\fB+\-\fR]" 65 Create an ASCII OpenPGP armored message. If \fB\-\fR is specified mpgp 66 will remove ASCII armor. 67 .TP 68 .B "\-b" 69 Specifies that the message is in binary format. 70 .SH CONFIGURATION 71 The Mixmaster OpenPGP module reads its configuration from the file 72 .B mix.cfg 73 in its working directory. The configuration file consists of lines of 74 the type 75 .PP 76 .I VARIABLE values 77 .PP 78 and of comments, which begin with a 79 .B # 80 character. 81 .PP 82 .TP 83 .B PGPPUBRING 84 Path to your public OpenPGP key ring. Default: 85 .BR ~/.pgp/pubring.pgp . 86 (Windows default: PGP registry value.) 87 .TP 88 .B PGPSECRING 89 Path to your secret OpenPGP key ring. Default: 90 .BR ~/.pgp/secring.pgp . 91 (Windows default: PGP registry value.) 92 .SH FILES 93 These filenames can be overridden by setting the corresponding configuration 94 option (given in parentheses). 95 .TP 96 .B mix.cfg 97 Mixmaster configuration file. 98 .TP 99 .B pubring.pgp 100 OpenPGP public keys (\fBPGPPUBRING\fP). 101 .TP 102 .B secring.pgp 103 OpenPGP secret keys (\fBPGPSECRING\fP). 104 .SH SEE ALSO 105 .BR mixmaster (1), 106 .BR pgp (1), 107 .BR gpg (1). 108 .SH HISTORY 109 The 110 .BR mpgp 111 command was written by Ulf Moeller as a test suite for Mixmaster 112 2.9's internal OpenPGP support. It was enhanced and debugged primarily 113 by Janis Jagars for use as a light-weight stand-alone OpenPGP application. 114 .SH COPYRIGHT 115 (C) 1999-2006 Ulf Moeller and others. 116 Mixmaster and 117 .BR mpgp 118 may be redistributed and modified under certain 119 conditions. This software is distributed on an "AS IS" basis, WITHOUT 120 WARRANTY OF ANY KIND, either express or implied. See the file COPYRIGHT 121 for details.