dlsetlibpath man page on HP-UX

Printed from http://www.polarhome.com/service/man/?qf=dlsetlibpath&af=0&tf=2&of=HP-UX

dlsetlibpath(3C)					      dlsetlibpath(3C)

       dlsetlibpath()  -  set  the  dynamic  search path used to locate shared

       [flag]...  file...  [library]...

   Multithread Usage
       This routine is thread-safe.  Calls to affect all subsequent  calls  to
       and on any thread.

       is  one of a family of routines that give the user direct access to the
       dynamic linking facilities (using the option on the compiler or command
       line).	sets  the  dynamic  search  path  used by and to locate shared

       libpath is the dynamic search path.  It is a list of one or  more  path
       names separated by colons

       When  searching	for a library, the dynamic loader uses search paths in
       the following default order:

	      1.  The dynamic search path specified in a call to

	      2.  The environment variable.

	      3.  The environment variable.

	      4.  The embedded path of the calling module (executable  program
		  or  shared  library)	for libraries named in calls to or For
		  dependent libraries, the embedded path of the	 library  that
		  named it as a dependent is used.

	      5.  The standard library path.

	      6.  The  current working directory.  (This is only for libraries
		  named in calls to and not their dependent libraries.)

       (See dld.so(5) for additional information on search paths  and  options
       that can change the order described above.)

       Any  combination of these paths may be disabled by setting flags to one
       or more of the following flag values OR'ed together.  If the  following
       value  is  set,	the dynamic loader does not search the specified loca‐

	      Directories specified in the dynamic search path.

	      Directories specified in the	 environment variable.

	      Directories specified in the	 environment variable.

	      Directories specified in the embedded path.

	      Standard library directory.

	      Current working directory.

       Multiple search paths can be disabled by OR'ing individual flags:


       A single search path can be enabled by setting flags to the  complement
       of the flag value that disables that search path:


       The  following example illustrates the use of to set the dynamic search
       path and disable other search paths.  For  simplicity,  error  checking
       has been omitted.

		 #include <dlfcn.h>

		 int main() {
		     void *handle;
		     int   status;
		     int   flags;

		     /* Set dynamic search path and disable the embedded
		      * path and the standard library directory.
		     status = dlsetlibpath("/opt/lib:/opt/usr/lib", flags);

		     /* Call dlopen to load a library using the dynamic
		      * search path.
		     handle = dlopen("mylib.so", RTLD_LAZY);

		     /* Remove the dynamic search path and reenable all
		      * disabled search paths.
		     status = dlsetlibpath(NULL, 0);

       If  successful,	returns	 otherwise  a  non-0  value is returned.  More
       detailed diagnostic information is available through or

       If fails, a subsequent call to returns one of the following values:

	      Cannot allocate dynamic memory.

	      Failed to apply relocation while resolving call to

	      call failed on entry to

	      call failed on exit from

	      failed on entry to or exit from

	      Invalid argument in call to

       dlopen(3C), dlopene(3C), dlgetfileinfo(3C),  dlerrno(3C),  dlerror(3C),

   Texts and Tutorials:
       (See the		 option)
       (See		 manuals(5) for ordering information)


List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net