Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(327)

Unified Diff: third_party/crashpad/crashpad/util/win/process_info.h

Issue 1505213004: Copy Crashpad into the Chrome tree instead of importing it via DEPS (Closed) Base URL: https://chromium.googlesource.com/chromium/src.git@master
Patch Set: Address review comments, update README.chromium Created 5 years ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
Index: third_party/crashpad/crashpad/util/win/process_info.h
diff --git a/third_party/crashpad/crashpad/util/win/process_info.h b/third_party/crashpad/crashpad/util/win/process_info.h
new file mode 100644
index 0000000000000000000000000000000000000000..fb1b8b3e0ac6783e3b85e594d976277d79b269f9
--- /dev/null
+++ b/third_party/crashpad/crashpad/util/win/process_info.h
@@ -0,0 +1,202 @@
+// 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/numeric/checked_range.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;
+ };
+
+ struct Handle {
+ Handle();
+ ~Handle();
+
+ //! \brief A string representation of the handle's type.
+ std::wstring type_name;
+
+ //! \brief The handle's value.
+ int handle;
+
+ //! \brief The attributes for the handle, e.g. `OBJ_INHERIT`,
+ //! `OBJ_CASE_INSENSITIVE`, etc.
+ uint32_t attributes;
+
+ //! \brief The `ACCESS_MASK` for the handle in this process.
+ //!
+ //! See
+ //! http://blogs.msdn.com/b/openspecification/archive/2010/04/01/about-the-access-mask-structure.aspx
+ //! for more information.
+ uint32_t granted_access;
+
+ //! \brief The number of kernel references to the object that this handle
+ //! refers to.
+ uint32_t pointer_count;
+
+ //! \brief The number of open handles to the object that this handle refers
+ //! to.
+ uint32_t handle_count;
+ };
+
+ 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 Gets the address and size of the process's Process Environment
+ //! Block.
+ //!
+ //! \param[out] peb_address The address of the Process Environment Block.
+ //! \param[out] peb_size The size of the Process Environment Block.
+ void Peb(WinVMAddress* peb_address, WinVMSize* peb_size) 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;
+
+ //! \brief Retrieves information about all pages mapped into the process.
+ const std::vector<MEMORY_BASIC_INFORMATION64>& MemoryInfo() const;
+
+ //! \brief Given a range to be read from the target process, returns a vector
+ //! of ranges, representing the readable portions of the original range.
+ //!
+ //! \param[in] range The range being identified.
+ //!
+ //! \return A vector of ranges corresponding to the portion of \a range that
+ //! is readable based on the memory map.
+ std::vector<CheckedRange<WinVMAddress, WinVMSize>> GetReadableRanges(
+ const CheckedRange<WinVMAddress, WinVMSize>& range) const;
+
+ //! \brief Given a range in the target process, determines if the entire range
+ //! is readable.
+ //!
+ //! \param[in] range The range being inspected.
+ //!
+ //! \return `true` if the range is fully readable, otherwise `false` with a
+ //! message logged.
+ bool LoggingRangeIsFullyReadable(
+ const CheckedRange<WinVMAddress, WinVMSize>& range) const;
+
+ //! \brief Retrieves information about open handles in the target process.
+ const std::vector<Handle>& Handles() const;
+
+ private:
+ template <class Traits>
+ friend bool GetProcessBasicInformation(HANDLE process,
+ bool is_wow64,
+ ProcessInfo* process_info,
+ WinVMAddress* peb_address,
+ WinVMSize* peb_size);
+ template <class Traits>
+ friend bool ReadProcessData(HANDLE process,
+ WinVMAddress peb_address_vmaddr,
+ ProcessInfo* process_info);
+
+ friend bool ReadMemoryInfo(HANDLE process,
+ bool is_64_bit,
+ ProcessInfo* process_info);
+
+ std::vector<Handle> BuildHandleVector(HANDLE process) const;
+
+ pid_t process_id_;
+ pid_t inherited_from_process_id_;
+ HANDLE process_;
+ std::wstring command_line_;
+ WinVMAddress peb_address_;
+ WinVMSize peb_size_;
+ std::vector<Module> modules_;
+ std::vector<MEMORY_BASIC_INFORMATION64> memory_info_;
+
+ // Handles() is logically const, but updates this member on first retrieval.
+ // See https://crashpad.chromium.org/bug/9.
+ mutable std::vector<Handle> handles_;
+
+ bool is_64_bit_;
+ bool is_wow64_;
+ InitializationStateDcheck initialized_;
+
+ DISALLOW_COPY_AND_ASSIGN(ProcessInfo);
+};
+
+//! \brief Given a memory map of a process, and a range to be read from the
+//! target process, returns a vector of ranges, representing the readable
+//! portions of the original range.
+//!
+//! This is a free function for testing, but prefer
+//! ProcessInfo::GetReadableRanges().
+std::vector<CheckedRange<WinVMAddress, WinVMSize>> GetReadableRangesOfMemoryMap(
+ const CheckedRange<WinVMAddress, WinVMSize>& range,
+ const std::vector<MEMORY_BASIC_INFORMATION64>& memory_info);
+
+} // namespace crashpad
+
+#endif // CRASHPAD_UTIL_WIN_PROCESS_INFO_H_

Powered by Google App Engine
This is Rietveld 408576698