Mercurial > irccd
annotate doc/man/irccd.conf.5.in @ 102:4777f7e18bf2
Irccd: several improvements in servers, #385
Make server state a class to manage data cleanly where they are needed and to
understand better the transitions.
Add a ping timer that defaults to 5 minutes before marking the server as
disconnected.
author | David Demelier <markand@malikania.fr> |
---|---|
date | Tue, 26 Apr 2016 13:19:35 +0200 |
parents | 2a6ac6daceee |
children | 4cb417fd4e18 |
rev | line source |
---|---|
0 | 1 .\" |
2 .\" Copyright (c) 2013-2016 David Demelier <markand@malikania.fr> | |
3 .\" | |
4 .\" Permission to use, copy, modify, and/or distribute this software for any | |
5 .\" purpose with or without fee is hereby granted, provided that the above | |
6 .\" copyright notice and this permission notice appear in all copies. | |
7 .\" | |
8 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES | |
9 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF | |
10 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR | |
11 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES | |
12 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN | |
13 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF | |
14 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. | |
15 .\" | |
16 .Dd @MONTH@ @DAY@, @YEAR@ | |
17 .Dt IRCCD.CONF 5 | |
18 .Os | |
19 .Sh NAME | |
20 .Nm irccd.conf | |
21 .Nd irccd configuration file | |
22 .Sh DESCRIPTION | |
23 The file | |
24 .Nm irccd.conf | |
25 contains all parameters for the application | |
26 .Nm irccd . | |
27 .Pp | |
28 The irccd.conf file is .ini based syntax, with some extensions. | |
29 .\" SYNTAX | |
30 .Sh SYNTAX | |
31 The usual syntax is: | |
32 .Bd -literal -offset indent | |
33 [foo] | |
34 option = value | |
35 | |
36 [bar] | |
37 name = "long string enclosed between quotes" | |
38 | |
39 [lists] | |
40 servers = ( "server1", "server2" ) | |
41 .Pp | |
42 .Ed | |
43 Comments start with # and continue to the end of the line. | |
44 .Pp | |
45 Note that quotes are needed if the value has more that one word, if not the | |
46 value will be truncated at the first space found. | |
47 .\" CONFIGURATION | |
48 .Sh CONFIGURATION | |
49 This section shows all available sections with the options allowed for them. | |
50 .\" GENERAL | |
51 .Ss general | |
52 This section covers general options. | |
53 .Pp | |
54 .Bl -tag -width XXXXXXXXXXXXXXXXXXX -compact | |
55 .It uid | |
56 (string or number) the user id to use (Optional, default: none), | |
57 .It gid | |
58 (string or number) the group id to use (Optional, default: none), | |
59 .It foreground | |
60 (bool) set to true to not daemonize (Optional, default: false) | |
61 .It pidfile | |
62 (string) path to a file where to store the irccd pid (Optional, default: none). | |
63 .El | |
64 .\" LOGS | |
65 .Ss logs | |
66 This section can let you configure how irccd should log the messages. | |
67 .Pp | |
68 .Bl -tag -width XXXXXXXXXXXXXXXXXXX -compact | |
69 .It verbose | |
70 (bool) be verbose (Optional, default: false), | |
71 .It type | |
72 (string) which kind of logging, console, file or syslog (Optional, default: console). | |
73 .El | |
74 .Pp | |
75 The following parameters are available for type "file": | |
76 .Pp | |
77 .Bl -tag -width PARAMETERXXX -compact -offset indent | |
78 .It path-logs | |
79 (string) path to the normal messages, | |
80 .It path-errors | |
81 (string) path to the error messages. | |
82 .El | |
83 .\" IDENTITY | |
84 .Ss identity | |
85 This section is completely optional, if you don't provide one, irccd will use | |
86 a default identity with irccd as nickname and username. This section is | |
87 redefinable, you can create one or more. | |
88 .Pp | |
89 .Bl -tag -width XXXXXXXXXXXXXXXXXXX -compact | |
90 .It name | |
91 (id) the identity unique id. | |
92 .It nickname | |
93 (string) the nickname (Optional, default: irccd). | |
94 .It realname | |
95 (string) the realname (Optional, default: IRC Client daemon). | |
96 .It username | |
97 (string) the username name (Optional, default: irccd). | |
98 .It ctcp-version | |
99 (string) what version to respond to CTCP VERSION (Optional, default: IRC Client Daemon). | |
100 .It ctcp-autoreply | |
101 (bool) enable auto CTCP VERSION reply, (Optional, default: true). | |
102 .El | |
103 .\" SERVER | |
104 .Ss server | |
105 This section is used to connect to one or more server. Thus, this section is also redefinable. | |
106 .Pp | |
107 .Bl -tag -width XXXXXXXXXXXXXXXXXXX -compact | |
108 .It name | |
109 (id) the unique id. | |
110 .It host | |
111 (string) the server address. | |
112 .It port | |
113 (int) the server port. | |
114 .It identity | |
115 (string) an identity to use (Optional, default: irccd's default). | |
116 .It password | |
117 (string) an optional password (Optional, default: none). | |
118 .It auto-rejoin | |
119 (bool) auto rejoin a channel after being kicked (Optional, default: false), | |
120 .It join-invite | |
121 (bool) join channels upon invitation (Optional, default: false). | |
122 .It channels | |
123 (list) list of channels to auto join, (Optional, default: empty). | |
124 .It command-char | |
125 (string) the prefix for invoking special commands (Optional, default: !). | |
126 .It ssl | |
127 (bool) enable or disable SSL (Optional, default: false). | |
128 .It ssl-verify | |
129 (bool) verify the SSL certificates (Optional, default: true). | |
130 .It reconnect | |
131 (bool) enable reconnection after failure (Optional, default: true). | |
132 .It reconnect-tries | |
22
23d59afec277
Irccd: fix server.reconnect-tries, #417
David Demelier <markand@malikania.fr>
parents:
0
diff
changeset
|
133 (int) number of tries before giving up. A value of -1 means indefinitely (Optional, default: -1). |
0 | 134 .It reconnect-timeout |
135 (int) number of seconds to wait before retrying (Optional, default: 30). | |
102
4777f7e18bf2
Irccd: several improvements in servers, #385
David Demelier <markand@malikania.fr>
parents:
51
diff
changeset
|
136 .It ping-timeout |
4777f7e18bf2
Irccd: several improvements in servers, #385
David Demelier <markand@malikania.fr>
parents:
51
diff
changeset
|
137 (int) number of seconds before ping timeout (Optional, default: 300). |
0 | 138 .El |
139 .\" PLUGINS | |
140 .Ss plugins | |
141 This section is used to load plugins. | |
142 .Pp | |
143 Just add any key you like to load a plugin. If the value is not specified, the plugin is searched through the standard | |
144 directories, otherwise, provide the full path (including the .js extension). | |
145 .Pp | |
146 Example | |
147 .Bd -literal | |
148 [plugins] | |
149 hangman = "" | |
150 .Ed | |
151 .\" TRANSPORT | |
152 .Ss transport | |
153 This section defines transports, you may use sockets to do a basic IPC system within irccd. | |
154 .Pp | |
155 With transports, you can may ask `irccd` to send a message, a notice or even kicking someone from a channel. Irccd | |
156 will also notify all clients connected to this transport on IRC events. | |
157 .Pp | |
158 There are two type of listeners availables: | |
159 .Bl -enum -offset 2n | |
160 .It | |
161 Internet sockets, IPv4 and IPv6 | |
162 .It | |
163 Unix sockets, based on files (not available on Windows) | |
164 .El | |
165 .Pp | |
166 .Bl -tag -width XXXXXXXXXXXXXXXXXXX -compact | |
167 .It | |
168 (string) type of listener "ip" or "unix" | |
169 .El | |
170 .Pp | |
171 The following parameters are available for type "ip": | |
172 .Pp | |
173 .Bl -tag -width PARAMETERXXX -compact -offset indent | |
174 .It port | |
175 (int) port number. | |
176 .It address | |
177 (string) address to bind or "*" for any (Optional, default: *). | |
178 .It familty | |
179 (list) ipv6, ipv4. Both are accepted (Optional, default: ipv4) | |
180 .El | |
181 .Pp | |
182 The following parameters are available for type "unix": | |
183 .Pp | |
184 .Bl -tag -width PARAMETERXXX -compact -offset indent | |
185 .It path | |
186 (string) the file path to the socket. | |
187 .El | |
188 .\" RULE | |
189 .Ss rule | |
190 The rule section is one of the most powerful within irccd configuration. | |
191 .Pp | |
192 It let you enable or disable plugins and IRC events for specific criterias. For | |
193 instance, you may want to disable a plugin only for a specific channel on a | |
194 specific server. And because rules are evaluated in the order they are defined, | |
195 you can override rules. | |
196 .Pp | |
197 .Bl -tag -width XXXXXXXXXXXXXXXXXXX -compact | |
198 .It servers | |
199 (list) a list of servers that will match the rule (Optional, default: empty), | |
200 .It channels | |
201 (list) a list of channel (Optional, default: empty), | |
202 .It plugins | |
203 (list) which plugins (Optional, default: empty), | |
204 .It events | |
205 (list) which events (e.g onCommand, onMessage, ...) (Optional, default: empty), | |
206 .It action | |
207 (string) set to **accept** or **drop**. | |
208 .\" FILES | |
209 .Sh FILES | |
210 The default config file is located at | |
51
2a6ac6daceee
Docs: fix various typos in manuals
David Demelier <markand@malikania.fr>
parents:
22
diff
changeset
|
211 .Em @CMAKE_INSTALL_PREFIX@/@WITH_CONFDIR@/irccd.conf |
0 | 212 .Pp |
213 The user defined file follow the XDG standard and is usually | |
214 .Em $HOME/.config/irccd/irccd.conf . | |
215 If the XDG variable is not set, we use that path. | |
216 .\" SEE ALSO | |
217 .Sh SEE ALSO | |
218 .Xr irccd 1 | |
219 .\" AUTHORS | |
220 .Sh AUTHORS | |
221 irccd was written by David Demelier <markand@malikania.fr> |