/* * Copyright (C) 2017 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. */ #include #include #include #include "adbconnection.h" #include "adbconnection/client.h" #include "android-base/endian.h" #include "android-base/stringprintf.h" #include "base/file_utils.h" #include "base/globals.h" #include "base/logging.h" #include "base/macros.h" #include "base/mutex.h" #include "base/socket_peer_is_trusted.h" #include "debugger.h" #include "jni/java_vm_ext.h" #include "jni/jni_env_ext.h" #include "mirror/throwable.h" #include "nativehelper/scoped_local_ref.h" #include "runtime-inl.h" #include "runtime_callbacks.h" #include "scoped_thread_state_change-inl.h" #include "well_known_classes.h" #include "fd_transport.h" #include "poll.h" #include #include #include #include #include #include namespace adbconnection { static constexpr size_t kJdwpHeaderLen = 11U; /* DDM support */ static constexpr uint8_t kJdwpDdmCmdSet = 199U; // 0xc7, or 'G'+128 static constexpr uint8_t kJdwpDdmCmd = 1U; // Messages sent from the transport using dt_fd_forward::kListenStartMessage; using dt_fd_forward::kListenEndMessage; using dt_fd_forward::kAcceptMessage; using dt_fd_forward::kCloseMessage; using dt_fd_forward::kHandshakeCompleteMessage; // Messages sent to the transport using dt_fd_forward::kPerformHandshakeMessage; using dt_fd_forward::kSkipHandshakeMessage; using android::base::StringPrintf; static constexpr const char kJdwpHandshake[14] = { 'J', 'D', 'W', 'P', '-', 'H', 'a', 'n', 'd', 's', 'h', 'a', 'k', 'e' }; static constexpr int kEventfdLocked = 0; static constexpr int kEventfdUnlocked = 1; static constexpr size_t kPacketHeaderLen = 11; static constexpr off_t kPacketSizeOff = 0; static constexpr off_t kPacketIdOff = 4; static constexpr off_t kPacketCommandSetOff = 9; static constexpr off_t kPacketCommandOff = 10; static constexpr uint8_t kDdmCommandSet = 199; static constexpr uint8_t kDdmChunkCommand = 1; static std::optional gState; static std::optional gPthread; static bool IsDebuggingPossible() { return art::Dbg::IsJdwpAllowed(); } // Begin running the debugger. void AdbConnectionDebuggerController::StartDebugger() { // The debugger thread is started for a debuggable or profileable-from-shell process. // The pid will be send to adbd for adb's "track-jdwp" and "track-app" services. // The thread will also set up the jdwp tunnel if the process is debuggable. if (IsDebuggingPossible() || art::Runtime::Current()->IsProfileableFromShell()) { connection_->StartDebuggerThreads(); } else { LOG(ERROR) << "Not starting debugger since process cannot load the jdwp agent."; } } // The debugger should have already shut down since the runtime is ending. As far // as the agent is concerned shutdown already happened when we went to kDeath // state. We need to clean up our threads still though and this is a good time // to do it since the runtime is still able to handle all the normal state // transitions. void AdbConnectionDebuggerController::StopDebugger() { // Stop our threads. gState->StopDebuggerThreads(); // Wait for our threads to actually return and cleanup the pthread. if (gPthread.has_value()) { void* ret_unused; if (TEMP_FAILURE_RETRY(pthread_join(gPthread.value(), &ret_unused)) != 0) { PLOG(ERROR) << "Failed to join debugger threads!"; } gPthread.reset(); } } bool AdbConnectionDebuggerController::IsDebuggerConfigured() { return IsDebuggingPossible() && !art::Runtime::Current()->GetJdwpOptions().empty(); } void AdbConnectionDdmCallback::DdmPublishChunk(uint32_t type, const art::ArrayRef& data) { connection_->PublishDdmData(type, data); } class ScopedEventFdLock { public: explicit ScopedEventFdLock(int fd) : fd_(fd), data_(0) { TEMP_FAILURE_RETRY(read(fd_, &data_, sizeof(data_))); } ~ScopedEventFdLock() { TEMP_FAILURE_RETRY(write(fd_, &data_, sizeof(data_))); } private: int fd_; uint64_t data_; }; AdbConnectionState::AdbConnectionState(const std::string& agent_name) : agent_name_(agent_name), controller_(this), ddm_callback_(this), sleep_event_fd_(-1), control_ctx_(nullptr, adbconnection_client_destroy), local_agent_control_sock_(-1), remote_agent_control_sock_(-1), adb_connection_socket_(-1), adb_write_event_fd_(-1), shutting_down_(false), agent_loaded_(false), agent_listening_(false), agent_has_socket_(false), sent_agent_fds_(false), performed_handshake_(false), notified_ddm_active_(false), next_ddm_id_(1), started_debugger_threads_(false) { // Add the startup callback. art::ScopedObjectAccess soa(art::Thread::Current()); art::Runtime::Current()->GetRuntimeCallbacks()->AddDebuggerControlCallback(&controller_); } AdbConnectionState::~AdbConnectionState() { // Remove the startup callback. art::Thread* self = art::Thread::Current(); if (self != nullptr) { art::ScopedObjectAccess soa(self); art::Runtime::Current()->GetRuntimeCallbacks()->RemoveDebuggerControlCallback(&controller_); } } static jobject CreateAdbConnectionThread(art::Thread* thr) { JNIEnv* env = thr->GetJniEnv(); // Move to native state to talk with the jnienv api. art::ScopedThreadStateChange stsc(thr, art::kNative); ScopedLocalRef thr_name(env, env->NewStringUTF(kAdbConnectionThreadName)); ScopedLocalRef thr_group( env, env->GetStaticObjectField(art::WellKnownClasses::java_lang_ThreadGroup, art::WellKnownClasses::java_lang_ThreadGroup_systemThreadGroup)); return env->NewObject(art::WellKnownClasses::java_lang_Thread, art::WellKnownClasses::java_lang_Thread_init, thr_group.get(), thr_name.get(), /*Priority=*/ 0, /*Daemon=*/ true); } struct CallbackData { AdbConnectionState* this_; jobject thr_; }; static void* CallbackFunction(void* vdata) { std::unique_ptr data(reinterpret_cast(vdata)); art::Thread* self = art::Thread::Attach(kAdbConnectionThreadName, true, data->thr_); CHECK(self != nullptr) << "threads_being_born_ should have ensured thread could be attached."; // The name in Attach() is only for logging. Set the thread name. This is important so // that the thread is no longer seen as starting up. { art::ScopedObjectAccess soa(self); self->SetThreadName(kAdbConnectionThreadName); } // Release the peer. JNIEnv* env = self->GetJniEnv(); env->DeleteGlobalRef(data->thr_); data->thr_ = nullptr; { // The StartThreadBirth was called in the parent thread. We let the runtime know we are up // before going into the provided code. art::MutexLock mu(self, *art::Locks::runtime_shutdown_lock_); art::Runtime::Current()->EndThreadBirth(); } data->this_->RunPollLoop(self); int detach_result = art::Runtime::Current()->GetJavaVM()->DetachCurrentThread(); CHECK_EQ(detach_result, 0); return nullptr; } void AdbConnectionState::StartDebuggerThreads() { // First do all the final setup we need. CHECK_EQ(adb_write_event_fd_.get(), -1); CHECK_EQ(sleep_event_fd_.get(), -1); CHECK_EQ(local_agent_control_sock_.get(), -1); CHECK_EQ(remote_agent_control_sock_.get(), -1); sleep_event_fd_.reset(eventfd(kEventfdLocked, EFD_CLOEXEC)); CHECK_NE(sleep_event_fd_.get(), -1) << "Unable to create wakeup eventfd."; adb_write_event_fd_.reset(eventfd(kEventfdUnlocked, EFD_CLOEXEC)); CHECK_NE(adb_write_event_fd_.get(), -1) << "Unable to create write-lock eventfd."; { art::ScopedObjectAccess soa(art::Thread::Current()); art::Runtime::Current()->GetRuntimeCallbacks()->AddDdmCallback(&ddm_callback_); } // Setup the socketpair we use to talk to the agent. bool has_sockets; do { has_sockets = android::base::Socketpair(AF_UNIX, SOCK_SEQPACKET | SOCK_CLOEXEC, 0, &local_agent_control_sock_, &remote_agent_control_sock_); } while (!has_sockets && errno == EINTR); if (!has_sockets) { PLOG(FATAL) << "Unable to create socketpair for agent control!"; } // Next start the threads. art::Thread* self = art::Thread::Current(); art::ScopedObjectAccess soa(self); { art::Runtime* runtime = art::Runtime::Current(); art::MutexLock mu(self, *art::Locks::runtime_shutdown_lock_); if (runtime->IsShuttingDownLocked()) { // The runtime is shutting down so we cannot create new threads. This shouldn't really happen. LOG(ERROR) << "The runtime is shutting down when we are trying to start up the debugger!"; return; } runtime->StartThreadBirth(); } ScopedLocalRef thr(soa.Env(), CreateAdbConnectionThread(soa.Self())); // Note: Using pthreads instead of std::thread to not abort when the thread cannot be // created (exception support required). std::unique_ptr data(new CallbackData { this, soa.Env()->NewGlobalRef(thr.get()) }); started_debugger_threads_ = true; gPthread.emplace(); int pthread_create_result = pthread_create(&gPthread.value(), nullptr, &CallbackFunction, data.get()); if (pthread_create_result != 0) { gPthread.reset(); started_debugger_threads_ = false; // If the create succeeded the other thread will call EndThreadBirth. art::Runtime* runtime = art::Runtime::Current(); soa.Env()->DeleteGlobalRef(data->thr_); LOG(ERROR) << "Failed to create thread for adb-jdwp connection manager!"; art::MutexLock mu(art::Thread::Current(), *art::Locks::runtime_shutdown_lock_); runtime->EndThreadBirth(); return; } data.release(); // NOLINT pthreads API. } static bool FlagsSet(int16_t data, int16_t flags) { return (data & flags) == flags; } void AdbConnectionState::CloseFds() { { // Lock the write_event_fd so that concurrent PublishDdms will see that the connection is // closed. ScopedEventFdLock lk(adb_write_event_fd_); // shutdown(adb_connection_socket_, SHUT_RDWR); adb_connection_socket_.reset(); } // If we didn't load anything we will need to do the handshake again. performed_handshake_ = false; // If the agent isn't loaded we might need to tell ddms code the connection is closed. if (!agent_loaded_ && notified_ddm_active_) { NotifyDdms(/*active=*/false); } } void AdbConnectionState::NotifyDdms(bool active) { art::ScopedObjectAccess soa(art::Thread::Current()); DCHECK_NE(notified_ddm_active_, active); notified_ddm_active_ = active; if (active) { art::Dbg::DdmConnected(); } else { art::Dbg::DdmDisconnected(); } } uint32_t AdbConnectionState::NextDdmId() { // Just have a normal counter but always set the sign bit. return (next_ddm_id_++) | 0x80000000; } void AdbConnectionState::PublishDdmData(uint32_t type, const art::ArrayRef& data) { SendDdmPacket(NextDdmId(), DdmPacketType::kCmd, type, data); } void AdbConnectionState::SendDdmPacket(uint32_t id, DdmPacketType packet_type, uint32_t type, art::ArrayRef data) { // Get the write_event early to fail fast. ScopedEventFdLock lk(adb_write_event_fd_); if (adb_connection_socket_ == -1 || !performed_handshake_) { VLOG(jdwp) << "Not sending ddms data of type " << StringPrintf("%c%c%c%c", static_cast(type >> 24), static_cast(type >> 16), static_cast(type >> 8), static_cast(type)) << " due to no connection!"; // Adb is not connected. return; } // the adb_write_event_fd_ will ensure that the adb_connection_socket_ will not go away until // after we have sent our data. static constexpr uint32_t kDdmPacketHeaderSize = kJdwpHeaderLen // jdwp command packet size + sizeof(uint32_t) // Type + sizeof(uint32_t); // length alignas(sizeof(uint32_t)) std::array pkt; uint8_t* pkt_data = pkt.data(); // Write the length first. *reinterpret_cast(pkt_data) = htonl(kDdmPacketHeaderSize + data.size()); pkt_data += sizeof(uint32_t); // Write the id next; *reinterpret_cast(pkt_data) = htonl(id); pkt_data += sizeof(uint32_t); // next the flags. (0 for cmd packet because DDMS). *(pkt_data++) = static_cast(packet_type); switch (packet_type) { case DdmPacketType::kCmd: { // Now the cmd-set *(pkt_data++) = kJdwpDdmCmdSet; // Now the command *(pkt_data++) = kJdwpDdmCmd; break; } case DdmPacketType::kReply: { // This is the error code bytes which are all 0 *(pkt_data++) = 0; *(pkt_data++) = 0; } } // These are at unaligned addresses so we need to do them manually. // now the type. uint32_t net_type = htonl(type); memcpy(pkt_data, &net_type, sizeof(net_type)); pkt_data += sizeof(uint32_t); // Now the data.size() uint32_t net_len = htonl(data.size()); memcpy(pkt_data, &net_len, sizeof(net_len)); pkt_data += sizeof(uint32_t); static uint32_t constexpr kIovSize = 2; struct iovec iovs[kIovSize] = { { pkt.data(), pkt.size() }, { const_cast(data.data()), data.size() }, }; // now pkt_header has the header. // use writev to send the actual data. ssize_t res = TEMP_FAILURE_RETRY(writev(adb_connection_socket_, iovs, kIovSize)); if (static_cast(res) != (kDdmPacketHeaderSize + data.size())) { PLOG(ERROR) << StringPrintf("Failed to send DDMS packet %c%c%c%c to debugger (%zd of %zu)", static_cast(type >> 24), static_cast(type >> 16), static_cast(type >> 8), static_cast(type), res, data.size() + kDdmPacketHeaderSize); } else { VLOG(jdwp) << StringPrintf("sent DDMS packet %c%c%c%c to debugger %zu", static_cast(type >> 24), static_cast(type >> 16), static_cast(type >> 8), static_cast(type), data.size() + kDdmPacketHeaderSize); } } void AdbConnectionState::SendAgentFds(bool require_handshake) { DCHECK(!sent_agent_fds_); const char* message = require_handshake ? kPerformHandshakeMessage : kSkipHandshakeMessage; union { cmsghdr cm; char buffer[CMSG_SPACE(dt_fd_forward::FdSet::kDataLength)]; } cm_un; iovec iov; iov.iov_base = const_cast(message); iov.iov_len = strlen(message) + 1; msghdr msg; msg.msg_name = nullptr; msg.msg_namelen = 0; msg.msg_iov = &iov; msg.msg_iovlen = 1; msg.msg_flags = 0; msg.msg_control = cm_un.buffer; msg.msg_controllen = sizeof(cm_un.buffer); cmsghdr* cmsg = CMSG_FIRSTHDR(&msg); cmsg->cmsg_len = CMSG_LEN(dt_fd_forward::FdSet::kDataLength); cmsg->cmsg_level = SOL_SOCKET; cmsg->cmsg_type = SCM_RIGHTS; // Duplicate the fds before sending them. android::base::unique_fd read_fd(art::DupCloexec(adb_connection_socket_)); CHECK_NE(read_fd.get(), -1) << "Failed to dup read_fd_: " << strerror(errno); android::base::unique_fd write_fd(art::DupCloexec(adb_connection_socket_)); CHECK_NE(write_fd.get(), -1) << "Failed to dup write_fd: " << strerror(errno); android::base::unique_fd write_lock_fd(art::DupCloexec(adb_write_event_fd_)); CHECK_NE(write_lock_fd.get(), -1) << "Failed to dup write_lock_fd: " << strerror(errno); dt_fd_forward::FdSet { read_fd.get(), write_fd.get(), write_lock_fd.get() }.WriteData(CMSG_DATA(cmsg)); int res = TEMP_FAILURE_RETRY(sendmsg(local_agent_control_sock_, &msg, MSG_EOR)); if (res < 0) { PLOG(ERROR) << "Failed to send agent adb connection fds."; } else { sent_agent_fds_ = true; VLOG(jdwp) << "Fds have been sent to jdwp agent!"; } } android::base::unique_fd AdbConnectionState::ReadFdFromAdb() { return android::base::unique_fd(adbconnection_client_receive_jdwp_fd(control_ctx_.get())); } bool AdbConnectionState::SetupAdbConnection() { int sleep_ms = 500; const int sleep_max_ms = 2 * 1000; const char* isa = GetInstructionSetString(art::Runtime::Current()->GetInstructionSet()); const AdbConnectionClientInfo infos[] = { {.type = AdbConnectionClientInfoType::pid, .data.pid = static_cast(getpid())}, {.type = AdbConnectionClientInfoType::debuggable, .data.debuggable = IsDebuggingPossible()}, {.type = AdbConnectionClientInfoType::profileable, .data.profileable = art::Runtime::Current()->IsProfileableFromShell()}, {.type = AdbConnectionClientInfoType::architecture, // GetInstructionSetString() returns a null-terminating C-style string. .data.architecture.name = isa, .data.architecture.size = strlen(isa)}, }; const AdbConnectionClientInfo *info_ptrs[] = {&infos[0], &infos[1], &infos[2], &infos[3]}; while (!shutting_down_) { // If adbd isn't running, because USB debugging was disabled or // perhaps the system is restarting it for "adb root", the // connect() will fail. We loop here forever waiting for it // to come back. // // Waking up and polling every couple of seconds is generally a // bad thing to do, but we only do this if the application is // debuggable *and* adbd isn't running. Still, for the sake // of battery life, we should consider timing out and giving // up after a few minutes in case somebody ships an app with // the debuggable flag set. control_ctx_.reset(adbconnection_client_new(info_ptrs, std::size(infos))); if (control_ctx_) { return true; } // We failed to connect. usleep(sleep_ms * 1000); sleep_ms += (sleep_ms >> 1); if (sleep_ms > sleep_max_ms) { sleep_ms = sleep_max_ms; } } return false; } void AdbConnectionState::RunPollLoop(art::Thread* self) { DCHECK(IsDebuggingPossible() || art::Runtime::Current()->IsProfileableFromShell()); CHECK_NE(agent_name_, ""); CHECK_EQ(self->GetState(), art::kNative); art::Locks::mutator_lock_->AssertNotHeld(self); self->SetState(art::kWaitingInMainDebuggerLoop); // shutting_down_ set by StopDebuggerThreads while (!shutting_down_) { // First, connect to adbd if we haven't already. if (!control_ctx_ && !SetupAdbConnection()) { LOG(ERROR) << "Failed to setup adb connection."; return; } while (!shutting_down_ && control_ctx_) { bool should_listen_on_connection = !agent_has_socket_ && !sent_agent_fds_; struct pollfd pollfds[4] = { { sleep_event_fd_, POLLIN, 0 }, // -1 as an fd causes it to be ignored by poll { (agent_loaded_ ? local_agent_control_sock_ : -1), POLLIN, 0 }, // Check for the control_sock_ actually going away. Only do this if we don't have an active // connection. { (adb_connection_socket_ == -1 ? adbconnection_client_pollfd(control_ctx_.get()) : -1), POLLIN | POLLRDHUP, 0 }, // if we have not loaded the agent either the adb_connection_socket_ is -1 meaning we don't // have a real connection yet or the socket through adb needs to be listened to for incoming // data that the agent or this plugin can handle. { should_listen_on_connection ? adb_connection_socket_ : -1, POLLIN | POLLRDHUP, 0 } }; int res = TEMP_FAILURE_RETRY(poll(pollfds, 4, -1)); if (res < 0) { PLOG(ERROR) << "Failed to poll!"; return; } // We don't actually care about doing this we just use it to wake us up. // const struct pollfd& sleep_event_poll = pollfds[0]; const struct pollfd& agent_control_sock_poll = pollfds[1]; const struct pollfd& control_sock_poll = pollfds[2]; const struct pollfd& adb_socket_poll = pollfds[3]; if (FlagsSet(agent_control_sock_poll.revents, POLLIN)) { CHECK(IsDebuggingPossible()); // This path is unexpected for a profileable process. DCHECK(agent_loaded_); char buf[257]; res = TEMP_FAILURE_RETRY(recv(local_agent_control_sock_, buf, sizeof(buf) - 1, 0)); if (res < 0) { PLOG(ERROR) << "Failed to read message from agent control socket! Retrying"; continue; } else { buf[res + 1] = '\0'; VLOG(jdwp) << "Local agent control sock has data: " << static_cast(buf); } if (memcmp(kListenStartMessage, buf, sizeof(kListenStartMessage)) == 0) { agent_listening_ = true; if (adb_connection_socket_ != -1) { SendAgentFds(/*require_handshake=*/ !performed_handshake_); } } else if (memcmp(kListenEndMessage, buf, sizeof(kListenEndMessage)) == 0) { agent_listening_ = false; } else if (memcmp(kHandshakeCompleteMessage, buf, sizeof(kHandshakeCompleteMessage)) == 0) { if (agent_has_socket_) { performed_handshake_ = true; } } else if (memcmp(kCloseMessage, buf, sizeof(kCloseMessage)) == 0) { CloseFds(); agent_has_socket_ = false; } else if (memcmp(kAcceptMessage, buf, sizeof(kAcceptMessage)) == 0) { agent_has_socket_ = true; sent_agent_fds_ = false; // We will only ever do the handshake once so reset this. performed_handshake_ = false; } else { LOG(ERROR) << "Unknown message received from debugger! '" << std::string(buf) << "'"; } } else if (FlagsSet(control_sock_poll.revents, POLLIN)) { if (!IsDebuggingPossible()) { // For a profielable process, this path can execute when the adbd restarts. control_ctx_.reset(); break; } bool maybe_send_fds = false; { // Hold onto this lock so that concurrent ddm publishes don't try to use an illegal fd. ScopedEventFdLock sefdl(adb_write_event_fd_); android::base::unique_fd new_fd(adbconnection_client_receive_jdwp_fd(control_ctx_.get())); if (new_fd == -1) { // Something went wrong. We need to retry getting the control socket. control_ctx_.reset(); break; } else if (adb_connection_socket_ != -1) { // We already have a connection. VLOG(jdwp) << "Ignoring second debugger. Accept then drop!"; if (new_fd >= 0) { new_fd.reset(); } } else { VLOG(jdwp) << "Adb connection established with fd " << new_fd; adb_connection_socket_ = std::move(new_fd); maybe_send_fds = true; } } if (maybe_send_fds && agent_loaded_ && agent_listening_) { VLOG(jdwp) << "Sending fds as soon as we received them."; // The agent was already loaded so this must be after a disconnection. Therefore have the // transport perform the handshake. SendAgentFds(/*require_handshake=*/ true); } } else if (FlagsSet(control_sock_poll.revents, POLLRDHUP)) { // The other end of the adb connection just dropped it. // Reset the connection since we don't have an active socket through the adb server. // Note this path is expected for either debuggable or profileable processes. DCHECK(!agent_has_socket_) << "We shouldn't be doing anything if there is already a " << "connection active"; control_ctx_.reset(); break; } else if (FlagsSet(adb_socket_poll.revents, POLLIN)) { CHECK(IsDebuggingPossible()); // This path is unexpected for a profileable process. DCHECK(!agent_has_socket_); if (!agent_loaded_) { HandleDataWithoutAgent(self); } else if (agent_listening_ && !sent_agent_fds_) { VLOG(jdwp) << "Sending agent fds again on data."; // Agent was already loaded so it can deal with the handshake. SendAgentFds(/*require_handshake=*/ true); } } else if (FlagsSet(adb_socket_poll.revents, POLLRDHUP)) { CHECK(IsDebuggingPossible()); // This path is unexpected for a profileable process. DCHECK(!agent_has_socket_); CloseFds(); } else { VLOG(jdwp) << "Woke up poll without anything to do!"; } } } } static uint32_t ReadUint32AndAdvance(/*in-out*/uint8_t** in) { uint32_t res; memcpy(&res, *in, sizeof(uint32_t)); *in = (*in) + sizeof(uint32_t); return ntohl(res); } void AdbConnectionState::HandleDataWithoutAgent(art::Thread* self) { DCHECK(!agent_loaded_); DCHECK(!agent_listening_); // TODO Should we check in some other way if we are userdebug/eng? CHECK(art::Dbg::IsJdwpAllowed()); // We try to avoid loading the agent which is expensive. First lets just perform the handshake. if (!performed_handshake_) { PerformHandshake(); return; } // Read the packet header to figure out if it is one we can handle. We only 'peek' into the stream // to see if it's one we can handle. This doesn't change the state of the socket. alignas(sizeof(uint32_t)) uint8_t packet_header[kPacketHeaderLen]; ssize_t res = TEMP_FAILURE_RETRY(recv(adb_connection_socket_.get(), packet_header, sizeof(packet_header), MSG_PEEK)); // We want to be very careful not to change the socket state until we know we succeeded. This will // let us fall-back to just loading the agent and letting it deal with everything. if (res <= 0) { // Close the socket. We either hit EOF or an error. if (res < 0) { PLOG(ERROR) << "Unable to peek into adb socket due to error. Closing socket."; } CloseFds(); return; } else if (res < static_cast(kPacketHeaderLen)) { LOG(ERROR) << "Unable to peek into adb socket. Loading agent to handle this. Only read " << res; AttachJdwpAgent(self); return; } uint32_t full_len = ntohl(*reinterpret_cast(packet_header + kPacketSizeOff)); uint32_t pkt_id = ntohl(*reinterpret_cast(packet_header + kPacketIdOff)); uint8_t pkt_cmd_set = packet_header[kPacketCommandSetOff]; uint8_t pkt_cmd = packet_header[kPacketCommandOff]; if (pkt_cmd_set != kDdmCommandSet || pkt_cmd != kDdmChunkCommand || full_len < kPacketHeaderLen) { VLOG(jdwp) << "Loading agent due to jdwp packet that cannot be handled by adbconnection."; AttachJdwpAgent(self); return; } uint32_t avail = -1; res = TEMP_FAILURE_RETRY(ioctl(adb_connection_socket_.get(), FIONREAD, &avail)); if (res < 0) { PLOG(ERROR) << "Failed to determine amount of readable data in socket! Closing connection"; CloseFds(); return; } else if (avail < full_len) { LOG(WARNING) << "Unable to handle ddm command in adbconnection due to insufficent data. " << "Expected " << full_len << " bytes but only " << avail << " are readable. " << "Loading jdwp agent to deal with this."; AttachJdwpAgent(self); return; } // Actually read the data. std::vector full_pkt; full_pkt.resize(full_len); res = TEMP_FAILURE_RETRY(recv(adb_connection_socket_.get(), full_pkt.data(), full_len, 0)); if (res < 0) { PLOG(ERROR) << "Failed to recv data from adb connection. Closing connection"; CloseFds(); return; } DCHECK_EQ(memcmp(full_pkt.data(), packet_header, sizeof(packet_header)), 0); size_t data_size = full_len - kPacketHeaderLen; if (data_size < (sizeof(uint32_t) * 2)) { // This is an error (the data isn't long enough) but to match historical behavior we need to // ignore it. return; } uint8_t* ddm_data = full_pkt.data() + kPacketHeaderLen; uint32_t ddm_type = ReadUint32AndAdvance(&ddm_data); uint32_t ddm_len = ReadUint32AndAdvance(&ddm_data); if (ddm_len > data_size - (2 * sizeof(uint32_t))) { // This is an error (the data isn't long enough) but to match historical behavior we need to // ignore it. return; } if (!notified_ddm_active_) { NotifyDdms(/*active=*/ true); } uint32_t reply_type; std::vector reply; if (!art::Dbg::DdmHandleChunk(self->GetJniEnv(), ddm_type, art::ArrayRef(reinterpret_cast(ddm_data), ddm_len), /*out*/&reply_type, /*out*/&reply)) { // To match historical behavior we don't send any response when there is no data to reply with. return; } SendDdmPacket(pkt_id, DdmPacketType::kReply, reply_type, art::ArrayRef(reply)); } void AdbConnectionState::PerformHandshake() { CHECK(!performed_handshake_); // Check to make sure we are able to read the whole handshake. uint32_t avail = -1; int res = TEMP_FAILURE_RETRY(ioctl(adb_connection_socket_.get(), FIONREAD, &avail)); if (res < 0 || avail < sizeof(kJdwpHandshake)) { if (res < 0) { PLOG(ERROR) << "Failed to determine amount of readable data for handshake!"; } LOG(WARNING) << "Closing connection to broken client."; CloseFds(); return; } // Perform the handshake. char handshake_msg[sizeof(kJdwpHandshake)]; res = TEMP_FAILURE_RETRY(recv(adb_connection_socket_.get(), handshake_msg, sizeof(handshake_msg), MSG_DONTWAIT)); if (res < static_cast(sizeof(kJdwpHandshake)) || strncmp(handshake_msg, kJdwpHandshake, sizeof(kJdwpHandshake)) != 0) { if (res < 0) { PLOG(ERROR) << "Failed to read handshake!"; } LOG(WARNING) << "Handshake failed!"; CloseFds(); return; } // Send the handshake back. res = TEMP_FAILURE_RETRY(send(adb_connection_socket_.get(), kJdwpHandshake, sizeof(kJdwpHandshake), 0)); if (res < static_cast(sizeof(kJdwpHandshake))) { PLOG(ERROR) << "Failed to send jdwp-handshake response."; CloseFds(); return; } performed_handshake_ = true; } void AdbConnectionState::AttachJdwpAgent(art::Thread* self) { art::Runtime* runtime = art::Runtime::Current(); self->AssertNoPendingException(); runtime->AttachAgent(/* env= */ nullptr, MakeAgentArg(), /* class_loader= */ nullptr); if (self->IsExceptionPending()) { LOG(ERROR) << "Failed to load agent " << agent_name_; art::ScopedObjectAccess soa(self); self->GetException()->Dump(); self->ClearException(); return; } agent_loaded_ = true; } bool ContainsArgument(const std::string& opts, const char* arg) { return opts.find(arg) != std::string::npos; } bool ValidateJdwpOptions(const std::string& opts) { bool res = true; // The adbconnection plugin requires that the jdwp agent be configured as a 'server' because that // is what adb expects and otherwise we will hit a deadlock as the poll loop thread stops waiting // for the fd's to be passed down. if (ContainsArgument(opts, "server=n")) { res = false; LOG(ERROR) << "Cannot start jdwp debugging with server=n from adbconnection."; } // We don't start the jdwp agent until threads are already running. It is far too late to suspend // everything. if (ContainsArgument(opts, "suspend=y")) { res = false; LOG(ERROR) << "Cannot use suspend=y with late-init jdwp."; } return res; } std::string AdbConnectionState::MakeAgentArg() { const std::string& opts = art::Runtime::Current()->GetJdwpOptions(); DCHECK(ValidateJdwpOptions(opts)); // TODO Get agent_name_ from something user settable? return agent_name_ + "=" + opts + (opts.empty() ? "" : ",") + "ddm_already_active=" + (notified_ddm_active_ ? "y" : "n") + "," + // See the comment above for why we need to be server=y. Since the agent defaults to server=n // we will add it if it wasn't already present for the convenience of the user. (ContainsArgument(opts, "server=y") ? "" : "server=y,") + // See the comment above for why we need to be suspend=n. Since the agent defaults to // suspend=y we will add it if it wasn't already present. (ContainsArgument(opts, "suspend=n") ? "" : "suspend=n,") + "transport=dt_fd_forward,address=" + std::to_string(remote_agent_control_sock_); } void AdbConnectionState::StopDebuggerThreads() { // The regular agent system will take care of unloading the agent (if needed). shutting_down_ = true; // Wakeup the poll loop. uint64_t data = 1; if (sleep_event_fd_ != -1) { TEMP_FAILURE_RETRY(write(sleep_event_fd_, &data, sizeof(data))); } } // The plugin initialization function. extern "C" bool ArtPlugin_Initialize() { DCHECK(art::Runtime::Current()->GetJdwpProvider() == art::JdwpProvider::kAdbConnection); // TODO Provide some way for apps to set this maybe? gState.emplace(kDefaultJdwpAgentName); return ValidateJdwpOptions(art::Runtime::Current()->GetJdwpOptions()); } extern "C" bool ArtPlugin_Deinitialize() { // We don't actually have to do anything here. The debugger (if one was // attached) was shutdown by the move to the kDeath runtime phase and the // adbconnection threads were shutdown by StopDebugger. return true; } } // namespace adbconnection