RTLD(1) NetBSD Reference Manual RTLD(1) NNAAMMEE lldd..ssoo - run-time link-editor DDEESSCCRRIIPPTTIIOONN lldd..ssoo is a self-contained, position independent program image providing run-time support for loading and link-editing shared objects into a pro- cess' address space. It uses the data structures (see link(5)) contained within dynamically linked programs to determine which shared libraries are needed and loads them at a convenient virtual address using the mmap(2) system call. After all shared libraries have been succesfully loaded, lldd..ssoo proceeds to resolve external references from both the main program and all objects loaded. A mechanism is provided for initialisation routines to be called, on a per-object basis, giving a shared object an opportunity to perform any extra set-up, before execution of the program proper begins. lldd..ssoo looks for a symbol named _._i_n_i_t in each object's symbol table. If present, this symbol is assumed to represent a C-function declared as _v_o_i_d ..iinniitt(_v_o_i_d), which is then called. Similarly, a _v_o_i_d ..ffiinnii(_v_o_i_d) function is called just before an object is unloaded from the process address space as a result of calling dlclose(3). Note that while an object's _._i_n_i_t is always called, whether the object is loaded automatically at program startup or programatically by using dlopen(3), the _._f_i_n_i func- tion is called only on `last dlclose(3)'. This mechanism is exploited by the system-supplied C++ constructor ini- tialization code located in _/_u_s_r_/_l_i_b_/_c_+_+_r_t_._o. This file should be includ- ed in the list of object-code files passed to ld(1) when building a shared C++ library. lldd..ssoo is itself a shared object that is initially loaded by the startup module _c_r_t_0. Since a.out(5) formats do not provide easy access to the file header from within a running process, _c_r_t_0 uses the special symbol ___D_Y_N_A_M_I_C to determine whether a program is in fact dynamically linked or not. Whenever the linker ld(1) has relocated this symbol to a location other than 0, _c_r_t_0 assumes the services of lldd..ssoo are needed (see link(5) for details). _c_r_t_0 passes control to rrttlldd's entry point before the pro- gram's mmaaiinn() routine is called. Thus, lldd..ssoo can complete the link-edit- ing process before the dynamic program calls upon services of any dynamic library. To quickly locate the required shared objects in the filesystem, lldd..ssoo may use a ``hints'' file, prepared by the ldconfig(8) utility, in which the full path specification of the shared objects can be looked up by hashing on the 3-tuple . lldd..ssoo recognises a number of environment variables that can be used to modify its behaviour as follows: LD_LIBRARY_PATH A colon separated list of directories, overriding the default search path for shared libraries. LD_WARN_NON_PURE_CODE When set, issue a warning whenever a link-editing operation requires modifi- cation of the text segment of some loaded object. This is usually indica- tive of an incorrectly built library. LD_SUPPRESS_WARNINGS When set, no warning messages of any kind are issued. Normally, a warning is given if satisfactorily versioned li- brary could not be found. LD_TRACE_LOADED_OBJECTS When set, causes lldd..ssoo to exit after loading the shared objects and printing a summary which includes the absolute pathnames of all objects, to standard output. LD_TRACE_LOADED_OBJECTS_FMT1 LD_TRACE_LOADED_OBJECTS_FMT2 When set, these variables are inter- preted as format strings a la printf(3) to customize the trace output and are used by ldd(1)'s --ff option and allows ldd(1) to be operated as a filter more conveniently. The following conver- sions can be used: %a The main program's name (also known as``__progname''). %A The value of the environment variable LD_TRACE_LOADED_OBJECTS_PROGNAME %o The libary name. %m The library's major version num- ber. %n The library's minor version num- ber. %p The full pathname as determined by rrttlldd's library search rules. %x The library's load address. Additionally, \\nn and \\tt are recognised and have their usual meaning. LD_NO_INTERN_SEARCH When set, lldd..ssoo does not process any internal search paths that were record- ed in the executable. LD_NOSTD_PATH When set, do not include a set of built-in standard directory paths for searching. This might be useful when running on a system with a completely non-standard filesystem layout. FFIILLEESS /var/run/ld.so.hints library location hints built by ldconfig(8) SSEEEE AALLSSOO ld(1), link(5), ldconfig(8) HHIISSTTOORRYY The shared library model employed first appeared in SunOS 4.0. NetBSD June 27, 1995 2