30.04.2000

servctrl.tcl Component Documentation

# servctrl.tcl for netbots.tcl v3.30
# designed to work with eggdrop 1.3.28 or higher
# Johoho's Eggdrop Page - http://johoho.tuts.net/eggdrop/
# splitdetect.tcl copyright (c) 1999,2000 by Johoho <johoho@hojo-net.de>
# netbots.tcl copyright (c) 1998-2000 by slennox <slennox@egghelp.org>

## servctrl.tcl component script v2.10.0, 30.04.2000 ##

# History:
#
# v1.00.1, 22.04.2000 - initial release
# v2.00.0, 28.04.2000 - extended the script
# v2.10.0, 30.04.2000 - added an option to make not to crash on startup

# thanks slennox for netbots.tcl
# thanks to Abraham for ideas/bugreports/feeback

Please note that this component is fully compatible with netbots.tcl v3.15 - 3.30 by slennox

Description

This script provides extended server control support to eggdrop. If notices when a connection to an irc server is restricted, unauthorized or denied (k-lined). It logs those servers in a file and removes those servers from the server cycling queue. Checks against k-lines, restricted or unauthorized connections can be turned on/off in netset.tcl file.
Servers which were registered to be not bot friendly can be removed later from the file by a dcc command.

Commands MSG/DCC

DCC Commands

.servprob (m|m) - list all servers which make trouble
.rmserv (m|m) - remove a server from bad servers list
.klined (m|m) - show all servers where the bot is k-lined
.restricted (m|m) - show all servers where the bot is restricted
.unauthorized (m|m) - show all servers where the bot is unauthorized

Further help is available via the netbots help system. Use .nethelp

Installation

netset.tcl

To install this component properly you have to copy it to your netbots directory and add these lines to your netset.tcl conf:

# servctrl.tcl
set nb_component(servctrl) 1
set sc_note "$owner"
set sc_file "servers.txt"
set sc_klined 1
set sc_restricted 1
set sc_unauthorized 1

Settings Documentation

sc_note (default: "$owner")
	Enter here a list of people who should be notified if the script notices a server where the bot is k-lined, unauthorized or restricted.
	Valid settings: One or more nicknames, seperated by a blank " ". Leave completely blank to disable.

sc_file (default: "servers.txt")
	Set here the filename you want servctrl to log the servers it can't connect to
	Valid settings: a string

sc_klined (default: 1)
	Should the script care about server which have the bot's host k-lined?
	Valid settings: 1 to enable, 0 to disable.

sc_restricted (default: 1)
	Should the script care about resticted connections?
	Valid settings: 1 to enable, 0 to disable.

sc_unauthorized (default: 1)
	Should the script care about unauthorized connections?
	Valid settings: 1 to enable, 0 to disable.

FAQ

Q:		A server doesn't allow my bot to connect since it's k-lined, unauthorized or just allows a restricted connection, but the script doesn't notice!
A:		The raw settings used in this script are adapted for IrcNET. It seems that your network uses other raw codes. Go to your bots partyline, enable console +r, and log the connect procedure on '.jump'. There's a three figure number, that's what you need. Open your netset.tcl and add those settings to the servctrl.tcl section: set sc_raw_klined code_for_klined_connections set sc_raw_restricted code_for_restricted_connections set sc_raw_unauthorized code_for_unauthorized_connections An example would look loke: set sc_raw_klined 301 set sc_raw_restricted 419 set sc_raw_unauthorized 398 Of course you don't have to use all three settings. If you're fine with the pre-set settings, there's no need to change them.

Q:		My bot crashed incidentely and doesn't start anymore since servctrl removes all servers from the cycling list. The error message given by eggdrop is "NO SERVER"
A:		Servctrl waits three seconds before it removes all servers from cycling list. To increase this number, open your netset.tcl and add this setting to the servctrl.tcl section: set sc_starttimeout 10 Set a timer in seconds here. This should fix your problems.

Q:		I have a question, but it's not listed here.
A:		Feel free to contact the authot at johoho@hojo-net.de!

Contact

You can contact me via E-Mail at johoho@hojo-net.de, at ICQ 2499577 (tell me who you are and what you want or I'll ignore you) or catch me on irc usually around 18-24 UTC+1 in #eggdrop. (IrcNET)

DISCLAIMER

servctrl.tcl is provided 'as is' and without warranty of any kind.