5 infobot.users - User accounts database for infobot
9 # Please edit to your needs.
10 # "local" is used for CLI mode
11 # Passwords can be generated with mkpasswd in linux
19 --HOSTS local!local@local
24 --HOSTS *!~timr@TimRiker.active.supporter.pdpc
29 --HOSTS *!xk@example.com
30 --HOSTS *!xk@superbox.home.org
35 This file controls who has access to use your infobot.
39 There are various fields allowed in your file. Whitespace is ignored, and as
40 usual, any line starting with a C<#> is treated as a comment.
42 The first non whitespace/comment line in your file, is the user name for the
43 account you are about to define. Take note that a special username called
44 C<_default>, is meant to define what everyone who doesnt have an account in this
45 file should use for permissions.
47 Also, the special user name C<local>, is used when you run the bot in B<CLI>
48 mode (console only, no B<IRC> connection). As well, the C<local> user requires a
49 special hostmask of S<I<local!local@local>>.
51 Below is a list of the valid options available for each user account.
57 This field is a list of possible flags that this account has. Think of them as
58 similar to irc user modes (although, with different meanings).
60 Here is a list of the current flags available, and their meanings:
62 I<Note: Modes flags are case sensitive>
68 B<A> - bot administration over /msg (default is only via DCC CHAT)
72 B<O> - dynamic ops (as on channel). (automatic +o)
80 B<a> - ask/request factoid.
84 B<m> - modify factoid. (includes renaming)
88 B<n> - bot owner, can "reload"
92 B<o> - master of bot (automatic +amrt).
98 Can search on factoid strings shorter than 2 chars
102 Can tell bot to join new channels
106 Can [un]lock factoids
112 B<r> - remove factoid.
116 B<t> - teach/add factoid.
120 B<s> - Bypass +silent on channels
126 This field is used to specify a hostmask that a user must appear from for the
127 bot to consider them to be this specific account definition.
129 This hostmask takes the form of: I<nick!user@hostname>
131 I<Note: You can have this field multiple times>
135 This field used a C<crypt> formated password, that is used for B<DCC> chats to
136 the bot, or if you need to identify yourself to the bot in the event that you
137 come from a different host.
139 You can generate one using the C<mkpasswd> command, available on most systems.
143 infobot@myhost:~$ mkpasswd
147 You can also change your password at anytime by sending the bot a C<chpass>
154 At some point, it is likely that the C<local> account will be removed and
155 implied to have full access.