2 # miau 0.6.2 configuration file example
3 # (C) 2003-2006 Tommi Saviranta <wnd@iki.fi>
6 # About structure of this configuration file:
8 # - All parameters are written inside quotes (for example, "foobar")
10 # - Options are defined like: option = "parameter1"[:"parameter2"] ...
12 # - When entering multiparameter options, certain parameters have default
13 # values and can be left out.
15 # - When entering multiparameter options and, for example, user doesn't want
16 # to set parameter2 at all but he needs to set parameter3, parameter2 can
17 # be skipped with column (':') like: "parameter1"::"parameter3".
19 # - Empty lines and characters after '#' (hash) are ignored.
21 # - When setting permissions, switched etc. (switches (booleans) are described
22 # as "state"), everything beginning with "t", "r" and "1" are concidered as
23 # "true" or "yes" (positive). Everything else is "false" or "no" (negative).
28 ################################################################################
31 # nicknames = { "nick" }: Your nickname (and secondary nicknames) on IRC.
33 # If the primary nick (first nick on the list) is already on use, miau will try
34 # the others on the list.
46 "miau_bnc_on_ipfire__"
50 # realname = "realname": Your "real" name on IRC.
55 #realname = "Prokhor Zakharov"
56 realname = "miau_bnc_on_ipfire"
59 # username = "username": Your username.
61 # Your ident, matters only if you don't have identd running.
68 username = "miau_bnc_on_ipfire"
70 # password = "password": The password miau will expect to receive from client
71 # when it's registering with nick.
73 # If this is 13 characters long, miau assumed it's crypted.
75 # If miau is compiled with ENABLE_MKPASSWD, miau can generate password-hashes
76 # (from command line) with -c -switch.
85 # listenport = "port": The port miau will wait for incoming connections.
93 # servers = { "server":"port":"password":"timeout" }: miau's IRC-server-list.
95 # Each line represents one server, where timeout is delay in seconds before
96 # connectiong attempt times out. Only "server" parameter is required.
103 # "irc.foo.bar":"6662"
104 # "localhost"::"foobar"
105 # "127.0.0.1":"6670"::"5"
112 # connhosts = { "host":"permitted" }: List of hosts that are allowed (or denied)
113 # to connect to miau.
115 # When boolean-value is left unset, it is assumed to be "true". This list will
116 # be processed as a chain which means latter rules can override previous ones.
118 # Default: no default
123 # "client*.evil.net":"no"
126 # "192.168.1.*":"yes"
133 ################################################################################
136 # statelog = "state": Should miau write state log.
138 # When true, log will be written to "$MIAUDIR/log". If set to false, the same
139 # stuff is printed on stdout (on terminal).
147 # listenhost = "host": Host miau uses to listen on.
149 # If you are compiled with IPV6 and need this to listen on an IPV4 port, you
150 # must use an IP in the form ::FFFF:127.0.0.1
152 # Default: no default
155 listenhost = "0.0.0.0"
158 # floodtimer = "number": Time it takes to send one message.
160 # When configuring flood-protection, this variable defined how fast you can
161 # send messages; how many seconds sending one message takes. See also burstsize.
169 # burstsize = "number": How manu messages can be sent at once.
171 # When onfiguring flood-protection, this variable defined how many messages
172 # can be sent at once (in a burst). See also floodtimer.
180 # jointries = "number": Number of tries to join channel after dropping from
181 # server etc. miau tries to join channels once a minute.
189 # bind = "host": Host/IP miau uses for outgoing connections.
197 # maxclients = "number": Maximum number of clients connected to miau
200 # Set to zero for unlimited clients.
208 # stonedtimeout = "seconds": Time (in seconds) with no data from the server
209 # before it is declared stoned and being disconnected.
211 # Although minimum value is 30, this value has no upper limit. Watch out,
212 # though, if this value is set too high, death of servers may stay undetected
213 # for a very long time if you are idle.
218 #stonedtimeout = "150"
221 # connecttimeout = "seconds": Time (in seconds) before connection attampt will
224 # Note that while connecting to the server miau will not respond to clients.
225 # Minimum value is 5, and many systems define maximum value.
230 #connecttimeout = "60"
233 # channels = { "channel":"keyword" }: List of channels to join.
244 # rejoin = "state": Rejoin channels after disconnecting from the server.
246 # If rejoin is set to true, channels defined in "channels" are also joined when
247 # client first time connects to miau.
255 # leave = "state": Leave channels when all clients have detached from miau.
257 # If "leave" is set to "false" and "rejoin" is set to "true", channels defined
258 # at "channels" will be joined at miau startup. If both "leave" and "rejoin"
259 # is set to "true", channels that are left at client detach, are rejoined when
260 # client attached back to miau.
268 # leavemsg = "message": Message miau will either use as PART-message or as an
269 # ACTION when all clients have detached from miau.
271 # If unset or set to empty, no message will be shown. Note that many people
272 # dislike event-based messages (which happens when "leave" is set to "false"
273 # and "leavemsg" is set). Also see usequitmsg.
275 # Note: Note that commenting this option out and rehashing after leavemsg was
276 # set, this option is _not_ reverted. To disable leavemsg afterwards you
277 # need to write an empty string here and rehash.
285 # awaymsg = "message": Text that will be set to miau's away-reason when all
286 # clients have detached from miau.
288 # If unset or set to empty, AWAY-status will be left untouched. When any client
289 # attaches back to miau, AWAY-status will be reset. Also see usequitmsg.
291 # Note: If user sets him/herself away, miau will not touch away-status nor
292 # message neither when connecting to or disconnecting from miau.
294 # Note: Note that commenting this option out and rehashing after awaymsg was
295 # set, this option is _not_ reverted. To disable awaymsg afterwards you
296 # need to write an empty string here and rehash.
301 #awaymsg = "bouncing around - all private messages will be logged"
304 # usequitmsg = "state": Use last quit-reason as away-reason and/or leave-message
305 # (if respective options are enabled) when all clients have
306 # disconnected from miau.
308 # If quit-reason is empty, default values of awaymsg and leavemsg will be used,
309 # otherwise most recent quit-message overrides values in miaurc.
314 # usequitmsg = "false"
317 # autoaway = "selection": miau can set user away automatically.
319 # This option allows to define when to do that. This option may be one of the
320 # following: "never", "detach", "noclients".
322 # never: never set user away
323 # detach: set user away when any of the clients disconnects
324 # noclients: set user away when the last client disconnects
329 #autoaway = "noclients"
332 # chandiscon = "selection": When miau is disconnected from the server e.g.
333 # because of network problem, miau can notify user about this in
336 # nothing: only print server notice
337 # notice: send notice to each channel
338 # part: part each channel. mIRC users probably don't want to use this.
339 # privmsg: send a private message to the user
344 #chandiscon = "notice"
347 # getnick = "selection": miau can try to reclaim your primary nick when it is
350 # This option may be one of the following: "never", "detached", "attached", or
353 # never miau will not try to get your nick back
354 # detached miau will try to get your nick when no clients are attached
355 # attached miau will try to get your nick when there are one or more
357 # always miau will try to get your nick
359 # Note: Do _not_ use options "attached" and "always" with clients (like
360 # irc-II EPIC) that automatically change your nick when they receive
361 # NICKINUSE from the server - you might end up chaning your nick until
362 # server drops your connection due excess flood.
364 # Note: If you issue "/nick not-primary-nick", miau will start trying to get
365 # your primary nick back.
373 # getnickinterval = "seconds": Time between tries (in seconds) to obtain
374 # currently (possibly) lost primary nick.
376 # Don't set it too low or you might get kicked out the server due to excess
382 #getnickinterval = "30"
385 # antiidle = "minutes": Time between idle-timer resets in minutes. Set to 0 to
394 # qloglength = "minutes": Age of oldest line in quicklog in minutes. Set to zero
395 # to disable quicklog.
397 # This option might not be compiled in.
405 # timestamp = "option": Location of timestamp in quicklog events.
407 # This option may be one of the following "beginning", "end", or "none".
409 # This option might not be compiled in.
414 #timestamp = "beginning"
417 # flushqlog = "state": Erase quicklog when quicklog is replayed.
419 # If set to true, quicklog will be written only when no clients are connected
420 # and quicklog will be erased when client connects to miau. If you are running
421 # a single client, you probably want to leave this to "false.
423 # This option might not be compiled in.
431 # autoqlog = "minutes": Automatically replay number of minutes of quiclog on
434 # This option might not be compiled in.
442 # inbox = "state": Enables logging private messages when no clients are
445 # This option might not be compiled in.
453 # nevergiveup = "state": Don't die when miau runs out of working servers.
455 # If set to true, miau will reset "working"-status of servers to working when
456 # all are set to dysfunctional. Respectively, if set to false, miau will quit
457 # when all servers on the list have been set to dysfunctional.
462 #nevergiveup = "false"
465 # norestricted = "state": Don't join servers where you get "+r".
467 # If set to true, miau will not stay on server that forces user to have
468 # restricted-status (+r).
473 #norestricted = "false"
476 # reconnectdelay = "seconds": Time (in seconds) between connection attempts.
478 # Minumun value is set to 1.
483 #reconnectdelay = "30"
486 # nickfillchar = "fill character": Fill nick with this character when unique
489 # Character used to modify your primary nick when all defined nicks are already
490 # occupied. Note character is a single octet (byte) and if longer string is
491 # fed, only the first character is used.
493 # Example: When nickfillchar is set to '_', primary nick is "zak" and all
494 # defined nicks are occupied, next nicks tried are "zak_", "zak__",
495 # "zak___" and so on. When nick has grown too long, it will be shifted
496 # one characted to right (where shift is cyclic) - this means
497 # "zak______" will become "_zak_____", which, again, will become
506 # maxnicklen = "length": Maximum nick length, used with nickfillchar.
514 # usermode = "usermode(s)": Usermode.
516 # Usermode that miau will request (if no clients are attached at the moment)
517 # from the server when connection to the server is established. Leave unset or
518 # set to empty to disable this feature.
526 # forwardmsg = "command": Commands to pipe private messages to.
528 # miau can collect the (private) messages within specified time (see
529 # forwardtime) and pipe them into the program specified. Leave this unset or
530 # set to empty to disable this feature.
535 #forwardmsg = "mail user@host"
538 # forwardtime = "seconds": Time between sending stuff in forwardmsg queue.
540 # Time in seconds after first inserted line into forwardmsg queue before
541 # piping the stuff out.
546 #forwardtime = "3600"
549 # ignore = { "mask":"ignored" }: Ignored users.
551 # List of users whose private messages (PRIVMSG) and noticies (NOTICE) are
552 # ignored when no clients are attached to miau. When "ignored" is left
553 # undefined, it is assumed to be "true". Setting "ignored" to "false" means
554 # that this user will _not_ be ignored. This list is processed as a chain.
560 # "*@localhost":"yes"
565 # privlog = "mode": Log private messages.
567 # Whatever private messages should be logged in nick-specific files. Can be one
568 # of "never", "detached", "attached", and "always".
570 # This option might not be compiled in.
578 # chanlog = { "channel(s)":"options":"logfile" }: List of channel logfiles.
580 # When channel is set to "*", line represents global log. When logging,
581 # if channel doesn't have entry of it's own in this list, it will use settings
582 # of global log and write log to it's own file. When defining global log,
583 # "logfile" is ignored. Each line can have multiple channels
584 # (like "#foobar,#miau").
586 # If logfile is left undefined, logfile will be named after the channel with
587 # possible suffix (see logsuffix). All lofiles are written in miau's work
590 # Options consist of abritary set of following possibilities:
592 # e: log parts (exits)
594 # m: log messages (privmsg/notice)
595 # c: log mode changes (changes)
596 # n: log nick changes
597 # o: log misc events (other)
598 # b: log messages from miau (bouncer)
599 # a: log all of above
600 # A: log when a client is attached
601 # D: log when a client is detached
602 # C: log continuously (status of clients doesn't matter)
604 # Note that all channelless messages (such as QUIT) are logged on every active
605 # channel. This is a feature, not a bug.
607 # This option might not be compiled in.
613 "#epel":"a":"epel.log" # log everything on #foobar
614 "#lugop":"a":"lugop.log" # log everything on #foobar
615 # "#miau":"aD":"foo.log" # log everything to file "foo.log" when
616 # all clients are detached
617 # "*":"mjeq" # log only messages, joins, parts and quits
622 # logsuffix = "suffix": Suffix for logfiles.
624 # When writing log to undefined logfile, each logfile consists of channel name
625 # followed by suffix. Suffix can be defined here.
627 # This option might not be compiled in.
635 # onconnect = { "mode":"target/data"(:"data") }: Commands to write at server
638 # When miau connects and registers user to server, miau can send pre-defined
639 # messages. User can define miau to send normal messages (PRIVMSG), notices
640 # (NOTICE) or arbitrary messages.
642 # Mode can be one of the following:
643 # p: private message (PRIVMSG).
644 # n: notice (NOTICE). Should be used with services and automatons, but
645 # unfortunately some network services can't cope with notices.
646 # r: "raw" message. This means user must provide complete message to send
647 # to the server. Using raw message user has complete control over what
648 # is being sent. If you don't know what this is, you don't need this.
649 # When using modes "p" or "n", user must provide both message and target where
650 # as with raw messages only one parameter in addition to type should be given.
652 # This option might not be compiled in.
658 "p":"nickserv":"identify password"
659 # "n":"nickserv@services.host.net":"id raboof"
664 # automodes = { "mask":"privilegded" }: List of people who are automatically
665 # given certain privilege on channel.
667 # Mask is given in form of "mode:nick!username@host/#channel" (where "mode" is
668 # a single character) and list is processed as a chain.
670 # This option might not be compiled in.
676 # "o:zak*!zak@client*-myisp.com/#channel":"yes"
677 # "o:zak*!*@evil.impersonator.net/#foobar":"no"
678 # "v:newbie*!*@ircnet.com/#newbie":"yes"
682 # automodedelay = "seconds": Time (in seconds) after first queued mode change
685 # During this period of time miau can collect more than one mode change and
686 # commit up to three at a time. Other situation reasonaly big value (like 30)
687 # here could prove useful is channel where there are stupid "auto-oping" bots.
688 # (Stupid bots do mode changes even if someone else did that already.)
690 # This option might not be compiled in.
695 #automodedelay = "60"
698 # cmdpasswd = "password": Password for remote commands.
700 # Please ignore this options.
702 # If this is 13 characters long, miau assumes it's crypted. Comment this out or
703 # leave it empty to disable remote commands. When sending miau a remote
704 # command, password _always_ begins with column (':') (if cmdpasswd is set to
705 # "foobar" (or hash of it), you need to send miau a message beginning with
706 # ":foobar" to issue a remote command).
708 # This feature might not be compiled in.
710 # If miau is compiled with ENABLE_MKPASSWD, miau can generate password-hashes
711 # (from command line) with -c -switch.
719 # dccbounce = "state": Bounce DDCs.
721 # miau can bounce DCCs. Set to true to enable bouncing. You probably don't
724 # This option might not be compiled in.
732 # dccbindhost = "host": IP to bind for DDC bounce.
734 # If miau has separate IPs for IRC-network and clients, you should enter IP for
737 # This option might not be compiled in.
739 # Default: no default
742 #dccbindhost = "10.0.0.1"