trinadh465/external_expat-2.1.0_cve-2022-43680Repositório de código-fonte para Expat 2.1.0, uma biblioteca de análise XML orientada a fluxo, com foco na análise e tratamento de CVE-2022-43680.
Expat, Release 2.1.0
Este é o Expat, uma biblioteca C para análise de XML, escrita por James Clark. Expat é um analisador XML orientado a fluxo. Isso significa que você registra manipuladores com o analisador antes de iniciar a análise. Esses manipuladores são chamados quando o analisador descobre as estruturas associadas no documento sendo analisado. Uma tag de abertura é um exemplo do tipo de estruturas para as quais você pode registrar manipuladores.
Usuários do Windows devem usar o pacote expat_win32bin, que inclui bibliotecas pré-compiladas e executáveis, e código-fonte para desenvolvedores.
Expat é software livre. Você pode copiar, distribuir 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.
Versões do Expat que têm um número de versão menor ímpar (o número do meio na versão acima) são versões de desenvolvimento e devem ser consideradas como software beta. Versões com números de versão menor pares são destinadas a ser software de nível de produção.
Se você está compilando o Expat a partir de um checkout do repositório CVS, você precisa executar um script que gera o script configure usando as ferramentas GNU autoconf e libtool. Para fazer isso, você precisa ter autoconf 2.58 ou mais recente. Execute o script assim:
./buildconf.sh
Depois disso, siga as mesmas instruções para compilar a partir de uma distribuição de fonte.
Para compilar o Expat a partir de uma distribuição de fonte, primeiro execute o script de configuração shell no diretório de distribuição de nível superior:
./configure
Existem muitas opções que você pode fornecer ao configure (que você pode descobrir executando o configure com a opção --help). Mas a de maior interesse é aquela que define o diretório de instalação. Por padrão, o script configure configurará para instalar 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 ao configure sobre isso 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 que quebra a 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.
Após executar o script configure, o comando "make" compilará as coisas e "make install" instalará as coisas em seus devidos lugares. 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ê está interessado em compilar o Expat para fornecer informações de documento na codificação UTF-16 em vez do UTF-8 padrão, siga estas instruções (após ter executado "make distclean"):
1. Para saída UTF-16 como unsigned short (e strings de versão/erro
como char), execute:
./configure CPPFLAGS=-DXML_UNICODE
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
2. Edite o MakeFile, alterando:
LIBRARY = libexpat.la
para:
LIBRARY = libexpatw.la
(Observe o "w" adicional no nome da biblioteca.)
3. Execute "make buildlib" (que compila apenas a biblioteca).
Ou, para pular a etapa 2, execute "make buildlib LIBRARY=libexpatw.la".
4. Execute "make installlib" (que instala apenas a biblioteca).
Ou, se a etapa 2 foi omitida, execute "make installlib LIBRARY=libexpatw.la".
O uso de DESTDIR ou INSTALL_ROOT é ativado, com INSTALL_ROOT sendo o valor padrão para DESTDIR, e o resto do arquivo make usando apenas DESTDIR. Funciona da seguinte forma: $ make install DESTDIR=/path/to/image substitui o DESTDIR definido no makefile, enquanto ambos $ INSTALL_ROOT=/path/to/image make install $ make install INSTALL_ROOT=/path/to/image usam DESTDIR=$(INSTALL_ROOT), mesmo que DESTDIR eventualmente esteja definido no ambiente, porque a prioridade de definição de variáveis é
Nota: Isso se aplica apenas à própria biblioteca Expat, a compilação de versões UTF-16 do xmlwf e dos testes atualmente não é suportada.
Nota para usuários Solaris: O comando "ar" geralmente está localizado em "/usr/ccs/bin", que não está no PATH padrão. Você precisará adicionar isso ao seu PATH para o comando "make", e provavelmente também mudar para GNU make (o "make" encontrado em /usr/ccs/bin parece não funcionar corretamente -- aparentemente ele não entende diretivas .PHONY). Se você estiver usando ksh ou bash, use este comando para compilar:
PATH=/usr/ccs/bin:$PATH make
Ao usar Expat com um projeto que usa autoconf para configuração, você pode usar a macro de sondagem em conftools/expat.m4 para determinar como incluir 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.
A página inicial deste projeto é http://www.libexpat.org/. Há links lá que o conectam à página de relatórios de bugs. Se você precisar relatar um bug quando não tiver acesso a um navegador, também pode enviar um relatório de bug por e-mail para [email protected].
Discussões relacionadas à direção do desenvolvimento futuro do expat ocorrem em [email protected]. Arquivos desta lista e outras listas relacionadas ao Expat podem ser encontrados em:
http://mail.libexpat.org/mailman/listinfo/