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
           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 © 2007 Giovanni Mascellani

[FIXME: source]                                     July 2007                                          WOTSAP(1)