satheesh575555/external_expat_aosp10_r33_cve-2022-23990Biblioteca C para análise de XML, especificamente corrigida para CVE-2022-23990, fornecendo uma implementação de referência para análise de vulnerabilidade e práticas de codificação segura.
Este é o Expat, uma biblioteca em C para análise de XML, iniciada por James Clark em 1997. O Expat é um analisador de XML orientado a fluxo. Isso significa que você registra manipuladores (handlers) no analisador antes de iniciar a análise. Esses manipuladores são chamados quando o analisador descobre as estruturas associadas no documento que está sendo analisado. Uma tag de abertura é um exemplo do tipo de estruturas para as quais você pode registrar manipuladores.
Os usuários de Windows devem usar o
expat_win32 package,
que inclui bibliotecas e executáveis pré-compilados, além do código-fonte para
desenvolvedores.
O Expat é um software livre.
Você pode copiá-lo, distribuí-lo e modificá-lo sob os termos da Licença
contida no arquivo
COPYING
distribuído com este pacote.
Esta licença é a mesma da licença MIT/X Consortium.
Se você estiver compilando o Expat a partir de um checkout do repositório Git, você precisa executar um script que gera o script configure usando as ferramentas GNU autoconf e libtool. Para isso, você precisa ter autoconf 2.58 ou mais recente. Execute o script desta forma:
./buildconf.sh
Depois que isso for feito, siga as mesmas instruções para compilar a partir de uma distribuição de código-fonte.
Para compilar o Expat a partir de uma distribuição de código-fonte, você primeiro executa o script de configuração shell no diretório de nível superior da distribuição:
./configure
Há muitas opções que você pode fornecer ao configure (que você pode
descobrir executando o configure com a opção --help). Mas a
mais interessante é a que define o diretório de instalação.
Por padrão, o script configure configurará a instalação da
libexpat em /usr/local/lib, expat.h em /usr/local/include, e
xmlwf em /usr/local/bin. Se, por exemplo, você preferir instalar
em /home/me/mystuff/lib, /home/me/mystuff/include, e
/home/me/mystuff/bin, você pode informar isso ao configure com:
./configure --prefix=/home/me/mystuff
Outra opção interessante é habilitar o suporte a inteiros de 64 bits para números de linha e coluna e o índice geral de bytes:
./configure CPPFLAGS=-DXML_LARGE_SIZE
No entanto, tal modificação seria uma mudança quebra de compatibilidade na ABI e, portanto, não é recomendada para uso geral — por exemplo, como parte de uma distribuição Linux — mas sim para compilações com requisitos especiais.
Depois de executar o script configure, o comando make compilará
as coisas e make install instalará tudo no local adequado.
Dê uma olhada no Makefile para aprender sobre opções adicionais
do make. Observe que você precisa ter permissão de escrita nos
diretórios onde as coisas serão instaladas.
Se você tiver interesse em compilar o Expat para fornecer informações
de documento em codificação UTF-16 em vez do UTF-8 padrão, siga
estas instruções (após ter executado make distclean).
Observe que configuramos com --without-xmlwf, pois o xmlwf ainda não
suporta este modo de compilação:
Aplique um patch em massa nos arquivos Makefile.am para usar libexpatw.la como nome da biblioteca:
find -name Makefile.am -exec sed -e 's,libexpat\.la,libexpatw.la,' -e 's,libexpat_la,libexpatw_la,' -i {} +
Execute automake para reescrever os arquivos Makefile.in:
automake
Para saída UTF-16 como unsigned short (e strings de versão/erro como char),
execute:
./configure CPPFLAGS=-DXML_UNICODE --without-xmlwf
Para saída UTF-16 como wchar_t (incluindo strings de versão/erro), execute:
./configure CFLAGS="-g -O2 -fshort-wchar" CPPFLAGS=-DXML_UNICODE_WCHAR_T --without-xmlwf
Nota: este último requer libc compilada com -fshort-wchar, também.
Execute make (que exclui o xmlwf).
Execute make install (novamente, exclui o xmlwf).
O uso de DESTDIR é suportado. Funciona da seguinte forma:
make install DESTDIR=/path/to/image
substitui o DESTDIR definido no makefile, porque a prioridade de definição de variáveis é
Nota: Isso se aplica apenas à própria biblioteca Expat; atualmente não é suportado compilar versões UTF-16 do xmlwf e dos testes.
Ao usar o Expat com um projeto que utiliza autoconf para configuração, você
pode usar a macro de sondagem em conftools/expat.m4 para determinar como
incluir o Expat. Veja os comentários no topo desse arquivo para mais
informações.
Um manual de referência está disponível no arquivo doc/reference.html nesta
distribuição.