hpux man page for dlmodadd

dlmodadd(3C)															      dlmodadd(3C)

NAME
       dlmodadd() - register information about dynamically generated functions

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

DESCRIPTION
       registers  information about a dynamically generated function, which can be retrived through The interface can be used to remove the regis-
       tered information.

       associate_handle is the module handle for an existing module with which the new function is associated.	When the dynamic loader is  called
       from the new function, it will behave as if it had been called from the associated module.  This handle must be a handle returned by or

       func_start is the starting address of the generated machine code for the function.  It is NOT the address of a function descriptor.

       func_size is the size, in bytes, of the generated machine code.

       linkage_ptr  is the gp (global pointer) value to be used for the function.  It could be the gp of the associated module.  It must be set to
       a valid value, even if the generated code doesn't actually use gp, as it is required at a minimum for  following  the  personality  routine
       pointer in the unwind information.

       unwind_info  is	a  pointer  to	the  beginning of the unwind info block for the function.  The unwind info block contains the header word,
       unwind descriptors, personality routine pointer, and language-specific data, as described in the Itanium-based system document.

       When is invoked to register information about a dynamically generated function, the dynamic loader creates an unwind header and	a  single-
       entry  unwind  table  for the function.	The unwind header is associated with the address range occupied by the dynamically generated func-
       tion.  The routine returns a handle as identification of the newly-added function.  Handles returned by share the same namespace as handles
       returned  by  and but they may not be used in calls to or If is called with an ip_value that belongs to a function that has been registered
       with it returns the associate_handle specified during invocation. If a library is unloaded by the unwind info for all dynamically generated
       functions associated with the library being unloaded is also removed.

MULTITHREAD USAGE
       This routine is thread-safe.

RETURN VALUE
       If successful, returns a handle as identification of the newly-added function.  NULL is returned otherwise.

ERRORS
       If fails, a subsequent call to returns one of the following values:
	      Out of memory.

	      Cannot apply relocation in library.

	      failed on entry to

	      failed on exit from

	      Invalid
		     argument .

	      failed on entry to or exit from

AUTHOR
       was developed by HP.

SEE ALSO
       ld(1), dlclose(3C), dlerrno(3C), dlerror(3C), dlget(3C), dlmodremove(3C), dlopen(3C), dlsym(3C), a.out(4), dld.so(5).

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

																      dlmodadd(3C)