nidhihcl/external_expat_2.1.0_cve-2022-43680Bibliothèque C pour l'analyse XML orientée flux avec un accent sur l'analyse de vulnérabilités et l'exploitation de CVE-2022-43680, permettant le fuzzing et les tests de sécurité au niveau binaire.
Expat, version 2.1.0
Ceci est Expat, une bibliothèque C pour l'analyse de XML, écrite par James Clark. Expat est un analyseur XML orienté flux. Cela signifie que vous enregistrez des gestionnaires auprès de l'analyseur avant de commencer l'analyse. Ces gestionnaires sont appelés lorsque l'analyseur découvre les structures associées dans le document analysé. Une balise ouvrante est un exemple du type de structures pour lesquelles vous pouvez enregistrer des gestionnaires.
Les utilisateurs de Windows devraient utiliser le paquet expat_win32bin, qui comprend à la fois des bibliothèques et des exécutables précompilés, ainsi que le code source pour les développeurs.
Expat est un logiciel libre. Vous pouvez le copier, le distribuer et le modifier selon les termes de la licence contenue dans le fichier COPYING distribué avec ce paquet. Cette licence est la même que la licence MIT/X Consortium.
Les versions d'Expat dont le numéro de version mineure est impair (le nombre du milieu dans la version ci-dessus) sont des versions de développement et doivent être considérées comme des logiciels bêta. Les versions dont les numéros de version mineure sont pairs sont destinées à être des logiciels de qualité production.
Si vous construisez Expat à partir d'une extraction du dépôt CVS, vous devez exécuter un script qui génère le script configure à l'aide des outils GNU autoconf et libtool. Pour ce faire, vous devez disposer d'autoconf 2.58 ou plus récent. Exécutez le script comme ceci :
./buildconf.sh
Une fois cela fait, suivez les mêmes instructions que pour une construction à partir d'une distribution source.
Pour construire Expat à partir d'une distribution source, vous exécutez d'abord le script shell de configuration dans le répertoire de premier niveau de la distribution :
./configure
Il existe de nombreuses options que vous pouvez fournir à configure (que vous pouvez découvrir en exécutant configure avec l'option --help). Mais celle qui présente le plus d'intérêt est celle qui définit le répertoire d'installation. Par défaut, le script configure installera libexpat dans /usr/local/lib, expat.h dans /usr/local/include, et xmlwf dans /usr/local/bin. Si, par exemple, vous préférez installer dans /home/me/mystuff/lib, /home/me/mystuff/include, et /home/me/mystuff/bin, vous pouvez l'indiquer à configure avec :
./configure --prefix=/home/me/mystuff
Une autre option intéressante consiste à activer la prise en charge des entiers 64 bits pour les numéros de ligne et de colonne et l'index d'octets global :
./configure CPPFLAGS=-DXML_LARGE_SIZE
Cependant, une telle modification constituerait un changement cassant pour l'ABI et n'est donc pas recommandée pour un usage général - par exemple dans le cadre d'une distribution Linux - mais plutôt pour des constructions avec des exigences particulières.
Après avoir exécuté le script configure, la commande « make » construira les éléments et « make install » les installera à leur emplacement approprié. Consultez le « Makefile » pour découvrir d'autres options de « make ». Notez que vous devez disposer de la permission d'écriture dans les répertoires dans lesquels les éléments seront installés.
Si vous souhaitez construire Expat pour fournir les informations du document en encodage UTF-16 plutôt qu'en UTF-8 par défaut, suivez ces instructions (après avoir exécuté « make distclean ») :
1. Pour une sortie UTF-16 en unsigned short (et des chaînes de version/d'erreur
en char), exécutez :
./configure CPPFLAGS=-DXML_UNICODE
Pour une sortie UTF-16 en wchar_t (y compris les chaînes de version/d'erreur),
exécutez :
./configure CFLAGS="-g -O2 -fshort-wchar" \
CPPFLAGS=-DXML_UNICODE_WCHAR_T
2. Modifiez le MakeFile, en changeant :
LIBRARY = libexpat.la
en :
LIBRARY = libexpatw.la
(Notez le « w » supplémentaire dans le nom de la bibliothèque.)
3. Exécutez « make buildlib » (qui construit uniquement la bibliothèque).
Ou, pour économiser l'étape 2, exécutez « make buildlib LIBRARY=libexpatw.la ».
4. Exécutez « make installlib » (qui installe uniquement la bibliothèque).
Ou, si l'étape 2 a été omise, exécutez « make installlib LIBRARY=libexpatw.la ».
L'utilisation de DESTDIR ou INSTALL_ROOT est activée, INSTALL_ROOT étant la valeur par défaut de DESTDIR, et le reste du makefile n'utilisant que DESTDIR. Cela fonctionne comme suit : $ make install DESTDIR=/path/to/image remplace le DESTDIR défini dans le makefile, tandis que les deux $ INSTALL_ROOT=/path/to/image make install $ make install INSTALL_ROOT=/path/to/image utilisent DESTDIR=$(INSTALL_ROOT), même si DESTDIR est éventuellement défini dans l'environnement, car la priorité de définition des variables est
Remarque : cela ne s'applique qu'à la bibliothèque Expat elle-même ; la construction de versions UTF-16 de xmlwf et des tests n'est actuellement pas prise en charge.
Remarque pour les utilisateurs de Solaris : la commande « ar » se trouve généralement dans « /usr/ccs/bin », qui n'est pas dans le PATH par défaut. Vous devrez l'ajouter à votre chemin pour la commande « make », et probablement aussi passer à GNU make (le « make » trouvé dans /usr/ccs/bin ne semble pas fonctionner correctement -- apparemment il ne comprend pas les directives .PHONY). Si vous utilisez ksh ou bash, utilisez cette commande pour construire :
PATH=/usr/ccs/bin:$PATH make
Lorsque vous utilisez Expat avec un projet utilisant autoconf pour la configuration, vous pouvez utiliser la macro de détection dans conftools/expat.m4 pour déterminer comment inclure Expat. Consultez les commentaires en haut de ce fichier pour plus d'informations.
Un manuel de référence est disponible dans le fichier doc/reference.html de cette distribution.
La page d'accueil de ce projet est http://www.libexpat.org/. Des liens vous y connectent à la page de signalement de bogues. Si vous devez signaler un bogue sans avoir accès à un navigateur, vous pouvez également envoyer un rapport de bogue par courrier électronique à [email protected].
Les discussions relatives à l'orientation du développement futur d'Expat ont lieu sur [email protected]. Les archives de cette liste et d'autres listes liées à Expat peuvent être consultées à l'adresse :
http://mail.libexpat.org/mailman/listinfo