--- wotsap-0.7.orig/man/wotsap.dbk +++ wotsap-0.7/man/wotsap.dbk @@ -0,0 +1,308 @@ + +Giovanni"> + Mascellani"> + July 2007"> + 1"> + g.mascellani@gmail.com"> + + WOTSAP"> + + + Debian"> + GNU"> + GPL"> +]> + + + +
+ &dhemail; +
+ + 2007 + &dhusername; + + &dhdate; + + + &dhucpackage; + + &dhsection; + + + &dhpackage; + + Web of Trust statistics and pathfinder + + + + &dhpackage; + + + bottomkey topkey + + + + DESCRIPTION + + &dhpackage; 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. + + &dhpackage; 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 + &dhpackage; main writer. + + Running &dhpackage; 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, + &dhpackage; 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, &dhpackage; + 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, + &dhpackage; will search for all the minimal paths + from bottomkey to topkey and output them. + + + + + + OPTIONS + + + + + + + + + Show help. + + + + + + + + Show version. + + + + + + + + + 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. + + + + + + + + + Use STR of WoT modification string. + + + + + + + + + Print signature matrix of comma separated keys. If there aren't + any commas in the key specification, &dhpackage; + will interpret it as a search string, and print the signature matrix + of all the key, whose name or email contains the string. + + + + + + + + + Don't print unknown keys in the signature matrix. + + + + + + + + + Write an image of the graph of all the minimal paths between + the two specified keys in FILE, in .png file format. + + + + + + + + + Like , 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. + + + + + + + + + With or options, set the + size of the generated image to NNNxMMM. + + + + + + + + + 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, &dhpackage; + will try to use some fonts installed in the system, or fall back to + a built-in one. + + + + + + + + + Like , but with a TrueType font file. + + + + + + + + + With , set the TrueType font size. Defaults + to 16. + + + + + + + + + Print the whole Web of Trust in human readable format (very long + output). + + + + + + + + + Print the debug information in the .wot file. + + + + + + + + + Print all differences between two .wot files (namely, between + the file specified with and that specified with + this option). + + + + + + + + + Just show MSD for the specified key instead of full statistics. + + + + + + + + + Show the NUM (defaults to 10) 'most wanted signatures' for key + (very long calculation time, try using ). + + + + + + + + + Restrict wanted signatures with STR, implies -W. + + + + + + + SEE ALSO + + gnupg (7), gpg (1). + + + AUTHOR + + This manual page was written by &dhusername; &dhemail; for + the &debian; 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. + + + + +