README für SWHOISD
Diese Software wird OHNE JEGLICHE GARANTIE in der Hoffnung angeboten, dass sie für den jeweiligen Zweck von Nutzen ist und den jeweiligen gesetzlichen Bestimmungen gemäss verwendet wird. Die Verbreitung dieser Software impliziert nicht die Garantie der Handelsfähigkeit als Ware oder die Einsatzfähigkeit für einen ganz bestimmten Zweck.
Einführung
Swhoisd ist ein Linux/*nix-Dämon, der eine Datenbankabfrage auf eine einfach strukturierte Datenbank (flatfile) durchführen kann. Er beantwortet Anfragen von Whois-Clients auf dem Port 43. Die derzeitige Version unterstützt vier Typen von Datenbankeinträgen:
- Host Record
- Domain Record
- Person Record
- Network Record
Die Konfigurationsdatei in /etc/swhoisd/swhoisd.conf ist eine Textdatei, die alle Datenbankinformationen für Hosts, Domains, Personen und Netzwerke in Form von Records enthält.
Format
Das Format von swhoisd.conf ist zur Zeit folgendermaßen aufgebaut:
# Host Record
<handle> hr {
name <name>
fqdn <fqdn>
os <os>
ip <ip>
arch <architecture>
cname <cname>
mx <mx>
country <country>
admin <handle>
tech <handle>
created <date>
updated <date>
}
# Domain Record
<handle> dr {
name <name>
domain <domain>
ns1 <ns1>
ns1ip <ns1ip>
ns2 <ns2>
ns2ip <ns2ip>
ns3 <ns2>
ns3ip <ns2ip>
ns4 <ns2>
ns4ip <ns2ip>
ns5 <ns2>
ns5ip <ns2ip>
hub <hub>
country <country>
contact <handle>
admin <handle>
tech <handle>
created <date>
updated <date>
}
# Person Record
<handle> pr {
name <name>
org <organization>
email <email>
address <address>
country <country>
phone <phone>
fax <fax>
created <date>
updated <date>
}
# Network Record
<handle> nr {
as <asn>
name <name>
net <old-pr-net>
bbnet <backbonenet>
usrnet <usernet>
prnet <packet-radio-2-as-net>
admin <handle>
tech <handle>
remark <text>
created <date>
updated <date>
Struktur
<handle> ist ein eindeutiger String, der den Datenbankeintrag identifiziert. Der zweite Key am Beginn eines jeden Records muss „hr“, „dr“, „pr“ oder „nr“ lauten. Hiermit wird dem folgenden Record einer der vier Typen Host, Domain, Person und Netzwerk zugewiesen.
Jeder Datenbankeintrag kann einen, mehrere oder alle der für den jeweiligen Typ gültigen Schlüsselbegriffe (Keys) enthalten. Schlüsselbegriffe können auch mehrfach in einem Record vorkommen.
Das Ausrufezeichen „!“ unmittelbar vor einem Schlüsselbegriff bedeutet, dass bei einer WHOIS-Anfrage die Datenbank innerhalb dieser markierten Schlüsselfelder nach dem eingegebenen Suchstring durchsucht wird. Swhoisd gibt dann als Antwort alle vollständigen Records der Datenbank aus, in denen der Suchstring innerhalb aller mit „!“ markierten Schlüsselbegriffe positiv gefunden wurde. Zeilen, die mit einem „#“ auskommentiert wurden, werden nicht ausgegeben.
Beispiel
# Host Records (hr) --------------------------------------------
DB0RES-SVR-HOST hr {
!fqdn db0res-svr.ampr.org
!cname dl-west.de.ampr.org
!ip 44.130.146.101
os Linux Debian 5
arch x86
mx 200 kle.nw.schule.de
country DE
admin DD9QP
tech DD9QP
created Sun Aug 09 23:50:22 CEST 2009
updated Sun Aug 09 23:50:22 CEST 2009
}
# Domain Records (dr) ------------------------------------------
RR-DE-DOM dr {
name rr-de
!domain rr.de.ampr.org
!ns1 db0res-svr.rr.de.ampr.org
ns1ip 44.130.146.101
ns2 db0gos.rr.de.ampr.org
ns2ip 44.130.18.200
ns3 hamgate.db0res.org
ns3ip 87.139.127.97
country DE
contact DD9QP-PR
admin DD9QP <dd9qp@db0res.de>
tech DD9QP <dd9qp@db0res.de>
remark This is the 1st remark line for testing
remark This is the 2nd remark line for testing
created Sun Aug 09 23:50:22 CEST 2009
updated Sun Aug 09 23:50:22 CEST 2009
}
# Network Records (nr) -----------------------------------------
AS64627 nr {
!as 64627
!name DISTRIKT-L-627-AS
bbnet 44.130.231.0/24
usrnet 44.130.212.0/24
country DE
admin DD9QP <dd9qp@db0res-svr.ampr.org>
tech DD9QP <dd9qp@db0res-svr.ampr.org>
remark AS allocated and assigned
created 2009-09-26
updated 2009-10-03
}
DB0RES-NET nr {
!name db0res-svr.ampr.org
net 44.130.146.0/24
net 44.130.18.0/24
net 44.130.22.0/24
net 44.130.0.0/16
net 44.0.0.0/8
admin DD9QP
tech DD9QP
remark networks are routet in the "old" amprnet
created 2009-08-09
updated 2009-10-03
}
# Person Records (pr) ------------------------------------------
DD9QP-PERSON pr {
!name DD9QP
email dd9qp@db0res.de
email dd9qp@db0res-svr.ampr.org
!email dd9qp@db0res-svr.rr.de.ampr.org
org DL-IP Koordination
address Egbert Zimmermann
address Rheinstrasse 13
address D-46459 Rees
country DE
phone +49 2851 92748
phone +49 173 5161955
remark This is a remark line only for testing
created Sun Aug 09 23:50:22 CEST 2009
updated Sun Aug 09 23:50:22 CEST 2009
}