From b489d119fc6c61e43c88efffb2ba4705ac4aeca8 Mon Sep 17 00:00:00 2001 From: Jameson Graef Rollins Date: Wed, 11 Jun 2008 12:00:36 -0400 Subject: Fill out a little of the man pages. --- man/man1/monkeysphere.1 | 76 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) (limited to 'man/man1/monkeysphere.1') diff --git a/man/man1/monkeysphere.1 b/man/man1/monkeysphere.1 index 4c3d483..fff16ba 100644 --- a/man/man1/monkeysphere.1 +++ b/man/man1/monkeysphere.1 @@ -4,3 +4,79 @@ monkeysphere \- monkeysphere client user interface .SH SYNOPSIS .B monkeysphere \fIcommand\fP [\fIargs\fP] .SH DESCRIPTION +.PP +\fBmonkeysphere\fP is the client monkeysphere tool. +.SH SUBCOMMANDS +\fBmonkeysphere\fP takes various subcommands: +.PD +.TP +.B update-known_hosts [HOST]... +Update the known_hosts file. For every host listed, search for a gpg +key for the host in the Web of Trust. If a key is found, any ssh keys +for the host are removed from the known_hosts file. If the found key +is acceptable (see KEY ACCEPTABILITY), then the gpg key is converted +to an ssh key and added to the known_hosts file. If now gpg key is +found for the host, then nothing is done. If no hosts are specified, +all hosts listed in the known_hosts file will be processed. If they +`k' may be used in place of `update-known_hosts'. +.TP +.B update-authorized_keys +Update the authorized_keys file. +.TP +.B update-userids [USERID]... +Update userid +.TP +.B gen-ae-subkey KEYID +Generate an `ae` capable subkey +.TP +.B help +Output a brief usage summary. `h' or `?' may be used in place of +`help'. +.PD +.SH KEY ACCEPTABILITY +GPG keys are considered acceptable if the following criteria are met: +.PD +.TP +.B capability +The key must have both the "authentication" and "encrypt" capability +flags. +.TP +.B validity +The key must be "fully" valid, and must not be expired or revoked. +.PD +.SH FILES +.PD 1 +.TP +~/.config/monkeysphere/monkeysphere.conf +User monkeysphere config file. +.TP +/etc/monkeysphere/monkeysphere.conf +System-wide monkeysphere config file. +.TP +~/.config/monkeysphere/authorized_user_ids +GPG user IDs to validate for addition to the authorized_keys file. +.TP +~/.config/monkeysphere/authorized_keys +Monkeysphere generated authorized_keys file. +.TP +~/.config/monkeysphere/user_keys +User keys cache directory. +.TP +~/.config/monkeysphere/host_keys +Host keys cache directory. +.PD +.SH AUTHOR +Written by Jameson Rollins +.SH "REPORTING BUGS" +Report bugs to . +.SH COPYRIGHT +Copyright \(co 2008 Jameson Graef Rollins and Daniel Kahn Gillmor +.br +This is free software. You may redistribute copies of it under the +terms of the GNU General Public License +. There is NO WARRANTY, to the +extent permitted by law. +.SH "SEE ALSO" +.BR ssh (1), +.BR gpg (1), +.BR monkeysphere-server (8) -- cgit v1.2.3