d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add examples of dlinfo() usage to manual page.

Browse Source
This commit is contained in:
Alexey Zelkin 2003-02-15 10:51:05 +00:00
parent 3f4b504568
commit f734492604
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=110931
1 changed files with 48 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

49
lib/libc/gen/dlinfo.3
View File

@ -182,7 +182,54 @@ pointer
.Ft ( char *p ) .
.El
.Sh EXAMPLES
To be continued
Example 1: Using
.Fn dlinfo
to retrieve Link_map structure.
.Pp
The following example shows how dynamic library can detect the list
of shared libraries loaded after caller's one.
For simplicity, error checking has been omitted.
.Bd -literal
Link_map *map;
dlinfo(RTLD_SELF, RTLD_DI_LINKMAP, &map);
while (map != NULL) {
printf("%p: %s\n", map->l_addr, map->l_name);
map = map->l_next;
}
.Ed
.Pp
Example 2: Using
.Fn dlinfo
to retrieve the library search paths.
.Pp
The following example shows how a dynamic object can inspect the library
search paths that would be used to locate a simple filename with
.Fn dlopen .
For simplicity, error checking has been omitted.
.Bd -literal
Dl_serinfo _info, *info = &_info;
Dl_serpath *path;
unsigned int cnt;
/* determine search path count and required buffer size */
dlinfo(RTLD_SELF, RTLD_DI_SERINFOSIZE, (void *)info);
/* allocate new buffer and initialize */
info = malloc(_info.dls_size);
info->dls_size = _info.dls_size;
info->dls_cnt = _info.dls_cnt;
/* obtain sarch path information */
dlinfo(RTLD_SELF, RTLD_DI_SERINFO, (void *)info);
path = &info->dls_serpath[0];
for (cnt = 1; cnt <= info->dls_cnt; cnt++, path++) {
(void) printf("%2d: %s\n", cnt, path->dls_name);
}
.Ed
.Sh RETURN VALUES
.Fn dlinfo
returns 0 on success, or -1 if error occured.