retronetworking
/
u-isdn
13
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
u-isdn/DOKU

1877 lines
76 KiB
Plaintext
Raw Permalink Blame History

Update 2022-02-17
=================
Fast 27 Jahre später.
Offenbar habe ich inzwischen wenigstens gelernt, meinen
Code bessser zu dokumentieren.
Ich stelle dieses Werk hiermit, soweit möglich, unter die GPLv2 oder
später.
"Soweit möglich" ist ernst zu nehmen. Insbesondere die Herkunft des
"streams"-Verzeichnis ist … äh … sagen wir mal so: wer sich mit der
Historie von Unix auskennt, weiß, wieso das ein Problem war.
Angesichts des Alters des Codes (der mit modernen Compilern schlicht
unverwendbar ist und mit aktuellen Linuxversionen noch viel weniger
zusammenarbeitet als damals) und der Tatsache, dass es den Inhaber des
besagten Copyrights nicht mehr gibt (mehr oder weniger), dürfte es
ausreichend unwahrscheinlich sein, dass sich irgendjemand jetzt noch
darüber aufregt.
Wenn jemand den "Brad K. Clements" kennt, der 1990 den Code geschrieben
hat, der in isdn/str_if/str_in.c gelandet ist … dann würde ich ihn gerne
fragen, ob er das "all rights reserved" immer noch ernst meint.
Ein FAQ von Harald Milz zu diesem Code ist auf
https://ftp.heise.de/ix/Historisches/Linux/docs/U-ISDN-FAQ.ps.gz
verfügbar und unter diesem Namen mit im Archiv.
Alter Krempelkram folgt
=======================
DOKU zum ISDN-Paket. R 8. // TEXT ohne Tabs //
Basiert auf Linuxkernel 2.0.8.
Dies ist eine Betaversion.
Dieses Programmpaket ist (c) 1994-1997 Matthias Urlichs <urlichs@noris.de>.
Es darf ohne meine Zustimmung _nicht_ weitergegeben werden. Kommerzielle
Verwertung jedweder Art bedarf meiner Zustimmung. Das Anbieten auf
FTP-Servern, in Mailboxen, etc.pp. ist ohne meine Zustimmung nicht
gestattet.
Obige Parameter gelten für diese Betaversion. Die Vollversion wird
unter der GPL bzw. ihrem deutschen Äquivalent verfügbar sein.
Wenn ich Fehler suchen soll:
---------------------------
- Support kaufen. (Kann man natürlich auch ohne Probleme machen :-)
- DOKU LESEN. Wenn nicht verstanden, nochmal lesen. Wenn immer noch nicht
verstanden, Verständnisfrage stellen anstatt rumzubasteln und mich mit
dem Resultat der Bastelei zu beglücken. :-/
- Wenn beim Verbindungsaufbau was nicht funktioniert:
Master mit -wdmM starten, cu und AT/L starten, zugucken was passiert,
Konfigdatei + Master-stderr + AT/L-Output mir schicken.
Achtung:
=======
Es gibt eine Mailingliste zum Thema: linux-isdn@uranus.central.de.
"Bitte trag mich ein"-Requests bitte _nicht_ dorthin, sondern an
linux-isdn-request@uranus.central.de.
Änderungen Version 45
---------------------
Die ISDN-Modulliste steht jetzt nicht mehr in /lib/modules/modules.isdn
oder so, sondern wird mit MOD-Zeilen in die /etc/isdn.conf-Datei geschrieben.
Umsetzung (so ähnlich):
# sed -e 's/isdn./MOD /' < /lib/modules/modules.isdn >> /etc/isdn.conf
Die volle Liste findet sich in modules.isdn (im Hauptverzeichnis der
Sourcen, nach dem Installieren), nicht in /lib/modules/modules.isdn.all.
rc.isdnmon schreibt nach /var/log/acct/ip.isdn.
Geldmangel
==========
Die Entwicklung so eines Treibers kostet Zeit. Zeit ist Geld. :-(
Wer sich an den Entwicklungskosten des Treibers beteiligen will:
Konto 2040206135, Hypo-Bank Nürnberg (BLZ 760 202 14). Für den überwiesenen
Betrag kann ich eine Rechnung schreiben, wenn nötig inkl. Märchen...äh,
Mehrwertsteuer.
Bekannte Fehler
===============
Die Konfigurationsdatei ist manchmal etwas undurchsichtig.
_Ich_ werde das nicht ändern, keine Zeit; wenn jemand ein Frontend
schreiben will -- nur zu!
Die Doku liegt nur auf deutsch vor.
Bei manchen Leuten hängt sich der Treiber bzw. der ganze Rechner bei
ankommenden (Voice-)anrufen kommentarlos auf. Ich konnte das leider bisher
nicht nachvollziehen...
Fragen? Probleme? (Gleich am Anfang, damit es keiner übersieht...)
=================
Bitte per Mail, und zwar an isdn-problem@smurf.noris.de.
Wenn ohne Internetanschluß: Bitte per Fax, an 0911/59818-11.
Telefonanrufe bekomme ich ziemlich ungern, weil sehr zeitaufwendig.
Vollständige Konfigdatei und genaues Protokoll dessen, was man gemacht hat,
was im Syslog oder auf der Konsole ausgegeben wurde, etc.pp., mitschicken.
Probleme mit der Doku? DIES IST noch KEINE ENDVERSION. Also bitte selber
nachdenken, in den Sourcen wühlen, rausfinden wo es hakt, und mir entweder
genauere Fragen stellen oder einen Lösungsvorschlag, zB ergänzte Doku,
schicken. Oder mich daür bezahlen, daß ich den Kram supporte -- das ist
nämlich der eigentliche Grund, weshalb der Treiber nicht schon vor einem
halben Jahr fertig wurde... Näheres zu meinem Supportangebot für Linux via
Mail -> info@smurf.noris.de.
Bei Systemcrashs und ähnlichen Widrigkeiten: Problem reproduzieren;
Konfiguration, genaue Infos was wann wie, Fehlermeldungen in eine Mail
verpacken und mir schicken.
Support
=======
Support gibt es bei mir zu kaufen. Nähere Informationen und Preise -> Mail.
Einen Treiberupdate gibts fuer DM 30 plus Medium. Fuer kommerzielle Kunden
gibts dasselbe fuer DM 250, Erstsupport bis zur erfolgreichen Installation
inbegriffen. Dieses Angebot gilt nicht für Leute, die mich jeden Tag
dreimal nerven; für die kostet der Support DM 400 pro Monat. (Jawohl, ich
habe solche Kunden...) Support für Nebenstellenanlagen, die sich nicht an
Wortlaut oder Sinn der Normen halten, wird gesondert berechnet.
Fuer Privatleute etc. gibt es den Erstsupport für DM 150, ansonsten
kostenlos via linux-isdn-request@uranus.central.de. Die Newsgroups
de.comm.isdn und de.comp.os.linux lese ich momentan wegen Zeitmangel nicht,
sorry.
Systemvoraussetzungen
=====================
Linux. GCC 2.7.2, Libraries 5.0.9, oder neuere (Testumgebung: Libraries
5.4.1).
Passive ISDN-Karte mit Hardware-Doku, oder Teles-8 oder -16 / Creatix.
Support fuer BSC- und AVM A1-Karten ist in Vorbereitung, Source liegt bei,
funktioniert aber noch nicht so ganz (BSC: B-Kanäle; beide: Interrupts?) --
wer kann und will, möge sich dransetzen.
Support für Teles S0/16.3 und Creatix PNP ist seit neuesten auch dabei;
Dank an Peter Brückner.
Kernelpatches
=============
Die Patches basieren auf dem Kernel 1.2.11.
Frühere bzw. spätere Kernels auf eigene Gefahr bzw. Bastelei.
Insbesondere sollten die Leute, die meckern, weil sie den Kram nicht unter
1.3.xx zum Laufen bekommen, sich ernsthaft fragen, wieso sie einen Kernel
einsetzen, der ausdrücklich für Leute gedacht ist, die selber nach Bugs
suchen können.
Was die einzelnen Patches machen und ob sie benötigt werden,
steht in den einzelnen Dateien am Anfang. Lesen, bevor der Kernel verändert
wird!
Der Kernel sollte mit CONFIG_MODVERSIONS gebaut werden; das ist zwar nicht
unbedingt notwendig, aber sinnvoll.
Das modutils-1.2.8-Paket wird in jedem Fall benötigt, um Parameter an die
einzelnen Module zu übergeben.
Sonstiges
---------
In /etc/syslog.conf steht meistens sowas wie
*.=debug ....
Das ist Unsinn. Ersetzen durch
*.debug ....
sonst debuggt er nur die Haelfte.
Der syslogd macht fsync() oder sync() nach dem Schreiben jeder Zeile.
Das ist ebenfalls Unsinn. Sourcen holen, den [f]sync()-Aufruf rauswerfen.
Leute mit 1.3.xx-Kernel brauchen neueste Netprogramme; insbesondere ein route,
das "del ... netmask" versteht.
Grundstruktur
=============
Das Modul "compat" stellt ein paar Funktionen zur Verfügung, wie sie aus
anderen Unixkernelumgebungen bekannt sind.
"streams" implementiert minimale Streamsunterstützung. Wegen der
tty-Verwaltung unter Linux gibt es keinen clone-Treiber (die ist nicht
darauf ausgelegt).
Der ISDN-Treiber "isdn_2" ist die Low-Level-Schnittstelle zwischen den
ISDN-Karten und dem Steuerprogramm (bin/master). Dieses öffnet /dev/isdnmon,
liest eine Konfigdatei (siehe unten) etc. Der Treiber meldet dem
Steuerprogramm, welche Karten sich bei ihm angemeldet haben.
Es gibt _keine_ Devices für einzelne Karten.
Der Treiber managt das Q.921-Protokoll für die Karten. Alles andere ist
Sache des Steuerprogramms (D-Kanal) bzw. anderer Streams-Module (B-Kanäle).
Ein kommunikationswilliges Programm öffnet einen freien ISDN-Port
(/dev/isdn/isdnX, X von 1 bis 99 oder so) und sendet einen Verbindungs-
wunsch an das Steuerprogramm ("atd/subnet/login", öffnen einer Verbindung
zum System "subnet" im Protokollmodus "login"). Das Steuerprogramm schiebt
diesem Kanal nun automatisch die notwendigen B-Kanal-Module unter (X.75,
T.70, V.110, was-auch-immer), baut die Verbindung auf, meldet den Zustand
der Verbindung ("RRING", "CONNECT") und verbindet schließlich B-Kanal und
Programm. Es erscheint das login:-Prompt des Systems "subnet".
Umgekehrt wird das Steuerprogframm bei einem ankommenden Anruf selbst einen
freien Port öffnen und das zuständige Programm auf diesem Port starten.
Dasselbe passiert bei abgehenden Anrufen, die auf das zuständige Programm
beschränkt sind, zB TCP/IP.
Beispiel:
% cu -l isdn/isdn22
beliebig, muß nur frei sein.
AT
OK
Der Interpreter im Kontrollprogramm tut so, als wäre er ein Modem mit
Hayes-Befehlssatz, und schickt ein OK zurück.
Hinweis: Das Ding ist minimal und kann nichtmal ATEx oder ATVx.
ATD/subnet/login
[ Virtuelles Rappeln einer Wählscheibe ]
RRING
CONNECT
login:
Die Verbindung steht. Viel Spaß beim Hacken eines Paßworts. ;-)
BETA-BEMERKUNG: Loginverbindungen sind in der jetztigen Version nicht allzu
gut getestet. Was sehr gut tut, ist TCP/IP; siehe dazu die Beispielkonfi-
guration. Ein Anrufbeantworter existiert ebenfalls (leider noch ohne
DMTF-Erkennung).
Statt ATD/name funktioniert auch ATDnummer; /login ist der Default für das
Protokoll.
Installation
============
### Wer noch nie einen eigenen Kernel gebaut hat, lese zunächst
### das entsprechende HOWTO-Dokument.
#
cd /usr/src
tar xfvz /wo/auch/immer/isdn-xx.tar.gz
cd isdn-xx
cd patches
for i in biglog more_free setnoswap firewall ; do
patch -p0 -d /usr/src/linux < $i
done
# Andere Patche in diesem Verzeichnis ansehen, evtl. ebenfalls installieren.
# Vorsicht, die Patches beruhen auf Linux 1.2.11.
#
# Kernel installieren und booten.
# (alten Kernel unbedingt zu Backupzwecken erhalten!)
# Danach:
make.isdn
# Wenn er nun über config.new und config.data meckert:
# Siehe unten Probleme.
# mv config/config.new config/config.data ## nicht "cp" !!
# vi config/config.data
# # Insbesondere: Zeilen "PROTOCOLS" und "SUBPROTOCOLS" ansehen.
# # Siehe unten "DL-Zeile".
# Danach: Nochmal make.isdn starten.
#
# Nun als Superuser:
make.isdn
# oder einfach "make install".
eintragen. Näheres siehe "Treiberparameter" weiter unten.
cd /usr/local/isdn/bin-Kernelversion # also zB .../bin-1.3.29
vi /etc/isdn.conf # ISDN-Nummern, Dienste, etc. eintragen
# MOD-Zeilen anpassen Insbesondere
MOD teles -o Tel0 name=$(cardname Tel0) mem=0xD6000 irq=5 ipl=1
anstatt
MOD teles
(zum Beispiel)
/etc/rc.d/rc.isdn # geht automatisch in den Hintergrund
### oder
/sbin/init.d/uisdn start
### .. je nach installierter Distribution
# Wenn das alles funktioniert, rc.isdn via rc.local starten.
Sämtliche Gerätedateien werden automatisch angelegt; die Zuordnung zu
Gerätenummern erfolgt dynamisch.
Probleme bei der Installation
--------
Als allererstes: Der obige Hinweis re Kernel installieren sollte ernst
genommen werden. Grund: Jeder modularisierte Treiber _braucht_ Zugriff auf
die korrekt konfigurierten Sourcen genau des Kernels, unter dem er später
laufen soll. Dies gilt ganz besonders, wenn der Kernel mit
CONFIG_MODVERSIONS gebaut wurde (das ist um einiges sicherer!).
Wenn sich die Module nicht laden lassen, weil insmod Sachen wie "kfree"
nicht findet, dann liegt das daran, daß die Version der Sourcen des
Kernels, des laufenden Kernels, und der ISDN-Treiber, nicht übereinstimmt.
Also: cd /wo/auch/immer/ist/src/linux; make config; make dep; make;
make modules; make modules_install; cp arch/i386/boot/zImage /boot/linux\
.versionsnummer; vi /etc/lilo.conf; lilo; reboot.
Disclaimer: So mache ich das.
config.new und config.dist und config.data. Das Problem ist, daß ich an der
config.data gelegentlich was ändern muß, aber der Benutzer daran auch
rumspielt (dazu ist die Datei da). Was tun?
Einfach: Mit den Parametern der alten config.data wird die neue config.dist
"geladen", und das Ergebnis liegt nun in config.new. Dasselbe passiert,
wenn es noch keine config.data gibt. In beiden Fällen tut man gut daran,
sich die Datei config.new näher anzusehen, evtl. mit der alten config.data
zu vergleichen, und dann "mv config.new config.data". Sicherheitshalber
weigert sich das Makefile in config/, ohne diesen Schritt weiterzuarbeiten.
Autoconfig und wieso nicht: Nein, ich weigere mich (momentan), automatisch
nach Karten, deren Interrupts, deren Konfigurationsregister etc.pp. zu
suchen. Bei einem laufenden Kernel ist das alles andere als einfach!
Stattdessen müssen die entsprechenden Daten in /etc/isdn.conf eingetragen
werden. Wenn irgendwas nicht stimmt, wird im allgemeinen die Karte nicht
erkannt und das Treibermodul nicht geladen.
Ausnahme: IRQs, die werden momentan nicht überprüft. Das kann man manuell
machen: nach der installation der Treiber beim ISDN-Anschluß der Karte
anrufen. Dann "cat /proc/interrupts". Wenn neben dem Wort ISDN eine Zahl
kleiner drei steht, stimmt was nicht -- anderen Interrupt probieren,
BIOS-Konfiguration überprüfen: auch korrekt eingestellte Interrupts können
Probleme machen, wenn zB das BIOS eines PCI-Rechners den Interrupt zu einem
PCI- anstatt zu einem ISA-Slot routet. (Evtl müssen da trotz BIOS-
Konfiguration noch Jumper auf dem Mainboard umgesetzt werden. Doku des
Teils lesen!)
Treiberparameter:
-----------------
Die Treiber für einzelne Karten werden wie folgt geladen:
- Zunächst wird ein generischer Treiber installiert (d_XXX.o).
- Dann wird pro Interface ein Modul (XXX.o) geladen, das diesem Treiber
genau eine Karte nennt, die er erkennen soll. Karte nicht erkannt ->
Laden schlägt fehl.
Alle Treiber verstehen:
- name=XXXX
XXXX ist eine Zahl. Die Zahl wird durch Aufruf des Programms "cardname"
aus dem 'eigentlichen' Namen der Karte gewonnen; ich wollte mich nicht
darauf verlassen, daß insmod korrekt Strings in den Treiber einbaut.
Treiber mit Adressen im Speicher verstehen;
- mem=0xZZZZZ
Lage der Karte im Hauptspeicher.
Treiber mit I/O-Adreßbereich verstehen;
- io=0xZZZ
Lage der Karte im I/O-Adreßbereich.
Treiber für Karten mit Interrupt verstehen:
- irq=XX
Interrupt der Karte.
Treiber für softkonfigurierbare Karten verstehen:
- ipl=X
Für softwarekonfigurierte Karten: Verwende die Xte Karte.
Beispiel: insmod d_teles.o
insmod teles.o -o Tel0 name=$(cardname Tel0) mem=0xD8000 irq=5
Zum Entfernen des Treibers:
rmmod Tel0 ; rmmod d_teles.o
Alle Kartentreiber können vor oder nach Start des Masterprogramms geladen
oder wieder entfernt werden. Aktive Verbindungen werden (unsauber)
abgebrochen.
Testen:
-------
% cu -l isdn/isdn59
AT/L
sollte die konfigurierten TCP-Verbindungen auflisten.
AT-Befehle
==========
Alle Schlüsselbuchstaben können groß oder klein geschrieben werden.
Das "AT" muß entweder vollständig groß oder vollständig klein
geschrieben werden. Zeichen vor dem "AT" werden ignoriert.
AT/Bn
Schaltet Verbindung <n> von "off" auf "down" um. Siehe AT/L.
AT/K
Beendet alle laufenden Verbindungen.
Kann nur vom Superuser ausgeführt werden.
AT/Kn
Beendet die Verbindung <n>, beendet das betreffende Programm.
AT/L Karte
Listet den momentanen Status aller Verbindungen für die angegebene
Karte (kann weggelassen werden: alle Karten).
<[minor:]id> <Art> <Partner> <Key> <pid> <Modus/Karte> <UnitNow> <UnitAll> <Status>
<minor> Nummer der Verbindung, für AT/K o.ä.
<n> interne Folgenummer der Statusmeldung; Meldungen, die einen
alten Status ersetzen, bekommen dieselbe Nummer.
<pid> PID des Prozesses, der für die Verbindung gestartet wurde.
<Modus>
off Verbindung nicht aktiv, wird bei ankommendem Ruf reaktiviert.
down Standby; sobald ein Datenpaket ansteht, wird die Verbindung
aufgebaut.
up Verbindung steht
->down
->up Verbindung wird gerade ab- bzw. aufgebaut.
Zusätzlich kann hinter <Modus> erscheinen:
.N Nter Anwahlversuch
-N ... nachdem N Serien fehlgeschlagen sind.
<UnitNow> Einheiten in der aktuellen Verbindung.
<UnitAll> Einheiten insgesamt seit Start des Prozesses.
<Flags> interner Zustand der Verbindung, komma remote-Nummer,
strichpunkt lokale-Nummer (jeweils wenn bekannt/vorhanden).
Interner Zustand:
:in Ruf ankommend
:ou Ruf abgehend
:dP virtuelle Verbindung
:dL Festverbindung
:dM Dialup, mehrfachaktiv
:dD Dialup, nur einmal aktiv
:is Verbindung ist unterbrechbar
:nc entfernte Nummer ist vollständig
:lc lokale Nummer ist vollständig
:oc Info für abgehende Verbindung ist vollständig
:si Verbindung ist neu gestartet
:sl Verbindung wird wieder aufgebaut
:nj, :xi, :yi, :bi, :il, :fX, :fr, :ib
siehe P-Zeile.
Der interne Zustand existiert in permanenter (bleibt mehr
doer weniger konstant) und in transienter (wird pro
Verbindungsaufbau neu generiert) Form. Der permanente Teil
wird zuerst ausgegeben, danach folgt entweder ein /
(der transiente Teil fängt bei Null an) oder ein ^ (der
zweite Teil übernimmt die vorher angegebenen Flags;
nochmals aufgeführte Flags werden wieder gelöscht).
<Status> Text; Meldung der Vermittlung (Groß/Kleinschreibung) oder
interner Zustand (Großschreibung).
Ein Ausrufezeichen an erster Stelle bedeutet, daß die Verbindung intern
nicht mehr bekannt ist, der Zustand aber noch eine Zeitlang aufgehoben
wird.
Ein Minuszeichen am Anfang meldet die Löschung eines internen
Zustands; das ist für Monitorprogramme interessant, die den aktuellen
Status anzeigen wollen, ohne sich darum zu kümmern, welche Meldungen
sie wie lange anzeigen sollen.
Jede Minute wird außerdem ein Zeitstempel der Form "#xx: hh:mm aa,bb,cc"
ausgegeben. 'xx' ist die Zahl der Minuten, die der Master ununterbrochen
aktiv ist; 'hh' und 'mm' sind die aktuelle Uhrzeit. 'aa' ist die Zahl
der offenen, 'cc' die der geschlossenen Verbindungen; 'bb' zählt die
Verbindungen, die gerade geöffnet oder geschlossen werden, und sollte
(fast) immer Null sein. Diese Angabe gilt für alle Karten, nicht nur
die bei AT/L evtl. angegebene.
Bis zum nächsten AT-Befehl bleibt der Kanal im Monitormodus und meldet
alle Zustandsänderungen automatisch. Außerdem kommt jede Minute eine
"Keepalive"-Zeile mit der aktuellen Uhrzeit sowie der Anzahl der
Minuten, die der Masterprozeß diesmal durchgelaufen ist. ;-)
AT/I
Listet den internen Zustand. In der ersten Zeile stehen die erkannten
ISDN-Karten, die zweite Zeile enthält den internen Zustand des ISDN-
Systems. Zum Debuggen.
AT/W Karte
Beobachtet den Traffic auf den D-Kanälen der angegebenen Karte (kann
ein Pattern sein oder weggelassen werden: AT/W* auf allen Karten). Dazu
muß :de in der DL-Zeile stehen.
Bei aktiven Karten sind das die Protokolldaten, zB CAPI-Nachrichten,
bei passiven Karten die D-Kanal-Informationen.
Die Daten werden _nicht_ interpretiert.
Zusätzlich werden dieselben Daten wie bei AT/L angezeigt.
AT/M foo
Sendet den Systembefehl "foo" nach unten. Gefährlich.
Kann zum Online-Rekonfigurieren von Modulen verwendet werden. Beispiel:
AT/M pr :mi 2 ::ms :ms timer :tr 30 :tw 30 :ti 10
würde auf Verbindung 2 den automatischen Verbindungsabbau dazu überreden,
alle 10 Sekunden nachzusehen, ob in den letzten 30 Sekunden keine Daten
übertragen wurden, und die Verbindung gegebenenfalls beenden.
AT/Q
Programmende. Kann nur vom Superuser ausgeführt werden.
AT/Sn
Sendet ein "Status schicken"-Kommando an die bezeichnete Verbindung.
Der Status wird an alle AT/L- oder AT/W-Monitore gesendet.
AT/S
Dasselbe wie AT/L, nur wird der aktuelle Zustand vorab _nicht_
ausgespuckt.
AT/R
Reload der Konfigdatei. Kann nur vom Superuser ausgeführt werden.
Alle wegen eines Fehlers deaktivierten Programme werden wieder aufgeweckt.
AT/Xn
Abbruch der Verbindung <n>. Kann nur vom Superuser ausgeführt werden.
ATD/sys/proto
Sucht Nummer und Protokoll in der Konfigdatei, wählt, macht Verbindung auf.
ATH
trennt die Verbindung.
<BREAK>
wechselt vom Online- in den Befehlsmodus, falls erlaubt. Der Interpreter
antwortet mit OK.
(zum Verbieten: entsprechenden Konfigurationsbefehl für das PROTO-Modul
verwenden.)
"+++" zum Wechseln funktioniert _nicht_.
Diverse andere Befehle sind 100% ungetestet. <BREAK> habe ich seit Ewigkeiten
nicht mehr ausprobiert.
ATA existiert nicht; stattdessen Konfigdatei ändern.
Einschub: Was ist dieser Streams-Kram eigentlich?
======== Was ist auf dem B-Kanal los, daß man sowas braucht?
Nimm an, du willst TCP/IP-Pakete verschicken. Du packst also jedes dieser
Pakete in einen Datenblock und schickst sie auf die Reise ... halt, so einfach
geht das nicht. Normalerweise wird auf dem B-Kanal sowas wie eine gesicherte
Verbindung gefahren. (Man kann sich streiten, ob das bei IP-Paketen, die
eigentlich sowieso beliebig verlorengehen dürfen, Sinn macht.) Außerdem können
manche ISDN-Implementierungen nur ziemlich kleine Pakete verarbeiten; um
zu vermeiden, daß die IP-Pakete fragmentiert werden (Overhead: ca. 20 Bytes
pro Fragment) oder von der Gegenseite weggeschmissen werden (Overhead:
unendlich ;-) , muß man sie so kennzeichnen, daß die Gegenseite sie direkt
wieder zusammensetzen kann (Overhead: 2 Bytes; braucht aber besagte gesicherte
Verbindung, um vernünftig zu funktionieren). BTX beispielsweise arbeitet
so. Außerdem ist ISDN bytesynchrton, d.h. irgendjemand muß kennzeichnen, wo
ein Datenpaket aufhört und wo/wann das nächste anfängt. Dafür gibt es, wie
üblich, mehrere Methoden...
Streams sind nun eine Möglichkeit, mehrere speziell geschriebene Module
auf einem ebenfalls speziell geschriebenen Treiber so zu stapeln, daß jedes
Modul eine Einzelaufgabe dieser Arbeit erledigt. Im Idealfall sind die
einzelnen Module recht klein und damit debugbar, lassen sich vielseitig
zusammenstöpseln, etc.pp. In der Praxis ist die Sache natürlich nicht ganz
so einfach; insbesondere ist der Overhead, die Pakete von einem Modul zum
nächsten zu schaufeln, nicht zu vernachlässigen. Er ist aber tolerierbar,
vor allem wenn man auf die ganzen überflüssigen "Features" (von manchen
Menschen als "Bugs" oder "Designfehler" bezeichnet...) verzichtet, die
USL und Co. in Sys5 Release 4 dazuerfunden haben.
Die einzelnen Module müssen parametrisiert werden. Im Normalfall spricht
man sich mit der Gegenseite vorher ab, ob beispielsweise X.75 verwendet
wird und in welchem Modus. Alternativ, und wenn man die Normen auswendig
weiß, schaltet man ein Monitor-Modul zuunterst auf den Datenstrom, läßt
sich von der Gegenseite anrufen, beobachtet genau was da passiert, und
richtet die Konfiguration entsprechend ein. (Das klingt nicht nur
kompliziert, das ist es auch. Außerdem gibt es ein paar Details, die sich
nicht ohne weiteres beobachten lassen.) Zum Glück haben sich ein paar
"normale" Betriebsarten herauskristallisiert, an die sich die meisten
Systeme halten.
Paketformate
------------
Im einfachsten Fall werden IP-Pakete direkt auf die Leitung geschickt. Wer
zusätzlich noch Appletalk oder IPX oder so machen will, kann diese entweder
in IP einpacken (Overhead, kein Kernelsupport unter Linux) oder ein paar
Bytes vor die Daten stellen, die angeben, um was für Daten es sich handelt.
Die Bytes können entweder genauso aussehen wie im Ethernet, oder so wie der
Pakettyp von PPP. Wer PPP macht, braucht offensichtlich letzteres (PPP
selber wird auch bald kommen...); normale Leute nehmen die Ethernet-Codes.
Noch ein Einschub: TCP-IP-Routing
=================================
So ein TCP/IP-Draht über ISDN mag ja ganz nett sein, aber irgendwie müssen
andere wissen, wie sie vom lokalen Netz zum IP-Rechner zur Gegenstelle
können. Und umgekehrt.
Das ganze Thema ist zu kompliziert, um es hier abzuhandeln. Man lese ein
gutes Buch über den Kram, zB Stevens.
Wichtige Spezialfälle:
- Das Große Internet ist auf der anderen Seite der ISDN-Leitung.
slipto mit -d starten und auf den ganzen anderen Rechnern im lokalen Netz
eine Defaultroute zum ISDN-Rechner eintragen. ACHTUNG! ALLE LOKALEN
RECHNER BRAUCHEN OFFIZIELL ZUGETEILTE IP-NUMMERN. Das Weiterleiten von
Nummernbereichen nach RFC 1597 muß unterbunden werden (wenn diese lokal
verwendet werden: unbedingt IP-Firewall in den Kernel einbauen und
rausfiltern); andere unzulässige Netznummern müssen durch einen zweiten
Gatewayrechner mit zwei Ethernetkarten o.ä. abgeschottet werden.
- Ein System, das eigentlich Teil des lokalen Netzes wäre, sitzt am anderen
Ende der Leitung. Am einfachsten ist hier Proxy-ARP; der benötigte Befehl
beim Booten lautet "arp -s IP_der_entfernten_Kiste Ether_des_ISDN_-
_Rechners pub". Die Ethernetadresse spuckt "ifconfig eth0" aus.
diplogin (für IP über serielle Leitung) kann den arp-Eintrag automatisch
setzen. Wenn jemand entsprechende Patches für slipto macht -> her zu mir.
- Ein Netz mit stupidem ISDN-Router, der ein Transfernetz sehen will, ist
auf der anderen Seite. Einfachste Methode: Vom lokalen Netzbereich wird
ein 4-Adressen-Bereich abgezwackt und als Transfernetz mißbraucht. Sei
die lokale Adresse 129.130.131.x, so wird zum Beispiel der Bereich x =
[224..227] verwendet (die beiden untersten Bits des unteren Endes des
Adressbereichs, hier 224, müssen(!!!) 00 sein). Die nächste Adresse
(hier: 225) wird die lokale Adresse (entweder als lokale Adresse im
slipto, oder via dummy-Interface: "ifconfig dummy0 129.130.131.225; route
add -host 129.130.131.225 dev lo" -- in der Konfigdatei wird in diesem
Fall die normale Ethernetadresse des Rechners als lokale Adresse
verwendet). Danach (hier; .226) kommt die entfernte Adresse (eintragen
via Proxy-ARP).
Auf der Gegenstelle wird dann das Transfernetz mit einer Netmask von
255.255.255.252 konfiguriert, die ..225 wird dort die entfernte
Adresse und die Defaultroute an der Gegenstelle zeigt darauf.
(Außerdem muß manchmal eine Route für das Netz, hier 129.130.131.0,
eingetragen werden, die auf die Gegenseite, hier .225, zeigt.)
Diese Methode verschwendet 75% des Adressbereichs (die Nummern .224,
.225 und .227 werden im Internet nie in Erscheinung treten) und einer der
Rechner auf der Gegenseite verwendet dummerweise eine Nummer aus dem
lokalen Netz, für die ein funktionierender Nameserver-Eintrag gepflegt
werden muß, hat aber den Vorteil, daß sie funktioniert.
Es fällt außerdem auf, daß die lokale Adresse und Konfiguration des
ISDN-Links nichts mit dem zu tun haben muß, was die Gegenseite von uns
denkt. Das ist auch total egal -- im Gegensatz zu PPP werden die Adressen
nicht mit der Gegenstelle abgeglichen. Das einzige, auf das es ankommt,
ist, daß die jeweils lokalen Adressen auch als lokal angesehen werden und
_nicht_ irgendwie wieder zur Gegenseite geroutet werden. Pingpongpakete
haben auf einer ISDN-Leitung nichts verloren! (Und auch nirgends anders.)
Es fällt außerdem auf, daß ich nichts von routed und ähnlichen Programmen
gesagt habe. Das ist Absicht. Konfiguriert eure Routen lieber statisch,
das ist gesünder...
Die Konfigurationsdatei
=======================
Die Datei besteht aus verschiedenen Zeilentypen, die frei gemischt werden
können. Der erste auf ein Problem passende Eintrag wird verwendet; auf eine
passende Zeile folgende solche werden bei manchen Zeilentypen ebenfalls
ausgewertet.
Strings in spitzen Klammern sind Platzhalter. Ein Doppelpunkt mit zwei
folgenden Buchstaben ist ein Parameter, dem eine vom Parameter abhängige
Anzahl Werte folgen kann.
Vorgehensweise des Masterprogramms beim Aufbau einer Verbindung:
--------------
Das Zielsystem wird ausgewählt (D- und P-Zeile: ankommende Verbindung;
R-Zeile, bei Programmstart).
Das in der R-Zeile angegebene Programm wird gestartet.
Die in der ML-Zeile angegebenen Module werden zwischen den ISDN-Treiber und
das Programm geschoben.
Die Module werden mit Parametern (in MP-Zeilen angegeben) versorgt.
Eine freie Karte (Liste der installierten Karten, DL-Zeile, CL-Zeile) wird
gesucht.
Eine Nummer des Zielsystems wird gewählt (D- und P-Zeile: abgehende
Verbindung).
Ein freier B-Kanal (welcher, sagt uns die Vermittlung) wird der Verbindung
zugeordnet.
Die Module (und optional das Programm, via Signal) werden informiert, daß
die Verbindung steht.
<Datenaustausch>
Zueinander passende Zeilen haben jeweils gleiche oder via Shell-Pattern-
matching zusammenpassende <Art>-, <Partner>- und <Karte>-Felder, in
mindestens einem Zeichen übereinstimmende <Key>-Felder, und zur
aufzubauenden Verbindung passende Zeichen im <Mod>-Feld etc.; siehe die
unten folgenden Detailbeschreibungen.
Nummern und ISDN-Karten werden im Rotationsverfahren durchprobiert; dadurch
werden mehrere lokale und entfernte Nummern gleichberechtigt verwendet.
Alle anderen Zeilen werden von oben nach unten durchsucht; die erste
passende Zeile wird verwendet. (Beim Scannen der P-Zeilen werden Daten aus
passenden Folgezeilen ebenfalls berücksichtigt -- siehe unten.)
Bei Problemen (Ggeenstelle besetzt...) wird bei permanenten Verbindungen
ein paarmal probiert, dann werden anstehende Daten weggeworfen und die
Verbindung eine bestimmte (exponentiell wachsende (ja, das muß sein) Zeit
auf Eis gelegt. Ein ankommender Anruf weckt diese Verbindung
selbstverständlich wieder auf.
Konfigurationsdatei: Details
-------------------
Alle Zeilentypen:
<Key> ist jeweils ein beliebiger String. Alle für eine Verbindung verwendeten
Zeilen in der Konfigdatei müssen zueinander passende Keys haben, d.h.
mindestens ein Zeichen muß in allen Keys übereinstimmen. "*" paßt zu
allen anderen Zeichen.
Der resultierende String ist also die Schnittmenge aller Zeichen in
den <Key>-Parametern aller verwendeter Konfigurationszeilen.
<Key>-Zeilen mit einem Pluszeichen an erster Stelle werden nur auf
Vorhandensein eines Zeichens geprüft, aber die Menge wird nicht
eingeschränkt. Beispiel:
"ab" "cd" -> leere Menge
"ab" "xay" -> "a"
"ab" "+x" -> leere Menge
"ab" "+bx" -> "ab+bx" (oder "ab+b", aber _nicht_ "ab" oder "b")
"ab" "+bx" "a" -> leere Menge
"ab" "+bx" "+a" -> "ab+bx+a" (oder so ähnlich)
Damit läßt sich sehr flexibel einstellen, wer wann auf welcher
Leitung / Nummer mit welchen Parametern anrufen kann.
<Karte> ist der vierstellige Name der ISDN-Karte, der dieser beim Laden
des Treibers verpaßt wurde; üblich ist eine dreistellike Kennung
des Kartentyps und eine fortlaufende Numerierung.
Ein angefügtes /# gibt an, daß die Zeile nur auf das Interface
Nr. # der Karte angewendet werden kann; mehrere Ziffern sind
möglich (Beispiel: "Bin0/23".)
<Mod> sind einzelne Buchstaben, die der betreffenden Zeile eine Sonder-
behandlung verpassen. Welche, ist jeweils beschrieben.
Die Unterscheidung "mehrere gleichzeitig" oder "nur eine
gleichzeitig" bei Wählverbindungen bezieht sich jeweils auf eine
Art/Partner-Kombination; allgemeinere Einschränkungen werden mit
einer Extra-CL-Zeile realisiert.
<Parameter...> ist eine Folge von einem oder mehr Parameter-Wert-Angaben.
(Manche Parameter haben keine Wertangabe.)
Merke: Zeilen ohne Parameter sind nicht besonders sinnvoll.
P-Zeile ("Protokoll")
-------
Form:
P <Art> <Partner> <Key> <Karte> <Mod> <Parameter...>
Beispiel:
P login * * R :sv 0700 :nr .2 :lr /2
Parameter:
:Ft Bei Festverbindungen angeben. (Erzwingt das Laden des
"Verbindungs"handlers.)
:dI Eine Verbinung dieses Typs soll persistent sein, d.h. zwischen zwei
Verbindungen wird das handhabende Programm nicht unterbrochen.
Ein "reconn"-Streamsmodul (_muß_ in der zu dieser P-Zeile passenden
ML-Zeile auftauchen!) stellt sicher, daß das Programm davon nichts
mitbekommt, außer wenn der Wiederaufbau der Verbindung nicht klappt.
:bc Zu verwendender B-Kanal, 1 oder 2 (oder 30, bei S2M). Nur für Fest-
verbindungen interessant; im normalen ISDN managt die Vermittlung die
B-Kanäle für uns.
:nj Kann der Ruf nicht angenommen werden, wird BUSY statt CallRejected
gesendet.
:xi Wenn ankommende und abgehende Anrufe kollidieren, soll der an-
kommende abgewiesen werden. (Default: Der abgehende Ruf wird
abgebrochen.)
:yi Bei einem ankommeden Ruf wird automatisch ein abgehender gestartet und
der ankommende wird abgewiesen (Callback). Das Flag :kl in der DL-Zeile
ist manchmal notwendig, Symptom: der abgehende Ruf wird kurz nach
dem Aufbau der Verbindung abgebrochen (beobachten mit AT/W).
:bi Bei einem ankommenden Ruf, der nicht angenommen werden kann (belegt?),
wird automatisch auf einer anderen Leitung zurückgerufen.
:fr ebenfalls zu setzen ist meist sinnvoll.
:il Die CL-Zeile wird ignoriert.
:fX Ankommende Anrufe, die (zB wegen besetzt) abgewiesen werden, werden
"schnell" abgelehnt. (Andere Geräte am Bus können nicht abheben, da die
Vermittlung nicht abwartet, ob sich noch jemand meldet.)
Dieses Flag ist bei aktivem Callback meistens notwendig, wenn der
andere B-Kanal anderweitig beschäftig ist, weil die Vermittlung den
ankommenden Ruf noch hält und den abgehenden wegen Kanalmangel abweist.
:-(
:fr Abgehende Anrufe, die nicht durchkommen, werden "sofort" und "oft"
wiederholt.
:ib Wenn ankommend kein B-Kanal mitgeliefert wird, wird die Verbindung
abgewiesen. (zB wenn man dich den Anschluß mit einem anderen gerät
teilt.) Fehlt :ib, hört die Gegenseite in diesem Fall ein normales
Rufzeichen ("Anklopfen"); die Verbindung wird nach 40 Sekunden
ausgelöst, wenn bis dahin kein B-Kanal frei wird..
Logischerweise darf :xi oder :yi nicht auf beiden Seiten angegeben
sein..!
Spezifisch für 1TR6 und CAPI:
:sv Dienstkennung; zwei Bytes in Hex. Telefon ist 0101 und 0102; DFÜ ist
07xx (xx ist üblicherweise 00).
:pv Semipermanente Verbindung bei abgehenden Rufen.
Ankommend werden SPVs automatisch unterstützt.
Spezifisch für Euro-ISDN:
:vB Bearer Capability. Hexstring, evtl. mit Maske.
:vL Lower Layer Compatibility. Hexstring, evtl. mit Maske.
:vU Upper Layer Compatibility. Hexstring, evtl. mit Maske.
Was diese Dinger bedeuten, steht in der Norm Q.931.
Die wichtigsten Codes für :vB stehen am Ende dieser Anleitung.
Spezifisch für die Bearbeitung von Telefonnummern:
:nr Entfernte Telefonnummer. Siehe unten unter Telefonnummernverarbeitung.
:lr Lokal angewählte Telefonnummer, bzw. deren variabler Teil.
Metaparameter:
:om Die folgenden Nummernteile sind zum Rauswählen bestimmt, d.h. eindeutig.
:im Die folgenden Nummernteile sind zum Einwählen bestimmt, d.h. Muster.
:bm Die Nummernteile werden sowohl ankommend als auch abgehend verwendet
(Default).
:vr Ankommend: bei fehlender externer Nummer wird die Zeile übersprungen.
:vl Dito, fehlende lokale Nummer.
:Vr Ankommend: bei mitgelieferter externer Nummer wird die Zeile übersprungen.
:Vl Dito, mitgelieferte lokale Nummer.
Hierbei gilt: Angegeben werden nur die Nummernteile, die nicht in den
D- bzw. DL-Zeilen stehen. Das System destilliert aus den verschiedenen
Angaben lokale und entfernte Nummern.
Mod:
R Die Zeile wird primär für einen Verbindungsaufbau verwendet.
M Die Zeile wird nur dann analysiert, wenn eine über ihr gefundene P-Zeile
"paßt".
X Wenn diese Zeile (oder eine darüberliegende) "paßt", wird das Scannen
nach weiteren passenden Angaben hier abgebrochen.
i für ankommende Verbindungen
o für abgehende Verbindungen
f für Festverbindungen
d für Wählverbindungen (nur eine gleichzeitig)
m für Wählverbindungen (mehrere gleichzeitig)
p für Verbindungsaufbau nach Bedarf
,# Ein Verbindungsaufbauversuch wird #-mal wiederholt, bevor ein Fehler
gemeldet und Daten weggeworfen werden.
.# Eine Verbindung muß mindestens # Sekunden lang bestehen, sonst wird sie
als Fehler gewertet und erstmal als OFF markiert.
Dasselbe passiert, wenn eine Verbindung nicht vollständig aufgebaut
werden konnte, aber Kosten verursacht hat.
Der Suchalgorithmus findet zunächst eine zur Verbindung passende Zeile mit
R-Flag und hängt an deren Parameterliste alle ebenfalls passenden Zeilen
mit M-Flag an (dabei werden bereits angegebene Werte beibehalten, die
spezifischen Einträge also nach oben!), bis er auf eine Zeile mit X-Flag
trifft.
ML-Zeile ("Modulliste")
--------
Form:
ML <Art> <Partner> <Key> <Karte> <Mod> <Module...>
Beispiel:
ML login * * * - frame x75 t70
Hiermit wird angegeben, wie die Karte eingestellt und welche Streams-Module
für einen B-Kanal verwendet werden müssen, um zwischen diesem und einer
Anwendung zu vermitteln. Die Beschreibung der verfügbaren Module folgt
weiter unten; als erstes "Modul" wird der Modus angegeben, in den der
B-Kanal beim Verbindungsaufbau geschaltet werden soll.
Konzeptuell sind diese Module gestapelt; "unten" ist die Karte, "oben" das
Anwendungsprogramm. Zwischen diesem und dem letzten Modul in der obigen
Liste wird stets ein Spezialmodul namens "proto" eingeschoben, das die
Meldungen zum Verbindungsaufbau etc. so verarbeitet, daß die Anwendung
davon nichts mitbekommt."proto" darf nie in einer ML - Zeile erscheinen.
Mod:
i für ankommende Verbindungen
o für abgehende Verbindungen
f für Festverbindungen
d für Wählverbindungen (nur eine gleichzeitig)
m für Wählverbindungen (mehrere gleichzeitig)
p für Verbindungsaufbau nach Bedarf
,# Verzögerung bei Verbindungsende, in Sekunden, für sauberes
Herunterfahren des B-Kanalprotokolls.
Modi:
trans volltransparente Verbindung. Es wird ständig ein synchroner
64-kBit-Datenstrom übertragen. Wenn nichts gesendet wird,
werden 1-Bits übertragen. (Der Zustand "wenn nichts empfangen
wird" kann nicht vorkommen!)
transalaw wie oben, aber statt Einsen wird 0xAA gesendet ("Ruhepegel" bei
A-Law-Sprachkodierung). Das Senden von Rauschen, wie auf
gemultiplexten Satellitenleitungen, habe ich mir erspart...
transv110 wie oben, aber statt Einsen werden leere V.110-Frames (38.4 kBaud)
gesendet.
frame Standardmodus für Datenübertragung; die Karte interpretiert den
B-Kanal als HDLC-Datenstrom, inkl. 0-Bit-Einschieben nach 5
1-Bits, Prüfsumme, etc.
frame16 16-bit breite Datenübertragung auf entsprechenden
Festverbindungen. Funktioniert nur auf dem ersten B-Kanal
(der Modus greift sich einfach beide Kanäle) und (unter anderem
wegen möglichen Laufzeitunterschieden) nicht bei zwei
Wählverbindungen zur gleichen Zielstation.
/* die folgenden Modi sind noch nicht implementiert, bzw. nicht getestet */
frame0 Wie 'frame', aber zusätzlich wird 1-Bit-Einschieben nach 7 0-Bits
aktiviert. Für Leitungen in manche Ecken der USA, die keine
Nulloktetts auf der Leitung zulassen (weil sie keinen externen
Takt verwenden).
framehi wie 'frame', nur werden nur die oberen 7 Bits verwendet.
framelo ... oder die unteren Bits. Sinnvoll dann, wenn jemand den Daten-
strom auf eine 56-kBaud-Leitung umsetzt.
ppp PPP. Momentan (leider) nur für aktive Karten, die PPP on-board
können.
MP-Zeile ("Modulparameter")
--------
Form:
MP <Art> <Partner> <Key> <Karte> <Mod> <Modul> <Parameter...>
Beispiel:
MP login * * * - proto :bk 0 :sg 0
MP login * * * - x75 :cm 3
Mit dieser Zeile können Module parametrisiert werden, um ihre interne
Arbeitsweise so einzustellen, daß sie korrekt mit der Gegenseite zusammen-
arbeiten. Die möglichen Parameter sind unter den einzelnen Modulen, unten,
beschrieben.
Mod:
i für ankommende Verbindungen
o für abgehende Verbindungen
f für Festverbindungen
d für Wählverbindungen (nur eine gleichzeitig)
m für Wählverbindungen (mehrere gleichzeitig)
p für Verbindungsaufbau nach Bedarf
u für Parameter, die nur beim Programmstart gesetzt werden (x75-Kram zB)
a für Parameter, die bei Neueinlesen der Konfigdaten gesetzt werden
D-Zeile ("Dial")
-------
Form:
D <Art> <Partner> <Key> <Karte> <Mod> <Nr>
Beispiel:
D * subnet * * - +49=721-961252.
D * Any-D * * I +49=*
D * Any * * I +*
D tcp xlink * Tel2 L
Angabe der Telefonnummer, unter der eine Gegenstelle erreichbar ist bzw.
mit der sie sich bei ankommenden Rufen meldet. Festverbindungen haben
natürlich keine Nummer.
Mod:
i für ankommende Verbindungen
o für abgehende Verbindungen
f für Festverbindungen (der zu verwendende B-Kanal steht in der P-Zeile)
d für Wählverbindungen (nur eine gleichzeitig)
m für Wählverbindungen (mehrere gleichzeitig)
p für Verbindungsaufbau nach Bedarf
,# Dies ist eine Backup-Nummer der Priorität #.
Zuerst werden alle Nummern mit Priorität Null (oder ohne Angabe)
probiert, dann die nächsthöhere Priorität, etc.
Der Verbindungsversuchszähler wird nach jedem Prioritätswechsel
zurückgesetzt.
TM-Zeile ("Time")
--------
Form:
TM <Key> <Zeitangabe>
Beispiel:
TM abcde SaSu,Mo-Fr18-08
Schlüssel für Zeiten. Zu der angegebenen Zeit werden nur Verbindungen
zugelassen, deren <Key>-Parameter mit dem angegebenen Key kompatibel ist.
Die gefundenen Schlüsselwerte werden geODERt, d.h.
TM ab Wk
TM cd 08-10
wird, wenn am Montag um neun Uhr aufgerufen, zu "abcd" aufgelöst.
DL-Zeile ("Dial Local")
--------
Form:
DL <Key> <Karte> <Nummer> <Protokolle>
Beispiel:
DL * Tel? +49=911-995962. :pr 0 :sp 65 :pr 63
Eigene Telefonnummer. Im Beispiel sind alle Karten, auf die "Tel?"
paßt, an einer ISDN-Leitung mit dieser Nummer angeschlossen.
Diese Zeile wird verwendet, um die kürzestmögliche Rufnummer für
abgehende Verbindungen zu finden und um die verwendeten Protokolle zu
spezifizieren. Hat eine Karte mehrere Rufnummern (MSNs), werden die
Protokolle nur in der ersten DL-Zeile angegeben.
Zusätzlich werden in der DL-Zeile die Protokolle beschrieben, mit denen der
ISDN-Treiber mit der Karte redet. Diese Protokolle müssen natürlich auch in
den Treiber eingebaut werden, und zwar in der Datei config/config.data,
Eintrag PROTOCOLS (spitze Klammer) und SUBPROTOCOLS (eckige Klammer).
Beispiel 1TR6: <phone tei> [german]
DL * Tel0 +49=911-23456. :pr 0 :sp 65 :pr 63
Beispiel Euro-ISDN: <phone tei> [euro]
DL * Tel0 +49=911-34567. :pr 0 :sp 8 :pr 63
Beispiel Festverbindung: <fixed>
DL * Tel2 - :pr 64
Beispiel intelligente Karte mit CAPI: <capi> [bintec]
DL * Bin0 +49=911-45678. :pr 65 :sp 0
Bedeutung der Spezialzeichen in der Nummer: Siehe "DP" unten.
Protokolle und Flags in der DL-Zeile:
--------------------
Die Reihenfolge ist wichtig.
:pp Punkt-zu-Punkt-Verbindung, feste TEI (0x00).
Vorsicht: Anlagenanschluß wird vom 1TR6-Treiber nicht und vom
Euro-Treiber nur unvollständig unterstützt.
:mp Verbindung am Bus, variabler TEI-Identifier. Bei manchen 1TR6-
Vermittlungen und Nebenstellenanlagen notwendig, in der DSS1-
Norm vorgeschrieben.
:mq Verbindung am Bus, fester TEI-Identifier. Default, weil es an
vielen Anlagen besser funktioniert als :mp.
:mt Verbindung am Bus, feste TEI(0x12). In Spezialfällen notwendig.
:de Debugging, macht D-Kanal-Datenaustausch beobachtbar (mit AT/W).
Vorsicht: Diese Option verlangsamt das gesamte ISDN-System, auch
wenn niemand mit AT/W zusieht.
Die beobachteten Daten sind bei manchen aktiven Karten entweder
verzögert, oder sie können nicht dargestellt werden!
:ud XX Verzögerung zwischen dem Verbindungsaufbau (D-Kanal) und dem
eigentlichen Datenaustausch (B-Kanal). Zehntelsekunden; max.
2 Sekunden; Default 1/4 Sekunde. Mit :ud 0 geht der Verbindungs-
aufbau entweder etwas schneller, oder das erste Paket wird
verschluckt, oder die Vermittlung kommt durcheinander und die
Verbindung ist tot. :-(
:pr 0 Normaler ISDN-D-Kanal, angeschlossen am Netz oder an einer
Telefonanlage. Darf nur zusammen mit TEI-Handler (:pr 63)
verwendet werden. <phone>
:kl Level-2-Verbindung zur Vermittlung nicht trennen. Bei Punkt-
zu-Punkt-Verbindungen und bei entsprechend konfigurierten
ISDN-Anschlüssen ("Dauerüberwachung" oder sowas ähnliches)
notwendig.
:cl Level-2-Verbindung zur Vermittlung trennen, wenn keine
Verbindung besteht. Default.
Entweder :sp 8 oder :sp 65 muß angegeben werden, NICHT beides!
:sp 8 DSS1, Euro-ISDN. [euro]
:b1 an manchen Nebenstellen zur korrekten Nummernerkennung notwendig.
Einschalten, wenn die Nebenstellennummer nicht mit . oder /
eingeleitet wird.
:b2 anscheinend senden manche Idioten (holländische PTT?) die
Gebühreninfo in DISPLAY- Datenblöcken. Grummel hoch drei.
:sp 65 1TR6, deutscher Standard. [german]
:ai Ankommenden Anruf mit dem ISDN-Äquivalent von "RINGING"
beantworten, dann prüfen ob der Anruf angenommen werden kann.
Notwendig bei langsamen Rechnern.
:ad Ankommende Anrufe erst prüfen, dann annehmen (oder auch nicht).
Default.
:pr 63 TEI-Handler (Transport Endpoint Identifier). <tei>
:ti TEI sofort zuordnen lassen. Notwendig bei langsamen / sehr
beschäftigten Rechnern und bei manchen Telefonanlagen.
:td TEI beim ersten Verbindungsaufbau zuordnen lassen. Default.
:pr 64 Festverbindung: kein D-Kanal. <fixed>
:pr 65 Intelligente Karte mit CAPI-1.x-Schnittstelle.
In der Konfiguration verhält sich eine CAPI-Karte ansonsten wie
der 1TR6-Treiber, und zwar AUCH DANN WENN DAS TEIL AM EURO-ISDN
HÄNGT. <capi>
:pb Die Karte hängt an einem Anlagenanschluß / S2M und verhält sich
wie eine Nebenstellenanlage.
:b1 Externe Nummern bei ankommenden Rufen haben eine Vorwahl mit
führender Null _und_ ein voranstehendes =. (U-ISDN versteht
das nicht.)
:sp 0 Bintec-Karte. [bintec]
Auf diese Karte muß zunächst boot.68k und dann entweder bri.68k
oder pmx.68k geladen werden (LF-Zeile).
:sc X Die folgenden Optionen betreffen nur das Xte Interface
auf der Karte. X in 1..4.
:lp X X X CAPI-Bitmasken für EAZ, Service, Infos. Hexadezimal.
Default: 03FF E7BF 003F.
:st XXXXX Protokollstack XXXXX laden. Siehe Handbuch zur Karte.
Default ist u_1tr6_pmp (wenn "german", aber nicht "euro", in
config/config.data angegeben wurde) oder u_dss1_pmp (sonst).
:ea N NNN EAZ N auf lokale Nummer (MSN) NNN mappen.
Default ist die letzte Ziffer der Nummer.
Nicht bei :pb verwenden.
:lw X Warte bis zu X Sekunden auf nachgewählte Ziffern.
Nur bei :pb verwenden.
DP-Zeile ("Dial Prefix")
--------
Form:
DP <Karte> <Präfixe-Dialout> <Präfixe-Dialin>
Beispiel:
DP Tel? +00=0- +00=0-
Definition von Nummernpräfixen, um Vermittlungsbereiche erreichen zu können.
Das erste Präfix ist für abgehende, das zweite (das weggelassen werden kann)
für ankommende Verbindungen; 1TR6-Nebenstellenanlagen wollen beim Wählen
typischerweise eine vorgestellte Null o.ä. sehen, die aber bei ankommenden
Gesprächen nicht mit angezeigt wird. (Ich habe keine Ahnung, wie Gespräche
innerhalb einer Anlage signalisiert werden; zum Glück stirbt 1TR6 langsam
aber sicher aus.)
Die Zeichen sind _immer_ "+" für internationale Verbindungen, "=" für
nationale Verbindungen, "-" für Ortsverbindungen, "." für Nummern an einer
Nebenstellenanlage und "/" für EAZs/MSNs etc. Der Unterschied zwischen "."
und "/" ist, daß Nummern einer Nebenstellenanlage direkt angerufen werden
können, während man für eine Verbindung zu einer anderen MSN am gleichen
Basisanschluß die Teilnehmernummer mitwählen muß. In der DP-Zeile erscheint
folglich niemals ein "/".
Beispiel: Eine Konfiguration
D ... -1234/[456]
DL... -23456
DP... -
MP... :nr /5
würde die Nummer 12345 wählen.
Siehe auch unten unter "Bugs anderer Leute".
R-Zeile ("Run")
-------
Form:
R <Art> <Partner> <Key> <Karte> <Benutzer> <Mod> <Programm> <Argumentliste...>
Beispiel:
R login * * * root IDUST /bin/login
Hiermit wird ein Programm (plus Parameter) angegeben, das bei ankommenden
oder abgehenden Gesprächen aufgerufen wird. Ein Dialout zu einem System
mit "R"-Zeile ist also direkt nicht möglich, da der Datenaustausch zum
betreffenden Programm geht.
Eine R-Zeile wird ignoriert, sobald das betreffende Programm einen Fehler
gemeldet hat (Exitstatus != 0) oder bei der Verbindungssteuerung ein Fehler
aufgetreten ist.
Im Environment dieses Programms werden folgende Variablen abgelegt, wenn
die Parameter bekannt sind:
SITE <Partner>
PROTOCOL <Art>
CLASS <Key>
PHONE Telefonnummer der Gegenstelle, so wie sie ankam bzw. gewählt wurde
LPHONE Lokale Nummer bzw. deren Endteil
DIRECTION "IN" oder "OUT"
DEVICE im Normalfall: /dev/ttyiXX
Mod:
.n Die Antwort wird um n Sekunden verzögert, beispielsweise um einen Anruf-
beantworter nicht sofort abheben zu lassen.
,n Wenn eine automatische Verbindung nicht hergestellt werden konnte, wird
nach n Sekunden der Verbindungsaufbau wieder erlaubt. (Noch nicht
implementiert)
$ Die Befehlszeile wird nicht direkt ausgeführt, sondern der Shell übergeben.
B Die Verbindung wird beim Hochfahren des Managers automatisch aufgebaut.
D /dev/ttyiXX wird angelegt und nach Programmende gelöscht.
E Beim Auftreten eines Fehlers wird dieses Programm deaktiviert.
(Reaktivieren: AT/R.)
F Das Programm wird sofort gestartet, und die Verbindung wird aufgebaut.
Interessant insbesondere bei Festverbindungen und SPVs.
L nur der angegebene Benutzer kann die Verbindung aktivieren.
Q strace(1) wird automatisch auf den neuen Prozeß losgelassen.
R kein Dialout via ATD möglich.
S stderr des Programms liegt auf ISDN (sonst: stderr des Treiberprogramms)
T Verbindung im Terminalmodus (ankommend, also zB beim Start von /bin/login).
U ein Eintrag in /etc/utmp wird angelegt (wichtig zB für login).
X der Verbindungsaufbau wird erst vollendet, wenn FD 3 geschlossen wird
(Fehlercode, wenn ein Zeichen kommt).
i für ankommende Verbindungen
o für abgehende Verbindungen
f für Festverbindungen. "B" wird hier normalerweise ebenfalls angegeben.
d für Wählverbindungen (nur eine gleichzeitig)
m für Wählverbindungen (mehrere gleichzeitig)
p für Verbindungsaufbau nach Bedarf ("reconn"-Modul nicht vergessen!);
wird beim Programmstart automatisch mitgestartet. Die eigentliche
ISDN-Verbindung wird hierdurch _nicht_ aufgebaut, dafür ist "B" gedacht.
CL-Zeile ("Connection Limit")
--------
Form: CL <Art> <Partner> <Key> <Karte> <Zahl>
Beispiel>
CL * * * Tel? 2
Begrenzt die Zahl der für einen gegebenen Verbindungstyp verwendbaren
B-Kanäle. Ueber das Limit hinausgehende Anrufe werden mit BUSY abgelehnt,
es sei denn in der entsprechenden P-Zeile steht der entsprechende
Parameter.
LF-Zeile ("Load File")
--------
Form: LF <Karte> <Segmentgröße> <Delay> <Dateiname>
Lädt die Datei auf die (aktive) Karte. Mehrere LF-Zeilen können angegeben
werden (in der richtigen Reihenfolge! Doku beachten!). Die maximal mögliche
Segmentgröße ist 4096. Der Delay gibt an, wie lange das Programm nach dem
Laden dieser Datei mit dem nächsten Schritt warten soll (Karte macht
Speichertest über 8 MB, und ähnliche Feinheiten).
RP-Zeile ("Run Program")
--------
Form:
RP <Art> <Partner> <Key> <Karte> <Benutzer> <Mod> <Programm> <Argumentliste...>
Beispiel:
RP login * * * root IDUST$u echo "Login von $PHONE auf $DEVICE" >>/var/log/isdn.use
Hiermit wird ein Programm (plus Parameter) angegeben, das bei Eintreten
eines bestimmten Zustands einer Verbindung gestartet wird. Parameter siehe
R-Zeile; zusätzliche Flags sind
c Stdin/out des Programms wird auf ein freies ISDN-Device gelegt.
(Sonst: /dev/null.)
s schicke keine Signale
Die folgenden zusätzlichen Flags werden außerdem in der
"REASON"-Environmentvariable übergeben:
u Start nach erfolgtem Aufbau der Verbindung
d Start bei Abbau einer Verbindung
f Start nach erfolglosem Verbindungsversuch (abgehend)
x Start bei temporärer Deaktivierung eines Interface (zu viele Versuche),
anstehende Datenpakete werden weggeworfen
y Start bei Reaktivierung des Interface
i Start bei Aufruf des Verbindungshandlers (zB des "slipto"-Programms)
r Start bei abgelehntem Anruf
t Start nach Tod des Verbindungshandlers
k Start bei laufenden Gebühreninformationen (während oder nach der Verbindung)
l Start bei endgültigen Gebühreninformationen (nach Verbindungsende)
Die folgenden Flags werden bei Programmen übergeben, die via R-Zeile
gestartet wurden:
B Start beim Booten oder bei Reload der Konfigdatei
I Start bei ankommendem Anruf
Ein mit "u" gestartetes Programm bekommt SIGHUP gesendet, wenn es bei
Verbindungsende noch läuft; dito ein mit "d" gestartetes Programm zu
Beginn des mächsten Verbindungsaufbaus. Einem Programm, das kontinuierlich
läuft, wird bei jedem Statuswechsel SIGUSR1 gesendet. SIGQUIT wird an alle
Programme gesendet, die laufen, wenn die zugeordnete Verbindung beendet
wird.
Vorsicht: Mehrere Programme unter demselben Flag laufen zu lassen
funktioniert nur dann sicher, wenn sich alle (möglicherweise bis auf eines)
ziemlich schnell wieder beenden, sonst gibt es Probleme (mehrfach oder
nicht gestartete Programme).
Im Environment finden sich zusätzlich:
COST für die laufende Verbindung angefallene Kosten
CCOST insgesamt angefallene Kosten
CAUSE Aktueller Fehlerzustand (bei
Module und deren Konfiguration
==============================
:XX <Wertbereich> <Default> Funktion eines Parameters mit Wertangabe
:YY Dito, ohne Wertangabe
A-Law-Coder "alaw"
-----------
Wandelt einen A-Law-Datenstrom in einen 8-Bit-Datenstrom. Dabei werden nur
die Bytes umkodiert, die Daten aber nicht auf 12 Bit aufgeblasen. Gibt nach
oben Bytes _mit_ Vorzeichen weiter.
Zusätzlich können für beide Richtungen Schwellwerte definiert werden,
unterhalb derer keine Uebertragung zugelassen wird, um Gesprächspausen
herauszufiltern.
:ro 0-127 Ansprechschwelle beim Empfang. Null schaltet permanent auf
"Durchgang".
:rx 0-127 Abschaltschwelle. Töne werden blockiert, wenn mehr als ..:
:rc 1-32767 aufeinanderfolgende Samples unterhalb der :rx-Schwelle liegen.
:xo :xx :xc wie :ro :rx :rc, aber für den Sendeteil.
Befehlsinterpreter "proto"
------------------
Sitzt immer automatisch zuoberst auf dem durch den ISDN-Treiber
definierten Stream. Interpretiert im Befehlsmodus die eingetippten Zeichen
und schickt sie zeilenweise an das Managementprogramm.
Im Online-Modus wird keine Spezialzeichenfolge wie etwa "+++" gesondert
interpretiert; stattdessen wird ein _BREAK_ zum Zurückschalten verwendet.
:cr 0-255 0x13 ASCII Carriage return
:lf 0-255 0x10 ASCII line feed
:bs 0-255 0x08 ASCII Backspace
:cc 0-255 0x03 Zeile löschen (Abbruch, ^C)
:ca 0-2 2 0: kein Hangup
1: Hangup bei NO CARRIER
2: Hangup bei CONNECT...NO CARRIER
:bk 0-1 1 BREAK bewirkt Rückkehr in den Befehlsmodus.
:sg 0-1 0 wenn 1, sende SIGUSR1 beim Aufbau der Verbindung und
SIGUSR2 beim Abbau der Verbindung
Die folgenden Codes werden normalerweise vom L4-Treiberprogramm gesendet:
:on schaltet auf Datenübertragung
:of schaltet auf Befehlsmodus
Streams->IP-Wandler (str_if)
-------------------
Implementiert ein TCP/IP-Modul. Daten werden nicht in Richtung Anwender-
programm, sondern in das TCP/IP-Networking des Kernels umgeleitet.
:mt 120-4096 512 MTU des Treibers. (Die MRU hängt vom ISDN-
Kartentreiber ab.)
Paketformat:
:.N TCP/IP (Default).
:.E Ethernet-Paketheader.
:.P PPP-Paketheader.
:eT xxxx xxxx: hexadezimal. Angabe des übertragenen Pakettyps (:.N).
TCP/IP ist 0800 (Default). Damit können zB statt
"nackter" IP-Pakete ebensolche Appletalk-Pakete
übertragen werden.
ioctl(x,SIOCGETU,int) ioctl-Aufruf zur Uebertragung der Unit-Nummer ("strX",
0 <= X <= 15) an ein Anwenderprogramm. Das Programm kann damit die IP-
Adressen auf beiden Seiten des Links konfigurieren. Ein einfaches
Treiberprogramm, "slipto", dem lokale und entfernte IP-Adresse übergeben
werden, ist im Verzeichnis str_if.
PPP-Modul "ppp"
---------
ACHTUNG: Momentan existiert dieses Modul NICHT. Der Treiber kann PPP nur in
Verbindung mit intelligenten Karten (momentan: Bintec BRI/PMX), die PPP
on-board haben. "Richtiges" PPP muß leider noch ein wenig warten.
Bei Verwendung von PAP/CHAP-Authentifizierung: ACHTUNG: /etc/isdn.conf
SOLLTE NICHT WORLD-LESBAR SEIN. Im Normalfall erledigt die
Authentifizierung aber bereits das ISDN. Dieser Treiber unterstützt bei PPP
sowieso (noch?) _keine_ Identifizierung nur via PAP oder CHAP, die
ISDN-Rufnummer _muß_ also trotzdem korrekt übermittelt werden. PAP/CHAP
bieten nur _zusätzliche_ Sicherheit.
str_if-Modul mit :.P konfigurieren!
:iv TCP/IP-Headerkompression aushandeln. vanj-Modul nicht vergessen...
:in TCP/IP-Headerkompression nicht aushandeln.
Entweder :iv oder :in muß angegeben werden, sonst wird kein IP
konfiguriert...
:pc lokal_user lokal_pw entfernt_user entfernt_pw
CHAP-Geheimnisse
:pp dto, PAP-Geheimnisse
Cisco-HDLC-Modul "fakeh"
----------------
Verwendet das Cisco-eigene "HDLC"-Protokoll. Auf der Gegenseite muß
(noch... hat jemand Doku zu den Tieren?) "no keepalives" konfiguriert
werden. Die Option für das Paketformat muß genauso wie bei str_if
eingestellt sein!
:.N TCP/IP (Default).
:.E Ethernet-Paketheader.
IP-Monitor "ipmon"
----------
Loggt IP-Pakete mit. Das Programm "monitor" liest dieses Protokoll aus dem
Kernel. Die Option für das Paketformat muß genauso wie bei str_if
eingestellt sein!
:.N TCP/IP (Default).
:.E Ethernet-Paketheader.
:.P PPP-Paketheader.
:pa Alle Pakete werden direkt mitprotokolliert.
:ps Es wird nur die Paketsumme mitprotokolliert.
:pf Das erste Paket einer Verbindung wird direkt mitgeloggt, danach
nur noch die Summe. Default.
:to 10 Timeout in Sekunden, nach dessen Ablauf die nächste Summenmeldung
an den Monitor geschickt werden.
Verbindungshalter "reconn"
-----------------
Verhindert (in Zusammenarbeit mit korrekten P- und R-Zeilen, siehe oben),
daß eine Verbindungstrennung sich auf eine Anwendung auswirkt; die
Verbindung wird automatisch neu aufgebaut, sobald wieder Daten anstehen.
Sollte logischerweise nicht unterhalb von X.75 oder ähnlichen Modulen zur
Übertragungssicherung eingesetzt werden, weil die ständig Daten
austauschen, um zu prüfen, ob die Gegenstelle noch da ist.
:pf Das jeweils erste Datenpaket (das, das zum Verbindungsneuaufbau
geführt hat), wird in den Syslog mitgeschrieben.
:nf Es wird nicht mitgeschrieben. (Default.)
Zeitbegrenzer "timer"
-------------
Bricht die Verbindung ab, wenn eine bestimmte Zeit lang keine Daten
übertragen wurden.
Alle Zeitangaben sind in Sekunden.
:ti 60 Abstand zwischen den möglichen Abbruchpunkten (zB Gebührenzeittakt)
:to 55 Zeit zwischen Verbindungsaufbau und erster Messung
:tw 0 wenn zum Meßzeitpunkt soviele Sekunden nichts gesendet wurde,
wird die Verbindung abgebrochen
:tr 0 dto., gelesen; eine der beiden Bedingungen reicht aus.
:li unterbrochen wird nur bei ankommenden Verbindungen.
:lo dto, bei abgehenden Verbindungen
:lb dto, beide Verbindungsarten (Default).
Vorsicht: Es macht absolut keinen Sinn, den Timer unterhalb von
übertragungssichernden Modulen wie x.75 oder gar Datenstrom-Modulen wie
v110 anzuordnen.
Der Timeout sollte mindestens dreimal so groß sein wie die Zeit, die
typischerweise zum Verbindungsaufbau benötigt wird, weil es sonst
scheußliche Interaktionen mit den TCP-Retryalgorithmen gebenb kann.
T.70 "t70"
----
Implementiert das T-70-Minimalprotokoll -- spaltet abgehende Dateneinheiten
auf, wenn sie zu groß sind, und faßt ankommende zusammen, wenn das ent-
sprechende Bit im T70-Header gesetzt ist.
:mt 0,4-4096 256 Maximale Datenblockgröße (exklusive T70-Header (2 Bytes)).
":mt 0": Maximum "unendlich".
CEPT "fakecept"
----
Erzeugt das von T-Online erwartete, vom T70-Standard abweichende Protokoll.
Abgehende Dateneinheiten werden wie bei T.70 aufgespalten, bei ankommenden
Dateneinheiten wird nur der Protokollheader entfernt.
/* TODO: Momentan wird die Aufspaltung _nicht_ markiert -- soll/darf das
passieren, wenn ja wie? */
:mt 1-4096 128 Maximale Datenblockgröße. Darf fuer T-Online auf keinen Fall
128 ueberschreiten.
V.110 "v110"
-----
Implementiert V.110 im 38400-Baud-Modus. Mehr oder weniger ungetestete
Experimentierversion. Warnung: Exzessive Kernelbelastung durch
Bitschieberei etc. Für ernsthafte Anwendungen braucht es einen
entsprechenden Wandler in Firmware / Hardware auf der Karte.
Datenpuffer "buffer"
-----------
Die meisten Module haben einen ziemlich kleinen Datenpuffer (ca. 200 Bytes).
Wenn das zuwenig ist, zB beim Empfangen von Audiodaten oder beim
Weiterleiten von IP-Paketen, kann ein Puffer zwischengeschaltet werden.
:br XXX Puffergröße beim Lesen / Empfangen
:bw XXX Puffergröße beim Schreiben / Senden
:bb XXX Puffergröße beim Lesen und Schreiben
Wertebereich für die Puffergröße: 10 bis 16*1024 Bytes.
Default: 4 kBytes.
Der Puffer füllt sich bis zur angegebenen Größe und leert sich
bis auf 1/4 dieses Werts.
Datenrate "rate" (ungetestet!)
---------
Begrenzt die mögliche Übertragungsrate. "Überschüssige" Daten werden
zunächst gepuffert, dann weggeworfen; daher ist es sinnvoll, "rate" vor
"x75" zu verwenden. Bei TCP/IP, das sowieso keinen gesicherten Kanal
voraussetzt, geht es natürlich auch ohne X75.
:ri XXX Begrenzung der ankommenden Daten auf XXX bytes pro Sekunden.
:ro XXX dito, gesendete Daten.
:rb XXX dito, beide Richtungen.
Van-Jacobsen-Kompression "vanj"
------------------------
Komprimiert TCP-IP-Header.
Sollte nur auf einer gesicherten Verbindung verwendet werden.
Option für das Paketformat muß genauso wie bei str_if eingestellt sein!
:sz tx rx 16 16 Zahl der gleichzeitig gecachten Verbindungen.
Zwischen 16 und 128; jeweils Sende- und Empfangsrichtung.
(noch nicht implementiert)
:ac Aktiv komprimieren. (Default bei abgehenden Verbindungen.)
:pa Komprimieren nur, nachdem ein komprimiertes Paket ankam.
(Default bei ankommenden Verbindungen.)
:.N TCP/IP (Default).
:.P PPP-Paketheader.
X.75 "x75"
----
Implementiert Ebene 2 des X75-Protokolls. Das Framing (Prüfsumme, 1-Stopfen,
Interframezeichen etc.) wird von der Hardware auf der Karte erledigt.
:nk 1-7 (127) 1 Parameter "k" -- Anzahl der maximal ausstehenden
Datenblöcke. (Die Länge dieser Blöcke wird nicht
begrenzt -- siehe T70-Modul)
:wd 2-Byte-Befehlswörter: SABME, max(k) 127.
:nw 1-Byte-Befehlswörter: SABM, max(k) 7.
:n1 1-100 3 Parameter "N1" -- Anzahl der Wiederholungen von Poll-Frames,
bis ein Fehler angenommen wird.
:t1 1-100 10 Parameter "t1" -- Timeout für unbestätigte Daten- und
Poll-Frames in Zehntelsekunden.
:t3 1-1000 100 Parameter "t3" -- Timer für Test, ob die Verbindung noch
aktiv ist. In Zehntelsekunden, muß > 2*t1 sein.
:ad 0-255 0-255 (dieser Parameter braucht zwei Wertangaben!)
1 3 Adreßbytes für Befehls- und Meldungsframes. Sollten
das niederwertige Bit gesetzt haben und verschieden sein.
Wegen Abwärtskompatibilität mit dummen Implementierungen
werden "falsche" Einstellungen akzeptiert.
:po Pollmodus -- löst beim Empfang einer RNR-Meldung sofort
einen RR/RNR-Befehl aus. Für Kompatibilität mit dummen
Gegenstellen, die vergessen, sich mit RR bereit zu melden,
nachdem sie RNR gesendet hatten.
:np schaltet den Pollmodus ab (Default).
:cm 012348 1 wann die X75-"Verbindung" aufgebaut wird
0 gar nicht -- es wird angenommen, die Verbindung existiert.
Zur Kompatibilität mit dummen Gegenstellen, die sich
auf die Steuerung im D-Kanal verlassen.
1 Baldmöglichst (abgehend)
2 Baldmöglichst (ankommend)
3 Baldmöglichst (an- und abgehend)
4 wenn der erste Datenblock zur Übertragung ansteht.
8 gar nicht -- es werden UI-Frames verwendet.
pr_on
-----
Spezialmodul, um die "Verbindung hergestellt"-Kennung auf einem Stream
abzusenden, der nicht über ISDN arbeitet. Wird zB vom slipto-Programm
verwendet.
Verzeichnisstruktur der Sourcen
===================
alaw/ Streamsmodul für alaw-Coder.
bin/ fertige Programme (Symlinks)
cards/ Treiber für Karten.
dumb/ .. für dumme Karten (mit Siemens-Chipsatz).
config/ Konfigurationsteil.
fakeh/ "Cisco-HDLC"-Modul.
final/ Installationsteil; final/Makefile wird als letztes aufgerufen
include/ Includedateien (was sonst...)
ip_mon/ TCP/IP-Monitorprogramm nebst Streamstreiber/Modul.
isdn_2/ Schicht-2-Treiber für ISDN (D-Kanalsteuerung, B-Kanal-Routing).
isdn_3/ Schicht-3-Treiber (1TR6 etc.).
isdn_4/ Steuerprogramm (besagter wilder Hack).
ksupport/ Supportkram für den Kernel, diverse Streamsmodule,
Supportcode für die ISDN-Protokollhandler.
reconnect/ Streamsmodul zum dynamischen Wiederaufbau einer Verbindung.
strslip/ Streamsmodul für SLIP-Framing.
str_if/ Streamsmodul für Anbindung an TCP/IP.
support/ Supportkram für Anwendungsprogramme.
t70/ Streamsmodul für T-70.
timer/ Streamsmodul zum Trennen einer Verbindung (Timeout).
v110/ Streamsmodul für V.110. Momentan ungetestet.
van_j/ Streamsmodul für VanJ-TCP/IP-Headerkompression. Funktioniert
momentan nur auf gesicherten Verbindungen 100%ig.
x75/ Streamsmodul für X.75-Handling.
Programme und -Optionen
=======================
isdn_4/master alias bin/isdn
----------------------------
Steuerprogramm für den gesamten ISDN-Kram.
-d Debugging; verhindert daß das Programm sich selber in den
Hintergrund setzt.
-f dev Steuerdevice anstelle von /dev/isdnmon.
-I Debugbefehle werden von stdin gelesen.
-l setzt ein strlog-Modul auf die Steuerverbindung. Debugging.
-w setzt ein logh-Modul auf die programminterne Verbindung zwischen
dem Treiber im Kernel und dem Masterprozeß. Debugging.
-L, -W wie -l / -w, jedoch im Kernel-Log anstatt auf stderr.
-m schreibt die programminterne Verbindung zwischen Ebene 3 und 4
auf stderr mit. Sehr wichtig beim Debuggen.
-M schreibt diverse andere Debugginginfo nach stderr.
-x file Datei mit (internen) Steuerbefehlen, die nach dem vollständigen Start
des ISDN-Krams ausgeführt wird. Ungetestet.
file... Konfigurationsdateien.
monitor
-------
Protokolliert die vom ip_mon-Modul gemeldeten IP-Daten.
-a numerische Angabe der lokalen IP-Adressen.
-b numerische Angabe der entfernten IP-Adressen.
-c numerische Angabe der IP-Protokolle.
-l Debugging; setzt strlog-Modul ein.
-n Die network/services-Dateien werden nicht permanent offengehalten.
-h Die hosts-Dateien werden nicht permanent offengehalten.
Das gilt auch für die Verbindung zum Nameserver.
Monitor kann auch zum Blockieren von IP-Paketen verwendet werden. Das ist
allerdings ungetestet; besser ist es, Firewall-Support in den Kernel
einzubauen.
slipto
------
Kontrollprogramm für den TCP/IP-Kram. Macht bei Verwendung mit ISDN _kein_
"slip"; wenn jemand (zB ein Amiga mit KA9Q) auf SLIP besteht, muß das
"slip"-Modul via ML-Zeile explizit eingesetzt werden.
-D Debugging-Output nach stderr.
-d eine "Default"-Route zur Gegenseite wird eingerichtet.
-R ip die IP-Nummer "ip" wird zur Gegenseite geroutet. (route -host)
-r ip Das IP-Netz "ip" wird zur Gegenseite geroutet. (route -net)
-r ip:nm Das IP-Netz "ip" wird mit der Netmask "nm" zur Gegenseite geroutet.
-r ip/nm Das IP-Netz "ip" wird mit einer Netmask mit "nm" 1-Bits geroutet
(zB das Class-C-Netz 192.168.100.0/24).
-x auf die eigene Adresse wird keine "Route" gesetzt. Dieses Flag
wird immer dann verwendet, wenn die ISDN-Interfaceadresse dieselbe
ist wie zB am lokalen Ethernet.
-A arpaddr setzt Proxy-ARP-Adresse f\ur alle Routen zur Gegenstelle.
Die korrekte "arpaddr" wird von "ifconfig eth0" ausgegeben.
(Vorsicht beim Wechsel der Ethernetkarte!)
Die folgenden Optionen werden _nicht_ im ISDN-Betrieb verwendet, sondern im
Standalonebetrieb mit anderen Streams-Treibern. Im ISDN-Betrieb werden
diese Optionen nicht verwendet; stattdessen werden die entsprechenden
Module auf der ML-Konfigurationszeile eingetragen bzw. als MP-Optionen
eingestellt.
-L protokolliert den Dialog zum Modem.
-l Debugging: setzt qinfo-Modul ein.
-ll zusätzlich count-Modul.
-lll zusätzlich strlog-Modul.
-M setzt IP-Monitor-Modul ein.
-S Betrieb auf synchroner Leitung: verwende kein "slip"-Modul.
-E Autoenable; wenn slipto auf einer bestehenden Verbindung gestartet
wird.
-o schickt ATA zur Leitung und wartet auf CONNECT.
-p dev öffnet Device "dev". (Man verwende "/dev/tty" für stdin/out.)
-v verwende Van-Jacobsen-Headerkompression.
-f verwende Cisco-HDLC-Header.
-m mtu setzt die MTU auf den angegebenen Wert. (Die MRU ist auf 4000 Bytes
begrenzt.)
Die folgenden Parameter müssen immer angegeben werden:
ip_loc lokale IP-Nummer.
Kann auch auf anderen Interfaces (Ethernet) verwendet werden!
ip_rem IP-Nummer der Gegenstelle.
Die beiden Nummern muessen nicht im gleichen Netz sein!
Hackers Corner
==============
Debuggingoptionen:
Das Masterprogramm schickt Debugkram nach stderr und manches andere nach
stdout. Umleiten nach /dev/null wenn's stört; die Debugsachen werden
sukzessive abgestellt, wenn ich mal wieder ein wenig Zeit habe. :-/
Das Debuggingverhalten des Haupttreibers im Kernel läßt sich durch die
isdn2_debug- und isdn2_log-Flags steuern; siehe isdn_2/isdn_2.c.
Hinweis: Wenn alles funktioniert, kann man die Debuggerei getrost
abschalten. Allerdings ist dann die Fehlersuche so gut wie unmöglich...
Module
======
strlog
------
protokolliert absolut alles mit, was über dieses Modul an Daten läuft.
"xstrlog" macht dasselbe wie "strlog", nur werden DATA-Pakete (also die
eigentlichen übertragenen Informationen) nicht mitgeschrieben.
qinfo
-----
Gibt alle N Sekunden eine Meldung über den aktuellen Zustand des
Datenstroms vom ISDN-Modul zum Anwendungsprogramm aus. Nützlich, wenn
man sehen will, wo die Daten hängenbleiben.
:tm 60 Zeit zwischen Meldungen, in Sekunden.
count
-----
Zählt mit, wieviele Datenpakete durchlaufen und wie lang diese sind.
Systemmeldungen
===============
Diese werden zwischen dem "proto"-Modul und dem ISDN-Treiber ausgetauscht
und informieren diese und die dazwischenliegenden Module vom Zustand einer
Verbindung.
"->L2" und "->Cmd" deuten an, dass die Meldung in Richtung ISDN-Treiber oder
"proto"-Modul gesendet werden.
in die Verbindung wird ankommend sein (->Cmd)
ou die Verbindung wird abgehend sein (->Cmd)
os X Reserviert zusätzlichen Pufferplatz am Anfang von Datenblöcken.
(Separat für beide Richtungen, wird automatisch initiiert.)
Module inkrementieren X, um die Zahl der Bytes, die sie selbst maximal
als Header vor die Daten stellen, und reservieren eine entsprechende
Anzahl beim Anfordern eines neuen Datenblocks.
"os" signalisiert außerdem, daß der Aufbau des Modulstacks abge-
schlossen ist. Module können sich also nach der Weitergabe dieser
Meldung untereinander unterhalten, wenn nötig.
li B-Kanal ankommend geschaltet, zB Wählton beim Telefon (->Cmd)
hl B-Kanal-Durchschaltung akzeptiert (->L2)
co B-Kanal bidirektional geschaltet (->Cmd)
hc Verbindung hergestellt (->L2)
wi Befehl zur Herstellung einer Unterbrechung (->Cmd)
is Verbindung unterbrechen (->L2)
is Verbindung ist unterbrochen (->Cmd)
hi Rückmeldung: Verbindung unterbrochen(->L2)
wd Befehl zum "sauberen" Abbau der Verbindung(->Cmd)
di Verbindung abbauen (->L2)
di Verbindung ist abgebaut (->Cmd)
hd Rückmeldung: Verbindung ist getrennt, evtl wird NO CARRIER gemeldet.
Wer beobachten will, wie genau diese Meldungen transpoortiert werden,
verwende ein xstrlog-Modul.
Euro-ISDN: Bearer Capability und andere Feinheiten
=========
Die Informationselemente sind in mehrere Blöcke aufgeteilt. Jeder Block
wird dadurch begrenzt, daß das höchstwertige Bit auf 1 steht. Die
weggelassenen Bytes haben Defaultwerte. Ich führe hier die wichtigsten
Codierungen auf; der Rest steht in der Q.931.
1 1AABBBBB AA Codierungsstandard
00 CCITT
BBBBB Datenformat
00000 Sprache
01000 digitale Daten
10000 Audio, 3.1 kHz
2 1AABBBBB AA Modus
00 Standard
BBBBB Übertragungsgeschwindigkeit
10000 64 kBit
3 x01AAAAA AAAAA Schicht-1-Protokoll
00001 V.110
00011 A-law Audio
01000 V.120
01001 X.31 mit HDLC-Flags.
Hinter einem Hexstring kann ein weiterer String angegeben werden, der als
Maske dient, welche Bits bei ankommenden Rufen beachtet werden. Die höchst-
wertigen Bits haben dieselbe Bedeutung wie oben und können zum Abkürzen
verwendet werden. Siehe support/vectcmp.c.
Beispiel:
:vB 9090A3 EFFFFF -- Sprache oder 3.1kHz Audio, für den Anrufbeantworter
:vB 8890 -- (alle Bits signifikant) entspricht :sv 0700, für
Datenverbindungen aus dem 1TR6-Raum
[ Falls jemand anders den Rest der relevanten Teile der Q.931 abtippen
will, nur zu... ]
Ansonsten: Sich von der Gegenstelle anrufen zu lassen und die betreffenden
Daten einfach einzutragen ist wohl die einfachste Methode.
Karten mit CAPI: Die CAPI ist doof...
===============
Im Internet heißt es in so gut wie jedem RFC, daß reservierte Bits beim
Senden auf Null zu setzen und beim Empfangen zu ignorieren sind. Nicht so
in der CAPI 1.1, dort sind gesetzte reservierte Bits ein Grund für eine
Fehlermeldung. Da aber nirgends definiert oder abfragbar ist, welche Bits
eigentlich erlaubt sind, ist es so gut wie unmöglich, ohne Ratespiel neue
Features zu unterstützen...
Wie dem auch sei, die Infobits haben folgende Bedeutung:
00000001 Gebühreneinheiten
00000002 Datum
00000004 Display
00000008 User-User Info
00000010 Cause
00000020 Status des gerufenen Teilnehmers
00000040 Rufnummernübergabe (Anlagenanschluß)
00000080...
20000000 reserviert
40000000 SPVs
80000000 Festverbindungen
Die EAZ-Bits:
0001 Null ("Global Call", wird aber nicht besonders behandelt)
0002 Eins ...
0200 Neun
0400...
8000 reserviert
Die Dienstkennungen, entsprechend :sv 00xx ... 0Fxx:
0001 Bildtelefon
0002 Telefonie
0004 a/b-Dienste
0008 X.21-Dienste
0010 Telefax Gruppe 4
0020 BTX, 64 KBit/sec
0040 ?
0080 DFÜ
0100 X.25
0200 Teletext
0400 Mixed Mode
0800 ?
1000 ?
2000 Fernwirken
4000 Grafiktelefon
8000 BTX (CEPT-Standard)
Ankommende Rufe, die zu diesen EAZs und Diensten passen, werden
durchgereicht (und die angeforderten Informationen werden gemeldet, wenn
die Vermittlung sie sendet(!)); andere Rufe werden ignoriert.
Bugs anderer Leute
==================
(1)
An manchen Nebenstellenanlagen werden ankommende Rufe teilweise mit,
teilweise ohne der zum Rauswählen notwendigen Null ausgeliefert.
Das liegt an der Quelle der Anrufe; die Telekom signalisiert 1TR6-Anrufe
etwas anders als Euro-ISDN (ist aber beides legal), die Telefonanlage setzt
aber nur eine Version korrekt um.
Workaround: Keiner.
Bugfix: Hersteller kräftig treten.
(2)
Manche Anlagen treiben es noch schlimmer und übergeben ankommende Anrufe
mit "unbekannter Nummerntyp" aber _ohne_ führende Null. Sorry, leider
daneben -- evtl. hilft :b1 in der DL-Zeile.
Noch schlimmer treibt es zB die Ackerman Euracom 181, Firmware 1.05, die
ankommend die Nebenstellennummer als "örtliche Nummer" kennzeichnet.
Workaround: Auch :b1. Abgesehen davon: Hersteller _kräftig_ treten, sowas
ist einfach Unsinn.
(3)
Die Niederländer übergeben die Einheiten nicht im dafür vorgesehenen
Format, sondern als DISPLAY-String. Grummel. :b2 in die DL-Zeile.
View Git Blame Copy Permalink