/[libtool]/libtool/doc/libtool.texi
ViewVC logotype

Diff of /libtool/doc/libtool.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.117 by rboehne, Sat Jun 16 17:33:05 2001 UTC revision 1.118 by gary, Tue Jun 26 00:50:38 2001 UTC
# Line 2841  directories.  Return 0 on success. Line 2841  directories.  Return 0 on success.
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,

Legend:
Removed from v.1.117  
changed lines
  Added in v.1.118

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26