Project:Gentoo-keys/gkeys

brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys -h usage: gkeys [-h] [-c CONFIG] [-D {WARNING,INFO,FATAL,NOTSET,WARN,DEBUG,ERROR,CRITICAL}] {---general---,sign,verify,keys-,check-key,import-key,installed,install-key,search-key,list-key,move-key,refresh-key,remove-key,spec-check,seeds,add-seed,fetch-seed,list-cats,list-seed,list-seedfiles,move-seed,remove-seed} ...

Gentoo-keys manager program

optional arguments: -h, --help           show this help message and exit -c CONFIG, --config CONFIG The path to an alternate config file -D {WARNING,INFO,FATAL,NOTSET,WARN,DEBUG,ERROR,CRITICAL}, --debug {WARNING,INFO,FATAL,NOTSET,WARN,DEBUG,ERROR,CRITICAL} The logging level to set for the logfile

Subcommands: Valid subcommands

{---general---,sign,verify,keys-,check-key,import-key,installed,install-key,search-key,list-key,move-key,refresh-key,remove-key,spec-check,seeds,add-seed,fetch-seed,list-cats,list-seed,list-seedfiles,move-seed,remove-seed} Additional help ---general---      - -- sign               Sign a file verify             File verification action keys-      --- check-key          Check keys actions import-key         Add a specified key to a specified keyring installed          Lists the installed key directories install-key        Install a key from the seed(s) search-key         Search for a key's seed field in the installed keys db    list-key            Pretty-print the selected seed file or nick move-key           Rename an installed key refresh-key        Calls gpg with the --refresh-keys option remove-key         Remove an installed key spec-check         Check keys actions seeds      -- --- add-seed           Add or replace a key in the selected seed file(s) fetch-seed         Download the selected seed file(s) list-cats          List seed file definitions found in the config list-seed          Pretty-print the selected seed file(s) list-seedfiles     List seed files found in the configured seed directory move-seed          Move keys between seed files remove-seed        Remove a key from the selected seed file(s)

CAUTION: adding UNTRUSTED keys can be HAZARDOUS to your system! brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys sign -h usage: gkeys sign [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-f FINGERPRINT [FINGERPRINT ...]] [-F FILENAME [FILENAME ...]] [-k KEYRING]

Sign a file

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -F FILENAME [FILENAME ...], --file FILENAME [FILENAME ...] The path/URL to use for the (signed) file -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys verify -h usage: gkeys verify [-h] [-d DESTINATION] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-F FILENAME] [-s SIGNATURE] [-t]

File verification action

@ param args: argparse.parse_args instance @param messages: list, private internal option used for recursion only

optional arguments: -h, --help           show this help message and exit -d DESTINATION, --dest DESTINATION The destination for move, copy, create operations -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -F FILENAME, --file FILENAME The path/URL to use for the (signed) file -s SIGNATURE, --signature SIGNATURE The path/URL to use for the signature -t, --timestamp      Turn on timestamp use brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys checkkey -h usage: gkeys [-h] [-c CONFIG] [-D {FATAL,DEBUG,WARN,WARNING,INFO,ERROR,CRITICAL,NOTSET}] {---general---,sign,verify,keys-,check-key,import-key,installed,install-key,search-key,list-key,move-key,refresh-key,remove-key,spec-check,seeds,add-seed,fetch-seed,list-cats,list-seed,list-seedfiles,move-seed,remove-seed} ... gkeys: error: invalid choice: 'checkkey' (choose from '---general---', 'sign', 'verify', 'keys-', 'check-key', 'import-key', 'installed', 'install-key', 'search-key', 'list-key', 'move-key', 'refresh-key', 'remove-key', 'spec-check', 'seeds', 'add-seed', 'fetch-seed', 'list-cats', 'list-seed', 'list-seedfiles', 'move-seed', 'remove-seed') brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys check-key -h usage: gkeys check-key [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING] [-i KEYID [KEYID ...]]

Check keys actions

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. -i KEYID [KEYID ...], --keyid KEYID [KEYID ...] The long keyid of the gpg key to search for brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys import-key -h usage: gkeys import-key [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING]

Add a specified key to a specified keyring

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys installed -h usage: gkeys installed [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING]

Lists the installed key directories

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys install-key -h usage: gkeys install-key [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING] [-F FILENAME]

Install a key from the seed(s)

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. -F FILENAME, --file FILENAME The path/URL to use for the (signed) file brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys search-key -h usage: gkeys search-key [-h] [-n NICK] [-N NAME] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-i KEYID [KEYID ...]] [-u [UID [UID ...]]] [-C CATEGORY] [-e] [-a]

Search for a key's seed field in the installed keys db

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N NAME, --name NAME The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -i KEYID [KEYID ...], --keyid KEYID [KEYID ...] The long keyid of the gpg key to search for -u [UID [UID ...]], --uid [UID [UID ...]] The user ID, gpg key uid -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -e, --exact          Use CASE matching in searches -a, --all            Match all inputs arguments in searches brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys list-key -h usage: gkeys list-key [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING] [-g GPGSEARCH] [-i KEYID [KEYID ...]]

Pretty-print the selected seed file or nick

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. -g GPGSEARCH, --gpgsearch GPGSEARCH Do a gpg search operations, rather than a gkey search -i KEYID [KEYID ...], --keyid KEYID [KEYID ...] The long keyid of the gpg key to search for brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys move-key -h usage: gkeys move-key [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING] [-d DESTINATION]

Rename an installed key

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. -d DESTINATION, --dest DESTINATION The destination for move, copy, create operations brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys refresh-key -h usage: gkeys refresh-key [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING] [-i KEYID [KEYID ...]]

Calls gpg with the --refresh-keys option for in place updates of the installed keys

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. -i KEYID [KEYID ...], --keyid KEYID [KEYID ...] The long keyid of the gpg key to search for brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys remove-key -h usage: gkeys remove-key [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING]

Remove an installed key

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys spec-check -h usage: gkeys spec-check [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING] [-i KEYID [KEYID ...]]

Check keys actions

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. -i KEYID [KEYID ...], --keyid KEYID [KEYID ...] The long keyid of the gpg key to search for brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys add-seed -h usage: gkeys add-seed [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-u [UID [UID ...]]]

Add or replace a key in the selected seed file(s)

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -u [UID [UID ...]], --uid [UID [UID ...]] The user ID, gpg key uid brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys fetch-seed -h usage: gkeys fetch-seed [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-k KEYRING]

Download the selected seed file(s)

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -k KEYRING, --keyring KEYRING The name of the keyring to use for verification, etc. brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys list-cats -h usage: gkeys list-cats [-h]

List seed file definitions found in the config

optional arguments: -h, --help show this help message and exit brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys list-seed -h usage: gkeys list-seed [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-F FILENAME]

Pretty-print the selected seed file(s)

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -F FILENAME, --file FILENAME The path/URL to use for the (signed) file brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys list-seedfile -h usage: gkeys [-h] [-c CONFIG] [-D {WARNING,FATAL,ERROR,NOTSET,CRITICAL,WARN,INFO,DEBUG}] {---general---,sign,verify,keys-,check-key,import-key,installed,install-key,search-key,list-key,move-key,refresh-key,remove-key,spec-check,seeds,add-seed,fetch-seed,list-cats,list-seed,list-seedfiles,move-seed,remove-seed} ... gkeys: error: invalid choice: 'list-seedfile' (choose from '---general---', 'sign', 'verify', 'keys-', 'check-key', 'import-key', 'installed', 'install-key', 'search-key', 'list-key', 'move-key', 'refresh-key', 'remove-key', 'spec-check', 'seeds', 'add-seed', 'fetch-seed', 'list-cats', 'list-seed', 'list-seedfiles', 'move-seed', 'remove-seed') brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys list-seedfiles -h usage: gkeys list-seedfiles [-h]

List seed files found in the configured seed directory

optional arguments: -h, --help show this help message and exit brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys move-seed -h usage: gkeys move-seed [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY] [-d DESTINATION]

Move keys between seed files

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update -d DESTINATION, --dest DESTINATION The destination for move, copy, create operations brian@big_daddy ~/Dev/git/gentoo-keys $ gkeys remove-seed -h usage: gkeys remove-seed [-h] [-n NICK] [-N [NAME [NAME ...]]] [-r KEYDIR] [-K [KEYS [KEYS ...]]] [-f FINGERPRINT [FINGERPRINT ...]] [-C CATEGORY]

Remove a key from the selected seed file(s)

optional arguments: -h, --help           show this help message and exit -n NICK, --nick NICK The nick associated with the the key -N [NAME [NAME ...]], --name [NAME [NAME ...]] The name of the the key -r KEYDIR, --keydir KEYDIR The keydir to use, update or search for/in -K [KEYS [KEYS ...]], --keys [KEYS [KEYS ...]] The name of the keyring to use for verification, etc. -f FINGERPRINT [FINGERPRINT ...], --fingerprint FINGERPRINT [FINGERPRINT ...] The fingerprint of the the key -C CATEGORY, --category CATEGORY The key or seed directory category to use or update brian@big_daddy ~/Dev/git/gentoo-keys $