| OLD | NEW |
| 1 // Copyright 2015 The Crashpad Authors. All rights reserved. | 1 // Copyright 2015 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, |
| 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | 11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| 12 // See the License for the specific language governing permissions and | 12 // See the License for the specific language governing permissions and |
| 13 // limitations under the License. | 13 // limitations under the License. |
| 14 | 14 |
| 15 #ifndef CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_ | 15 #ifndef CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_ |
| 16 #define CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_ | 16 #define CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_ |
| 17 | 17 |
| 18 #include <sys/time.h> | 18 #include <sys/time.h> |
| 19 #include <windows.h> | 19 #include <windows.h> |
| 20 | 20 |
| 21 #include <vector> | 21 #include <vector> |
| 22 | 22 |
| 23 #include "util/misc/initialization_state_dcheck.h" | 23 #include "util/misc/initialization_state_dcheck.h" |
| 24 #include "util/win/address_types.h" | 24 #include "util/win/address_types.h" |
| 25 #include "util/win/process_info.h" | 25 #include "util/win/process_info.h" |
| 26 | 26 |
| 27 namespace crashpad { | 27 namespace crashpad { |
| 28 | 28 |
| 29 //! \brief State of process being read by ProcessReaderWin. |
| 30 enum class ProcessSuspensionState : bool { |
| 31 //! \brief The process has not been suspended. |
| 32 kRunning, |
| 33 |
| 34 //! \brief The process is suspended. |
| 35 kSuspended, |
| 36 }; |
| 37 |
| 29 //! \brief Accesses information about another process, identified by a `HANDLE`. | 38 //! \brief Accesses information about another process, identified by a `HANDLE`. |
| 30 class ProcessReaderWin { | 39 class ProcessReaderWin { |
| 31 public: | 40 public: |
| 32 //! \brief Contains information about a thread that belongs to a process. | 41 //! \brief Contains information about a thread that belongs to a process. |
| 33 struct Thread { | 42 struct Thread { |
| 34 Thread(); | 43 Thread(); |
| 35 ~Thread() {} | 44 ~Thread() {} |
| 36 | 45 |
| 37 CONTEXT context; | 46 CONTEXT context; |
| 38 uint64_t id; | 47 uint64_t id; |
| 39 WinVMAddress teb; | 48 WinVMAddress teb; |
| 40 WinVMAddress stack_region_address; | 49 WinVMAddress stack_region_address; |
| 41 WinVMSize stack_region_size; | 50 WinVMSize stack_region_size; |
| 42 uint32_t suspend_count; | 51 uint32_t suspend_count; |
| 43 uint32_t priority_class; | 52 uint32_t priority_class; |
| 44 uint32_t priority; | 53 uint32_t priority; |
| 45 }; | 54 }; |
| 46 | 55 |
| 47 ProcessReaderWin(); | 56 ProcessReaderWin(); |
| 48 ~ProcessReaderWin(); | 57 ~ProcessReaderWin(); |
| 49 | 58 |
| 50 //! \brief Initializes this object. This method must be called before any | 59 //! \brief Initializes this object. This method must be called before any |
| 51 //! other. | 60 //! other. |
| 52 //! | 61 //! |
| 53 //! \param[in] process Process handle, must have `PROCESS_QUERY_INFORMATION`, | 62 //! \param[in] process Process handle, must have `PROCESS_QUERY_INFORMATION`, |
| 54 //! `PROCESS_VM_READ`, and `PROCESS_DUP_HANDLE` access. | 63 //! `PROCESS_VM_READ`, and `PROCESS_DUP_HANDLE` access. |
| 64 //! \param[in] suspension_state Whether \a process has already been suspended |
| 65 //! by the caller. Typically, this will be |
| 66 //! ProcessSuspensionState::kSuspended, except for testing uses and where |
| 67 //! the reader is reading itself. |
| 55 //! | 68 //! |
| 56 //! \return `true` on success, indicating that this object will respond | 69 //! \return `true` on success, indicating that this object will respond |
| 57 //! validly to further method calls. `false` on failure. On failure, no | 70 //! validly to further method calls. `false` on failure. On failure, no |
| 58 //! further method calls should be made. | 71 //! further method calls should be made. |
| 59 bool Initialize(HANDLE process); | 72 //! |
| 73 //! \sa ScopedProcessSuspend |
| 74 bool Initialize(HANDLE process, ProcessSuspensionState suspension_state); |
| 60 | 75 |
| 61 //! \return `true` if the target task is a 64-bit process. | 76 //! \return `true` if the target task is a 64-bit process. |
| 62 bool Is64Bit() const { return process_info_.Is64Bit(); } | 77 bool Is64Bit() const { return process_info_.Is64Bit(); } |
| 63 | 78 |
| 64 pid_t ProcessID() const { return process_info_.ProcessID(); } | 79 pid_t ProcessID() const { return process_info_.ProcessID(); } |
| 65 pid_t ParentProcessID() const { return process_info_.ParentProcessID(); } | 80 pid_t ParentProcessID() const { return process_info_.ParentProcessID(); } |
| 66 | 81 |
| 67 bool ReadMemory(WinVMAddress at, WinVMSize num_bytes, void* into); | 82 bool ReadMemory(WinVMAddress at, WinVMSize num_bytes, void* into); |
| 68 | 83 |
| 69 //! \brief Determines the target process' start time. | 84 //! \brief Determines the target process' start time. |
| (...skipping 19 matching lines...) Expand all Loading... |
| 89 | 104 |
| 90 //! \return The modules loaded in the process. The first element (at index | 105 //! \return The modules loaded in the process. The first element (at index |
| 91 //! `0`) corresponds to the main executable. | 106 //! `0`) corresponds to the main executable. |
| 92 const std::vector<ProcessInfo::Module>& Modules(); | 107 const std::vector<ProcessInfo::Module>& Modules(); |
| 93 | 108 |
| 94 private: | 109 private: |
| 95 HANDLE process_; | 110 HANDLE process_; |
| 96 ProcessInfo process_info_; | 111 ProcessInfo process_info_; |
| 97 std::vector<Thread> threads_; | 112 std::vector<Thread> threads_; |
| 98 std::vector<ProcessInfo::Module> modules_; | 113 std::vector<ProcessInfo::Module> modules_; |
| 114 ProcessSuspensionState suspension_state_; |
| 99 bool initialized_threads_; | 115 bool initialized_threads_; |
| 100 InitializationStateDcheck initialized_; | 116 InitializationStateDcheck initialized_; |
| 101 | 117 |
| 102 DISALLOW_COPY_AND_ASSIGN(ProcessReaderWin); | 118 DISALLOW_COPY_AND_ASSIGN(ProcessReaderWin); |
| 103 }; | 119 }; |
| 104 | 120 |
| 105 } // namespace crashpad | 121 } // namespace crashpad |
| 106 | 122 |
| 107 #endif // CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_ | 123 #endif // CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_ |
| OLD | NEW |