Summary: There was some confusion in the code about how to represent process environment. Most of the code (ab)used the Args class for this purpose, but some of it used a more basic StringList class instead. In either case, the fact that the underlying abstraction did not provide primitive operations for the typical environment operations meant that even a simple operation like checking for an environment variable value was several lines of code. This patch adds a separate Environment class, which is essentialy a llvm::StringMap<std::string> in disguise. To standard StringMap functionality, it adds a couple of new functions, which are specific to the environment use case: - (most important) envp conversion for passing into execve() and likes. Instead of trying to maintain a constantly up-to-date envp view, it provides a function which creates a envp view on demand, with the expectation that this will be called as the very last thing before handing the value to the system function. - insert(StringRef KeyEqValue) - splits KeyEqValue into (key, value) pair and inserts it into the environment map. - compose(value_type KeyValue) - takes a map entry and converts in back into "KEY=VALUE" representation. With this interface most of the environment-manipulating code becomes one-liners. The only tricky part was maintaining compatibility in SBLaunchInfo, which expects that the environment entries are accessible by index and that the returned const char* is backed by the launch info object (random access into maps is hard and the map stores the entry in a deconstructed form, so we cannot just return a .c_str() value). To solve this, I have the SBLaunchInfo convert the environment into the "envp" form, and use it to answer the environment queries. Extra code is added to make sure the envp version is always in sync. (This also improves the layering situation as Args was in the Interpreter module whereas Environment is in Utility.) Reviewers: zturner, davide, jingham, clayborg Subscribers: emaste, lldb-commits, mgorny Differential Revision: https://reviews.llvm.org/D41359 llvm-svn: 322174
882 lines
31 KiB
C++
882 lines
31 KiB
C++
//===-- PlatformRemoteGDBServer.cpp -----------------------------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include "PlatformRemoteGDBServer.h"
|
|
#include "lldb/Host/Config.h"
|
|
|
|
// C++ Includes
|
|
// Other libraries and framework includes
|
|
// Project includes
|
|
#include "lldb/Breakpoint/BreakpointLocation.h"
|
|
#include "lldb/Core/Debugger.h"
|
|
#include "lldb/Core/Module.h"
|
|
#include "lldb/Core/ModuleList.h"
|
|
#include "lldb/Core/ModuleSpec.h"
|
|
#include "lldb/Core/PluginManager.h"
|
|
#include "lldb/Core/StreamFile.h"
|
|
#include "lldb/Host/ConnectionFileDescriptor.h"
|
|
#include "lldb/Host/Host.h"
|
|
#include "lldb/Host/HostInfo.h"
|
|
#include "lldb/Host/PosixApi.h"
|
|
#include "lldb/Target/Process.h"
|
|
#include "lldb/Target/Target.h"
|
|
#include "lldb/Utility/FileSpec.h"
|
|
#include "lldb/Utility/Log.h"
|
|
#include "lldb/Utility/Status.h"
|
|
#include "lldb/Utility/StreamString.h"
|
|
#include "lldb/Utility/UriParser.h"
|
|
|
|
#include "Plugins/Process/Utility/GDBRemoteSignals.h"
|
|
|
|
using namespace lldb;
|
|
using namespace lldb_private;
|
|
using namespace lldb_private::platform_gdb_server;
|
|
|
|
static bool g_initialized = false;
|
|
|
|
void PlatformRemoteGDBServer::Initialize() {
|
|
Platform::Initialize();
|
|
|
|
if (g_initialized == false) {
|
|
g_initialized = true;
|
|
PluginManager::RegisterPlugin(
|
|
PlatformRemoteGDBServer::GetPluginNameStatic(),
|
|
PlatformRemoteGDBServer::GetDescriptionStatic(),
|
|
PlatformRemoteGDBServer::CreateInstance);
|
|
}
|
|
}
|
|
|
|
void PlatformRemoteGDBServer::Terminate() {
|
|
if (g_initialized) {
|
|
g_initialized = false;
|
|
PluginManager::UnregisterPlugin(PlatformRemoteGDBServer::CreateInstance);
|
|
}
|
|
|
|
Platform::Terminate();
|
|
}
|
|
|
|
PlatformSP PlatformRemoteGDBServer::CreateInstance(bool force,
|
|
const ArchSpec *arch) {
|
|
bool create = force;
|
|
if (!create) {
|
|
create = !arch->TripleVendorWasSpecified() && !arch->TripleOSWasSpecified();
|
|
}
|
|
if (create)
|
|
return PlatformSP(new PlatformRemoteGDBServer());
|
|
return PlatformSP();
|
|
}
|
|
|
|
ConstString PlatformRemoteGDBServer::GetPluginNameStatic() {
|
|
static ConstString g_name("remote-gdb-server");
|
|
return g_name;
|
|
}
|
|
|
|
const char *PlatformRemoteGDBServer::GetDescriptionStatic() {
|
|
return "A platform that uses the GDB remote protocol as the communication "
|
|
"transport.";
|
|
}
|
|
|
|
const char *PlatformRemoteGDBServer::GetDescription() {
|
|
if (m_platform_description.empty()) {
|
|
if (IsConnected()) {
|
|
// Send the get description packet
|
|
}
|
|
}
|
|
|
|
if (!m_platform_description.empty())
|
|
return m_platform_description.c_str();
|
|
return GetDescriptionStatic();
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::ResolveExecutable(
|
|
const ModuleSpec &module_spec, lldb::ModuleSP &exe_module_sp,
|
|
const FileSpecList *module_search_paths_ptr) {
|
|
// copied from PlatformRemoteiOS
|
|
|
|
Status error;
|
|
// Nothing special to do here, just use the actual file and architecture
|
|
|
|
ModuleSpec resolved_module_spec(module_spec);
|
|
|
|
// Resolve any executable within an apk on Android?
|
|
// Host::ResolveExecutableInBundle (resolved_module_spec.GetFileSpec());
|
|
|
|
if (resolved_module_spec.GetFileSpec().Exists() ||
|
|
module_spec.GetUUID().IsValid()) {
|
|
if (resolved_module_spec.GetArchitecture().IsValid() ||
|
|
resolved_module_spec.GetUUID().IsValid()) {
|
|
error = ModuleList::GetSharedModule(resolved_module_spec, exe_module_sp,
|
|
module_search_paths_ptr, NULL, NULL);
|
|
|
|
if (exe_module_sp && exe_module_sp->GetObjectFile())
|
|
return error;
|
|
exe_module_sp.reset();
|
|
}
|
|
// No valid architecture was specified or the exact arch wasn't
|
|
// found so ask the platform for the architectures that we should be
|
|
// using (in the correct order) and see if we can find a match that way
|
|
StreamString arch_names;
|
|
for (uint32_t idx = 0; GetSupportedArchitectureAtIndex(
|
|
idx, resolved_module_spec.GetArchitecture());
|
|
++idx) {
|
|
error = ModuleList::GetSharedModule(resolved_module_spec, exe_module_sp,
|
|
module_search_paths_ptr, NULL, NULL);
|
|
// Did we find an executable using one of the
|
|
if (error.Success()) {
|
|
if (exe_module_sp && exe_module_sp->GetObjectFile())
|
|
break;
|
|
else
|
|
error.SetErrorToGenericError();
|
|
}
|
|
|
|
if (idx > 0)
|
|
arch_names.PutCString(", ");
|
|
arch_names.PutCString(
|
|
resolved_module_spec.GetArchitecture().GetArchitectureName());
|
|
}
|
|
|
|
if (error.Fail() || !exe_module_sp) {
|
|
if (resolved_module_spec.GetFileSpec().Readable()) {
|
|
error.SetErrorStringWithFormat(
|
|
"'%s' doesn't contain any '%s' platform architectures: %s",
|
|
resolved_module_spec.GetFileSpec().GetPath().c_str(),
|
|
GetPluginName().GetCString(), arch_names.GetData());
|
|
} else {
|
|
error.SetErrorStringWithFormat(
|
|
"'%s' is not readable",
|
|
resolved_module_spec.GetFileSpec().GetPath().c_str());
|
|
}
|
|
}
|
|
} else {
|
|
error.SetErrorStringWithFormat(
|
|
"'%s' does not exist",
|
|
resolved_module_spec.GetFileSpec().GetPath().c_str());
|
|
}
|
|
|
|
return error;
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::GetModuleSpec(const FileSpec &module_file_spec,
|
|
const ArchSpec &arch,
|
|
ModuleSpec &module_spec) {
|
|
Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
|
|
|
|
const auto module_path = module_file_spec.GetPath(false);
|
|
|
|
if (!m_gdb_client.GetModuleInfo(module_file_spec, arch, module_spec)) {
|
|
if (log)
|
|
log->Printf(
|
|
"PlatformRemoteGDBServer::%s - failed to get module info for %s:%s",
|
|
__FUNCTION__, module_path.c_str(),
|
|
arch.GetTriple().getTriple().c_str());
|
|
return false;
|
|
}
|
|
|
|
if (log) {
|
|
StreamString stream;
|
|
module_spec.Dump(stream);
|
|
log->Printf(
|
|
"PlatformRemoteGDBServer::%s - got module info for (%s:%s) : %s",
|
|
__FUNCTION__, module_path.c_str(), arch.GetTriple().getTriple().c_str(),
|
|
stream.GetData());
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::GetFileWithUUID(const FileSpec &platform_file,
|
|
const UUID *uuid_ptr,
|
|
FileSpec &local_file) {
|
|
// Default to the local case
|
|
local_file = platform_file;
|
|
return Status();
|
|
}
|
|
|
|
//------------------------------------------------------------------
|
|
/// Default Constructor
|
|
//------------------------------------------------------------------
|
|
PlatformRemoteGDBServer::PlatformRemoteGDBServer()
|
|
: Platform(false), // This is a remote platform
|
|
m_gdb_client() {}
|
|
|
|
//------------------------------------------------------------------
|
|
/// Destructor.
|
|
///
|
|
/// The destructor is virtual since this class is designed to be
|
|
/// inherited from by the plug-in instance.
|
|
//------------------------------------------------------------------
|
|
PlatformRemoteGDBServer::~PlatformRemoteGDBServer() {}
|
|
|
|
bool PlatformRemoteGDBServer::GetSupportedArchitectureAtIndex(uint32_t idx,
|
|
ArchSpec &arch) {
|
|
ArchSpec remote_arch = m_gdb_client.GetSystemArchitecture();
|
|
|
|
if (idx == 0) {
|
|
arch = remote_arch;
|
|
return arch.IsValid();
|
|
} else if (idx == 1 && remote_arch.IsValid() &&
|
|
remote_arch.GetTriple().isArch64Bit()) {
|
|
arch.SetTriple(remote_arch.GetTriple().get32BitArchVariant());
|
|
return arch.IsValid();
|
|
}
|
|
return false;
|
|
}
|
|
|
|
size_t PlatformRemoteGDBServer::GetSoftwareBreakpointTrapOpcode(
|
|
Target &target, BreakpointSite *bp_site) {
|
|
// This isn't needed if the z/Z packets are supported in the GDB remote
|
|
// server. But we might need a packet to detect this.
|
|
return 0;
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::GetRemoteOSVersion() {
|
|
uint32_t major, minor, update;
|
|
if (m_gdb_client.GetOSVersion(major, minor, update)) {
|
|
m_major_os_version = major;
|
|
m_minor_os_version = minor;
|
|
m_update_os_version = update;
|
|
return true;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::GetRemoteOSBuildString(std::string &s) {
|
|
return m_gdb_client.GetOSBuildString(s);
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::GetRemoteOSKernelDescription(std::string &s) {
|
|
return m_gdb_client.GetOSKernelDescription(s);
|
|
}
|
|
|
|
// Remote Platform subclasses need to override this function
|
|
ArchSpec PlatformRemoteGDBServer::GetRemoteSystemArchitecture() {
|
|
return m_gdb_client.GetSystemArchitecture();
|
|
}
|
|
|
|
FileSpec PlatformRemoteGDBServer::GetRemoteWorkingDirectory() {
|
|
if (IsConnected()) {
|
|
Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
|
|
FileSpec working_dir;
|
|
if (m_gdb_client.GetWorkingDir(working_dir) && log)
|
|
log->Printf(
|
|
"PlatformRemoteGDBServer::GetRemoteWorkingDirectory() -> '%s'",
|
|
working_dir.GetCString());
|
|
return working_dir;
|
|
} else {
|
|
return Platform::GetRemoteWorkingDirectory();
|
|
}
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::SetRemoteWorkingDirectory(
|
|
const FileSpec &working_dir) {
|
|
if (IsConnected()) {
|
|
// Clear the working directory it case it doesn't get set correctly. This
|
|
// will
|
|
// for use to re-read it
|
|
Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::SetRemoteWorkingDirectory('%s')",
|
|
working_dir.GetCString());
|
|
return m_gdb_client.SetWorkingDir(working_dir) == 0;
|
|
} else
|
|
return Platform::SetRemoteWorkingDirectory(working_dir);
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::IsConnected() const {
|
|
return m_gdb_client.IsConnected();
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::ConnectRemote(Args &args) {
|
|
Status error;
|
|
if (IsConnected()) {
|
|
error.SetErrorStringWithFormat("the platform is already connected to '%s', "
|
|
"execute 'platform disconnect' to close the "
|
|
"current connection",
|
|
GetHostname());
|
|
} else {
|
|
if (args.GetArgumentCount() == 1) {
|
|
m_gdb_client.SetConnection(new ConnectionFileDescriptor());
|
|
// we're going to reuse the hostname when we connect to the debugserver
|
|
int port;
|
|
std::string path;
|
|
const char *url = args.GetArgumentAtIndex(0);
|
|
if (!url)
|
|
return Status("URL is null.");
|
|
llvm::StringRef scheme, hostname, pathname;
|
|
if (!UriParser::Parse(url, scheme, hostname, port, pathname))
|
|
return Status("Invalid URL: %s", url);
|
|
m_platform_scheme = scheme;
|
|
m_platform_hostname = hostname;
|
|
path = pathname;
|
|
|
|
const ConnectionStatus status = m_gdb_client.Connect(url, &error);
|
|
if (status == eConnectionStatusSuccess) {
|
|
if (m_gdb_client.HandshakeWithServer(&error)) {
|
|
m_gdb_client.GetHostInfo();
|
|
// If a working directory was set prior to connecting, send it down
|
|
// now
|
|
if (m_working_dir)
|
|
m_gdb_client.SetWorkingDir(m_working_dir);
|
|
} else {
|
|
m_gdb_client.Disconnect();
|
|
if (error.Success())
|
|
error.SetErrorString("handshake failed");
|
|
}
|
|
}
|
|
} else {
|
|
error.SetErrorString(
|
|
"\"platform connect\" takes a single argument: <connect-url>");
|
|
}
|
|
}
|
|
return error;
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::DisconnectRemote() {
|
|
Status error;
|
|
m_gdb_client.Disconnect(&error);
|
|
m_remote_signals_sp.reset();
|
|
return error;
|
|
}
|
|
|
|
const char *PlatformRemoteGDBServer::GetHostname() {
|
|
m_gdb_client.GetHostname(m_name);
|
|
if (m_name.empty())
|
|
return NULL;
|
|
return m_name.c_str();
|
|
}
|
|
|
|
const char *PlatformRemoteGDBServer::GetUserName(uint32_t uid) {
|
|
// Try and get a cache user name first
|
|
const char *cached_user_name = Platform::GetUserName(uid);
|
|
if (cached_user_name)
|
|
return cached_user_name;
|
|
std::string name;
|
|
if (m_gdb_client.GetUserName(uid, name))
|
|
return SetCachedUserName(uid, name.c_str(), name.size());
|
|
|
|
SetUserNameNotFound(uid); // Negative cache so we don't keep sending packets
|
|
return NULL;
|
|
}
|
|
|
|
const char *PlatformRemoteGDBServer::GetGroupName(uint32_t gid) {
|
|
const char *cached_group_name = Platform::GetGroupName(gid);
|
|
if (cached_group_name)
|
|
return cached_group_name;
|
|
std::string name;
|
|
if (m_gdb_client.GetGroupName(gid, name))
|
|
return SetCachedGroupName(gid, name.c_str(), name.size());
|
|
|
|
SetGroupNameNotFound(gid); // Negative cache so we don't keep sending packets
|
|
return NULL;
|
|
}
|
|
|
|
uint32_t PlatformRemoteGDBServer::FindProcesses(
|
|
const ProcessInstanceInfoMatch &match_info,
|
|
ProcessInstanceInfoList &process_infos) {
|
|
return m_gdb_client.FindProcesses(match_info, process_infos);
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::GetProcessInfo(
|
|
lldb::pid_t pid, ProcessInstanceInfo &process_info) {
|
|
return m_gdb_client.GetProcessInfo(pid, process_info);
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::LaunchProcess(ProcessLaunchInfo &launch_info) {
|
|
Log *log(GetLogIfAllCategoriesSet(LIBLLDB_LOG_PLATFORM));
|
|
Status error;
|
|
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::%s() called", __FUNCTION__);
|
|
|
|
auto num_file_actions = launch_info.GetNumFileActions();
|
|
for (decltype(num_file_actions) i = 0; i < num_file_actions; ++i) {
|
|
const auto file_action = launch_info.GetFileActionAtIndex(i);
|
|
if (file_action->GetAction() != FileAction::eFileActionOpen)
|
|
continue;
|
|
switch (file_action->GetFD()) {
|
|
case STDIN_FILENO:
|
|
m_gdb_client.SetSTDIN(file_action->GetFileSpec());
|
|
break;
|
|
case STDOUT_FILENO:
|
|
m_gdb_client.SetSTDOUT(file_action->GetFileSpec());
|
|
break;
|
|
case STDERR_FILENO:
|
|
m_gdb_client.SetSTDERR(file_action->GetFileSpec());
|
|
break;
|
|
}
|
|
}
|
|
|
|
m_gdb_client.SetDisableASLR(
|
|
launch_info.GetFlags().Test(eLaunchFlagDisableASLR));
|
|
m_gdb_client.SetDetachOnError(
|
|
launch_info.GetFlags().Test(eLaunchFlagDetachOnError));
|
|
|
|
FileSpec working_dir = launch_info.GetWorkingDirectory();
|
|
if (working_dir) {
|
|
m_gdb_client.SetWorkingDir(working_dir);
|
|
}
|
|
|
|
// Send the environment and the program + arguments after we connect
|
|
m_gdb_client.SendEnvironment(launch_info.GetEnvironment());
|
|
|
|
ArchSpec arch_spec = launch_info.GetArchitecture();
|
|
const char *arch_triple = arch_spec.GetTriple().str().c_str();
|
|
|
|
m_gdb_client.SendLaunchArchPacket(arch_triple);
|
|
if (log)
|
|
log->Printf(
|
|
"PlatformRemoteGDBServer::%s() set launch architecture triple to '%s'",
|
|
__FUNCTION__, arch_triple ? arch_triple : "<NULL>");
|
|
|
|
int arg_packet_err;
|
|
{
|
|
// Scope for the scoped timeout object
|
|
process_gdb_remote::GDBRemoteCommunication::ScopedTimeout timeout(
|
|
m_gdb_client, std::chrono::seconds(5));
|
|
arg_packet_err = m_gdb_client.SendArgumentsPacket(launch_info);
|
|
}
|
|
|
|
if (arg_packet_err == 0) {
|
|
std::string error_str;
|
|
if (m_gdb_client.GetLaunchSuccess(error_str)) {
|
|
const auto pid = m_gdb_client.GetCurrentProcessID(false);
|
|
if (pid != LLDB_INVALID_PROCESS_ID) {
|
|
launch_info.SetProcessID(pid);
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::%s() pid %" PRIu64
|
|
" launched successfully",
|
|
__FUNCTION__, pid);
|
|
} else {
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::%s() launch succeeded but we "
|
|
"didn't get a valid process id back!",
|
|
__FUNCTION__);
|
|
error.SetErrorString("failed to get PID");
|
|
}
|
|
} else {
|
|
error.SetErrorString(error_str.c_str());
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::%s() launch failed: %s",
|
|
__FUNCTION__, error.AsCString());
|
|
}
|
|
} else {
|
|
error.SetErrorStringWithFormat("'A' packet returned an error: %i",
|
|
arg_packet_err);
|
|
}
|
|
return error;
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::KillProcess(const lldb::pid_t pid) {
|
|
if (!KillSpawnedProcess(pid))
|
|
return Status("failed to kill remote spawned process");
|
|
return Status();
|
|
}
|
|
|
|
lldb::ProcessSP PlatformRemoteGDBServer::DebugProcess(
|
|
ProcessLaunchInfo &launch_info, Debugger &debugger,
|
|
Target *target, // Can be NULL, if NULL create a new target, else use
|
|
// existing one
|
|
Status &error) {
|
|
lldb::ProcessSP process_sp;
|
|
if (IsRemote()) {
|
|
if (IsConnected()) {
|
|
lldb::pid_t debugserver_pid = LLDB_INVALID_PROCESS_ID;
|
|
std::string connect_url;
|
|
if (!LaunchGDBServer(debugserver_pid, connect_url)) {
|
|
error.SetErrorStringWithFormat("unable to launch a GDB server on '%s'",
|
|
GetHostname());
|
|
} else {
|
|
if (target == NULL) {
|
|
TargetSP new_target_sp;
|
|
|
|
error = debugger.GetTargetList().CreateTarget(debugger, "", "", false,
|
|
NULL, new_target_sp);
|
|
target = new_target_sp.get();
|
|
} else
|
|
error.Clear();
|
|
|
|
if (target && error.Success()) {
|
|
debugger.GetTargetList().SetSelectedTarget(target);
|
|
|
|
// The darwin always currently uses the GDB remote debugger plug-in
|
|
// so even when debugging locally we are debugging remotely!
|
|
process_sp = target->CreateProcess(
|
|
launch_info.GetListenerForProcess(debugger), "gdb-remote", NULL);
|
|
|
|
if (process_sp) {
|
|
error = process_sp->ConnectRemote(nullptr, connect_url.c_str());
|
|
// Retry the connect remote one time...
|
|
if (error.Fail())
|
|
error = process_sp->ConnectRemote(nullptr, connect_url.c_str());
|
|
if (error.Success())
|
|
error = process_sp->Launch(launch_info);
|
|
else if (debugserver_pid != LLDB_INVALID_PROCESS_ID) {
|
|
printf("error: connect remote failed (%s)\n", error.AsCString());
|
|
KillSpawnedProcess(debugserver_pid);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
error.SetErrorString("not connected to remote gdb server");
|
|
}
|
|
}
|
|
return process_sp;
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::LaunchGDBServer(lldb::pid_t &pid,
|
|
std::string &connect_url) {
|
|
ArchSpec remote_arch = GetRemoteSystemArchitecture();
|
|
llvm::Triple &remote_triple = remote_arch.GetTriple();
|
|
|
|
uint16_t port = 0;
|
|
std::string socket_name;
|
|
bool launch_result = false;
|
|
if (remote_triple.getVendor() == llvm::Triple::Apple &&
|
|
remote_triple.getOS() == llvm::Triple::IOS) {
|
|
// When remote debugging to iOS, we use a USB mux that always talks
|
|
// to localhost, so we will need the remote debugserver to accept
|
|
// connections
|
|
// only from localhost, no matter what our current hostname is
|
|
launch_result =
|
|
m_gdb_client.LaunchGDBServer("127.0.0.1", pid, port, socket_name);
|
|
} else {
|
|
// All other hosts should use their actual hostname
|
|
launch_result =
|
|
m_gdb_client.LaunchGDBServer(nullptr, pid, port, socket_name);
|
|
}
|
|
|
|
if (!launch_result)
|
|
return false;
|
|
|
|
connect_url =
|
|
MakeGdbServerUrl(m_platform_scheme, m_platform_hostname, port,
|
|
(socket_name.empty()) ? nullptr : socket_name.c_str());
|
|
return true;
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::KillSpawnedProcess(lldb::pid_t pid) {
|
|
return m_gdb_client.KillSpawnedProcess(pid);
|
|
}
|
|
|
|
lldb::ProcessSP PlatformRemoteGDBServer::Attach(
|
|
ProcessAttachInfo &attach_info, Debugger &debugger,
|
|
Target *target, // Can be NULL, if NULL create a new target, else use
|
|
// existing one
|
|
Status &error) {
|
|
lldb::ProcessSP process_sp;
|
|
if (IsRemote()) {
|
|
if (IsConnected()) {
|
|
lldb::pid_t debugserver_pid = LLDB_INVALID_PROCESS_ID;
|
|
std::string connect_url;
|
|
if (!LaunchGDBServer(debugserver_pid, connect_url)) {
|
|
error.SetErrorStringWithFormat("unable to launch a GDB server on '%s'",
|
|
GetHostname());
|
|
} else {
|
|
if (target == NULL) {
|
|
TargetSP new_target_sp;
|
|
|
|
error = debugger.GetTargetList().CreateTarget(debugger, "", "", false,
|
|
NULL, new_target_sp);
|
|
target = new_target_sp.get();
|
|
} else
|
|
error.Clear();
|
|
|
|
if (target && error.Success()) {
|
|
debugger.GetTargetList().SetSelectedTarget(target);
|
|
|
|
// The darwin always currently uses the GDB remote debugger plug-in
|
|
// so even when debugging locally we are debugging remotely!
|
|
process_sp = target->CreateProcess(
|
|
attach_info.GetListenerForProcess(debugger), "gdb-remote", NULL);
|
|
if (process_sp) {
|
|
error = process_sp->ConnectRemote(nullptr, connect_url.c_str());
|
|
if (error.Success()) {
|
|
ListenerSP listener_sp = attach_info.GetHijackListener();
|
|
if (listener_sp)
|
|
process_sp->HijackProcessEvents(listener_sp);
|
|
error = process_sp->Attach(attach_info);
|
|
}
|
|
|
|
if (error.Fail() && debugserver_pid != LLDB_INVALID_PROCESS_ID) {
|
|
KillSpawnedProcess(debugserver_pid);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
error.SetErrorString("not connected to remote gdb server");
|
|
}
|
|
}
|
|
return process_sp;
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::MakeDirectory(const FileSpec &file_spec,
|
|
uint32_t mode) {
|
|
Status error = m_gdb_client.MakeDirectory(file_spec, mode);
|
|
Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::MakeDirectory(path='%s', mode=%o) "
|
|
"error = %u (%s)",
|
|
file_spec.GetCString(), mode, error.GetError(),
|
|
error.AsCString());
|
|
return error;
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::GetFilePermissions(const FileSpec &file_spec,
|
|
uint32_t &file_permissions) {
|
|
Status error = m_gdb_client.GetFilePermissions(file_spec, file_permissions);
|
|
Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::GetFilePermissions(path='%s', "
|
|
"file_permissions=%o) error = %u (%s)",
|
|
file_spec.GetCString(), file_permissions, error.GetError(),
|
|
error.AsCString());
|
|
return error;
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::SetFilePermissions(const FileSpec &file_spec,
|
|
uint32_t file_permissions) {
|
|
Status error = m_gdb_client.SetFilePermissions(file_spec, file_permissions);
|
|
Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::SetFilePermissions(path='%s', "
|
|
"file_permissions=%o) error = %u (%s)",
|
|
file_spec.GetCString(), file_permissions, error.GetError(),
|
|
error.AsCString());
|
|
return error;
|
|
}
|
|
|
|
lldb::user_id_t PlatformRemoteGDBServer::OpenFile(const FileSpec &file_spec,
|
|
uint32_t flags, uint32_t mode,
|
|
Status &error) {
|
|
return m_gdb_client.OpenFile(file_spec, flags, mode, error);
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::CloseFile(lldb::user_id_t fd, Status &error) {
|
|
return m_gdb_client.CloseFile(fd, error);
|
|
}
|
|
|
|
lldb::user_id_t
|
|
PlatformRemoteGDBServer::GetFileSize(const FileSpec &file_spec) {
|
|
return m_gdb_client.GetFileSize(file_spec);
|
|
}
|
|
|
|
uint64_t PlatformRemoteGDBServer::ReadFile(lldb::user_id_t fd, uint64_t offset,
|
|
void *dst, uint64_t dst_len,
|
|
Status &error) {
|
|
return m_gdb_client.ReadFile(fd, offset, dst, dst_len, error);
|
|
}
|
|
|
|
uint64_t PlatformRemoteGDBServer::WriteFile(lldb::user_id_t fd, uint64_t offset,
|
|
const void *src, uint64_t src_len,
|
|
Status &error) {
|
|
return m_gdb_client.WriteFile(fd, offset, src, src_len, error);
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::PutFile(const FileSpec &source,
|
|
const FileSpec &destination,
|
|
uint32_t uid, uint32_t gid) {
|
|
return Platform::PutFile(source, destination, uid, gid);
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::CreateSymlink(
|
|
const FileSpec &src, // The name of the link is in src
|
|
const FileSpec &dst) // The symlink points to dst
|
|
{
|
|
Status error = m_gdb_client.CreateSymlink(src, dst);
|
|
Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::CreateSymlink(src='%s', dst='%s') "
|
|
"error = %u (%s)",
|
|
src.GetCString(), dst.GetCString(), error.GetError(),
|
|
error.AsCString());
|
|
return error;
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::Unlink(const FileSpec &file_spec) {
|
|
Status error = m_gdb_client.Unlink(file_spec);
|
|
Log *log = GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PLATFORM);
|
|
if (log)
|
|
log->Printf("PlatformRemoteGDBServer::Unlink(path='%s') error = %u (%s)",
|
|
file_spec.GetCString(), error.GetError(), error.AsCString());
|
|
return error;
|
|
}
|
|
|
|
bool PlatformRemoteGDBServer::GetFileExists(const FileSpec &file_spec) {
|
|
return m_gdb_client.GetFileExists(file_spec);
|
|
}
|
|
|
|
Status PlatformRemoteGDBServer::RunShellCommand(
|
|
const char *command, // Shouldn't be NULL
|
|
const FileSpec &
|
|
working_dir, // Pass empty FileSpec to use the current working directory
|
|
int *status_ptr, // Pass NULL if you don't want the process exit status
|
|
int *signo_ptr, // Pass NULL if you don't want the signal that caused the
|
|
// process to exit
|
|
std::string
|
|
*command_output, // Pass NULL if you don't want the command output
|
|
uint32_t
|
|
timeout_sec) // Timeout in seconds to wait for shell program to finish
|
|
{
|
|
return m_gdb_client.RunShellCommand(command, working_dir, status_ptr,
|
|
signo_ptr, command_output, timeout_sec);
|
|
}
|
|
|
|
void PlatformRemoteGDBServer::CalculateTrapHandlerSymbolNames() {
|
|
m_trap_handlers.push_back(ConstString("_sigtramp"));
|
|
}
|
|
|
|
const UnixSignalsSP &PlatformRemoteGDBServer::GetRemoteUnixSignals() {
|
|
if (!IsConnected())
|
|
return Platform::GetRemoteUnixSignals();
|
|
|
|
if (m_remote_signals_sp)
|
|
return m_remote_signals_sp;
|
|
|
|
// If packet not implemented or JSON failed to parse,
|
|
// we'll guess the signal set based on the remote architecture.
|
|
m_remote_signals_sp = UnixSignals::Create(GetRemoteSystemArchitecture());
|
|
|
|
StringExtractorGDBRemote response;
|
|
auto result = m_gdb_client.SendPacketAndWaitForResponse("jSignalsInfo",
|
|
response, false);
|
|
|
|
if (result != decltype(result)::Success ||
|
|
response.GetResponseType() != response.eResponse)
|
|
return m_remote_signals_sp;
|
|
|
|
auto object_sp = StructuredData::ParseJSON(response.GetStringRef());
|
|
if (!object_sp || !object_sp->IsValid())
|
|
return m_remote_signals_sp;
|
|
|
|
auto array_sp = object_sp->GetAsArray();
|
|
if (!array_sp || !array_sp->IsValid())
|
|
return m_remote_signals_sp;
|
|
|
|
auto remote_signals_sp = std::make_shared<lldb_private::GDBRemoteSignals>();
|
|
|
|
bool done = array_sp->ForEach(
|
|
[&remote_signals_sp](StructuredData::Object *object) -> bool {
|
|
if (!object || !object->IsValid())
|
|
return false;
|
|
|
|
auto dict = object->GetAsDictionary();
|
|
if (!dict || !dict->IsValid())
|
|
return false;
|
|
|
|
// Signal number and signal name are required.
|
|
int signo;
|
|
if (!dict->GetValueForKeyAsInteger("signo", signo))
|
|
return false;
|
|
|
|
llvm::StringRef name;
|
|
if (!dict->GetValueForKeyAsString("name", name))
|
|
return false;
|
|
|
|
// We can live without short_name, description, etc.
|
|
bool suppress{false};
|
|
auto object_sp = dict->GetValueForKey("suppress");
|
|
if (object_sp && object_sp->IsValid())
|
|
suppress = object_sp->GetBooleanValue();
|
|
|
|
bool stop{false};
|
|
object_sp = dict->GetValueForKey("stop");
|
|
if (object_sp && object_sp->IsValid())
|
|
stop = object_sp->GetBooleanValue();
|
|
|
|
bool notify{false};
|
|
object_sp = dict->GetValueForKey("notify");
|
|
if (object_sp && object_sp->IsValid())
|
|
notify = object_sp->GetBooleanValue();
|
|
|
|
std::string description{""};
|
|
object_sp = dict->GetValueForKey("description");
|
|
if (object_sp && object_sp->IsValid())
|
|
description = object_sp->GetStringValue();
|
|
|
|
remote_signals_sp->AddSignal(signo, name.str().c_str(), suppress, stop,
|
|
notify, description.c_str());
|
|
return true;
|
|
});
|
|
|
|
if (done)
|
|
m_remote_signals_sp = std::move(remote_signals_sp);
|
|
|
|
return m_remote_signals_sp;
|
|
}
|
|
|
|
std::string PlatformRemoteGDBServer::MakeGdbServerUrl(
|
|
const std::string &platform_scheme, const std::string &platform_hostname,
|
|
uint16_t port, const char *socket_name) {
|
|
const char *override_scheme =
|
|
getenv("LLDB_PLATFORM_REMOTE_GDB_SERVER_SCHEME");
|
|
const char *override_hostname =
|
|
getenv("LLDB_PLATFORM_REMOTE_GDB_SERVER_HOSTNAME");
|
|
const char *port_offset_c_str =
|
|
getenv("LLDB_PLATFORM_REMOTE_GDB_SERVER_PORT_OFFSET");
|
|
int port_offset = port_offset_c_str ? ::atoi(port_offset_c_str) : 0;
|
|
|
|
return MakeUrl(override_scheme ? override_scheme : platform_scheme.c_str(),
|
|
override_hostname ? override_hostname
|
|
: platform_hostname.c_str(),
|
|
port + port_offset, socket_name);
|
|
}
|
|
|
|
std::string PlatformRemoteGDBServer::MakeUrl(const char *scheme,
|
|
const char *hostname,
|
|
uint16_t port, const char *path) {
|
|
StreamString result;
|
|
result.Printf("%s://%s", scheme, hostname);
|
|
if (port != 0)
|
|
result.Printf(":%u", port);
|
|
if (path)
|
|
result.Write(path, strlen(path));
|
|
return result.GetString();
|
|
}
|
|
|
|
lldb::ProcessSP PlatformRemoteGDBServer::ConnectProcess(
|
|
llvm::StringRef connect_url, llvm::StringRef plugin_name,
|
|
lldb_private::Debugger &debugger, lldb_private::Target *target,
|
|
lldb_private::Status &error) {
|
|
if (!IsRemote() || !IsConnected()) {
|
|
error.SetErrorString("Not connected to remote gdb server");
|
|
return nullptr;
|
|
}
|
|
return Platform::ConnectProcess(connect_url, plugin_name, debugger, target,
|
|
error);
|
|
}
|
|
|
|
size_t PlatformRemoteGDBServer::ConnectToWaitingProcesses(Debugger &debugger,
|
|
Status &error) {
|
|
std::vector<std::string> connection_urls;
|
|
GetPendingGdbServerList(connection_urls);
|
|
|
|
for (size_t i = 0; i < connection_urls.size(); ++i) {
|
|
ConnectProcess(connection_urls[i].c_str(), "", debugger, nullptr, error);
|
|
if (error.Fail())
|
|
return i; // We already connected to i process succsessfully
|
|
}
|
|
return connection_urls.size();
|
|
}
|
|
|
|
size_t PlatformRemoteGDBServer::GetPendingGdbServerList(
|
|
std::vector<std::string> &connection_urls) {
|
|
std::vector<std::pair<uint16_t, std::string>> remote_servers;
|
|
m_gdb_client.QueryGDBServer(remote_servers);
|
|
for (const auto &gdbserver : remote_servers) {
|
|
const char *socket_name_cstr =
|
|
gdbserver.second.empty() ? nullptr : gdbserver.second.c_str();
|
|
connection_urls.emplace_back(
|
|
MakeGdbServerUrl(m_platform_scheme, m_platform_hostname,
|
|
gdbserver.first, socket_name_cstr));
|
|
}
|
|
return connection_urls.size();
|
|
}
|