genode/repos/libports
2023-05-30 12:03:30 +02:00
..
doc tool: remove deprecated 'make prepare' mechanism 2016-03-17 17:02:04 +01:00
include stdcxx/riscv: update to version 12.3.0 2023-05-30 12:03:28 +02:00
lib libport: remove icu library 2023-05-30 12:03:30 +02:00
ports libports: update ada-runtime .ali files for GCC 12 2023-05-30 12:03:30 +02:00
recipes libport: remove icu library 2023-05-30 12:03:30 +02:00
run qt5: create 'bin' directory in test run scripts 2023-05-08 15:55:34 +02:00
src libc: replace enum by static constexpr (C++20) 2023-05-30 12:03:29 +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.