genode/os/src/lib/ldso
Alexander Boettcher bab1663ea2 ldso: be quiet by default 2013-08-22 15:13:12 +02:00
..
arch Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
arm crt0 cleanup 2013-07-05 12:37:43 +02:00
contrib Imported Genode release 11.11 2011-12-22 16:19:25 +01:00
include crt0 cleanup 2013-07-05 12:37:43 +02:00
startup Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
x86_32 crt0 cleanup 2013-07-05 12:37:43 +02:00
x86_64 crt0 cleanup 2013-07-05 12:37:43 +02:00
README Imported Genode release 11.11 2011-12-22 16:19:25 +01:00
dl_extensions.h Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
environ.cc Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
err.cc Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
file.cc ldso: increase 'MEM_SIZE' in 'mmap()' 2013-08-15 09:22:49 +02:00
file.h Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
ldso.ld Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
ldso_types.c Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
lock.cc Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
main.c ldso: be quiet by default 2013-08-22 15:13:12 +02:00
platform.c Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
rtld_dummies.c Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
stdio.cc Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
stdlib.cc Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
string.cc Update copyright headers to 2013 2013-01-10 21:44:47 +01:00
symbol.map NOVA: cleanup - remove _first_sel special handling 2012-10-08 15:08:12 +02:00
target.inc Merge base libraries into a single library 2013-02-19 14:45:55 +01:00
test.cc Update copyright headers to 2013 2013-01-10 21:44:47 +01: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.