shaikusaf/external_expact_aosp10_r33_cve-2022-25315XML 파싱용 C 라이브러리로, CVE-2022-25315용으로 패치되었으며 효율적인 문서 처리를 위한 핸들러가 있는 스트림 지향 XML 파싱을 제공합니다.
Expat는 XML을 파싱하기 위한 C 라이브러리로, 1997년 James Clark에 의해 시작되었습니다. Expat는 스트림 지향 XML 파서입니다. 즉, 파싱을 시작하기 전에 파서에 핸들러를 등록합니다. 이 핸들러는 파서가 파싱 중인 문서에서 관련 구조를 발견할 때 호출됩니다. 시작 태그는 핸들러를 등록할 수 있는 구조의 한 예입니다.
Windows 사용자는 expat_win32 패키지를 사용해야 합니다.
이 패키지에는 사전 컴파일된 라이브러리와 실행 파일, 그리고 개발자를 위한 소스 코드가 포함되어 있습니다.
Expat는 자유 소프트웨어입니다.
이 패키지와 함께 배포되는 파일 COPYING에 포함된 라이선스 조건에 따라 복사, 배포 및 수정할 수 있습니다.
이 라이선스는 MIT/X Consortium 라이선스와 동일합니다.
Git 저장소에서 체크아웃하여 Expat를 빌드하는 경우, GNU autoconf 및 libtool 도구를 사용하여 configure 스크립트를 생성하는 스크립트를 실행해야 합니다. 이를 위해서는 autoconf 2.58 이상이 필요합니다. 다음과 같이 스크립트를 실행하십시오:
./buildconf.sh
이 작업이 완료되면 소스 배포판에서 빌드하는 것과 동일한 지침을 따르십시오.
소스 배포판에서 Expat를 빌드하려면 먼저 최상위 배포 디렉토리에서 구성 셸 스크립트를 실행하십시오:
./configure
configure에 제공할 수 있는 많은 옵션이 있습니다(--help 옵션으로 실행하면 확인 가능).
하지만 가장 관심 있는 옵션은 설치 디렉토리를 설정하는 것입니다.
기본적으로 configure 스크립트는 libexpat를 /usr/local/lib에, expat.h를 /usr/local/include에, xmlwf를 /usr/local/bin에 설치하도록 설정합니다.
예를 들어, /home/me/mystuff/lib, /home/me/mystuff/include, /home/me/mystuff/bin에 설치하려면 다음과 같이 configure에 알릴 수 있습니다:
./configure --prefix=/home/me/mystuff
또 다른 흥미로운 옵션은 라인 및 컬럼 번호와 전체 바이트 인덱스에 대한 64비트 정수 지원을 활성화하는 것입니다:
./configure CPPFLAGS=-DXML_LARGE_SIZE
그러나 이러한 수정은 ABI에 대한 변경을 초래하므로 일반적인 사용(예: Linux 배포판의 일부)에는 권장되지 않으며, 특별한 요구 사항이 있는 빌드에만 권장됩니다.
configure 스크립트를 실행한 후 make 명령으로 빌드하고 make install로 적절한 위치에 설치합니다.
추가 make 옵션을 알아보려면 Makefile을 확인하십시오.
설치할 디렉토리에 대한 쓰기 권한이 필요합니다.
기본 UTF-8 대신 UTF-16 인코딩으로 문서 정보를 제공하도록 Expat를 빌드하려면 다음 지침을 따르십시오(make distclean 실행 후).
xmlwf가 아직 이 컴파일 모드를 지원하지 않으므로 --without-xmlwf로 구성한다는 점에 유의하십시오:
라이브러리 이름으로 libexpatw.la를 사용하도록 Makefile.am 파일을 대량 패치합니다:
find -name Makefile.am -exec sed -e 's,libexpat\.la,libexpatw.la,' -e 's,libexpat_la,libexpatw_la,' -i {} +
automake를 실행하여 Makefile.in 파일을 다시 작성합니다:
automake
unsigned short(그리고 버전/에러 문자열은 char)로 UTF-16 출력을 하려면 다음을 실행합니다:
./configure CPPFLAGS=-DXML_UNICODE --without-xmlwf
wchar_t로 UTF-16 출력을 하려면(버전/에러 문자열 포함) 다음을 실행합니다:
./configure CFLAGS="-g -O2 -fshort-wchar" CPPFLAGS=-DXML_UNICODE_WCHAR_T --without-xmlwf
참고: 후자는 libc도 -fshort-wchar로 컴파일되어야 합니다.
make를 실행합니다(xmlwf 제외).
make install을 실행합니다(역시 xmlwf 제외).
DESTDIR 사용이 지원됩니다. 다음과 같이 작동합니다:
make install DESTDIR=/path/to/image
in-makefile에 설정된 DESTDIR을 재정의합니다. 변수 설정 우선순위는
참고: 이것은 Expat 라이브러리 자체에만 적용되며, xmlwf 및 테스트의 UTF-16 버전 빌드는 현재 지원되지 않습니다.
autoconf를 사용하여 구성을 하는 프로젝트에서 Expat를 사용할 때, conftools/expat.m4의 탐지 매크로를 사용하여 Expat를 포함하는 방법을 결정할 수 있습니다.
자세한 내용은 해당 파일의 상단 주석을 참조하십시오.
참조 매뉴얼은 이 배포판의 doc/reference.html 파일에서 확인할 수 있습니다.