dlinfo(3DL)

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | SEE ALSO | NOTES

NAME

dlinfo- dynamic load information

SYNOPSIS

cc [ flag ... ] file ... -ldl [ library ... ]
#include <dlfcn.h>
#include <link.h>

int dlinfo(void *handle, int request, void *p);

DESCRIPTION

The dlinfo() function extracts information about a dynamically-loaded object. This function is loosely modeled after the ioctl() function. The request argument and a third argument with varying type are passed to dlinfo(). The action taken by dlinfo() depends on the value of the request provided. The handle argument is a value returned from a dlopen() or dlmopen() call.

The following are possible values for request to be passed into dlinfo():

RTLD_DI_CONFIGADDR

obtain the configuration file name and the address at which it has been loaded. The p argument is a Dl_info pointer ( Dl_info *p). The following elements from this structure are initialized:

dli_fname

The full name of the configuration file.

dli_fbase

The base address of the configuration file loaded into memory.

RTLD_DI_LMID

obtain the ID for the link-map list upon which the handle is loaded. The p argument is a Lmid_t pointer ( Lmid_t *p).

RTLD_DI_LINKMAP

obtain the Link_map for the handle specified. The p argument points to a Link_map pointer ( Link_map **p ). The actual storage for the Link_map structure is maintained by ld.so.1.

The Link_map structure includes the following members:

unsigned long    l_addr;        /* base address */
char *           l_name;        /* object name */
Elf32_Dyn *      l_ld;          /* .dynamic section */
Link_map *       l_next;        /* next link object */
Link_map *       l_prev;        /* previous link object */
char *           l_refname;     /* filter reference name */

l_addr

The base address of the object loaded into memory.

l_name

The full name of the loaded object. This is the filename of the object as referenced by ld.so.1.

l_ld

Points to the SHT_DYNAMIC structure.

l_next

The next Link_map on the link-map list, other objects on the same link-map list as the current object may be examined by following the and l_prev fields.

l_prev

The previous Link_map on the link-map list.

l_refname

If the object referenced is a filter this field points to the name of the object being filtered. If the object is not a filter, this field will be 0. See Linker and Libraries Guide.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT Level	MT-Safe

SEE ALSO

ld(1), ioctl(2), dlclose(3DL), dldump(3DL), dlerror(3DL), dlmopen(3DL), dlopen(3DL), dlsym(3DL), attributes(5)

Linker and Libraries Guide

NOTES

These functions are available to dynamically-linked processes only.

SunOS 5.8  Last Revised 2 Sept 1999

NAME | SYNOPSIS | DESCRIPTION | ATTRIBUTES | SEE ALSO | NOTES