trinadh465/external_lib_aosp10_r33_cve-2021-45960_cve-2021-46143-Biblioteca C para el análisis XML orientado a flujo, que proporciona un analizador rápido y configurable con soporte para manejadores personalizados y opciones de codificación.
Esto es Expat, una biblioteca en C para analizar XML, iniciada por James Clark en 1997. Expat es un analizador XML orientado a flujos. Esto significa que registras manejadores en el analizador antes de comenzar el análisis. Estos manejadores se invocan cuando el analizador descubre las estructuras asociadas en el documento que se está analizando. Una etiqueta de apertura es un ejemplo del tipo de estructuras para las cuales puedes registrar manejadores.
Los usuarios de Windows deben usar el
expat_win32 package,
que incluye tanto bibliotecas precompiladas como ejecutables, y código fuente para
desarrolladores.
Expat es software libre.
Puedes copiar, distribuir y modificarlo bajo los términos de la Licencia
contenida en el archivo
COPYING
distribuido con este paquete. Esta licencia es la misma que la licencia MIT/X Consortium.
Si estás compilando Expat desde un checkout del repositorio Git, necesitas ejecutar un script que genera el script configure utilizando las herramientas GNU autoconf y libtool. Para hacerlo, necesitas tener autoconf 2.58 o posterior. Ejecuta el script de la siguiente manera:
./buildconf.sh
Una vez hecho esto, sigue las mismas instrucciones que para compilar desde una distribución de código fuente.
Para compilar Expat desde una distribución de código fuente, primero ejecutas el script de shell de configuración en el directorio de distribución de nivel superior:
./configure
Hay muchas opciones que puedes proporcionar a configure (que puedes
descubrir ejecutando configure con la opción --help). Pero la
de mayor interés es la que establece el directorio de instalación.
Por defecto, el script configure configurará las cosas para instalar
libexpat en /usr/local/lib, expat.h en /usr/local/include, y
xmlwf en /usr/local/bin. Si, por ejemplo, prefieres instalar
en /home/me/mystuff/lib, /home/me/mystuff/include, y
/home/me/mystuff/bin, puedes decirle a configure eso con:
./configure --prefix=/home/me/mystuff
Otra opción interesante es habilitar el soporte de enteros de 64 bits para los números de línea y columna y el índice general de bytes:
./configure CPPFLAGS=-DXML_LARGE_SIZE
Sin embargo, tal modificación sería un cambio incompatible con la ABI y por lo tanto no se recomienda para uso general — p.ej. como parte de una distribución Linux — sino más bien para compilaciones con requisitos especiales.
Después de ejecutar el script configure, el comando make compilará
todo y make install instalará las cosas en su ubicación adecuada.
Echa un vistazo al Makefile para conocer opciones adicionales
de make. Ten en cuenta que necesitas tener permiso de escritura en
los directorios donde se instalarán las cosas.
Si estás interesado en compilar Expat para que proporcione información
de documentos en codificación UTF-16 en lugar del UTF-8 predeterminado, sigue
estas instrucciones (después de haber ejecutado make distclean).
Ten en cuenta que configuramos con --without-xmlwf ya que xmlwf no
soporta este modo de compilación (aún):
Aplica parches masivos a los archivos Makefile.am para usar libexpatw.la como nombre de biblioteca:
find -name Makefile.am -exec sed -e 's,libexpat\.la,libexpatw.la,' -e 's,libexpat_la,libexpatw_la,' -i {} +
Ejecuta automake para reescribir los archivos Makefile.in:
automake
Para salida UTF-16 como unsigned short (y cadenas de versión/error como char),
ejecuta:
./configure CPPFLAGS=-DXML_UNICODE --without-xmlwf
Para salida UTF-16 como wchar_t (incluyendo cadenas de versión/error), ejecuta:
./configure CFLAGS="-g -O2 -fshort-wchar" CPPFLAGS=-DXML_UNICODE_WCHAR_T --without-xmlwf
Nota: Esto último requiere libc compilado con -fshort-wchar, también.
Ejecuta make (que excluye xmlwf).
Ejecuta make install (de nuevo, excluye xmlwf).
Se soporta el uso de DESTDIR. Funciona de la siguiente manera:
make install DESTDIR=/path/to/image
anula el DESTDIR establecido en makefile, porque la prioridad de configuración de variables es
Nota: Esto solo se aplica a la propia biblioteca Expat; actualmente no se soporta la compilación de versiones UTF-16 de xmlwf y las pruebas.
Cuando uses Expat con un proyecto que use autoconf para la configuración,
puedes usar la macro de detección en conftools/expat.m4 para determinar cómo
incluir Expat. Consulta los comentarios al inicio de ese archivo para más
información.
Un manual de referencia está disponible en el archivo doc/reference.html en esta
distribución.