genode/repos/libports/src/test/python
Norman Feske 4da52517c1 Simpify startup of dynamically linked binaries
This patch removes the component_entry_point library, which used to
proved a hook for the libc to intercept the call of the
'Component::construct' function. The mechansim has several shortcomings
(see the discussion in the associated issue) and was complex. So we
eventually discarded the approach in favor of the explicit handling of
the startup.

A regular Genode component provides a 'Component::construct' function,
which is determined by the dynamic linker via a symbol lookup.
For the time being, the dynamic linker falls back to looking up a 'main'
function if no 'Component::construct' function could be found.

The libc provides an implementation of 'Component::construct', which
sets up the libc's task handling and finally call the function
'Libc::Component::construct' from the context of the appllication task.
This function is expected to be provided by the libc-using application.
Consequently, Genode components that use the libc have to implement the
'Libc::Component::construct' function.

The new 'posix' library provides an implementation of
'Libc::Component::construct' that calls a main function. Hence, POSIX
programs that merely use the POSIX API merely have to add 'posix' to the
'LIBS' declaration in their 'target.mk' file. Their execution starts at
'main'.

Issue #2199
2017-01-13 13:06:52 +01:00
..
main.cc base: avoid use of deprecated base/printf.h 2016-08-29 17:27:10 +02:00
README tool: remove deprecated 'make prepare' mechanism 2016-03-17 17:02:04 +01:00
target.mk Simpify startup of dynamically linked binaries 2017-01-13 13:06:52 +01:00

This directory contains a sample python interpreter called 'test-python'.

When building this test program, a shared library 'python.lib.so' will be
generated. This library is based on the original code of Python-2.6.4 available
from the Python website.

:Python website: [http://www.python.org]

Usage
-----
Call './tool/ports/prepare_port libc python' from within Genode's toplevel
directory. Add 'libports' to your build.conf file. A sample Genode configuration
is provided with the 'python.run' script located at 'libports/run/'. It starts a
Python script can be found within this directory. If you are not using Linux as
a Genode base platform, do not forget to add 'python.lib.so' to your boot module
list.

Limitations
-----------
Currently, this Python port does not feature any standard modules or the import
of any modules from a Python script.