genode/repos/libports
Josef Söntgen 9d989b1557 fetchurl: add 'ignore_failures' option
This option is useful in cases where batching is configured and
failing to fetch a resource should not influence the over-all
result.

Issue genodelabs/genodians.org#32.
2023-12-01 10:43:45 +01:00
..
doc libports: update doc/libc.txt 2023-05-30 12:03:33 +02:00
include libyuv: add support to overwrite default allocator 2023-10-04 13:22:06 +02:00
lib mk: create separate debug info files 2023-11-28 14:24:24 +01:00
ports libyuv: add support to overwrite default allocator 2023-10-04 13:22:06 +02:00
recipes depot: update recipe hashes 2023-11-30 15:11:36 +01:00
run Supplement the build of shared libs where needed 2023-11-28 14:44:29 +01:00
src fetchurl: add 'ignore_failures' option 2023-12-01 10:43:45 +01: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.