Merged from silc_1_0_branch.
[silc.git] / doc / silcd.yo
1 manpage(SILCD) (8) (October 31 2002) (silc-server) (silc-server)
2
3
4 manpagename(silcd) (SILC server)
5
6
7 manpagesynopsis()
8 bf(silcd) bf([) -f em(file) | -d | -D | -x | -h | -F | -C | -V bf(])
9
10
11 manpagedescription()
12 Silcd is a server for SILC, Secure Internet Live Conferencing network.
13
14
15 manpageoptions()
16 bf(-f) em(FILE)    Read configuration from em(FILE).
17
18 bf(-d)         Enable debugging (Implies -F).
19
20 bf(-D) em(LEVEL)   Enable debug messages of level em(LEVEL) and lower (Implies -F).
21
22 bf(-x)         Enable hexdumps (Implies -d).
23
24 bf(-F)         Don't fork.  Run silcd on foreground.
25
26 bf(-h)         Display help message.
27
28 bf(-V)         Display version.
29
30 bf(-C)         Create new public key pair. See bf(KEY GENERATION) for options.
31
32 manpagesection(LONG OPTIONS)
33 bf(--config-file)=em(FILE)    Same as bf(-f).
34
35 bf(--debug)=em(STRING)        Same as bf(-d), limit to messages *em(STRING)*.
36
37 bf(--debug-level)=em(LEVEL)   Same as bf(-D).
38
39 bf(--hexdump)             Same as bf(-x).
40
41 bf(--foreground)          Same as bf(-F).
42
43 bf(--version)             Same as bf(-V).
44
45 bf(--create-key-pair)     Same as bf(-C).
46
47
48 manpagesection(KEY GENERATION)
49 When generating new key pair for silcd (bf(-C)), the following extra switches
50 apply:
51
52 bf(--pkcs)=em(PKCS)       Set the public key algorithm of public key pair.  For example bf(rsa).
53
54 bf(--bits)=em(VALUE)      Set the length of public key pair, in bits.
55
56 bf(--identifier)=em(ID)   Set em(ID) as public key identifier.
57
58 The identifier has the format of:
59
60 UN=<username>, HN=<hostname or IP>, RN=<real name>, E=<email>,
61 O=<organization>, C=<country>
62
63 Both UN and HN are mandatory, all the rest are optional but recommended.
64 If no bf(--identifier) is used, an identifier will be created automatically.
65
66 Example:
67
68 bf(silcd -C --identifier)="UN=foobar, HN=foo.bar.com, RN=Foo T. Bar,
69 E=foo@bar.com, C=FI"
70
71
72 manpagefiles()
73 There are two configuration files for silcd: 
74 em(/etc/silc/silcd.conf) for server configuration and
75 em(/etc/silc/silcalgs.conf) for SIM (SILC Modules) configuration. 
76 Do note that silcalgs.conf is only needed if cryptographic algorithms are 
77 built as separate modules.
78
79
80 manpageseealso()
81 bf(silc(1)), bf(silcd.conf(5))
82
83
84 manpagesection(NETWORK RESOURCES)
85 Homepage: bf(http://silcnet.org)
86
87 manpageauthor()
88 SILC is designed and written by Pekka Riikonen <priikone@iki.fi> and rest
89 of the SILC Project.
90
91 This manpage was written by Mika 'Bostik' Boström <bostik@lut.fi>
92
93 See bf(CREDITS) for full list of contributors.
94