hpux man page for uwx_init_context

uwx_init_context(3X)													      uwx_init_context(3X)

NAME
       uwx_init_context() - initialize the unwind context

SYNOPSIS

DESCRIPTION
       is  part  of  the  Unwind  Express  Library for Integrity systems; see uwx(3X).	provides the basic initial context as a starting point for
       unwinding.  This initial context consists of the values of ip (instruction pointer), sp (stack pointer), bsp (backing store  pointer),  and
       cfm (current frame marker).  The frame described by these values becomes the current frame.

       These  values  alone are not usually sufficient for a complete stack unwind, but the unwind engine will use the copy-in callback routine to
       obtain additional context information as needed.

       For self-unwinding, this entry point should not be used directly.  Instead, use

   Parameters
       env	      A pointer to an unwind environment object.

       ip	      The current instruction pointer.

       sp	      The current stack pointer.

       bsp	      The backing store pointer: the address in the register stack backing store where GR32 of the current frame would	be  stored
		      by the register stack engine.

       cfm	      The  current  frame  marker  and epilog counter.	Because the unwind library tracks the epilog counter as part of the ar.pfs
		      register, this parameter should combine the cfm and epilog counter in the same way they are combined in the ar.pfs  register
		      when a function call is made.  In other words, the value of should be used as the initial cfm.

RETURN VALUE
       returns on success.  See uwx(3X) for error codes.

AUTHOR
       The Unwind Express Library was developed by Hewlett-Packard.

SEE ALSO
       uwx(3X),  uwx_add_to_bsp(3X),  uwx_find_source_info(3X),  uwx_find_symbol(3X),  uwx_free(3X),  uwx_get_abi_context_code(3X),  uwx_get_func-
       start(3X),  uwx_get_module_info(3X),  uwx_get_nat(3X),  uwx_get_reg(3X),   uwx_get_source_info(3X),   uwx_get_sym_info(3X),   uwx_init(3X),
       uwx_init_context(3X),  uwx_register_alloc_cb(3X),  uwx_register_callbacks(3X), uwx_release_symbol_cache(3X), uwx_self_do_context_frame(3X),
       uwx_self_free_info(3X),	 uwx_self_init_context(3X),   uwx_self_init_info(3X),	 uwx_set_nofr(3X),    uwx_set_remote(3X),    uwx_step(3X),
       uwx_step_inline(3X).

							      Integrity Systems Only					      uwx_init_context(3X)