updates.
[silc.git] / doc / example_silcd.conf.in
1 #
2 # Example configuration file.  Note that this attempts to present various
3 # configuration possibilities and may not actually give any sensible 
4 # configuration.  For real life example see the examples/ directory.
5 #
6
7 #
8 # Configured ciphers.
9 #
10 # Format: <name>:<module path>:<key length>:<block length>
11 #
12 # If the cipher is builtin the <module path> maybe omitted.
13 #
14 [Cipher]
15 aes-256-cbc:@MODULESDIR@/aes.sim.so:32:16
16 aes-192-cbc:@MODULESDIR@/aes.sim.so:24:16
17 aes-128-cbc:@MODULESDIR@/aes.sim.so:16:16
18 twofish-256-cbc:@MODULESDIR@/twofish.sim.so:32:16
19 twofish-192-cbc:@MODULESDIR@/twofish.sim.so:24:16
20 twofish-128-cbc:@MODULESDIR@/twofish.sim.so:16:16
21 mars-256-cbc:@MODULESDIR@/mars.sim.so:32:16
22 mars-192-cbc:@MODULESDIR@/mars.sim.so:24:16
23 mars-128-cbc:@MODULESDIR@/mars.sim.so:16:16
24 none:@MODULESDIR@/none.sim.so:0:0
25
26 #
27 # Configured hash functions.
28 #
29 # Format: <name>:<module path>:<block length>:<digest length>
30 #
31 # If the hash function is builtin the <module path> maybe omitted.
32 #
33 [Hash]
34 sha1::64:20
35 md5::64:16
36
37 #
38 # Configured HMAC functions. The hash function used in the HMAC must
39 # configured to the [hash] section.
40 #
41 # Format: <name>:<hash name>:<mac length>
42 #
43 [hmac]
44 hmac-sha1-96:sha1:12
45 hmac-md5-96:md5:12
46 hmac-sha1:sha1:20
47 hmac-md5:md5:16
48
49 #
50 # Configured PKCS.
51 #
52 # Format: <name>
53 #
54 [PKCS]
55 rsa
56
57 #
58 # Run SILC server as specific user and group. The server must be initially
59 # run as root.
60 #
61 # Format: <user>:<group>
62 #
63 [Identity]
64 nobody:nobody
65
66 #
67 # Server's administrative information.
68 #
69 # Format: <location>:<server type>:<admin's name>:<admin's email address>
70 #
71 [AdminInfo]
72 Kuopio, Finland:Test Server:Pekka Riikonen:priikone@poseidon.pspt.fi
73
74 #
75 # Server information.
76 #
77 # Format: +<server FQDN>:<server IP>:<geographic location>:<port>
78 #
79 [ServerInfo]
80 lassi.kuo.fi.ssh.com:10.2.1.6:Kuopio, Finland:706
81
82 #
83 # Server keys
84 #
85 # Format: +<public key>:<private key>
86 #
87 [ServerKeys]
88 @ETCDIR@/silcd.pub:@ETCDIR@/silcd.prv
89
90 #
91 # Listenning ports.
92 #
93 # Format: <local IP>:<Listener IP>:<port>
94 #
95 [ListenPort]
96 10.2.1.6:10.2.1.6:706
97
98 #
99 # Log files.
100 #
101 # This section is used to set various logging files, their paths
102 # and maximum sizes. All the other directives except those defined
103 # below are ignored in this section. Log files are purged after they
104 # reach the maximum set byte size.
105 #
106 # Format: infologfile:<path>:<max byte size>
107 #         warninglogile:<path>:<max byte size>
108 #         errorlogile:<path>:<max byte size>
109 #         fatallogile:<path>:<max byte size>
110 #
111 [Logging]
112 infologfile:@LOGSDIR@/silcd.log:10000
113 #warninglogfile:@LOGSDIR@/silcd_warning.log:10000
114 #errorlogfile:@LOGSDIR@/error.log:10000
115 #fatallogfile:@LOGSDIR@/silcd_error.log:
116
117 #
118 # Connection classes.
119 #
120 # This section is used to define connection classes. These can be
121 # used to optimize the server and the connections.#
122 #
123 # Format: <class number>:<ping freq>:<connect freq>:<max links>
124 #
125 [ConnectionClass]
126 1:100:100:100
127 2:200:300:400
128
129 #
130 # Configured client connections.
131 #
132 # Format: <remote host>:<auth method>:<auth data>:<port>:<class>
133 #
134 # The <auth data> is either passphrase or file path to the public key
135 # file.
136 #
137 [ClientConnection]
138 :::706:1
139
140 #
141 # Configured server administrator connections
142 #
143 # Format: <host>:<username>:<nickname>:<auth method>:<auth data>
144 #
145 # The <auth data> is either passphrase or file path to the public key
146 # file.
147 #
148 [AdminConnection]
149 10.2.1.199:priikone:pekka:passwd:veryscret
150
151 #
152 # Configured server connections.
153 #
154 # If server connections are configured it means that our server is
155 # router server.  Normal server must not configure server connections.
156 # Thus, if your server is not router do not configure this section.  If
157 # your server is router, this must be configured.
158 #
159 # Format: <remote host>:<auth method>:<auth data>:<port>:
160 #         <version ID>:<class>:<backup connection>
161 #
162 # The <auth data> is either passphrase or file path to the public key
163 # file. If the connection is backup connection then set the <backup 
164 # connection> to value 1. For normal connections set it 0. If it is
165 # set to value 1 then this server will be backup router.
166 #
167 [ServerConnection]
168 10.2.1.7:passwd:veryscret:706:1:1:0
169 10.2.1.17:passwd:veryscret13:706:1:1:1   # backup connection, that host
170                                          # will use this server as backup
171                                          # router.
172
173 #
174 # Configured router connections.
175 #
176 # For normal server only one entry maybe configured to this section.  It
177 # must be the router this server will be connected to.  For router server,
178 # this sections includes all configured router connections.  The first
179 # configured connection is the primary route.
180 #
181 # Format: <remote host>:<auth method>:<auth data>:<port>:<version ID>:
182 #         <class>:<initiator>:<backup replace IP>:<backup replace port>:
183 #         <local backup>
184 #
185 # The <auth data> is either passphrase or file path to the public key
186 # file. If you are the initiator of the connection then set the <initiator>
187 # to value 1.  If you are the responder of the connection (waiting for 
188 # incoming connection) then set it to 0.
189 #
190 # If the connection is backup router connection then set the <backup
191 # replace IP> to the IP address of the router that the backup router will
192 # replace if it becomes unavailable.  Set also the router's port to the
193 # <backup replace port>.  For normal connection leave both empty. If this
194 # backup router is in our cell then set the <local backup> to value 1.
195 # If the backup router is in other cell then set it to value 0.
196 #
197 [RouterConnection]
198 #10.2.1.100:passwd:veryverysecret:706:1:1:1
199 #10.2.100.131:pubkey:/path/to/the/publickey:706:1:1:1
200 #10.2.100.100:pubkey:/path/to/the/publickey:706:1:1:0:10.2.1.6:706:1
201
202 #
203 # Denied connections.
204 #
205 # These connections are denied to connect our server.
206 #
207 # Format: <remote host>:<port>:<comment>
208 #
209 [DenyConnection]
210 #10.2.1.99:0:Your connection has been denied
211
212 #
213 #Message Of The Day
214 #
215 #specify the text file containing the motd:
216 #
217 #[motd]
218 #@ETCDIR@/motd.txt
219
220 #
221 #pidfile
222 #
223 #speficy the pidfile where it will be written:
224 #
225 [pid]
226 @PIDFILE@