.TH PIUS 1 "MARCH 2010"
.SH NAME
pius \- PGP Individual UID Signer
.SH SYNOPSIS
.B pius [options] -s
.I <signer-keyid>
.I <keyid>
.I [<keyid> ...]
.br
.B pius [options] -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 it's respective email address. This drastically reduces the time
and errors involved in signing keys after a keysigning party.
.SH OPTIONS
.IP --version
show program's version number and exit
.IP "-h or --help"
show this help message and exit
.IP "-a or --use-agent"
Use pgp-agent instead of letting gpg prompt the user or every UID. [default: false]
.IP "-A or --all-keys"
Sign all keys on the keyring. Requires \-r.
.IP "-b PATH or --gpg-path=PATH"
Path to gpg binary. [default: /usr/bin/gpg]
.IP "-e or --encrypt-outfiles"
Encrypt output files with respective keys.
.IP "-d or --debug"
Enable debugging output.
.IP "-H HOSTNAME or --mail-host"
Hostname of SMTP server. [default: localhost]
.IP "-i or --interactive"
Use the pexpect module for signing and drop to the gpg shell for entering the passphrase. [default: false]
.IP "-I or --import"
Also import the unsigned keys from the keyring into the default keyring. Ignored if \-r is not specified, or if it's the same as the default keyring.
.IP "-m EMAIL or --mail"
Email the encrypted, signed keys to the respective email addresses. EMAIL is the address to send from. See also \-H and \-p.
.IP "-M FILE or --mail-text"
Use the text in FILE as the body of email when sending out emails instead of the default text. To see the default text use \-\-print-default-email. Requires \-m.
.IP "-n EMAIL or --override-email"
Rather than send to the user, send to this address. Mostly useful for debugging.
.IP "-o OUTDIR or --out-dir"
Directory to put signed keys in. [default: /tmp/pius_out]
.IP "-O or --no-pgp-mime"
Do not use PGP/Mime when sending email.
.IP "-p or --cache-passphrase"
Cache private key passphrase in memory and provide it to gpg instead of letting gpg prompt the user for every UID. [default: true]
.IP "-P PORT or --mail-port"
Port of SMTP server. [default: 25]
.IP "-r KEYRING or --keyring"
The keyring to use. Be sure to specify full or relative path. Just a filename will cause GPG to assume relative to ~/.gnupg. [default: ~/.gnupg/pubring.gpg]
.IP "-s SIGNER or --signer"
The keyid to sign with (required).
.IP "-S or --mail-tls"
Use STARTTLS when talking to the SMTP server.
.IP "-t TMP_DIR or --tmp-dir"
Directory to put temporary stuff in. [default: /tmp/pius_tmp]
.IP "-T or --print-default-email"
Print the default email.
.IP "-u USER or --mail-user"
Authenticate to the SMTP server, and use username USER. You will be prompted for the password. Implies \-S.
.IP "-v or --verbose"
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).