NAME
dlgetname() — retrieve the name of a load module given a load module descriptor
SYNOPSIS
cc
[flag]...
file...
-ldl
[library]...
#include <dlfcn.h>
char *dlgetname(struct load_module_desc *desc,
size_t desc_size,
void *(*read_tgt_mem)(void* buffer,
unsigned long long ptr,
size_t bufsiz,
int ident),
int ident_parm,
unsigned long long load_map_parm);
Multithread Usage
This routine is thread-safe.
DESCRIPTION
dlgetname()
is one of a family of routines that give the user
direct access to the dynamic linking facilities.
dlgetname()
returns the pathname of a load module represented by
desc.
The
read_tgt_mem,
ident_parm,
and
load_map_parm
parameters are identical to those for
dlmodinfo().
See
dlmodinfo(3C).
The caller of
dlgetname()
must copy the return value to insure that it is not corrupted.
RETURN VALUE
If
desc
does not describe a loaded module, then
NULL is returned.
More detailed diagnostic information is available
through
dlerror().
ERRORS
If
dlgetname()
fails, a subsequent call to
dlerrno
returns one of the following values:
- RTLD_ERR_CANT_APPLY_RELOC
Cannot apply relocation in library.
- RTLD_ERR_NO_MEMORY
Out of memory.
- RTLD_ERR_READ_TGT_MEM_FAILED
read_tgt_mem
failed in reading target memory.
- RTLD_ERR_SETCANCELSTATE_FAILED
__thread_setcancelstate
failed on entry to or exit from
dlgetname().
- RTLD_ERR_SIGENABLE_FAILED
sigenable
failed on exit from
dlgetname().
- RTLD_ERR_SIGINHIBIT_FAILED
siginhibit
failed on entry to
dlgetname().
AUTHOR
dlgetname()
was developed by HP.
SEE ALSO
Miscellaneous
- a.out(4)
Assembler, compiler, and linker output.
- dlclose(3C)
Unloads a shared library previously loaded by
dlopen().
- dlerror(3C)
Returns the last error message recorded by
dld.
- dlerrno(3C)
Returns an error code for the last error recorded by
dld.
- dlget(3C)
Returns information on a loaded module.
- dlmodinfo(3C)
Returns information about a loaded module.
- dlopen(3C)
Loads a shared library.
- dlsym(3C)
Gets the address of a symbol in a shared library.
Texts and Tutorials
- HP-UX Linker and Libraries Online User Guide
(See the
+help
option)
- HP-UX Linker and Libraries User's Guide
(See
manuals(5)
for ordering information)
Printable version
