1
0
mirror of https://gitlab.gnome.org/GNOME/libxml2.git synced 2024-12-24 21:33:51 +03:00
XML parser and toolkit
Go to file
2023-10-02 15:04:18 +02:00
.gitlab-ci gitlab-ci: Revert accidental change to setup_mingw.sh 2022-12-21 22:30:25 +01:00
doc tests: Add ATTRIBUTE_NO_SANITIZE_INTEGER macro 2023-09-29 00:15:40 +02:00
example tests: Don't use deprecated symbols 2023-09-20 22:06:49 +02:00
fuzz fuzz: Disable XML_PARSE_SAX1 option in xml fuzzer 2023-09-30 14:45:53 +02:00
include parser: Fix initialization of namespace data 2023-10-02 12:33:29 +02:00
m4 Link with --undefined-version 2023-04-29 19:12:23 +02:00
os400 fix Schematron spelling 2022-05-06 10:44:03 +02:00
python error: Make xmlGetLastError return a const error 2023-09-22 13:29:07 +02:00
result tests: Add more tests for redefined attributes 2023-09-29 12:43:08 +02:00
test tests: Add more tests for redefined attributes 2023-09-29 12:43:08 +02:00
vms Remove remaining definitions of STDC_HEADERS 2022-04-20 19:18:17 +02:00
win32 globals: Use thread-local storage if available 2023-09-20 22:06:49 +02:00
xstc .gitignore: Split up and rearrange .gitignore files 2023-04-30 16:22:27 +02:00
.editorconfig Fix .editorconfig 2022-11-22 17:01:21 +01:00
.gitattributes Fix .gitattributes 2020-07-23 20:46:42 +02:00
.gitignore .gitignore: Split up and rearrange .gitignore files 2023-04-30 16:22:27 +02:00
.gitlab-ci.yml encoding: Suppress -Wcast-align warnings 2023-10-02 15:04:18 +02:00
autogen.sh Build Autotools CI tests out of source tree (VPATH) 2022-04-21 06:59:02 +02:00
buf.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
c14n.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
catalog.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
check-relaxng-test-suite2.py Stop calling xmlMemoryDump 2023-04-30 15:48:41 +02:00
check-relaxng-test-suite.py Stop calling xmlMemoryDump 2023-04-30 15:48:41 +02:00
check-xinclude-test-suite.py Use python3 not python 2022-12-07 13:21:12 +00:00
check-xml-test-suite.py Use python3 not python 2022-12-07 13:21:12 +00:00
check-xsddata-test-suite.py Stop calling xmlMemoryDump 2023-04-30 15:48:41 +02:00
chvalid.c libxml.h: Don't include stdio.h 2022-12-08 04:24:57 +01:00
chvalid.def Remove executable bit from non-executable files 2019-09-16 15:48:59 +02:00
CMakeLists.txt dict: Internal API to look up hash values 2023-09-29 12:43:08 +02:00
config.h.cmake.in dict: Use xoroshiro64** as PRNG 2023-09-01 14:52:04 +02:00
configure.ac dict: Internal API to look up hash values 2023-09-29 12:43:08 +02:00
Copyright hash: Rewrite hash table code 2023-09-29 02:25:57 +02:00
dbgen.pl add a Timingtests target to check bad behaviour from the streaming engine 2003-09-17 22:33:22 +00:00
dbgenattr.pl add a Timingtests target to check bad behaviour from the streaming engine 2003-09-17 22:33:22 +00:00
debugXML.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
dict.c dict: Compare strings with strncmp 2023-10-02 14:52:40 +02:00
encoding.c encoding: Suppress -Wcast-align warnings 2023-10-02 15:04:18 +02:00
entities.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
error.c error: Make xmlGetLastError return a const error 2023-09-22 13:29:07 +02:00
genChRanges.py libxml.h: Don't include stdio.h 2022-12-08 04:24:57 +01:00
gentest.py testapi: test_xmlSAXDefaultVersion() leaves xmlSAX2DefaultVersionValue set to 1 with LIBXML_SAX1_ENABLED 2023-06-10 10:55:38 -07:00
genUnicode.py Remove XMLCALL and XMLCDECL macros from public headers 2022-12-08 02:48:27 +01:00
globals.c parser: Fix reinitialization 2023-09-27 17:24:46 +02:00
hash.c malloc-fail: Grow hash tables before making allocations 2023-09-30 17:02:46 +02:00
HTMLparser.c parser: Simplify xmlStringCurrentChar 2023-09-22 19:01:11 +02:00
HTMLtree.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
legacy.c legacy: Add private declarations for stubs 2023-09-29 13:19:37 +02:00
libxml2-config.cmake.cmake.in cmake: Check whether static linking dependencies found in config files 2023-09-23 16:48:54 +01:00
libxml2-config.cmake.in cmake: Check whether static linking dependencies found in config files 2023-09-23 16:48:54 +01:00
libxml2.doap Remove broken VxWorks support 2022-03-01 17:18:56 +01:00
libxml2.syms libxml2.syms: Revert removal of version information 2023-04-29 18:59:41 +02:00
libxml-2.0-uninstalled.pc.in autoconf: Don't bake build time CFLAGS into pkg-config file 2023-09-04 22:14:02 +01:00
libxml-2.0.pc.in autoconf: Don't bake build time CFLAGS into pkg-config file 2023-09-04 22:14:02 +01:00
libxml.h tests: Add ATTRIBUTE_NO_SANITIZE_INTEGER macro 2023-09-29 00:15:40 +02:00
libxml.m4 libxml.m4: Fix "possibly undefined macro" error 2023-04-30 13:18:47 +02:00
list.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
MAINTAINERS.md doc: Add notes about runtest to MAINTAINERS.md 2023-09-29 16:07:45 +02:00
Makefile.am autoconf: fix iconv library paths 2023-05-06 12:26:17 -04:00
nanoftp.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
nanohttp.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
NEWS doc: Update MAINTAINERS and NEWS 2023-09-22 19:01:11 +02:00
parser.c parser: Fix initialization of namespace data 2023-10-02 12:33:29 +02:00
parserInternals.c parser: Fix initialization of namespace data 2023-10-02 12:33:29 +02:00
pattern.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
README.md doc: Improve documentation of configuration options 2023-08-21 11:13:33 +02:00
README.zOS Large batch of typo fixes 2019-09-30 18:04:38 +02:00
relaxng.c debug: Remove debugging code 2023-09-19 17:35:09 +02:00
rngparser.c Remove elfgcchack.h 2022-02-20 21:49:04 +01:00
runsuite.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
runtest.c build: Fix build when certain modules are disabled 2023-09-21 02:26:43 +02:00
runxmlconf.c error: Make xmlGetLastError return a const error 2023-09-22 13:29:07 +02:00
SAX2.c parser: Use hash tables to avoid quadratic behavior 2023-09-29 12:43:22 +02:00
SAX.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
schematron.c globals: Don't include SAX2.h from globals.h 2023-09-20 22:06:49 +02:00
testapi.c tests: Update testapi.c 2023-09-21 22:58:02 +02:00
testchar.c test: Add push parser test with overridden encoding 2023-08-08 15:19:49 +02:00
testdict.c hash: Add hash table tests 2023-09-29 00:15:40 +02:00
testdso.c warning patches from Peter Breitenlohner serious DTD parsing speedups, 2005-01-25 00:22:52 +00:00
testlimits.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
testModule.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
testOOM.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
testOOMlib.c Don't check for standard C89 headers 2022-03-02 00:43:54 +01:00
testOOMlib.h Remove unneeded #includes 2022-03-04 22:11:49 +01:00
testrecurse.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
testThreads.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
threads.c dict: Separate RNG code 2023-09-29 00:15:40 +02:00
timsort.h Large batch of typo fixes 2019-09-30 18:04:38 +02:00
tree.c doc: Make apibuild.py happy 2023-09-21 22:57:33 +02:00
trio.c Don't check for standard C89 headers 2022-03-02 00:43:54 +01:00
trio.h Fix typos 2020-03-08 17:41:53 +01:00
triodef.h Fix typos 2020-03-08 17:41:53 +01:00
trionan.c Fix typos 2020-03-08 17:41:53 +01:00
trionan.h Fix typos 2020-03-08 17:41:53 +01:00
triop.h Fix typos 2020-03-08 17:41:53 +01:00
triostr.c Fix typos 2020-03-08 17:41:53 +01:00
triostr.h Fix typos 2020-03-08 17:41:53 +01:00
uri.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
valid.c doc: Make apibuild.py happy 2023-09-21 22:57:33 +02:00
xinclude.c xinclude: Expand comment about fuzz timeouts 2023-09-30 15:47:46 +02:00
xlink.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
xml2-config.in build: Generate better pkg-config files for static-only builds 2023-09-03 08:52:36 +01:00
xmlcatalog.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
xmlIO.c globals: Move remaining globals back to correct header files 2023-09-20 22:06:49 +02:00
xmllint.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
xmlmemory.c memory: Fix memory debugging with Windows threads 2023-09-21 23:29:18 +02:00
xmlmodule.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
xmlreader.c xmlreader: Fix EOF detection in xmlTextReaderPushData 2023-09-21 16:29:28 +02:00
xmlregexp.c malloc-fail: Report malloc failure in xmlFARegExec 2023-09-29 00:15:40 +02:00
xmlsave.c doc: Make apibuild.py happy 2023-09-21 22:57:33 +02:00
xmlschemas.c error: Make xmlGetLastError return a const error 2023-09-22 13:29:07 +02:00
xmlschemastypes.c include: Remove more unnecessary includes 2023-09-21 01:50:53 +02:00
xmlstring.c string: Fix UTF-8 validation in xmlGetUTF8Char 2023-09-29 00:15:40 +02:00
xmlunicode.c Mark more static data as const 2022-04-07 12:01:23 -07:00
xmlwriter.c globals: Don't include SAX2.h from globals.h 2023-09-20 22:06:49 +02:00
xpath.c doc: Make apibuild.py happy 2023-09-21 22:57:33 +02:00
xpointer.c globals: Stop including globals.h 2023-09-20 22:07:40 +02:00
xzlib.c Stop using sprintf 2023-05-08 23:33:04 +02:00

libxml2

libxml2 is an XML toolkit implemented in C, originally developed for the GNOME Project.

Official releases can be downloaded from https://download.gnome.org/sources/libxml2/

The git repository is hosted on GNOME's GitLab server: https://gitlab.gnome.org/GNOME/libxml2

Bugs should be reported at https://gitlab.gnome.org/GNOME/libxml2/-/issues

Documentation is available at https://gitlab.gnome.org/GNOME/libxml2/-/wikis

License

This code is released under the MIT License, see the Copyright file.

Build instructions

libxml2 can be built with GNU Autotools, CMake, or several other build systems in platform-specific subdirectories.

Autotools (for POSIX systems like Linux, BSD, macOS)

If you build from a Git tree, you have to install Autotools and start by generating the configuration files with:

./autogen.sh [configuration options]

If you build from a source tarball, extract the archive with:

tar xf libxml2-xxx.tar.gz
cd libxml2-xxx

Then you can configure and build the library:

./configure [configuration options]
make

The following options disable or enable code modules and relevant symbols:

--with-c14n             Canonical XML 1.0 support (on)
--with-catalog          XML Catalogs support (on)
--with-debug            debugging module and shell (on)
--with-history          history support for shell (off)
--with-readline[=DIR]   use readline in DIR (for shell history)
--with-html             HTML parser (on)
--with-http             HTTP support (on)
--with-iconv[=DIR]      iconv support (on)
--with-icu              ICU support (off)
--with-iso8859x         ISO-8859-X support if no iconv (on)
--with-lzma[=DIR]       use liblzma in DIR (on)
--with-mem-debug        memory debugging module (off)
--with-modules          dynamic modules support (on)
--with-output           serialization support (on)
--with-pattern          xmlPattern selection interface (on)
--with-push             push parser interfaces (on)
--with-python           Python bindings (on)
--with-reader           xmlReader parsing interface (on)
--with-regexps          regular expressions support (on)
--with-run-debug        runtime debugging module (off)
--with-sax1             older SAX1 interface (on)
--with-schemas          XML Schemas 1.0 and RELAX NG support (on)
--with-schematron       Schematron support (on)
--with-threads          multithreading support (on)
--with-thread-alloc     per-thread malloc hooks (off)
--with-tree             DOM like tree manipulation APIs (on)
--with-valid            DTD validation support (on)
--with-writer           xmlWriter serialization interface (on)
--with-xinclude         XInclude 1.0 support (on)
--with-xpath            XPath 1.0 support (on)
--with-xptr             XPointer support (on)
--with-zlib[=DIR]       use libz in DIR (on)

Other options:

--with-minimum          build a minimally sized library (off)
--with-legacy           maximum ABI compatibility (off)

Note that by default, no optimization options are used. You have to enable them manually, for example with:

CFLAGS='-O2 -fno-semantic-interposition' ./configure

Now you can run the test suite with:

make check

Please report test failures to the mailing list or bug tracker.

Then you can install the library:

make install

At that point you may have to rerun ldconfig or a similar utility to update your list of installed shared libs.

CMake (mainly for Windows)

Another option for compiling libxml is using CMake:

cmake -E tar xf libxml2-xxx.tar.gz
cmake -S libxml2-xxx -B libxml2-xxx-build [possible options]
cmake --build libxml2-xxx-build
cmake --install libxml2-xxx-build

Common CMake options include:

-D BUILD_SHARED_LIBS=OFF            # build static libraries
-D CMAKE_BUILD_TYPE=Release         # specify build type
-D CMAKE_INSTALL_PREFIX=/usr/local  # specify the install path
-D LIBXML2_WITH_ICONV=OFF           # disable iconv
-D LIBXML2_WITH_LZMA=OFF            # disable liblzma
-D LIBXML2_WITH_PYTHON=OFF          # disable Python
-D LIBXML2_WITH_ZLIB=OFF            # disable libz

You can also open the libxml source directory with its CMakeLists.txt directly in various IDEs such as CLion, QtCreator, or Visual Studio.

Dependencies

Libxml does not require any other libraries. A platform with somewhat recent POSIX support should be sufficient (please report any violation to this rule you may find).

However, if found at configuration time, libxml will detect and use the following libraries:

  • libz, a highly portable and widely available compression library.
  • liblzma, another compression library.
  • libiconv, a character encoding conversion library. The iconv function is part of POSIX.1-2001, so libiconv isn't required on modern UNIX-like systems like Linux, BSD or macOS.
  • ICU, a Unicode library. Mainly useful as an alternative to iconv on Windows. Unnecessary on most other systems.

Contributing

The current version of the code can be found in GNOME's GitLab at at https://gitlab.gnome.org/GNOME/libxml2. The best way to get involved is by creating issues and merge requests on GitLab. Alternatively, you can start discussions and send patches to the mailing list. If you want to work with patches, please format them with git-format-patch and use plain text attachments.

All code must conform to C89 and pass the GitLab CI tests. Add regression tests if possible.

Authors

  • Daniel Veillard
  • Bjorn Reese
  • William Brack
  • Igor Zlatkovic for the Windows port
  • Aleksey Sanin
  • Nick Wellnhofer