dlgetmodinfo(3c) [hpux man page]

dlgetmodinfo(3C)														  dlgetmodinfo(3C)

NAME

       dlgetmodinfo() - retrieve information about a loaded module (program or shared library)

SYNOPSIS

       [flag... ] file ...  [library] ...

   Multithread Usage
       Thread safe in but not in

DESCRIPTION

       is one of a family of routines that give the user direct access to the dynamic linking facilities.  retrieves information about a load mod-
       ule from an index specifying the placement of the load module in the dynamic loader's search list.  Unlike can retrieve information about a
       load  module  in another process.  index of requests information about the dynamic loader.  An index of requests information about the pro-
       gram file itself.  The routine fills the load_module_desc with information from the matching load module.

       The desc, desc_size, read_tgt_mem, ident_parm, and load_map_parm parameters are identical to those for See dlmodinfo(3C).

RETURN VALUE

       If successful, returns a handle for the shared library as defined by the return value from NULL is returned otherwise.  The  return  values
       are type-converted to

ERRORS

       If fails, a subsequent call to returns one of the following values:
	      Cannot apply relocation in library.

	      Invalid address.

	      Invalid descriptor argument.

	      Invalid descriptor version.

	      Invalid load module index.

	      Out of memory.

	      failed in reading target memory.

	      failed on entry to or exit from

	      failed on exit from

	      failed on entry to

AUTHOR

       was developed by HP.

SEE ALSO

   System Tools
       exec(2)		 System loader.
       ld(1)		 Invokes the link editor.

   Miscellaneous
       a.out(4) 	 Assembler, compiler, and linker output.
       dlclose(3C)	 Unloads a shared library previously loaded by
       dlerror(3C)	 Returns the last error message recorded by
       dlerrno(3C)	 Returns an error code for the last error recorded by
       dlget(3C)	 Returns information about a loaded module.
       dlgetname(3C)	 Returns the name of the storage containing a load module.
       dlopen(3C)	 Loads a shared library.
       dlsym(3C)	 Gets the address of a symbol in a shared library.
       dlmodinfo(3C)	 Retrieve information about a loaded module (program or shared library).

   Texts and Tutorials
       (See the 	 option)
       (See		 manuals(5) for ordering information)

																  dlgetmodinfo(3C)

dlget(3C)																 dlget(3C)

NAME

       dlget() - retrieve information about a loaded module (program or shared library)

SYNOPSIS

       [flag]...  file...  [library]...

   Multithread Usage
       This routine is thread-safe.

DESCRIPTION

       is one of a family of routines that give the user direct access to the dynamic linking facilities.  returns information about a loaded mod-
       ule for a process.  retrieves information about a load module from an index specifying the placement of the  load  module  in  the  dynamic
       loader's  search list.  An index of requests information about the dynamic loader.  An index of requests information about the program file
       itself.

       If successful, returns a handle for the shared library as defined by the return value from

       desc must be preallocated by the user.  The structure members are filled in by the dynamic loader  with	information  about  the  requested
       shared library.

       A load_module_desc structure has the following members:

	      struct load_module_desc {
		 unsigned long text_base;
		 unsigned long text_size;
		 unsigned long data_base;
		 unsigned long data_size;
		 unsigned long unwind_base;
		 unsigned long linkage_ptr;
		 unsigned long phdr_base;
		 unsigned long tls_size;
		 unsigned long tls_start_addr;
		 }

       desc_size specifies the size in bytes of the load_module_desc structure sent in by the user.

       If a call to is unsuccessful, a NULL pointer is returned and desc remains unchanged.

ERRORS

       If fails, a subsequent call to returns one of the following values:
	      Cannot apply relocation in library.

	      Invalid descriptor argument.

	      Invalid descriptor version.

	      Invalid load module index.

	      Out of memory.

	      failed on entry to or exit from

	      failed on exit from

	      failed on entry to

AUTHOR

       was developed by HP.

SEE ALSO

   System Tools
       exec(2)		 System loader.
       ld(1)		 Invokes the link editor.

   Miscellaneous
       a.out(4) 	 Assembler, compiler, and linker output.
       dlclose(3C)	 Unloads a shared library previously loaded by
       dlerror(3C)	 Prints the last error message recorded by
       dlerrno(3C)	 Returns an error code for the last error recorded by
       dlgetname(3C)	 Returns the name of the storage containing a load 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
       (See the 	 option)
       (See		 manuals(5) for ordering information)

							       ELF Applications Only							 dlget(3C)