crashpad/util/win/process_info.h
Scott Graham 69d135acda win: make CrashpadInfo retrievable
The main goal was to get the beginnings of module iteration and retrieval
of CrashpadInfo in snapshot. The main change for that is to move
crashpad_info_client_options[_test] down out of mac/.

This also requires adding some of the supporting code of snapshot in
ProcessReaderWin, ProcessSnapshotWin, and ModuleSnapshotWin. These are
partially copied from Mac or stubbed out with lots of TODO annotations.
This is a bit unfortunate, but seemed like the most productive way to
make progress incrementally. That is, it's mostly placeholder at the
moment, but hopefully has the right shape for things to come.

R=mark@chromium.org
BUG=crashpad:1

Review URL: https://codereview.chromium.org/1052813002
2015-05-01 13:48:23 -07:00

108 lines
3.2 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_UTIL_WIN_PROCESS_INFO_H_
#define CRASHPAD_UTIL_WIN_PROCESS_INFO_H_
#include <sys/types.h>
#include <windows.h>
#include <string>
#include <vector>
#include "base/basictypes.h"
#include "util/misc/initialization_state_dcheck.h"
#include "util/win/address_types.h"
namespace crashpad {
//! \brief Gathers information about a process given its `HANDLE`. This consists
//! primarily of information stored in the Process Environment Block.
class ProcessInfo {
public:
//! \brief Contains information about a module loaded into a process.
struct Module {
Module();
~Module();
//! \brief The pathname used to load the module from disk.
std::wstring name;
//! \brief The base address of the loaded DLL.
WinVMAddress dll_base;
//! \brief The size of the module.
WinVMSize size;
//! \brief The module's timestamp.
time_t timestamp;
};
ProcessInfo();
~ProcessInfo();
//! \brief Initializes this object with information about the given
//! \a process.
//!
//! This method must be called successfully prior to calling any other
//! method in this class. This method may only be called once.
//!
//! \return `true` on success, `false` on failure with a message logged.
bool Initialize(HANDLE process);
//! \return `true` if the target process is a 64-bit process.
bool Is64Bit() const;
//! \return `true` if the target process is running on the Win32-on-Win64
//! subsystem.
bool IsWow64() const;
//! \return The target process's process ID.
pid_t ProcessID() const;
//! \return The target process's parent process ID.
pid_t ParentProcessID() const;
//! \return The command line from the target process's Process Environment
//! Block.
bool CommandLine(std::wstring* command_line) const;
//! \brief Retrieves the modules loaded into the target process.
//!
//! The modules are enumerated in initialization order as detailed in the
//! Process Environment Block. The main executable will always be the
//! first element.
bool Modules(std::vector<Module>* modules) const;
private:
template <class T>
friend bool ReadProcessData(HANDLE process,
WinVMAddress peb_address_vmaddr,
ProcessInfo* process_info);
pid_t process_id_;
pid_t inherited_from_process_id_;
std::wstring command_line_;
std::vector<Module> modules_;
bool is_64_bit_;
bool is_wow64_;
InitializationStateDcheck initialized_;
DISALLOW_COPY_AND_ASSIGN(ProcessInfo);
};
} // namespace crashpad
#endif // CRASHPAD_UTIL_WIN_PROCESS_INFO_H_