DLL Programmer's Guide for TNS/E Systems

Advanced DLL Facility Controls
DLL Programmer’s Guide for TNS/E Systems—527252-006
5-13
Load-Time Operation
-map tells the linker to report the virtual addresses and sizes of the segments and the
sections, within each segment, of a loadfile being built. Further, the linker shows
the library and file names of all liblisted libraries. -m is a synonym for -map.
Load-Time Operation
To load a program and its DLLs, the system is commanded simply to load the program.
The loader automatically ensures that the program’s entire loadList is loaded and that
all symbols are resolved with proper bindings.
Controlling the Loader’s Search Path at Load Time
Like the linker (eld), the loader (rld) searches for DLLs, but the loader does it
according to rld’s search path, which was initially specified when the loadfile was
linked; see The Link-Time-Defined Search Path of the Loader on page 2-17. To this
path, other directories or subvolumes may be added at load time as follows.
On OSS, you can specify the following environmental variables:
EXPORT _RLD_FIRST_LIB_PATH=path1[:path2]...
EXPORT _RLD_LIB_PATH=path1[:path2]...
where path1, path2, etc. are the paths the loader is to search.
On Guardian, you can use the following Search Class Defines, specified according to
the Guardian Programmers Guide.
ADD DEFINE =_RLD_FIRST_LIB_PATH
ADD DEFINE =_RLD_LIB_PATH
The list of paths is the set of subvolumes specified by the define's attributes in the
order SUBVOL0, RELSUBVOL0, SUBVOL1, ..., RELSUBVOL20. Each attribute can
specify a single subvolume or a parenthesized, comma-separated list of subvolumes.
Any attributes unspecified are ignored.
For example the following TACL statements specify search list $A.B:$B.C:$C.D:$D.E:
SET CLASS SEARCH, SUBVOL0 $A.B, RELSUBVOL0 $B.C, &
SUBVOL1 ($C.D,$D.E)
ADD DEFINE = _RLD_FIRST_LIB_PATH
The same list can be specified more simply with a single statement and single
attribute:
ADD DEFINE =_RLD_LIB_PATH, CLASS SEARCH, &
SUBVOL0 ($A.B,$B.C,$C.D,$D.E)
No blank spaces are permitted within the parenthesized list.