crashpad/util/linux/ptrace_connection.h
Joshua Peraza 59c5d848e5 linux: Refactor ptrace usage.
1) Add PtraceConnection which serves as the base class for specific
types of connections Crashpad uses to trace processes.
2) Add DirectPtraceConnection which is used when the handler process
has `ptrace` capabilities for the target process.
3) Move `ptrace` logic into Ptracer. This class isolates `ptrace` call
logic for use by various PtraceConnection implementations.

Bug: crashpad:30
Change-Id: I98083134a9f7d9f085e4cc816d2b85ffd6d73162
Reviewed-on: https://chromium-review.googlesource.com/671659
Commit-Queue: Joshua Peraza <jperaza@chromium.org>
Reviewed-by: Mark Mentovai <mark@chromium.org>
Reviewed-by: Leonard Mosescu <mosescu@chromium.org>
2017-09-22 16:25:32 +00:00

53 lines
1.7 KiB
C++

// 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_PTRACE_CONNECTION_H_
#define CRASHPAD_UTIL_LINUX_PTRACE_CONNECTION_H_
#include <sys/types.h>
#include "util/linux/thread_info.h"
namespace crashpad {
//! \brief Provides an interface for making `ptrace` requests against a process
//! and its threads.
class PtraceConnection {
public:
virtual ~PtraceConnection() {}
//! \brief Returns the process ID of the connected process.
virtual pid_t GetProcessID() = 0;
//! \brief Adds a new thread to this connection.
//!
//! \param[in] tid The thread ID of the thread to attach.
//! \return `true` on success. `false` on failure with a message logged.
virtual bool Attach(pid_t tid) = 0;
//! \brief Returns `true` if connected to a 64-bit process.
virtual bool Is64Bit() = 0;
//! \brief Retrieves a ThreadInfo for a target thread.
//!
//! \param[in] tid The thread ID of the target thread.
//! \param[out] info Information about the thread.
//! \return `true` on success. `false` on failure with a message logged.
virtual bool GetThreadInfo(pid_t tid, ThreadInfo* info) = 0;
};
} // namespace crashpad
#endif // CRASHPAD_UTIL_LINUX_PTRACE_CONNECTION_H_