.\"     Title: WOTSAP
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\"      Date: July 2007
.\"    Manual: 
.\"    Source: 
.\"
.TH "WOTSAP" "1" "July 2007" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
wotsap - Web of Trust statistics and pathfinder
.SH "SYNOPSIS"
.HP 7
\fBwotsap\fR [\fBOPTIONS\fR] [bottomkey\ [topkey]]
.SH "DESCRIPTION"
.PP
\fBwotsap\fR
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\.
.PP
OpenPGP is the most widely used email encryption standard, used by encryption software such as the GNU Privacy Guard (see
\fBgnupg\fR
(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\.
.PP
\fBwotsap\fR
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
\fBwotsap\fR
main writer\.
.PP
Running
\fBwotsap\fR
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:
.sp
.RS 4
\h'-04'\(bu\h'+03'If you don\'t specify any of bottomkey and topkey,
\fBwotsap\fR
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\.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'If you specify only bottomkey,
\fBwotsap\fR
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\.
.RE
.sp
.RS 4
\h'-04'\(bu\h'+03'If you specify either bottomkey and topkey,
\fBwotsap\fR
will search for all the minimal paths from bottomkey to topkey and output them\.
.RE
.SH "OPTIONS"
.PP
\fB\-h\fR \fB\-\-help\fR
.RS 4
Show help\.
.RE
.PP
\fB\-\-version\fR
.RS 4
Show version\.
.RE
.PP
\fB\-w\fR \fB\-\-wot=FILE\fR
.RS 4
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\.
.RE
.PP
\fB\-m\fR \fB\-\-modify=STR\fR
.RS 4
Use STR of WoT modification string\.
.RE
.PP
\fB\-g\fR \fB\-\-group\fR
.RS 4
Print signature matrix of comma separated keys\. If there aren\'t any commas in the key specification,
\fBwotsap\fR
will interpret it as a search string, and print the signature matrix of all the key, whose name or email contains the string\.
.RE
.PP
\fB\-G\fR \fB\-\-nounknowns\fR
.RS 4
Don\'t print unknown keys in the signature matrix\.
.RE
.PP
\fB\-o\fR \fB\-\-png=FILE\fR
.RS 4
Write an image of the graph of all the minimal paths between the two specified keys in FILE, in \.png file format\.
.RE
.PP
\fB\-O\fR \fB\-\-show\-png=PRG\fR
.RS 4
Like
\fB\-o\fR, 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\.
.RE
.PP
\fB\-s\fR \fB\-\-size=NNNxMMM\fR
.RS 4
With
\fB\-o\fR
or
\fB\-O\fR
options, set the size of the generated image to NNNxMMM\.
.RE
.PP
\fB\-F\fR \fB\-\-font=FILE\fR
.RS 4
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,
\fBwotsap\fR
will try to use some fonts installed in the system, or fall back to a built\-in one\.
.RE
.PP
\fB\-T\fR \fB\-\-ttffont=FILE\fR
.RS 4
Like
\fB\-F\fR, but with a TrueType font file\.
.RE
.PP
\fB\-S\fR \fB\-\-ttfsize=NUM\fR
.RS 4
With
\fB\-T\fR, set the TrueType font size\. Defaults to 16\.
.RE
.PP
\fB\-p\fR \fB\-\-print\fR
.RS 4
Print the whole Web of Trust in human readable format (very long output)\.
.RE
.PP
\fB\-D\fR \fB\-\-print\-debug\fR
.RS 4
Print the debug information in the \.wot file\.
.RE
.PP
\fB\-d\fR \fB\-\-diff=FILE\fR
.RS 4
Print all differences between two \.wot files (namely, between the file specified with
\fB\-w\fR
and that specified with this option)\.
.RE
.PP
\fB\-M\fR \fB\-\-msd\fR
.RS 4
Just show MSD for the specified key instead of full statistics\.
.RE
.PP
\fB\-W\fR \fB\-\-wanted[=NUM]\fR
.RS 4
Show the NUM (defaults to 10) \'most wanted signatures\' for key (very long calculation time, try using
\fB\-r\fR)\.
.RE
.PP
\fB\-r\fR \fB\-\-restrict=STR\fR
.RS 4
Restrict wanted signatures with STR, implies \-W\.
.RE
.SH "SEE ALSO"
.PP
\fBgnupg\fR
(7),
\fBgpg\fR
(1)\.
.SH "AUTHOR"
.PP
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\.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common\-licenses/GPL\.
.SH "COPYRIGHT"
Copyright \(co 2007 Giovanni Mascellani
.br