OLD | NEW |
1 // Copyright 2014 The Crashpad Authors. All rights reserved. | 1 // Copyright 2014 The Crashpad Authors. All rights reserved. |
2 // | 2 // |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
6 // | 6 // |
7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
8 // | 8 // |
9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
(...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
72 //! \brief Returns the snapshot process’ CPU usage times in \a user_time and | 72 //! \brief Returns the snapshot process’ CPU usage times in \a user_time and |
73 //! \a system_time. | 73 //! \a system_time. |
74 //! | 74 //! |
75 //! \param[out] user_time The time that the process has spent executing in | 75 //! \param[out] user_time The time that the process has spent executing in |
76 //! user mode. | 76 //! user mode. |
77 //! \param[out] system_time The time that the process has spent executing in | 77 //! \param[out] system_time The time that the process has spent executing in |
78 //! system (kernel) mode. | 78 //! system (kernel) mode. |
79 virtual void ProcessCPUTimes(timeval* user_time, | 79 virtual void ProcessCPUTimes(timeval* user_time, |
80 timeval* system_time) const = 0; | 80 timeval* system_time) const = 0; |
81 | 81 |
| 82 //! \brief Returns a %UUID identifying the event that the snapshot describes. |
| 83 //! |
| 84 //! This provides a stable identifier for a crash even as the report is |
| 85 //! converted to different formats, provided that all formats support storing |
| 86 //! a crash report ID. When a report is originally created, a report ID should |
| 87 //! be assigned. From that point on, any operations involving the same report |
| 88 //! should preserve the same report ID. |
| 89 //! |
| 90 //! If no identifier is available, this field will contain zeroes. |
| 91 virtual void ReportID(UUID* client_id) const = 0; |
| 92 |
82 //! \brief Returns a %UUID identifying the client that the snapshot | 93 //! \brief Returns a %UUID identifying the client that the snapshot |
83 //! represents. | 94 //! represents. |
84 //! | 95 //! |
85 //! Client identification is within the scope of the application, but it is | 96 //! Client identification is within the scope of the application, but it is |
86 //! expected that the identifier will be unique for an instance of Crashpad | 97 //! expected that the identifier will be unique for an instance of Crashpad |
87 //! monitoring an application or set of applications for a user. The | 98 //! monitoring an application or set of applications for a user. The |
88 //! identifier shall remain stable over time. | 99 //! identifier shall remain stable over time. |
89 //! | 100 //! |
90 //! If no identifier is available, this field will contain zeroes. | 101 //! If no identifier is available, this field will contain zeroes. |
91 virtual void ClientID(UUID* client_id) const = 0; | 102 virtual void ClientID(UUID* client_id) const = 0; |
(...skipping 55 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
147 //! \return An ExceptionSnapshot object. The caller does not take ownership of | 158 //! \return An ExceptionSnapshot object. The caller does not take ownership of |
148 //! this object, it is scoped to the lifetime of the ProcessSnapshot | 159 //! this object, it is scoped to the lifetime of the ProcessSnapshot |
149 //! object that it was obtained from. If the snapshot is not a result of | 160 //! object that it was obtained from. If the snapshot is not a result of |
150 //! an exception, returns `nullptr`. | 161 //! an exception, returns `nullptr`. |
151 virtual const ExceptionSnapshot* Exception() const = 0; | 162 virtual const ExceptionSnapshot* Exception() const = 0; |
152 }; | 163 }; |
153 | 164 |
154 } // namespace crashpad | 165 } // namespace crashpad |
155 | 166 |
156 #endif // CRASHPAD_SNAPSHOT_PROCESS_SNAPSHOT_H_ | 167 #endif // CRASHPAD_SNAPSHOT_PROCESS_SNAPSHOT_H_ |
OLD | NEW |