DragonFly On-Line Manual Pages
keyart(1) DragonFly General Commands Manual keyart(1)
NAME
keyart - Create ASCII art of an OpenPGP key.
SYNOPSIS
keyart [-c|--color] [-l|--longid] [-f|--fingerprint HEX
[-f|--fingerprint HEX ...]] [-k|--keyring KEYRING [-k|--keyring KEYRING
...]] [KEYID ...]
DESCRIPTION
keyart creates an ASCII art representation of public OpenPGP keys. The
art is an implementation of the Drunken Bishop by Dirk Loss.
Documentation about the algorithm can be found in
/usr/share/doc/signing-party/keyart/, or as appropriate for your
distribution.
keyart supports printing the ASCII art in both plain text (default) and
ANSI color. ANSI color uses a "heat map", where cold (blue) represents
squares in the room the drunk bishop has rarely visited, and hot (red)
represents squares in the room the drunk bishop has frequently visited.
There is a 1:1 ratio of color to printed character.
The KEYIDs are key identifiers (fingerprint, keyid, user ID, etc. see
gpg(1) for details). If no KEYID is given, keyart creates an ASCII art
representation for all keys found.
OPTIONS
-c | --color
Print the ASCII art using ANSI color to the terminal.
-l | --longid
Print the 16-character long ID of a on OpenPGP key in the
footer badge. Default is to print the 8-character short ID.
Silently ignored if "-f | --fingerprint HEX" is passed.
-f | --fingerprint HEX
Any arbitrary hexadecimal string of any length. Could be an
MD5, SHA1, SHA2, or SHA3 hexadecimal checksum. Useful for
comparing and analyzing potential collisions with existing
keys. This option can be repeated multiple times.
-k | --keyring KEYRING
An OpenPGP public key file or keyring, from which the KEYIDs
are to be found. If this option is not present, the KEYIDs are
found from GnuPG's default keyring (usually
~/.gnupg/pubring.gpg); if it is repeated multiple times, the
provided KEYRINGs are used as successive sources.
-h | --help
Print the help message and quit.
ENVIRONMENT
HOME Set the default home directory.
GNUPGBIN
Set the gpg binary. Default: "gpg".
GNUPGHOME
Set the default working directory for gpg. Default:
"~/.gnupg".
EXIT STATUS
0 keyart was executed successfully.
1 gpg(1) or gpg2(1) are not installed.
2 The supplied hexadecimal string is not a multiple of 8 bytes.
SEE ALSO
gpg(1)
AUTHOR
keyart and its documentation is written by Aaron Toponce
<aaron.toponce@gmail.com>.
17 Jun 2014 keyart(1)