genode/repos/os/src/lib/ldso
Norman Feske ca971bbfd8 Move repositories to 'repos/' subdirectory
This patch changes the top-level directory layout as a preparatory
step for improving the tools for managing 3rd-party source codes.
The rationale is described in the issue referenced below.

Issue #1082
2014-05-14 16:08:00 +02:00
..
arch Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
arm Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
contrib Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
include Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
startup Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
README Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
call_program_main.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
dl_extensions.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
environ.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
err.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
file.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
file.h Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
ldso.ld Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
ldso_types.c Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
lock.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
main.c Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
platform.c Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
rtld_dummies.c Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
stdio.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
stdlib.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
string.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
symbol.map Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
target.inc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00
test.cc Move repositories to 'repos/' subdirectory 2014-05-14 16:08:00 +02:00

README

This directory contains the port of the dynamic linker (ldso) from FreeBSD.


Usage
-----

To build a shared library instead of a regular static library, you just need to
declare 'SHARED_LIB = yes' in the library-description file.  When doing so, a
'<libname>.lib.so' file will be generated and installed in the
'<build-dir>/bin/' directory.  For building an executable that uses a shared
library, no special precautions are needed. The build system will automatically
detect the use of shared libraries, concludes that the binary must be
dynamically linked, and will use the correct linker script.  When loading a
dynamically linked program, the dynamic linker 'lsdo' and all used shared
objects must be loaded as well.

Debugging dynamic binaries with GDB stubs
-----------------------------------------

! # start GDB with binary to debug
! gdb <path to binary>
!
! # break in main routine
! b main
!
! # inspect loaded shared libraries
! info sharedlibrary
!
! # load shared symbols of shared libaries
! share
!
! # from here you can debug within libraries

:Known issues:

GDB 7.2 has a regression bug in its line information parser. These issue has
been fixed with version 7.3.