a73df601b7
All intercept requests and crash dump requests must now specify a dump_type, which can be one of kDebuggerdNativeBacktrace, kDebuggerdTombstone or kDebuggerdJavaBacktrace. Each process can have only one outstanding intercept registered at a time. There's only one non-trivial change in this changeset; and that is to crash_dump. We now pass the type of dump via a command line argument instead of inferring it from the (resent) signal, this allows us to connect to tombstoned before we wait for the signal as the protocol requires. Test: debuggerd_test Change-Id: I189b215acfecd08ac52ab29117e3465da00e3a37
78 lines
2.3 KiB
C++
78 lines
2.3 KiB
C++
/*
|
|
* Copyright 2016, The Android Open Source Project
|
|
*
|
|
* 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.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <stdint.h>
|
|
|
|
#include "dump_type.h"
|
|
|
|
// Sockets in the ANDROID_SOCKET_NAMESPACE_RESERVED namespace.
|
|
// Both sockets are SOCK_SEQPACKET sockets, so no explicit length field is needed.
|
|
constexpr char kTombstonedCrashSocketName[] = "tombstoned_crash";
|
|
constexpr char kTombstonedJavaTraceSocketName[] = "tombstoned_java_trace";
|
|
constexpr char kTombstonedInterceptSocketName[] = "tombstoned_intercept";
|
|
|
|
enum class CrashPacketType : uint8_t {
|
|
// Initial request from crash_dump.
|
|
kDumpRequest = 0,
|
|
|
|
// Notification of a completed crash dump.
|
|
// Sent after a dump is completed and the process has been untraced, but
|
|
// before it has been resumed with SIGCONT.
|
|
kCompletedDump,
|
|
|
|
// Responses to kRequest.
|
|
// kPerformDump sends along an output fd via cmsg(3).
|
|
kPerformDump = 128,
|
|
kAbortDump,
|
|
};
|
|
|
|
struct DumpRequest {
|
|
DebuggerdDumpType dump_type;
|
|
int32_t pid;
|
|
};
|
|
|
|
// The full packet must always be written, regardless of whether the union is used.
|
|
struct TombstonedCrashPacket {
|
|
CrashPacketType packet_type;
|
|
union {
|
|
DumpRequest dump_request;
|
|
} packet;
|
|
};
|
|
|
|
// Comes with a file descriptor via SCM_RIGHTS.
|
|
// This packet should be sent before an actual dump happens.
|
|
struct InterceptRequest {
|
|
DebuggerdDumpType dump_type;
|
|
int32_t pid;
|
|
};
|
|
|
|
enum class InterceptStatus : uint8_t {
|
|
// Returned when an intercept of a different type has already been
|
|
// registered (and is active) for a given PID.
|
|
kFailedAlreadyRegistered,
|
|
// Returned in all other failure cases.
|
|
kFailed,
|
|
kStarted,
|
|
kRegistered,
|
|
};
|
|
|
|
// Sent either immediately upon failure, or when the intercept has been used.
|
|
struct InterceptResponse {
|
|
InterceptStatus status;
|
|
char error_message[127]; // always null-terminated
|
|
};
|