Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
keyart(1)		    General Commands Manual		     keyart(1)

NAME
       keyart -	Create ASCII art of an OpenPGP key.

SYNOPSIS
       keyart  [-c|--color]  [-l|--longid] [-f|--fingerprint HEX [-f|--finger-
       print 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. Documenta-
       tion 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 com-
	       paring 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/pub-
	       ring.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.to-
       ponce@gmail.com>.

				  17 Jun 2014			     keyart(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=keyart&sektion=1&manpath=FreeBSD+Ports+15.0>

home | help