WOTSAP(1)																 WOTSAP(1)

NAME

       wotsap - Web of Trust statistics and pathfinder

SYNOPSIS

       wotsap [OPTIONS] [bottomkey [topkey]]

DESCRIPTION

       wotsap is a pathfinder for the OpenPGP Web of Trust, which also produces some statistics and similar things. It obtains the description of
       the Web of Trust from a .wot file.

       OpenPGP is the most widely used email encryption standard, used by encryption software such as the GNU Privacy Guard (see gnupg (7)). To
       encrypt to someone or verify someone's signature, you need that persons OpenPGP key. Say you want to verify a digital signature made by
       Bob. To get Bob's key is easy with some help from keyservers, being sure you got the right key is the tricky part. This is accomplished
       either by meeting Bob in person and exchanging signatures, or by trusting someone else, who you have met in person, who claims to have met
       Bob. Or by trusting someone who has met someone who has met Bob. This gives rise to a completely decentralized network of trusts between
       people.

       wotsap lets you explore the Web of Trust. It works on a compressed copy of the Web of Trust in the .wot file format, generated daily and
       distributed on the site of wotsap main writer.

       Running wotsap you can specify on the command line just bottomkey, bottomkey and topkey or neither of them. They are the hexadecimal ID of
       the keys you want to investigate:

       o   If you don't specify any of bottomkey and topkey, wotsap will just produce some piece of information on the Wot of Trust, such as the
	   total number of key and signatures and the average signatures per key.

       o   If you specify only bottomkey, wotsap will output detailed statistics about that key: how far are the other key in the Web from this,
	   the Mean Shortest Distance for this key, which key have signed this key or are signed by this key. The Mean Shortest Distance is the
	   average of the distances from all the keys in the Web of Trust to the key you under considaration. The distance from a key to another
	   is the length of a minimal path from the first to the second.

       o   If you specify either bottomkey and topkey, wotsap will search for all the minimal paths from bottomkey to topkey and output them.

OPTIONS

       -h --help
	   Show help.

       --version
	   Show version.

       -w --wot=FILE
	   Read Web of Trust information from FILE. Defaults to ~/.wotsapdb. You can find the latest version of this file (generated daily) at
	   http://www.lysator.liu.se/~jc/wotsap/wots2/latest.wot.

       -m --modify=STR
	   Use STR of WoT modification string.

       -g --group
	   Print signature matrix of comma separated keys. If there aren't any commas in the key specification, wotsap will interpret it as a
	   search string, and print the signature matrix of all the key, whose name or email contains the string.

       -G --nounknowns
	   Don't print unknown keys in the signature matrix.

       -o --png=FILE
	   Write an image of the graph of all the minimal paths between the two specified keys in FILE, in .png file format.

       -O --show-png=PRG
	   Like -o, but shows the image with PRG instead of writing it in a file. More precisely, it saves the minimal paths image in a temporary
	   file, the executes 'PRG image_file' and, when PRG is over, deletes the temporary file.

       -s --size=NNNxMMM
	   With -o or -O options, set the size of the generated image to NNNxMMM.

       -F --font=FILE
	   Use FILE as the font file, in .pil/.pbm format. Point it to the .pil file, with the .pbm file in the same directory. If no font
	   specifications are given, wotsap will try to use some fonts installed in the system, or fall back to a built-in one.

       -T --ttffont=FILE
	   Like -F, but with a TrueType font file.

       -S --ttfsize=NUM
	   With -T, set the TrueType font size. Defaults to 16.

       -p --print
	   Print the whole Web of Trust in human readable format (very long output).

       -D --print-debug
	   Print the debug information in the .wot file.

       -d --diff=FILE
	   Print all differences between two .wot files (namely, between the file specified with -w and that specified with this option).

       -M --msd
	   Just show MSD for the specified key instead of full statistics.

       -W --wanted[=NUM]
	   Show the NUM (defaults to 10) 'most wanted signatures' for key (very long calculation time, try using -r).

       -r --restrict=STR
	   Restrict wanted signatures with STR, implies -W.

SEE ALSO

       gnupg (7), gpg (1).

AUTHOR

       This manual page was written by Giovanni Mascellani <g.mascellani@gmail.com> for the Debian(TM) system (but may be used by others),
       beacause the original program doesn't have a manual page. Permission is granted to copy, distribute and/or modify this document under the
       terms of the GNU General Public License, Version 2 any later version published by the Free Software Foundation.

       On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.

COPYRIGHT

       Copyright (C) 2007 Giovanni Mascellani

								     July 2007								 WOTSAP(1)