README

Diese README basiert auf der README Datei die mit shroudBNC 1.1 ausgeliefert wird.

Es wird vorausgesetzt das sie sBNC bereits runter geladen 1) und in ihr Benutzerverzeichnis des Benutzers (Nicht als root) der sBNC verwendet werden soll 2) entpackt haben 3).

• Ein Compiler (GCC/G++)
  • Benötigt.
  • Falls noch kein Compiler auf ihrem System installiert ist, installieren Sie ihn über ihren Paketmanager.
  • Unter Debian ist der Compiler im build-essential Paket enthalten 4)
• TCL 8.4+
  • Optional (TCL 8.4+ wird nur benötigt wenn sie wollen das sBNC TCL versteht).

1. Wechseln Sie in den ~/sbnc-1.1 Ordner.
2. Überprüfen Sie Ihre Konfiguration:

   ./configure

3. Compilieren:

   make

4. Installieren:

   make install

• Fahren Sie entweder mit dem compilieren des TCL Moduls unten fort oder machen sie direkt mit der sBNC Konfiguration weiter. Sie können das TCL Modul jederzeit, auch später wenn Sie wollen, compilieren.

Stellen Sie sicher das sie beide, das “tcl8.4” und das “tcl8.4-dev”, Pakete installiert haben. Sie werden benötigt um das TCL Modul zu compilieren.

1. Wechseln Sie in den ~/sbnc-1.1/tickle Ordner.
2. Überprüfen Sie ihre Konfiguration:

   ./configure

3. Compilieren:

   make

4. Installieren:

   make install

• Bei Erfolg wird eine “tickle.so” Datei erstellt und in ihren ”~/sbnc” Ordner kopiert.
• Sobald Sie sBNC gestartet haben und mit ihrem Bouncer verbunden sind können sie das Modul mit ”/sbnc insmod ./tickle.so” über IRC laden.

• Nachdem Sie “make install” oben ausgeführt haben wird ein neuer Ordner in ihrem Benutzerverzeichnis erstellt. Begeben Sie sich dort hin.

  cd ~/sbnc

• Starten sie das mitgelieferte Konfigurationsprogramm um einige grundlegende Einstellungen wie den Port und den ersten Benutzer einzustellen.

  ./conftool

• Jetzt können Sie ihren sBNC mit dem Befehl ”./sbnc” oder ”./sbnc -n” starten. Der ”-n” Flag zeigt ihnen die Konsolen-Ausgaben.

  user@server:~/sbnc$ ./sbnc
  shroudBNC loader
  Loading shroudBNC from /home/user/sbnc/sbnc-20051215034250.so
  Thu Dec 15 03:43:11 2005 Log system initialized.
  shroudBNC1.0 $Revision: 370 $ - an object-oriented IRC bouncer
  Thu Dec 15 03:43:11 2005 Created main listener.
  Thu Dec 15 03:43:11 2005 Starting main loop.
  Daemonizing... DONE
  user@server:~/sbnc$

Verbinden Sie sich einfach mit einem beliebigen IRC Client mit ihrem Bouncer. Sie müssen ihren Benutzernamen (in den meisten Fällen über die E-Mail-Adresse) auf ihren gewählten Bouncer-Benutzernamen einstellen.

Nachdem Sie verbunden sind sollten sie ”/sbnc help” eingeben um eine Liste der verfügbaren Befehle zu erhalten.

Wenn Sie das TCL Modul compiliert haben, können Sie es mit ”/sbnc insmod ./tickle.so” laden.

Eine Liste der geladenen Module können sie mit ”/sbnc lsmod” einsehen, mit ”/sbnc rmmod <Modul-ID>” können sie Module entfernen.

shroudBNC unterstützt oidentd um eigene Idents für jeden Benutzer zur Verfügung zu stellen. Sie werden Ident-Spoofing für den UNIX-Account unter dem shroudBNC läuft aktivieren müssen. Lesen sie die oidentd-Anleitung für weite Details und schauen Sie sich unsere [.::oidentd|Anleitung] an.

shroudBNC kann während der Laufzeit upgedatet werden – ohne eine bestehende IRC oder Client Verbindung zu verlieren. Um shroudBNC upzudaten müssen Sie shroudBNC in ein sauberes Verzeichnis entpacken, genau wie bei der Installation.

Nach dem compilieren können Sie das “make update” Script anstelle des “make install” Scripts verwenden, welches automatisch den im Moment laufenden shroudBNC updaten wird (Das Script setzt voraus das das Bouncer-Verzeichnis ~/sbnc/ ist).

Bitte beachten Sie das Sie möglicherweise diverse Module wie z.B. tickle.so entladen bevor sie ein Update durchführen. Die ältere Version des Modus könnte nicht kompatibel mit Ihrer neuen sBNC Version sein.

Es ist unumgänglich das Sie verstehen das jeder Bouncer-Administrator auf folgende Dinge Zugriff hat:

• Den Shell-Account auf dem der Bouncer läuft.
• Jede Benutzerverbindung.

Durch die Verwendung des TCL Moduls kann jeder Administrator Shell-Befehle ausführen (durch die Benutzung des “exec” Befehls) und IRC Befehle über jede Benutzerverbindung ausführen. Sie sollten ihre Administratoren mit bedacht wählen. Laden Sie keine unbekannten Scripte und stellen Sie sicher das Sie verstehen was die Scripte bewirken die Sie laden.

Jemandem Shell-Zugang zu gewähren dem Sie nicht vertrauen ist eine potenzielle Gefahrenquelle.