.TH PIUS 1 "MARCH 2014"
.SH NAME
pius \- PGP Individual UID Signer
.SH SYNOPSIS
.B pius
.RI [ options ]
.B \-s
.I <signer-keyid>
.I <keyid>
.RI [ <keyid> ...]
.br
.B pius
.RI [ options ]
.B \-A \-r
.I <keyring-path>
.B \-s
.I <signer-keyid>
.SH DESCRIPTION
.B pius
The PGP Individual UID Signer (PIUS) is a tool for individually
signing all of the UIDs on a set of keys and encrypt-emailing each
one to its respective email address. This drastically reduces the time
and errors involved in signing keys after a keysigning party.
.SH OPTIONS
.IP \fB\-\-version\fP
show program's version number and exit
.IP "\fB\-h\fP or \fB\-\-help\fP"
show this help message and exit
.IP "\fB\-a\fP or \fB\-\-use\-agent\fP"
Use gpg-agent instead of letting gpg prompt the user or every UID. [default: false]
.IP "\fB\-A\fP or \fB\-\-all\-keys\fP"
Sign all keys on the keyring. Requires \fB\-r\fP.
.IP "\fB\-b\fP \fIPATH\fP or \fB\-\-gpg\-path=\fP\fIPATH\fP"
Path to gpg binary. [default: \fI/usr/bin/gpg\fP]
.IP "\fB\-e\fP or \fB\-\-encrypt\-outfiles\fP"
Encrypt output files with respective keys.
.IP "\fB\-d\fP or \fB\-\-debug\fP"
Enable debugging output.
.IP "\fB\-H\fP \fIHOSTNAME\fP or \fB\-\-mail\-host\fP"
Hostname of SMTP server. [default: \fIlocalhost\fP]
.IP "\fB\-i\fP or \fB\-\-interactive\fP"
Use the pexpect module for signing and drop to the gpg shell for entering the passphrase. [default: false]
.IP "\fB\-I\fP or \fB\-\-import\fP"
Also import the unsigned keys from the keyring into the default keyring. Ignored if \fB\-r\fP is not specified, or if it's the same as the default keyring.
.IP "\fB\-m\fP \fIEMAIL\fP or \fB\-\-mail\fP"
Email the encrypted, signed keys to the respective email addresses. \fIEMAIL\fP is the address to send from. See also \fB\-H\fP and \fB\-p\fP.
.IP "\fB\-M\fP \fIFILE\fP or \fB\-\-mail\-text\fP"
Use the text in \fIFILE\fP as the body of email when sending out emails instead of the default text. To see the default text use \fB\-\-print\-default\-email\fP. Requires \fB\-m\fP.
.IP "\fB\-n\fP \fIEMAIL\fP or \fB\-\-override\-email\fP"
Rather than send to the user, send to this address. Mostly useful for debugging.
.IP "\fB\-o\fP \fIOUTDIR\fP or \fB\-\-out\-dir\fP"
Directory to put signed keys in. [default: \fI/tmp/pius_out\fP]
.IP "\fB\-O\fP or \fB\-\-no\-pgp\-mime\fP"
Do not use PGP/Mime when sending email.
.IP "\fB\-p\fP or \fB\-\-cache\-passphrase\fP"
Cache private key passphrase in memory and provide it to gpg instead of letting gpg prompt the user for every UID. [default: true]
.IP "\fB\-P\fP \fIPORT\fP or \fB\-\-mail\-port\fP"
\fIPort\fP of SMTP server. [default: 25]
.IP "\fB\-r\fP \fIKEYRING\fP or \fB\-\-keyring\fP"
The keyring to use. Be sure to specify full or relative path. Just a filename will cause GPG to assume relative to \fI~/.gnupg\fP. [default: \fI~/.gnupg/pubring.gpg\fP]
.IP "\fB\-s\fP \fISIGNER\fP or \fB\-\-signer\fP"
The keyid to sign with (required).
.IP "\fB\-S\fP or \fB\-\-mail\-tls\fP"
Use STARTTLS when talking to the SMTP server.
.IP "\fB\-t\fP \fITMP_DIR\fP or \fB\-\-tmp\-dir\fP"
Directory to put temporary stuff in. [default: \fI/tmp/pius_tmp\fP]
.IP "\fB\-T\fP or \fB\-\-print\-default\-email\fP"
Print the default email.
.IP "\fB\-u\fP \fIUSER\fP or \fB\-\-mail\-user\fP"
Authenticate to the SMTP server, and use username \fIUSER\fP. You will be prompted for the password. Implies \fB\-S\fP.
.IP "\fB\-v\fP or \fB\-\-verbose\fP"
Be more verbose.
.SH AUTHOR
PIUS was written by Phil Dibowitz <phil@ipom.com>
.PP
This manual page was written by Luke Cycon <lcycon@gmail.com>,
for the Debian project (but may be used by others).