Guardian Native C Library Calls Reference Manual (G06.28+, H06.05+)

Guardian Native C Library Calls (a - e) dlopen(3)

4. Locations speciﬁed by -rld_l at link time (the value of rpath)

5. Default locations:

On OSS: /lib:/usr/lib:/usr/local/lib:/G/SYSTEM/ZDLL

On Guardian: $SYSTEM.ZDLL

Environment Variables and Runtime Searches

At run time, users can modify the path list speciﬁed at link time. For OSS programs, the load-

time path lists can be speciﬁed using the following environment variables:

_RLD_LIB_PATH=object_pathname[:object_pathname]...

The speciﬁed paths are to be searched before the default locations.

_RLD_FIRST_LIB_PATH=

object_pathname[:object_pathname]...

The speciﬁed paths are to be searched before the public libraries and linker-

speciﬁed places.

For Guardian programs, the class SEARCH DEFINEs =_RLD_LIB_PATH and

=_RLD_FIRST_LIB_PATH correspond to these environment variables. For these DEFINEs, the

set of path list elements is speciﬁed in order by:

1. the subvolume (or parenthesized list of subvolumes) in the SUBVOL0 attribute

2. the subvolume (or parenthesized list of subvolumes) in the RELSUBVOL0 attribute

3. and so on for SUBVOL1, RELSUBVOL1, ..., SUBVOL20, RELSUBVOL20, ignoring

any absent attributes

See the Guardian Procedure Calls Reference Manual for more information about these

DEFINEs.

When run-time options are used, the search path list becomes:

1. Locations speciﬁed by _RLD_FIRST_LIB_PATH at load time *

2. Locations speciﬁed by -rld_ﬁrst_l at link time (the value of rpath_ﬁrst)

3. Public libraries

4. Program location *

5. Locations speciﬁed by _RLD_LIB_PATH at load time *

6. Locations speciﬁed by -rld_l at link time (the value of rpath)

7. Default locations:

On OSS: /lib:/usr/lib:/usr/local/lib:/G/SYSTEM/ZDLL

On Guardian: $SYSTEM.ZDLL

where the asterisk (*) marks those locations that are omitted when the ld or eld command

-limit_runtime_paths option was used.

Environment Variables and Diagnostic Output

If you do not specify RTLD_VERBOSE() for mode in the dlopen( ) call, the verbosity level

defaults to that speciﬁed by _RLDVERBOSE=n. For OSS programs, _RLDVERBOSE=n is

deﬁned as the following environment variable:

_RLDVERBOSE=n

where n has the possible values and meanings described for the RTLD_VERBOSE(n) value for

mode.

527192-007 Hewlett-Packard Company 1−59