80849f58ca9a76896abf056d53da3ffa1c411275
[ssh-keysync.git] / files / client / man1 / ssh-keysync.1
1 .TH ssh-keysync 1 "2005-09-08" "1.0"
2
3 .\"""
4 .\" Short term description
5 .SH NAME
6 ssh-keysync \- Get ssh_known_hosts file from server
7
8 .\"""
9 .\" The general command line
10 .SH SYNOPSIS
11 .B ssh-keysync
12 .RB [\| \-configcheck \||\| \-pull \|]
13 .RB [\| \-q \||\| \-quiet \|]
14
15 .SH DESCRIPTION
16 .B ssh-keysync
17 is the client script to download a
18 .IR ssh_known_hosts
19 file generated by
20 .BR ssh-keysync-merge
21 from the configured
22 .IR webserver
23 to
24 .IR /etc/ssh/ssh_known_hosts .
25 This file should contain all the public hosts keys from your clients
26 to ensure that
27 .BR ssh
28 will complain if you're connecting a maschine whichs host key has changed.
29
30 This mechanism allows you to identify compromised maschines rather fast,
31 because everyone connecting to a compromised host will be warned about the
32 changed key, regardless about the up-to-dateness of the per user known hosts
33 file
34 .IR ~/.ssh/known_hosts .
35
36
37 .SH OPTIONS
38 .TP
39 .BI \-configcheck
40 Check the configuration file for errors and exit.
41
42 .TP
43 .BI \-pull
44 Pull the generated ssh_known_hosts file from the
45 .IR webserver
46 and put it to
47 .IR /etc/ssh/ssh/known_hosts .
48
49 .TP
50 .BI \-q,\ \-quiet
51 Let
52 .BR ssh-keysync
53 shut up about informational messages. 
54 Only errors will be print out in quiet mode.
55 This is usefull when running 
56 .BR sh-keysync
57 from cron.
58
59
60 .\" Files used by this utility
61 .SH FILES
62 .TP
63 .I /etc/rbm/ssh-keysync-client.conf
64 Configuration file upgraded by
65 .BR ssh-keysync
66
67 .\"""
68 .\" You may want to have a look at this:
69 .SH "SEE ALSO"
70 .BR ssh-keysync-merge (1)
71
72 .\" The perl monger...
73 .SH AUTHOR
74 Written by Maximilian Wilhelm <max@rfc2324.org>