Index: third_party/crashpad/crashpad/util/linux/process_memory.h |
diff --git a/third_party/crashpad/crashpad/util/linux/process_memory.h b/third_party/crashpad/crashpad/util/linux/process_memory.h |
new file mode 100644 |
index 0000000000000000000000000000000000000000..6a04dea3b3368a1524b96233ae7ae84d5634e72f |
--- /dev/null |
+++ b/third_party/crashpad/crashpad/util/linux/process_memory.h |
@@ -0,0 +1,105 @@ |
+// Copyright 2017 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_LINUX_PROCESS_MEMORY_H_ |
+#define CRASHPAD_UTIL_LINUX_PROCESS_MEMORY_H_ |
+ |
+#include <sys/types.h> |
+ |
+#include <string> |
+ |
+#include "base/files/scoped_file.h" |
+#include "base/macros.h" |
+#include "util/linux/address_types.h" |
+ |
+namespace crashpad { |
+ |
+//! \brief Accesses the memory of another process. |
+class ProcessMemory { |
+ public: |
+ ProcessMemory(); |
+ ~ProcessMemory(); |
+ |
+ //! \brief Initializes this object to read the memory of a process whose ID |
+ //! is \a pid. |
+ //! |
+ //! This method must be called successfully prior to calling any other method |
+ //! in this class. |
+ //! |
+ //! \param[in] pid The process ID of a target process. |
+ //! |
+ //! \return `true` on success, `false` on failure with a message logged. |
+ bool Initialize(pid_t pid); |
+ |
+ //! \brief Copies memory from the target process into a caller-provided buffer |
+ //! in the current process. |
+ //! |
+ //! \param[in] address The address, in the target process' address space, of |
+ //! the memory region to copy. |
+ //! \param[in] size The size, in bytes, of the memory region to copy. |
+ //! \a buffer must be at least this size. |
+ //! \param[out] buffer The buffer into which the contents of the other |
+ //! process' memory will be copied. |
+ //! |
+ //! \return `true` on success, with \a buffer filled appropriately. `false` on |
+ //! failure, with a message logged. |
+ bool Read(LinuxVMAddress address, size_t size, void* buffer) const; |
+ |
+ //! \brief Reads a `NUL`-terminated C string from the target process into a |
+ //! string in the current process. |
+ //! |
+ //! The length of the string need not be known ahead of time. This method will |
+ //! read contiguous memory until a `NUL` terminator is found. |
+ //! |
+ //! \param[in] address The address, in the target process’s address space, of |
+ //! the string to copy. |
+ //! \param[out] string The string read from the other process. |
+ //! |
+ //! \return `true` on success, with \a string set appropriately. `false` on |
+ //! failure, with a message logged. Failures can occur, for example, when |
+ //! encountering unmapped or unreadable pages. |
+ bool ReadCString(LinuxVMAddress address, std::string* string) const; |
+ |
+ //! \brief Reads a `NUL`-terminated C string from the target process into a |
+ //! string in the current process. |
+ //! |
+ //! \param[in] address The address, in the target process’s address space, of |
+ //! the string to copy. |
+ //! \param[in] size The maximum number of bytes to read. The string is |
+ //! required to be `NUL`-terminated within this many bytes. |
+ //! \param[out] string The string read from the other process. |
+ //! |
+ //! \return `true` on success, with \a string set appropriately. `false` on |
+ //! failure, with a message logged. Failures can occur, for example, when |
+ //! a `NUL` terminator is not found within \a size bytes, or when |
+ //! encountering unmapped or unreadable pages. |
+ bool ReadCStringSizeLimited(LinuxVMAddress address, |
+ size_t size, |
+ std::string* string) const; |
+ |
+ private: |
+ bool ReadCStringInternal(LinuxVMAddress address, |
+ bool has_size, |
+ size_t size, |
+ std::string* string) const; |
+ |
+ base::ScopedFD mem_fd_; |
+ pid_t pid_; |
+ |
+ DISALLOW_COPY_AND_ASSIGN(ProcessMemory); |
+}; |
+ |
+} // namespace crashpad |
+ |
+#endif // CRASHPAD_UTIL_LINUX_PROCESS_MEMORY_H_ |