trinadh465/external_expat-2.1.0_cve-2022-43680Dépôt de code source pour Expat 2.1.0, une bibliothèque d'analyse XML orientée flux, avec un accent sur l'analyse et le traitement de CVE-2022-43680.
Expat, version 2.1.0
Ceci est Expat, une bibliothèque C pour l'analyse syntaxique du 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 en cours d'analyse. 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 inclut à la fois des bibliothèques et 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 qui ont un numéro de version mineur 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 avec des numéros de version mineur pairs sont destinées à être des logiciels de qualité production.
Si vous construisez Expat à partir d'un extrait 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 avoir 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 la 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 distribution de plus haut niveau :
./configure
Il existe de nombreuses options que vous pouvez fournir à configure (vous pouvez les 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 est d'activer le support des entiers 64 bits pour les numéros de ligne et de colonne ainsi que l'index global en octets :
./configure CPPFLAGS=-DXML_LARGE_SIZE
Cependant, une telle modification serait un changement cassant pour l'ABI et n'est donc pas recommandée pour une utilisation générale - 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 choses et "make install" les installera à leur emplacement approprié. Jetez un coup d'œil au "Makefile" pour en savoir plus sur les options supplémentaires de "make". Notez que vous devez avoir la permission d'écriture dans les répertoires dans lesquels les choses seront installées.
Si vous êtes intéressé par la construction d'Expat pour fournir des informations de document en encodage UTF-16 plutôt que l'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 les chaînes de version/erreur en char), exécutez :
./configure CPPFLAGS=-DXML_UNICODE
Pour une sortie UTF-16 en wchar_t (incluant les chaînes de version/erreur), exécutez :
./configure CFLAGS="-g -O2 -fshort-wchar" \
CPPFLAGS=-DXML_UNICODE_WCHAR_T
2. Modifiez le MakeFile, en changeant :
LIBRARY = libexpat.la
to:
LIBRARY = libexpatw.la
(Notez le "w" supplémentaire dans le nom de la bibliothèque.)
3. Exécutez "make buildlib" (qui construit la bibliothèque uniquement). Ou, pour économiser l'étape 2, exécutez "make buildlib LIBRARY=libexpatw.la".
4. Exécutez "make installlib" (qui installe la bibliothèque uniquement). 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 pour DESTDIR, et le reste du fichier make utilisant uniquement DESTDIR. Cela fonctionne comme suit : $ make install DESTDIR=/path/to/image overrides the in-makefile set DESTDIR, while both $ INSTALL_ROOT=/path/to/image make install $ make install INSTALL_ROOT=/path/to/image use DESTDIR=$(INSTALL_ROOT), even if DESTDIR eventually is defined in the environment, because variable-setting priority is
Note : Cela s'applique uniquement à la bibliothèque Expat elle-même, la construction des versions UTF-16 de xmlwf et des tests n'est actuellement pas prise en charge.
Note pour les utilisateurs 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 PATH pour la commande "make", et probablement aussi passer à GNU make (le "make" de /usr/ccs/bin ne semble pas fonctionner correctement -- il ne comprend apparemment 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 sondage 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/. Il y a des liens qui vous mènent à la page des rapports de bogues. Si vous devez signaler un bogue sans avoir accès à un navigateur, vous pouvez également envoyer un rapport de bogue par courriel à [email protected].
Les discussions concernant l'orientation du futur développement d'Expat ont lieu sur [email protected]. Les archives de cette liste et d'autres listes liées à Expat peuvent être trouvées à :
http://mail.libexpat.org/mailman/listinfo/