genode/repos/libports
Johannes Schlatow 16b863fc6e tool/run: use xmlcatalog for xsd file paths
With libxml2 >= 2.13, the `-path` argument can no longer be used for
setting search paths for xsd files. Instead, we use an XML catalog to
replace genode:// URIs with absolute paths.

Fixes #5248
2024-06-20 12:56:20 +02:00
..
doc libports: update doc/libc.txt 2023-05-30 12:03:33 +02:00
include Remove Xml_node::attribute accessors 2024-06-20 12:56:19 +02:00
lib qt5: adapt to C++20 API changes 2024-06-20 12:54:30 +02:00
ports qt5: adapt to C++20 API changes 2024-06-20 12:54:30 +02:00
recipes Rename src/drivers to src/driver 2024-06-20 12:54:30 +02:00
run acpi_suspend: add wifi support 2024-06-20 12:54:30 +02:00
src tool/run: use xmlcatalog for xsd file paths 2024-06-20 12:56:20 +02:00
README Update README files 2023-03-13 14:32:53 +01:00

This directory contains ports of 3rd-party libraries to Genode.


Usage
-----

The tool './tool/ports/prepare_port' in the toplevel directory automates the
task of downloading and preparing the 3rd-party source codes. One can select
individual ports that have to be prepared by specifying their base names
(without the version number) as command-line argument. For example, the
following command prepares both the C library and the Freetype library:
! ./tool/ports/prepare_port libc freetype

To compile and link against 3rd-party libraries of the 'libports' repository,
you have to include the repository into the build process by appending it to the
'REPOSITORIES' declaration of your '<build-dir>/etc/build.conf' file.


Under the hood
--------------

For each library, there is a file contained in the 'libports/ports/'
subdirectory. The file is named after the library and contains the
library-specific rules for downloading the source code and installing header
files.


How does 'libports' relate to the other repositories?
-----------------------------------------------------

Most libraries hosted in the 'libports' repository expect a complete C
library, which is provided via the 'libc' port. The libc, in turn, depends on
the 'os' repository for its back end.