Print this page
10229 Some man pages have incorrect cross-references


  97 or thread or that try to force system calls on a victim process will work.
  98 Furthermore several of the information and iteration interfaces are limited
  99 based on the data that is available in the core file.
 100 For example, if the core file is of a process that omits the frame pointer, the
 101 ability to iterate the stack will be limited.
 102 .Pp
 103 Use the
 104 .Fn Pgrab_core
 105 or
 106 .Fn Pfgrab_core
 107 function to open a core file.
 108 Use the
 109 .Fn Pgrab_file
 110 function to open an ELF object file.
 111 This is useful for obtaining information stored in ELF headers and
 112 sections.
 113 .Ss Debug Information
 114 Many of the operations in the library rely on debug information being
 115 present in a process and its associated libraries.
 116 The library leverages symbol table information, CTF data
 117 .Pq Xr CTF 4
 118 sections, and frame unwinding information based on the use of an ABI
 119 defined frame pointer, e\&.g\&.
 120 .Sy %ebp
 121 and
 122 .Sy %rbp
 123 on x86 systems.
 124 .Pp
 125 Some software providers strip programs of this information or build
 126 their executables such that the information will not be present in a
 127 core dump.
 128 To deal with this fact, the library is able to consume information that is not
 129 present in the core file or the running process.
 130 It can both consume it from the underlying executable and it also supports
 131 finding it from related ELF objects that are linked to it via the
 132 .Sy .gnu_debuglink
 133 and the
 134 .Sy .note.gnu.build-id
 135 ELF sections.
 136 .Ss Iteration Interfaces
 137 The




  97 or thread or that try to force system calls on a victim process will work.
  98 Furthermore several of the information and iteration interfaces are limited
  99 based on the data that is available in the core file.
 100 For example, if the core file is of a process that omits the frame pointer, the
 101 ability to iterate the stack will be limited.
 102 .Pp
 103 Use the
 104 .Fn Pgrab_core
 105 or
 106 .Fn Pfgrab_core
 107 function to open a core file.
 108 Use the
 109 .Fn Pgrab_file
 110 function to open an ELF object file.
 111 This is useful for obtaining information stored in ELF headers and
 112 sections.
 113 .Ss Debug Information
 114 Many of the operations in the library rely on debug information being
 115 present in a process and its associated libraries.
 116 The library leverages symbol table information, CTF data
 117 .Pq Xr ctf 4
 118 sections, and frame unwinding information based on the use of an ABI
 119 defined frame pointer, e\&.g\&.
 120 .Sy %ebp
 121 and
 122 .Sy %rbp
 123 on x86 systems.
 124 .Pp
 125 Some software providers strip programs of this information or build
 126 their executables such that the information will not be present in a
 127 core dump.
 128 To deal with this fact, the library is able to consume information that is not
 129 present in the core file or the running process.
 130 It can both consume it from the underlying executable and it also supports
 131 finding it from related ELF objects that are linked to it via the
 132 .Sy .gnu_debuglink
 133 and the
 134 .Sy .note.gnu.build-id
 135 ELF sections.
 136 .Ss Iteration Interfaces
 137 The