Haftungsausschluss

Automatisch exportiert von code.google.com/p/firmware-mod-kit

Firmware-Modifikations-Kit

Dieses Kit ist eine Sammlung von Skripten und Dienstprogrammen zum Extrahieren und Neuerstellen von Linux-basierten Firmware-Images.

Ein Firmware-Image in seine Bestandteile zerlegen
Der Benutzer nimmt die gewünschten Änderungen am Dateisystem der Firmware oder der Weboberfläche (webif) vor
Firmware neu erstellen
Modifizierte Firmware auf das Gerät flashen und es brickieren (ha)

WARNUNG: Sie werden Ihr Gerät durch die Verwendung dieses Kits brickieren (vielleicht nicht, aber es ist besser zu sagen, dass Sie es tun werden). Brickieren bedeutet, dass das Gerät effektiv zu einem funktionslosen 'Ziegelstein' wird. Eine Wiederherstellung ist manchmal ohne Hardware-Modifikationen möglich. Manchmal sind Hardware-Modifikationen erforderlich (z. B. serielle oder JTAG-Header, die auf die Leiterplatte gelötet werden). Manchmal ist es einfach nicht machbar oder die Gesamtwiederherstellungskosten übersteigen den Wert des Geräts.

Verwenden Sie dieses Kit NICHT, wenn Sie nicht bereit sind, dass Ihr Router bricked wird!

EULA: Durch Herunterladen oder Verwenden dieses Kits stimmen Sie zu, die Haftung für die Folgen der Nutzung oder des Missbrauchs des Firmware-Mod-Kits zu übernehmen. Dazu gehört das Brickieren Ihres Geräts. Die Autoren dieses Kits haben Sie gewarnt. Dieses Kit ist nur für Embedded-Systems-Softwareingenieure bestimmt.

Firmware Mod Kit

Einführung
Voraussetzungen
Verwendung des Kits
Links

Einführung

Das Firmware Mod Kit ermöglicht die einfache Zerlegung und Neuerstellung von Firmware-Images für verschiedene eingebettete Geräte. Obwohl es sich hauptsächlich an Linux-basierte Router richtet, sollte es mit den meisten Firmware kompatibel sein, die gängige Firmware-Formate und Dateisysteme wie TRX/uImage und SquashFS/CramFS verwendet.

Voraussetzungen

Um das Firmware Mod Kit zu verwenden, benötigen Sie einen Subversion-Client, Standard-Linux-Entwicklungstools (gcc, make, etc.), das Python-Magic-Modul sowie die Entwicklerpakete für zlib und lzma. Wenn Sie eine Linux-Distribution verwenden, die apt-get nutzt, z. B. Ubuntu oder Debian, verwenden Sie:

Für Ubuntu 18.04 und älter:

sudo apt-get install git build-essential zlib1g-dev liblzma-dev python-magic autoconf

Für Ubuntu 20.04 und neuer:

sudo apt-get install git build-essential zlib1g-dev liblzma-dev python3-magic autoconf python-is-python3

Für RedHat:

yum groupinstall "Development Tools"
yum install git zlib1g-dev xz-devel python-magic zlib-devel util-linux

Für Arch Linux:

Es gibt ein AUR-Paket unter https://aur.archlinux.org/packages/firmware-mod-kit/

Für andere Distributionen sollten Sie die entsprechenden Pakete mit dem Paketmanager Ihrer Distribution installieren.

git clone https://github.com/rampageX/firmware-mod-kit.git
cd firmware-mod-kit/src
make

Binwalk 2.1.1

[Zurück im Verzeichnis firmware-mod-kit]
cd src/binwalk-2.1.1
sudo python2 setup.py install

Das Firmware Mod Kit wird nur auf der Linux-Plattform unterstützt. Mit einigen kleinen Änderungen sollte es auf anderen POSIX-Plattformen funktionieren.

Verwendung des Kits

Klonen Sie das Repository des Firmware Mod Kit mit Git.

Kit-Ausführbare Dateien

Das Firmware Mod Kit ist eine Sammlung von Dienstprogrammen und Shell-Skripten. Die Dienstprogramme können direkt verwendet werden, oder die Shell-Skripte können verwendet werden, um gängige Firmware-Operationen (z. B. Extrahieren und Neuerstellen) zu automatisieren und zu kombinieren. Die Kernskripte zur Durchführung von Firmware-Operationen sind unten aufgeführt.

Primäre Skripte:

Skript	Beschreibung
extract-firmware.sh	Skript zum Extrahieren von Firmware
build-firmware.sh	Skript zum Neuerstellen von Firmware

Sekundäre Skripte:

ddwrt-gui-extract.sh	Extrahiert Web-GUI-Dateien aus extrahierter DD-WRT-Firmware.
ddwrt-gui-rebuild.sh	Stellt modifizierte Web-GUI-Dateien in der extrahierten DD-WRT-Firmware wieder her.

Das Firmware-Arbeitsverzeichnis

Das Firmware Mod Kit verwendet ein 'hartcodiertes' Arbeitsverzeichnis mit dem Namen 'fmk'. Das Extraktionsskript extrahiert in diesen Ordner, und das Neuerstellungsskript erstellt aus diesem Ordner neu. Die Verwendung alternativer Arbeitsverzeichnisse wird für einige Operationen unterstützt, jedoch nicht für alle. Wir werden dies in Zukunft erweitern. Wenn Sie mehrere Arbeitsverzeichnisse haben, empfehlen wir Ihnen, diejenigen umzubenennen, mit denen Sie gerade nicht arbeiten.

Extrahieren von Firmware

Die automatisierte Firmware-Extraktion funktioniert in der Regel mit den meisten Firmware-Images, die uImage/TRX-Firmware-Header verwenden und SquashFS- oder CramFS-Dateisysteme nutzen. Derzeit ist extract-firmware.sh die bevorzugte Extraktionsmethode, da es mehr Firmware-Typen unterstützt als das ältere Skript old-extract.sh. old-extract.sh ist jedoch weiterhin enthalten und funktioniert mit vielen Firmware-Formaten.

Die Verwendung für extract-firmware.sh und build-firmware.sh ist einfach:

./extract-firmware.sh firmware.bin

Standardmäßig befindet sich die Ausgabe von extract-firmware.sh im Verzeichnis 'fmk', während old-extract.sh die extrahierten Daten in das angegebene Arbeitsverzeichnis legt.

Neuerstellen von Firmware

Welches Build-Skript verwendet wird, hängt davon ab, welches Extraktionsskript verwendet wurde. Wenn Sie ein Firmware-Image mit extract-firmware.sh extrahiert haben, müssen Sie build-firmware.sh zum Neuerstellen verwenden. Wenn old-extract.sh verwendet wurde, muss old-build.sh zum Neuerstellen des Images aufgerufen werden:

./build-firmware.sh [-nopad] [-min]

Die von build-firmware.sh generierte neue Firmware befindet sich unter 'fmk/new-firmware.bin', während old-build.sh Firmware-Images in verschiedenen Formaten erzeugt und im angegebenen Ausgabeverzeichnis speichert.

Der optionale Schalter -nopad weist build-firmware.sh an, die Firmware NICHT auf die ursprüngliche Größe aufzufüllen.

Der optionale Schalter -min verwendet die maximale SquashFS-Blockgröße von 1 MB. Dies verringert die Größe des Firmware-Images, erhöht jedoch den CPU- und RAM-Ressourcenverbrauch auf dem Zielgerät. Verwenden Sie diesen Schalter nur, wenn es unbedingt erforderlich ist. Dies ist eine sehr große Blockgröße für eingebettete Systeme. Die ursprüngliche SquashFS-Blockgröße der Firmware bleibt beim Neuerstellen erhalten, und die ursprüngliche Blockgröße sollte verwendet werden, es sei denn, Sie sind sich sicher, was Sie tun. Eine zu große Blockgröße mag zwar funktionieren, aber die Laufzeitleistung der Firmware kann unter allen oder bestimmten Lasten leiden.

Modifizieren von DD-WRT-Webseiten

Eine sehr einzigartige Funktion des Firmware Mod Kit ist die Möglichkeit, Dateien aus der DD-WRT-Web-GUI zu extrahieren und neu zu erstellen. Dies wird durch die Skripte ddwrt-gui-extract.sh und ddwrt-gui-restore.sh automatisiert.

Sobald Sie ein DD-WRT-Firmware-Image mit extract-firmware.sh extrahiert haben, können Sie die Webdateien wie folgt extrahieren:

firmware-mod-kit

Beliebteste