mirror of
https://github.com/chromium/crashpad.git
synced 2025-03-10 14:46:07 +00:00
Removes the bitness-specific targets in favour of pulling binaries from the other build directory. This is to avoid the added complexity of duplicating all the targets for the x86 in x64 build. Overall, mostly templatizing more functions to support the wow64-flavoured structures. The only additional functionality required is reading the x86 TEB that's chained from the x64 TEB when running as WOW64. The crashing child test was switched to a manual CreateProcess because it needs to launch a binary other than itself. R=mark@chromium.org BUG=crashpad:50 Review URL: https://codereview.chromium.org/1349313003 .
133 lines
4.3 KiB
C++
133 lines
4.3 KiB
C++
// Copyright 2015 The Crashpad Authors. All rights reserved.
|
||
//
|
||
// Licensed under the Apache License, Version 2.0 (the "License");
|
||
// you may not use this file except in compliance with the License.
|
||
// You may obtain a copy of the License at
|
||
//
|
||
// http://www.apache.org/licenses/LICENSE-2.0
|
||
//
|
||
// Unless required by applicable law or agreed to in writing, software
|
||
// distributed under the License is distributed on an "AS IS" BASIS,
|
||
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
// See the License for the specific language governing permissions and
|
||
// limitations under the License.
|
||
|
||
#ifndef CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_
|
||
#define CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_
|
||
|
||
#include <sys/time.h>
|
||
#include <windows.h>
|
||
|
||
#include <vector>
|
||
|
||
#include "build/build_config.h"
|
||
#include "util/misc/initialization_state_dcheck.h"
|
||
#include "util/win/address_types.h"
|
||
#include "util/win/process_info.h"
|
||
|
||
namespace crashpad {
|
||
|
||
//! \brief State of process being read by ProcessReaderWin.
|
||
enum class ProcessSuspensionState : bool {
|
||
//! \brief The process has not been suspended.
|
||
kRunning,
|
||
|
||
//! \brief The process is suspended.
|
||
kSuspended,
|
||
};
|
||
|
||
//! \brief Accesses information about another process, identified by a `HANDLE`.
|
||
class ProcessReaderWin {
|
||
public:
|
||
//! \brief Contains information about a thread that belongs to a process.
|
||
struct Thread {
|
||
Thread();
|
||
~Thread() {}
|
||
|
||
union {
|
||
CONTEXT native;
|
||
#if defined(ARCH_CPU_64_BITS)
|
||
WOW64_CONTEXT wow64;
|
||
#endif;
|
||
} context;
|
||
uint64_t id;
|
||
WinVMAddress teb;
|
||
WinVMAddress stack_region_address;
|
||
WinVMSize stack_region_size;
|
||
uint32_t suspend_count;
|
||
uint32_t priority_class;
|
||
uint32_t priority;
|
||
};
|
||
|
||
ProcessReaderWin();
|
||
~ProcessReaderWin();
|
||
|
||
//! \brief Initializes this object. This method must be called before any
|
||
//! other.
|
||
//!
|
||
//! \param[in] process Process handle, must have `PROCESS_QUERY_INFORMATION`,
|
||
//! `PROCESS_VM_READ`, and `PROCESS_DUP_HANDLE` access.
|
||
//! \param[in] suspension_state Whether \a process has already been suspended
|
||
//! by the caller. Typically, this will be
|
||
//! ProcessSuspensionState::kSuspended, except for testing uses and where
|
||
//! the reader is reading itself.
|
||
//!
|
||
//! \return `true` on success, indicating that this object will respond
|
||
//! validly to further method calls. `false` on failure. On failure, no
|
||
//! further method calls should be made.
|
||
//!
|
||
//! \sa ScopedProcessSuspend
|
||
bool Initialize(HANDLE process, ProcessSuspensionState suspension_state);
|
||
|
||
//! \return `true` if the target task is a 64-bit process.
|
||
bool Is64Bit() const { return process_info_.Is64Bit(); }
|
||
|
||
pid_t ProcessID() const { return process_info_.ProcessID(); }
|
||
pid_t ParentProcessID() const { return process_info_.ParentProcessID(); }
|
||
|
||
bool ReadMemory(WinVMAddress at, WinVMSize num_bytes, void* into) const;
|
||
|
||
//! \brief Determines the target process' start time.
|
||
//!
|
||
//! \param[out] start_time The time that the process started.
|
||
//!
|
||
//! \return `true` on success, `false` on failure, with a warning logged.
|
||
bool StartTime(timeval* start_time) const;
|
||
|
||
//! \brief Determines the target process' execution time.
|
||
//!
|
||
//! \param[out] user_time The amount of time the process has executed code in
|
||
//! user mode.
|
||
//! \param[out] system_time The amount of time the process has executed code
|
||
//! in kernel mode.
|
||
//!
|
||
//! \return `true` on success, `false` on failure, with a warning logged.
|
||
bool CPUTimes(timeval* user_time, timeval* system_time) const;
|
||
|
||
//! \return The threads that are in the process. The first element (at index
|
||
//! `0`) corresponds to the main thread.
|
||
const std::vector<Thread>& Threads();
|
||
|
||
//! \return The modules loaded in the process. The first element (at index
|
||
//! `0`) corresponds to the main executable.
|
||
const std::vector<ProcessInfo::Module>& Modules();
|
||
|
||
private:
|
||
template <class Traits>
|
||
void ReadThreadData(bool is_64_reading_32);
|
||
|
||
HANDLE process_;
|
||
ProcessInfo process_info_;
|
||
std::vector<Thread> threads_;
|
||
std::vector<ProcessInfo::Module> modules_;
|
||
ProcessSuspensionState suspension_state_;
|
||
bool initialized_threads_;
|
||
InitializationStateDcheck initialized_;
|
||
|
||
DISALLOW_COPY_AND_ASSIGN(ProcessReaderWin);
|
||
};
|
||
|
||
} // namespace crashpad
|
||
|
||
#endif // CRASHPAD_SNAPSHOT_WIN_PROCESS_READER_WIN_H_
|