LibMacAddressDB. Version 1.0. Marko Schröder

Transkript

1 Technische LibMacAddressDB Dokumentation Version 1.0 Marko Schröder

2 Inhalt LibMacAddressDB... 3 Einleitung... 3 Bereitgestellte Variablen... 3 Bereitgestellte Methoden... 3 UML... 5

3 LibMacAddressDB Einleitung Die als DLL bereitgestellte LibMacAddressDB stellt Funktionen bereit, mit denen es möglich ist eine MAC-Adresse einem spezifischen herstellen zuzuordnen. Um diese Funktionalität zu gewährleisten, wird eine lokale Datenbank benötigt, die diese Daten enthält. Der Inhalt dieser Datenbank wird aus der Datei (oder einer lokalen Kopie dieser) generiert. Alle, eventuell auftretenden Exceptions, werden an den Aufrufer weitergeleitet. Bereitgestellte Variablen 1) public String PathToDb { get; set; } enthält den Pfad zur Adress-Datenbank. 2) private Dictionary<String, String> _db; die eigentliche Adress-Datenbank Bereitgestellte Methoden 1) MacAddressDB(String pathtodb) Konstruktor Der Pfad zur Adress-Datenbank wird übergeben und gespeichert. Des Weiteren wird _db erstellt und überprüft ob am übergebenen Pfad bereits eine Datenbank existiert, diese wird gegebenenfalls deserialisiert. 2) private void updatedb(stream st) führt ein Update der lokalen Datenbank aus dem übergebenen Stream-Objekt durch. Da das Stream-Objekt die zu lesenden Datei enthält muss zunächst verifiziert werden, dass es sich um eine gültige bzw. korrekte Ausgangsdatei handelt. Hierzu werden die ersten 6 Zeilen der Datei eingelesen und überprüft ob diese dem folgenden Aufbau entsprechen: OUI<TAB><TAB><TAB><TAB>Organization company_id<tab><tab><tab>organization <TAB><TAB><TAB><TAB>Address Wurde diese Überprüfung erfolgreich beendet, so kann damit begonnen werden die einzelnen Kombinationen von MAC-Adresse und Hersteller aus der Datei zu extrahieren. Diese stehen in Textblöcken von 5-6 Zeilen Länge, wobei die Zeile die sowohl MAC-Adresse als auch den Namen des Herstellers enthält, durch die Zeichenfolge (hex) identifiziert werden kann. In dieser Zeile steht innerhalb der ersten 8 Zeichen die MAC-Adresse (bzw. der einem Hersteller zugewiesene Adress-Kreis) und ab dem 19. Zeichen folgt der Herstellername. Wenn die Kombination aus Adresse und Hersteller noch nicht in der

4 Datenbank enthalten ist, so wird sie dem Dictionary hinzugefügt. Sind alle Kombinationen aus der Datei in die Datenbank überführt worden, so wird das Dictionary durch den Aufruf von serialize() serialisiert. InvalidDataException die zugrunde liegende Datei scheint fehlerhaft zu sein ArgumentNullException Parameter (Stream) ist null ArgumentException der übergebene parameter ist leer 3) public void updatefromfile(string path) Führt ein Update der lokalen Datenbank aus einer lokalen Datei (z.b. oui.txt) durch. Dies geschieht indem die übergebene Datei geöffnet wird und der daraus resultierende Stream an updatedb(stream st) übergeben wird. ArgumentNullException Parameter ist null ArgumentException Parameter ist leer ( ) FileNotFoundException Datei kann nicht gefunden werden IOException 4) public void updatedbonline() Führt ein Internet basiertes Update der lokalen Datenbank durch. Hierzu wird die Datei heruntergeladen und in einen Stream kopiert. Dieser Stream wird dann an updatedb(stream st) übergeben. WebException 5) private void deserialize() Deserialisiert das Dictionary. FileNotFoundException Datei in pathtodb kann nicht gefunden werden IOException SerializationException 6) private serialize() Serialisiert das Dictionary.

5 FileNotFoundException Datei in pathtodb kann nicht gefunden werden IOException SerializationException 7) public String getmanufacturer(string macaddress) Sucht den passenden Hersteller zu einer übergebenen MAC-Adresse und gibt diesen zurück. Da die im Dictionary gespeicherten Adressen nur eine Länge von 8 Zeichen haben, müssen die übergeben Adresse zunächst auf diese Länge gekürzt werden. Zusätzlich wird auf dem so erhaltenen String.toUpper() aufgerufen. Nun wird überprüft ob die übergeben Adresse im Dictionary enthalten ist, wenn ja wird der dazugehörige Hersteller zurückgegeben, wenn nicht wird der String NOT FOUND zurückgegeben. Bei einer leeren Datenbank wird null zurückgegeben. Die der Funktion übergebene MAC-Adresse muss eines der folgenden Formate haben: aa-bb-cc-dd-ee-ff AA-BB-CC-DD-EE-FF ArgumentNullException Parameter ist null UML