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:
•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.
•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.
•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
-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), because 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 © 2007 Giovanni Mascellani
