NAME

gpg-ringmgr - easily move gpg keys from one keyring to another

SYNOPSIS

gpg-ringmgr [options] -t <GPG Keyring> -k <GPG Key ID> [<Key ID> ...]

OPTIONS

-h, --help

Print some basic help.

-m, --man

Be more helpful, with usage examples.

-f, --from-ring

Which ring to move the key from. Your keyrings should be in the form of pubring.x.gpg, where x is defined by this option. Defaults to misc.

-t, --to-ring

Same as --from-ring, except it defines where the key is moved to. The default value is undefined, which means that you must specify this argument!

-s, --secret-keys

Causes script to also manipulate your secret keys, as well as public keys. Without this option, the script only touches public keys.

-k, --key-id

A comma separated list of key IDs that you want to move from one ring to another. This option can be specified more than once.

-n, --no-opts-args

This option defines the options that are passed to GPG in order to make it ignore the contents of it's options file. You probably shouldn't change this unless you know what you're doing.

-d, --debug

uses the Data::Dumper module to display some debugging info. You probably shouldn't use this option.

EXAMPLES

gpg-ringmgr --from-ring misc --to-ring business --key-id 12345678

This will move that key from the keyring at ~/.gnupg/pubring.misc.gpg to the keyring at ~/.gnupg/pubring.business.gpg.

gpg-ringmgr --to-ring business --key-id 12345678

Since --from-ring misc is default behavior, this is exactly the same as the previous example.

gpg-ringmgr -f work -t play -k 12345678,23456789,34567890

This moves those three keys from the keyring at ~/.gnupg/pubring.work.gpg to the keyring at ~/.gnupg/pubring.play.gpg.

gpg-ringmgr -t example 12345678 23456789 34567890

Demonstrating that the --key-id argument itself is optional, even though the key ids themselves aren't.

gpg-ringmgr -f personal -t impersonal -s -k 12345678

Moves the public key with that ID from ~/.gnupg/pubring.personal.gpg to ~/.gnupg/pubring.impersonal.gpg, and the secret key with that ID from ~/.gnupg/secring.personal.gpg to ~/.gnupg/secring.impersonal.gpg.

NOTES

If you specify a keyring with --to-ring that doesn't exist, it will be created for you automatically.

VERSION

$Id: gpg-ringmgr,v 1.12 2003/02/02 02:46:38 feztaa Exp $

AUTHOR

Rob Park <rbpark@ualberta.ca>. Original bash version hacked together by David T-G <davidtg-hack@justpickone.org>.

SEE ALSO

gpg(1)