<ahref="#pub-methods">Public Member Functions</a>|
<ahref="classcrashpad_1_1ProcessSnapshotMinidump-members.html">List of all members</a></div>
<divclass="headertitle">
<divclass="title">crashpad::ProcessSnapshotMinidump Class Reference<spanclass="mlabels"><spanclass="mlabel">final</span></span></div></div>
</div><!--header-->
<divclass="contents">
<p>A <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> based on a minidump file.
<areahref="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. "alt="crashpad::ProcessSnapshot"shape="rect"coords="0,0,223,24"/>
<trclass="memdesc:ac45f9e9f13f22047f936ec3c652df5ec"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Initializes the object. <ahref="#ac45f9e9f13f22047f936ec3c652df5ec">More...</a><br/></td></tr>
<trclass="memdesc:a570c55376918b055c51092257222365d"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns the snapshot process’ process ID. <br/></td></tr>
<trclass="memdesc:a94649ccbdcb2b5de911021bc297c3df9"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns the snapshot process’ parent process’ process ID. <br/></td></tr>
<trclass="memdesc:aa2e89e89a6157258a92477705c2755e8"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns the time that the snapshot was taken in <em>snapshot_time</em>. <ahref="#aa2e89e89a6157258a92477705c2755e8">More...</a><br/></td></tr>
<trclass="memdesc:a3be1cc1efd90feede4c1761f4f78f6a8"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns the time that the snapshot process was started in <em>start_time</em>. <ahref="#a3be1cc1efd90feede4c1761f4f78f6a8">More...</a><br/></td></tr>
<trclass="memdesc:a08d363f93f87c7173c1f03a247054168"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns the snapshot process’ CPU usage times in <em>user_time</em> and <em>system_time</em>. <ahref="#a08d363f93f87c7173c1f03a247054168">More...</a><br/></td></tr>
<trclass="memdesc:ad246ff4d8e140ed917c2a5b92a5b4441"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns a UUID identifying the event that the snapshot describes. <ahref="#ad246ff4d8e140ed917c2a5b92a5b4441">More...</a><br/></td></tr>
<trclass="memdesc:a85538c374ee62566620f2ab2cc720668"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns a UUID identifying the client that the snapshot represents. <ahref="#a85538c374ee62566620f2ab2cc720668">More...</a><br/></td></tr>
<trclass="memdesc:af13ec8cce7d92dccebe6c4ab61ec20e9"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns key-value string annotations recorded for the process, system, or snapshot producer. <ahref="#af13ec8cce7d92dccebe6c4ab61ec20e9">More...</a><br/></td></tr>
<trclass="memdesc:aa683e2031df211c36f207924f6c45ace"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns a <aclass="el"href="classcrashpad_1_1SystemSnapshot.html"title="An abstract interface to a snapshot representing the state of a system, comprising an operating syste...">SystemSnapshot</a> reflecting the characteristics of the system that ran the snapshot process at the time of the snapshot. <ahref="#aa683e2031df211c36f207924f6c45ace">More...</a><br/></td></tr>
<trclass="memdesc:a8a518d697aa1f5d165e1547472b13574"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns <aclass="el"href="classcrashpad_1_1ThreadSnapshot.html"title="An abstract interface to a snapshot representing a thread (lightweight process) present in a snapshot...">ThreadSnapshot</a> objects reflecting the threads (lightweight processes) existing in the snapshot process at the time of the snapshot. <ahref="#a8a518d697aa1f5d165e1547472b13574">More...</a><br/></td></tr>
<trclass="memdesc:a444b80f87f374d632eb69e010875fcc0"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns <aclass="el"href="classcrashpad_1_1ModuleSnapshot.html"title="An abstract interface to a snapshot representing a code module (binary image) loaded into a snapshot ...">ModuleSnapshot</a> objects reflecting the code modules (binary images) loaded into the snapshot process at the time of the snapshot. <ahref="#a444b80f87f374d632eb69e010875fcc0">More...</a><br/></td></tr>
<trclass="memdesc:a0d24462a336bdf476d21face15d34165"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns <aclass="el"href="classcrashpad_1_1UnloadedModuleSnapshot.html"title="Information about an unloaded module that was previously loaded into a snapshot process. ">UnloadedModuleSnapshot</a> objects reflecting the code modules the were recorded as unloaded at the time of the snapshot. <ahref="#a0d24462a336bdf476d21face15d34165">More...</a><br/></td></tr>
<trclass="memdesc:a7da0549fe7d24fa2b4192e53421a0d23"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns an <aclass="el"href="classcrashpad_1_1ExceptionSnapshot.html"title="An abstract interface to a snapshot representing an exception that a snapshot process sustained and t...">ExceptionSnapshot</a> reflecting the exception that the snapshot process sustained to trigger the snapshot being taken. <ahref="#a7da0549fe7d24fa2b4192e53421a0d23">More...</a><br/></td></tr>
<trclass="memdesc:aaeb703b3b19b503b094fccf629ae72b8"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns <aclass="el"href="classcrashpad_1_1MemoryMapRegionSnapshot.html"title="An abstract interface to a snapshot representing a region of the memory map present in the snapshot p...">MemoryMapRegionSnapshot</a> objects reflecting the regions of the memory map in the snapshot process at the time of the snapshot. <ahref="#aaeb703b3b19b503b094fccf629ae72b8">More...</a><br/></td></tr>
<trclass="memdesc:ac2c9f38544c523566da27683481b9134"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns <aclass="el"href="structcrashpad_1_1HandleSnapshot.html">HandleSnapshot</a> objects reflecting the open handles in the snapshot process at the time of the snapshot. <ahref="#ac2c9f38544c523566da27683481b9134">More...</a><br/></td></tr>
<trclass="memdesc:a4fb52f95d9eaf634dd0aa15254215b61"><tdclass="mdescLeft"> </td><tdclass="mdescRight">Returns a vector of additional memory blocks that should be included in a minidump. <ahref="#a4fb52f95d9eaf634dd0aa15254215b61">More...</a><br/></td></tr>
<divclass="textblock"><p>A <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> based on a minidump file. </p>
</div><h2class="groupheader">Member Function Documentation</h2>
<p>Returns key-value string annotations recorded for the process, system, or snapshot producer. </p>
<p>This method retrieves annotations recorded for a process. These annotations are intended for diagnostic use, including crash analysis. “Simple annotations” are structured as a sequence of key-value pairs, where all keys and values are strings. These are referred to in Chrome as “crash keys.”</p>
<p>Annotations stored here may reflect the process, system, or snapshot producer. Most annotations not under the client’s direct control will be retrievable by this method. For clients such as Chrome, this includes the product name and version.</p>
<p>Additional per-module annotations may be obtained by calling <aclass="el"href="classcrashpad_1_1ModuleSnapshot.html#a4d1328fda3e91a4c25369b5fcc4cf2f6"title="Returns key-value string annotations recorded in the module. ">ModuleSnapshot::AnnotationsSimpleMap()</a>. </p>
<p>Returns a UUID identifying the client that the snapshot represents. </p>
<p>Client identification is within the scope of the application, but it is expected that the identifier will be unique for an instance of Crashpad monitoring an application or set of applications for a user. The identifier shall remain stable over time.</p>
<p>If no identifier is available, this field will contain zeroes. </p>
<p>Returns an <aclass="el"href="classcrashpad_1_1ExceptionSnapshot.html"title="An abstract interface to a snapshot representing an exception that a snapshot process sustained and t...">ExceptionSnapshot</a> reflecting the exception that the snapshot process sustained to trigger the snapshot being taken. </p>
<dlclass="section return"><dt>Returns</dt><dd>An <aclass="el"href="classcrashpad_1_1ExceptionSnapshot.html"title="An abstract interface to a snapshot representing an exception that a snapshot process sustained and t...">ExceptionSnapshot</a> object. The caller does not take ownership of this object, it is scoped to the lifetime of the <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> object that it was obtained from. If the snapshot is not a result of an exception, returns <code>nullptr</code>. </dd></dl>
<p>Returns a vector of additional memory blocks that should be included in a minidump. </p>
<dlclass="section return"><dt>Returns</dt><dd>An vector of <aclass="el"href="classcrashpad_1_1MemorySnapshot.html"title="An abstract interface to a snapshot representing a region of memory present in a snapshot process...">MemorySnapshot</a> objects that will be included in the crash dump. The caller does not take ownership of these objects, they are scoped to the lifetime of the <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> object that they were obtained from. </dd></dl>
<p>Returns <aclass="el"href="structcrashpad_1_1HandleSnapshot.html">HandleSnapshot</a> objects reflecting the open handles in the snapshot process at the time of the snapshot. </p>
<dlclass="section return"><dt>Returns</dt><dd>A vector of <aclass="el"href="structcrashpad_1_1HandleSnapshot.html">HandleSnapshot</a> objects. </dd></dl>
<tr><tdclass="paramdir">[in]</td><tdclass="paramname">file_reader</td><td>A file reader corresponding to a minidump file. The file reader must support seeking.</td></tr>
</table>
</dd>
</dl>
<dlclass="section return"><dt>Returns</dt><dd><code>true</code> if the snapshot could be created, <code>false</code> otherwise with an appropriate message logged. </dd></dl>
<p>Returns <aclass="el"href="classcrashpad_1_1MemoryMapRegionSnapshot.html"title="An abstract interface to a snapshot representing a region of the memory map present in the snapshot p...">MemoryMapRegionSnapshot</a> objects reflecting the regions of the memory map in the snapshot process at the time of the snapshot. </p>
<dlclass="section return"><dt>Returns</dt><dd>A vector of <aclass="el"href="classcrashpad_1_1MemoryMapRegionSnapshot.html"title="An abstract interface to a snapshot representing a region of the memory map present in the snapshot p...">MemoryMapRegionSnapshot</a> objects. The caller does not take ownership of these objects, they are scoped to the lifetime of the <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> object that they were obtained from. </dd></dl>
<p>Returns <aclass="el"href="classcrashpad_1_1ModuleSnapshot.html"title="An abstract interface to a snapshot representing a code module (binary image) loaded into a snapshot ...">ModuleSnapshot</a> objects reflecting the code modules (binary images) loaded into the snapshot process at the time of the snapshot. </p>
<dlclass="section return"><dt>Returns</dt><dd>A vector of <aclass="el"href="classcrashpad_1_1ModuleSnapshot.html"title="An abstract interface to a snapshot representing a code module (binary image) loaded into a snapshot ...">ModuleSnapshot</a> objects. The caller does not take ownership of these objects, they are scoped to the lifetime of the <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> object that they were obtained from. </dd></dl>
<p>Returns the snapshot process’ CPU usage times in <em>user_time</em> and <em>system_time</em>. </p>
<dlclass="params"><dt>Parameters</dt><dd>
<tableclass="params">
<tr><tdclass="paramdir">[out]</td><tdclass="paramname">user_time</td><td>The time that the process has spent executing in user mode. </td></tr>
<tr><tdclass="paramdir">[out]</td><tdclass="paramname">system_time</td><td>The time that the process has spent executing in system (kernel) mode. </td></tr>
<p>Normally, process uptime in wall clock time can be computed as <aclass="el"href="classcrashpad_1_1ProcessSnapshotMinidump.html#aa2e89e89a6157258a92477705c2755e8"title="Returns the time that the snapshot was taken in snapshot_time. ">SnapshotTime()</a>−<aclass="el"href="classcrashpad_1_1ProcessSnapshotMinidump.html#a3be1cc1efd90feede4c1761f4f78f6a8"title="Returns the time that the snapshot process was started in start_time. ">ProcessStartTime()</a>, but this cannot be guaranteed in cases where the real-time clock has been set during the snapshot process’ lifetime.</p>
<p>Returns a UUID identifying the event that the snapshot describes. </p>
<p>This provides a stable identifier for a crash even as the report is converted to different formats, provided that all formats support storing a crash report ID. When a report is originally created, a report ID should be assigned. From that point on, any operations involving the same report should preserve the same report ID.</p>
<p>If no identifier is available, this field will contain zeroes. </p>
<p>Returns the time that the snapshot was taken in <em>snapshot_time</em>. </p>
<dlclass="params"><dt>Parameters</dt><dd>
<tableclass="params">
<tr><tdclass="paramdir">[out]</td><tdclass="paramname">snapshot_time</td><td>The time that the snapshot was taken. This is distinct from the time that a <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> object was created or initialized, although it may be that time for <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> objects representing live or recently-crashed process state. </td></tr>
<p>Returns a <aclass="el"href="classcrashpad_1_1SystemSnapshot.html"title="An abstract interface to a snapshot representing the state of a system, comprising an operating syste...">SystemSnapshot</a> reflecting the characteristics of the system that ran the snapshot process at the time of the snapshot. </p>
<dlclass="section return"><dt>Returns</dt><dd>A <aclass="el"href="classcrashpad_1_1SystemSnapshot.html"title="An abstract interface to a snapshot representing the state of a system, comprising an operating syste...">SystemSnapshot</a> object. The caller does not take ownership of this object, it is scoped to the lifetime of the <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> object that it was obtained from. </dd></dl>
<p>Returns <aclass="el"href="classcrashpad_1_1ThreadSnapshot.html"title="An abstract interface to a snapshot representing a thread (lightweight process) present in a snapshot...">ThreadSnapshot</a> objects reflecting the threads (lightweight processes) existing in the snapshot process at the time of the snapshot. </p>
<dlclass="section return"><dt>Returns</dt><dd>A vector of <aclass="el"href="classcrashpad_1_1ThreadSnapshot.html"title="An abstract interface to a snapshot representing a thread (lightweight process) present in a snapshot...">ThreadSnapshot</a> objects. The caller does not take ownership of these objects, they are scoped to the lifetime of the <aclass="el"href="classcrashpad_1_1ProcessSnapshot.html"title="An abstract interface to a snapshot representing the state of a process. ">ProcessSnapshot</a> object that they were obtained from. </dd></dl>
<p>Returns <aclass="el"href="classcrashpad_1_1UnloadedModuleSnapshot.html"title="Information about an unloaded module that was previously loaded into a snapshot process. ">UnloadedModuleSnapshot</a> objects reflecting the code modules the were recorded as unloaded at the time of the snapshot. </p>
<dlclass="section return"><dt>Returns</dt><dd>A vector of <aclass="el"href="classcrashpad_1_1UnloadedModuleSnapshot.html"title="Information about an unloaded module that was previously loaded into a snapshot process. ">UnloadedModuleSnapshot</a> objects. </dd></dl>
