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
|