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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | EXIT STATUS | SEE ALSO | AUTHOR

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

home | help