Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   10987 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

uwx_get_source_info(3X)				       uwx_get_source_info(3X)

NAME
       uwx_get_source_info() - return source information for current frame

SYNOPSIS

DESCRIPTION
       is  part	 of  the  Unwind  Express  Library  for Integrity systems; see
       uwx(3X).	 obtains source file and line number information for the  cur‐
       rent frame from the symbolic information stored in the ELF object file,
       if available.

       This entry point is provided for use immediately following a call to or
       For other situations, see uwx_find_source_info(3X).

   Parameters
       env	      A pointer to an unwind environment object.

       ifuncp	      Pointer  to  a variable of type char * where the inlined
		      function name will be returned.  If  NULL,  the  inlined
		      function name will not be returned.  If the IP (instruc‐
		      tion pointer) of	the  current  context  is  not	in  an
		      inlined  call  or	 if  symbolic debug information is not
		      available, a NULL pointer will be returned.

       srcfilep	      Pointer to a variable of type char *  where  the	source
		      file  name  will	be returned.  If NULL, the source file
		      name will not be returned.  If symbolic  debug  informa‐
		      tion is not available, a NULL pointer will be returned.

       linenump	      Pointer  to a variable of type int where the source line
		      number will be returned.	If NULL, the source line  num‐
		      ber will not be returned.	 If symbolic debug information
		      is not available, 0 will be returned.

       inline_contextp
		      Pointer to a variable of type int where the inline  con‐
		      text  identifier	will be returned.  If NULL, the inline
		      context identifier will not be returned.	If the	IP  of
		      the current context is not in an inlined call or if sym‐
		      bolic debug information is  not  available,  0  will  be
		      returned.

       In  all	cases  where  a pointer to a string is returned, the string is
       allocated within the unwind environment, and the pointer is valid  only
       until the next call to either or

   Stepping through inlined calls
       If  returns a non-zero inline context identifier, it indicates that the
       IP is located within an inline call.  If the application wishes to step
       through the chain of inlined calls, it can find the name of the inlined
       function through the ifuncp pointer, then call to move one step up  the
       chain  of inlined calls.	 The application may then call again to obtain
       the updated information.	 This process should  be  repeated  until  the
       returned identifier is 0.

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_sym‐
       bol(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_sym_info(3X),  uwx_init(3X),  uwx_init_context(3X),  uwx_regis‐
       ter_alloc_cb(3X),      uwx_register_callbacks(3X),     uwx_release_sym‐
       bol_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_get_source_info(3X)

Vote for polarhome