2841 |
Return the current user-defined library search path. |
Return the current user-defined library search path. |
2842 |
@end deftypefun |
@end deftypefun |
2843 |
|
|
2844 |
|
@deftypefun int lt_dlforeachfile (@w{const char *@var{search_path}}, @w{int (*@var{func}) (const char *@var{filename}, lt_ptr @var{data})}, @w{lt_ptr @var{data}}) |
2845 |
|
In some applications you may not want to load individual modules with |
2846 |
|
known names, but rather find all of the modules in a set of |
2847 |
|
directories and load them all during initialisation. With this function |
2848 |
|
you can have libltdl scan the colon delimited directory list in |
2849 |
|
@var{search_path} for candidates, and pass them, along with @var{data} |
2850 |
|
to your own callback function, @var{func}. If @var{seach_path} is |
2851 |
|
@samp{NULL}, then search all of the standard locations that |
2852 |
|
@code{lt_dlopen} would examine. This function will continue to make |
2853 |
|
calls to @var{func} for each file that it discovers in @var{search_path} |
2854 |
|
until one of these calls returns non-zero, or until the files are |
2855 |
|
exhausted. @samp{lt_dlforeachfile} returns value returned by the last |
2856 |
|
call made to @var{func}. |
2857 |
|
|
2858 |
|
For example you could define @var{func} to build an ordered |
2859 |
|
@dfn{argv}-like vector of files using @var{data} to hold the address of |
2860 |
|
the start of the vector. |
2861 |
|
@end deftypefun |
2862 |
|
|
2863 |
@deftypefun int lt_dlmakeresident (lt_dlhandle @var{handle}) |
@deftypefun int lt_dlmakeresident (lt_dlhandle @var{handle}) |
2864 |
Mark a module so that it cannot be @samp{lt_dlclose}d. This can be |
Mark a module so that it cannot be @samp{lt_dlclose}d. This can be |
2865 |
useful if a module implements some core functionality in your project, |
useful if a module implements some core functionality in your project, |