annotate doc/examples/irccd.conf @ 131:77c90336ba56

Irccd: initial Plugin split, #501
author David Demelier <markand@malikania.fr>
date Thu, 12 May 2016 15:06:11 +0200
parents f0e00b72fea9
children 6635b9187d71
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
1 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
2 # irccd.conf -- config file for irccd
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
3 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
4
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
5 # Section general:
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
6 # This section describe global options used by irccd.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
7 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
8 # [general]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
9 # uid = "nobody" # (string or number) the user id to use (Optional, default: none),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
10 # gid = "nobody" # (string or number) the group id to use (Optional, default: none),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
11 # foreground = false # (bool) set to true to not daemonize (Optional, default: false),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
12 # pidfile = "/tmp/irccd.pid" # (string) path to a file where to store the irccd pid (Optional, default: none).
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
13
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
14 [general]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
15 foreground = true
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
16
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
17 # Section plugins:
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
18 # Load plugins by name or by paths.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
19 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
20 # [plugins]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
21 # abc = # This will search for abc
36
f0e00b72fea9 Misc: remove old references to Lua
David Demelier <markand@malikania.fr>
parents: 0
diff changeset
22 # ask = /tmp/ask.js # This use /tmp/ask.js to load the plugin
0
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
23
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
24 [plugins]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
25 history = ""
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
26 ask = ""
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
27
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
28 # Section identities:
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
29 # This describe identities, you can add any number you want they are used with servers so you can reuse an
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
30 # identity for one or more servers if you want.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
31 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
32 # [identity]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
33 # name = "id" # (id) the identity unique id,
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
34 # nickname = "foo" # (string) the nickname (Optional, default: irccd),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
35 # username = "bar" # (string) the realname (Optional, default: IRC Client daemon),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
36 # realname = "Jean" # (string) the username name (Optional, default: irccd),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
37 # ctcp-version = "irccd" # (string) what version to respond to CTCP VERSION (Optional, default: IRC Client Daemon),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
38 # ctcp-autoreply = true # (bool) enable auto CTCP VERSION reply, (Optional, default: true).
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
39
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
40 [identity]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
41 name = "default"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
42 nickname = "superbot"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
43 username = "superbot"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
44 realname = "Superbot Killer"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
45
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
46 # Section transport:
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
47 # You can use transport to wait for any input you want. Unix and internet sockets are supported. Unix are used
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
48 # for file based socket while internet bind to standard address plus a specific port.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
49 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
50 # For internet sockets:
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
51 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
52 # [transport]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
53 # type = "ip"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
54 # port = "1234" # (int) port number,
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
55 # address = "*" # (string) address to bind or "*" for any (Optional, default: *),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
56 # family = ( "ipv4", "ipv6" ) # (list) ipv6, ipv4. Both are accepted (Optional, default: ipv4).
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
57 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
58 # For unix sockets:
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
59 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
60 # [transport]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
61 # type = "unix"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
62 # path = "/tmp/irccd.sock" # (string) the file path to the socket.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
63
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
64 [transport]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
65 type = "ip"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
66 address = "*"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
67 port = "5980"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
68 family = "ipv4 ipv6"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
69
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
70 # Section server:
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
71 # List of server you want to connect to. A server may use an identity to
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
72 # set the username, nickname and so on. A server is registered with a
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
73 # unique id that is needed for irccdctl(1).
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
74 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
75 # [server]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
76 # name = "id" # (id) the unique id,
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
77 # host = "chat.foo.com" # (string) the server address,
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
78 # port = "4321" # (int) the server port (Optional, default: 6667),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
79 # identity = "default" # (string) an identity to use (Optional, default: irccd's default),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
80 # password = "secret" # (string) an optional password (Optional, default: none),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
81 # auto-rejoin = false # (bool) auto rejoin a channel after being kicked (Optional, default: false),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
82 # join-invite = false # (bool) join channels upon invitation (Optional, default: false),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
83 # channels = "" # (list) list of channels to auto join, (Optional, default: empty),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
84 # command-char = "!" # (string) the prefix for invoking special commands (Optional, default: !),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
85 # ssl = false # (bool) enable or disable SSL (Optional, default: false),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
86 # ssl-verify = false # (bool) verify the SSL certificates (Optional, default: true),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
87 # reconnect = true # (bool) enable reconnection after failure (Optional, default: true),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
88 # reconnect-tries = 0 # (int) number of tries before giving up. A value of 0 means indefinitely (Optional, default: 0),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
89 # reconnect-timeout = 5 # (int) number of seconds to wait before retrying (Optional, default: 30).
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
90
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
91 [server]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
92 identity = "default"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
93 name = "localhost"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
94 host = "localhost"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
95 port = 6667
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
96 reconnect-timeout = 60
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
97 reconnect-tries = 20
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
98
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
99 # Section rule:
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
100 # Add one or more rules to filter IRC events.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
101 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
102 # servers = "" # (list) a list of servers that will match the rule (Optional, default: empty),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
103 # channels = "" # (list) a list of channel (Optional, default: empty),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
104 # plugins = "" # (list) which plugins (Optional, default: empty),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
105 # events = "" # (list) which events (e.g onCommand, onMessage, ...) (Optional, default: empty),
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
106 # action = "" # (string) set to **accept** or **drop**.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
107 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
108 # Block plugin hangman everywhere.
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
109 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
110 # [rule]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
111 # plugins = "hangman"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
112 # action = drop
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
113 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
114 # Allow it again on #games@localhost
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
115 #
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
116 # [rule]
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
117 # servers = "localhost"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
118 # channels = "#games"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
119 # plugins = "hangman"
1158cffe5a5e Initial import
David Demelier <markand@malikania.fr>
parents:
diff changeset
120 # action = accept