NAME

       pius-keyring-mgr - PIUS (PGP Individual UID Signer) Keyring Manager

SYNOPSIS

       pius-keyring-mgr <mode> [options]

DESCRIPTION

       pius-keyring-mgr  has  several  modes  to  manage  keyrings.  It  was designed for signing
       parties, but can be used for any PGP keyring. The mode must be the  first  argument,  with
       options as explained below.

OPTIONS

       -d, --debug
              Enable debugging output.

       -g PATH, --gpg-path=PATH
              Path to gpg binary. [default: /usr/bin/gpg2]

       -r KEYRING, --keyring=KEYRING
              Use this keyring.

       -v, --verbose
              Print summaries.

MODES

       The  build  mode is used most of the time. It can parse a CSV file, automatically look for
       keys, and email anyone whose key was not be found. This mode can also import keys from  an
       mbox file. The options are:

       -b MBOX-FILE, --mbox-file=MBOX-FILE
              Parse  MBOX-FILE  and  examine  each  message for PGP fingerprints or ascii-armored
              keys. Decodes messages as necessary.

       -c CSV-FILE, --csv-file=CSV-FILE
              Parse MBOX-FILE and import keys. You will almost certainly also want -D, -E, -F and
              -N.

       -D DELIMITER, --delimiter=DELIMITER
              Field delimiter to use when parsing CSV. Only meaningful with -c.  [default: ',']

       -E EMAIL-COLUMN, --email-field=EMAIL-COLUMN
              Column  number  with  the  email  address in the CSV file. Only meaningful with -c.
              [default: 3]

       -F FINGERPRINT-COLUMN, --fp-field=FINGERPRINT-COLUMN
              Column number with the GPG fingerprint in the CSV file. Only  meaningful  with  -c.
              [default: 4]

       -m FROM-EMAIL, --mail=FROM-EMAIL
              Email people whose keys were not located, using FROM-EMAIL as sender.

       -M FILE, --mail-text=FILE
              Use  the  text  in  FILE  as  the  body of email when sending emails instead of the
              default text. To see the default text use --print-default-email.  Requires -m.

       -N NAME-COLUMN, --name-field=NAME-COLUMN
              Column number with the name in the CSV file.  Only meaningful with -c. [default: 2]

       -n TO-EMAIL, --override-email=TO-EMAIL
              Rather than send to the user, send to this address. Mostly useful for debugging.

       -p PARTY-NAME, --party=PARTY-NAME
              The name of the party. Will be printed in the email sent out.  Only useful with -m.

       -s KEY-SERVER, --keyservers=KEY-SERVER
              Try this keyserver. Specify once for  each  server  (-s  foo  -s  bar).   [default:
              pool.sks-keyservers.net, pgp.mit.edu, keys.gnupg.net]

       -t TEMP-DIR, --tmp-dir=TEMP-DIR
              Directory to put temporary stuff in. [default: /tmp/pius_keyring_mgr_tmp]

       -T, --print-default-email
              Print the default email.

       --ignore-emails=IGNORE-EMAILS
              Comma-separated list of emails to ignore (no spaces).

       --ignore-fingerprints=IGNORE-FINGERPRINTS
              Comma-separated list of PGP fingerprints to ignore (no spaces).

       The prune mode opens a keyring and, for each key, asks to remove it.  Useful after a party
       to trim a keyring of people who didn't show, and before distributing the keyring to  those
       who went. There are no options.

       The raw mode passes options directly to gpg. Useful when adding keys by hand. Your options
       are added to those those necessary to work on the party keyring safely. (It does not  load
       your   personal   keyring.)    Your   options   must  be  passed  after  '--'  to  prevent
       pius-keyring-manager from interpreting them as its own.

EXAMPLES

       Scan a CSV file and an MBOX for emails and write to anyone whose key was not found,  using
       you@company.com as sender:

       /usr/bin/pius-keyring-mgr build --csv-file /tmp/report --mbox-file
       /tmp/mbox --mail you@company.com

       Download a key and add it to the party keyring:

       pius-keyring-mgr raw -r path/to/keyring.gpg -- --recv-key <keyid>

AUTHOR

       PIUS was written by Phil Dibowitz <phil@ipom.com>

       This  manual  page  was  written by Felix Lechner <felix.lechner@gmail.com> for the Debian
       project, but may be used by others.

                                          DECEMBER 2016                       PIUS-KEYRING-MGR(1)