trinadh465/external_lib_aosp10_r33_cve-2021-45960_cve-2021-46143-C-Bibliothek für streamorientiertes XML-Parsing, die einen schnellen und konfigurierbaren Parser mit Unterstützung für benutzerdefinierte Handler und Kodierungsoptionen bereitstellt.
Dies ist Expat, eine C-Bibliothek zum Parsen von XML, gestartet von James Clark im Jahr 1997. Expat ist ein streamorientierter XML-Parser. Das bedeutet, dass Sie Handler beim Parser registrieren, bevor Sie das Parsen starten. Diese Handler werden aufgerufen, wenn der Parser die zugehörigen Strukturen im zu parsenden Dokument entdeckt. Ein Start-Tag ist ein Beispiel für die Art von Strukturen, für die Sie Handler registrieren können.
Windows-Benutzer sollten das
expat_win32-Paket verwenden,
das sowohl vorkompilierte Bibliotheken und ausführbare Dateien als auch Quellcode für
Entwickler enthält.
Expat ist freie Software.
Sie dürfen es unter den Bedingungen der Lizenz kopieren, verbreiten und modifizieren,
die in der Datei
COPYING
enthalten ist, die mit diesem Paket verteilt wird.
Diese Lizenz ist dieselbe wie die MIT/X Consortium-Lizenz.
Wenn Sie Expat aus einem Check-out aus dem Git-Repository erstellen, müssen Sie ein Skript ausführen, das das configure-Skript mit den GNU autoconf- und libtool-Werkzeugen generiert. Dazu benötigen Sie autoconf 2.58 oder neuer. Führen Sie das Skript wie folgt aus:
./buildconf.sh
Sobald dies erledigt ist, folgen Sie den gleichen Anweisungen wie für die Erstellung aus einer Quellverteilung.
Um Expat aus einer Quellverteilung zu erstellen, führen Sie zunächst das Konfigurations-Shellskript im obersten Verzeichnis der Verteilung aus:
./configure
Es gibt viele Optionen, die Sie configure bereitstellen können (die Sie
durch Ausführen von configure mit der Option --help entdecken können).
Aber die interessanteste ist diejenige, die das Installationsverzeichnis festlegt.
Standardmäßig richtet das configure-Skript die Installation so ein, dass
libexpat in /usr/local/lib, expat.h in /usr/local/include und
xmlwf in /usr/local/bin installiert werden. Wenn Sie zum Beispiel
bevorzugen, in /home/me/mystuff/lib, /home/me/mystuff/include und
/home/me/mystuff/bin zu installieren, können Sie configure dies wie
folgt mitteilen:
./configure --prefix=/home/me/mystuff
Eine weitere interessante Option ist die Aktivierung der 64-Bit-Integer-Unterstützung für Zeilen- und Spaltennummern und den gesamten Byte-Index:
./configure CPPFLAGS=-DXML_LARGE_SIZE
Eine solche Modifikation wäre jedoch eine brechende Änderung der ABI und wird daher nicht für den allgemeinen Gebrauch empfohlen — z. B. als Teil einer Linux-Distribution — sondern eher für Builds mit besonderen Anforderungen.
Nach dem Ausführen des configure-Skripts wird der Befehl make die Dinge
erstellen und make install wird die Dinge an ihrem richtigen Ort installieren.
Werfen Sie einen Blick auf das Makefile, um weitere make-Optionen zu erfahren.
Beachten Sie, dass Sie Schreibberechtigung in den Verzeichnissen benötigen, in die
die Dinge installiert werden.
Wenn Sie daran interessiert sind, Expat zu erstellen, um Dokumentinformationen
in UTF-16-Kodierung anstelle des standardmäßigen UTF-8 bereitzustellen, befolgen
Sie diese Anweisungen (nachdem Sie make distclean ausgeführt haben).
Bitte beachten Sie, dass wir mit --without-xmlwf konfigurieren, da xmlwf diesen
Kompilierungsmodus (noch) nicht unterstützt:
Patchen Sie Makefile.am-Dateien massenhaft, um libexpatw.la als Bibliotheksnamen zu verwenden:
find -name Makefile.am -exec sed -e 's,libexpat\.la,libexpatw.la,' -e 's,libexpat_la,libexpatw_la,' -i {} +
Führen Sie automake aus, um Makefile.in-Dateien neu zu schreiben:
automake
Für UTF-16-Ausgabe als unsigned short (und Versions-/Fehlerstrings als char) führen Sie aus:
./configure CPPFLAGS=-DXML_UNICODE --without-xmlwf
Für UTF-16-Ausgabe als wchar_t (einschließlich Versions-/Fehlerstrings) führen Sie aus:
./configure CFLAGS="-g -O2 -fshort-wchar" CPPFLAGS=-DXML_UNICODE_WCHAR_T --without-xmlwf
Hinweis: Letzteres erfordert eine libc, die ebenfalls mit -fshort-wchar kompiliert wurde.
Führen Sie make aus (was xmlwf ausschließt).
Führen Sie make install aus (wiederum ohne xmlwf).
Die Verwendung von DESTDIR wird unterstützt. Es funktioniert wie folgt:
make install DESTDIR=/path/to/image
überschreibt das im Makefile gesetzte DESTDIR, da die Priorität der Variablensetzung ist
Hinweis: Dies gilt nur für die Expat-Bibliothek selbst; das Erstellen von UTF-16-Versionen von xmlwf und der Tests wird derzeit nicht unterstützt.
Wenn Sie Expat mit einem Projekt verwenden, das autoconf zur Konfiguration verwendet,
können Sie das Prüf-Makro in conftools/expat.m4 verwenden, um zu bestimmen, wie
Expat eingebunden wird. Weitere Informationen finden Sie in den Kommentaren am Anfang
dieser Datei.
Ein Referenzhandbuch ist in der Datei doc/reference.html in dieser Verteilung verfügbar.