genode/repos/libports
2023-03-15 17:02:51 +01:00
..
doc tool: remove deprecated 'make prepare' mechanism 2016-03-17 17:02:04 +01:00
include libports: freestanding 'format' string library 2023-03-13 14:32:53 +01:00
lib libusb: fix constructor order in vfs_libusb 2023-03-13 14:32:53 +01:00
ports qt5: up-mix mono audio output data in QtWebEngine OSS backend 2023-02-27 08:22:45 +01:00
recipes depot: update recipe hashes 2023-03-13 14:32:54 +01:00
run libusb: fix constructor order in vfs_libusb 2023-03-13 14:32:53 +01:00
src test-libc_fifo_pipe: increase buffer size 2023-03-15 17:02:51 +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.