Modified the OptionGroupOptions to be able to specify only some of the options that should be appended by using the usage_mask in the group defintions and also provided a way to remap them to a new usage mask after the copy. This allows options to be re-used and also targetted for specific option groups. Modfied the CommandArgumentType to have a new eArgTypePlatform enumeration. Taught the option parser to be able to automatically use the appropriate auto completion for a given options if nothing is explicitly specified in the option definition. So you don't have to specify it in the option definition tables. Renamed the default host platform name to "host", and the default platform hostname to be "localhost". Modified the "file" and "platform select" commands to make sure all options and args are good prior to creating a new platform. Also defer the computation of the architecture in the file command until all options are parsed and the platform has either not been specified or reset to a new value to avoid computing the arch more than once. Switch the PluginManager code over to using llvm::StringRef for string comparisons and got rid of all the AccessorXXX functions in lieu of the newer mutex + collection singleton accessors. llvm-svn: 129483
408 lines
12 KiB
C++
408 lines
12 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"
|
|
|
|
// C Includes
|
|
#include <sys/sysctl.h>
|
|
|
|
// C++ Includes
|
|
// Other libraries and framework includes
|
|
// Project includes
|
|
#include "lldb/Breakpoint/BreakpointLocation.h"
|
|
#include "lldb/Core/ConnectionFileDescriptor.h"
|
|
#include "lldb/Core/Debugger.h"
|
|
#include "lldb/Core/Error.h"
|
|
#include "lldb/Core/Module.h"
|
|
#include "lldb/Core/ModuleList.h"
|
|
#include "lldb/Core/PluginManager.h"
|
|
#include "lldb/Core/StreamString.h"
|
|
#include "lldb/Host/FileSpec.h"
|
|
#include "lldb/Host/Host.h"
|
|
#include "lldb/Target/Process.h"
|
|
#include "lldb/Target/Target.h"
|
|
|
|
using namespace lldb;
|
|
using namespace lldb_private;
|
|
|
|
static bool g_initialized = false;
|
|
|
|
void
|
|
PlatformRemoteGDBServer::Initialize ()
|
|
{
|
|
if (g_initialized == false)
|
|
{
|
|
g_initialized = true;
|
|
PluginManager::RegisterPlugin (PlatformRemoteGDBServer::GetShortPluginNameStatic(),
|
|
PlatformRemoteGDBServer::GetDescriptionStatic(),
|
|
PlatformRemoteGDBServer::CreateInstance);
|
|
}
|
|
}
|
|
|
|
void
|
|
PlatformRemoteGDBServer::Terminate ()
|
|
{
|
|
if (g_initialized)
|
|
{
|
|
g_initialized = false;
|
|
PluginManager::UnregisterPlugin (PlatformRemoteGDBServer::CreateInstance);
|
|
}
|
|
}
|
|
|
|
Platform*
|
|
PlatformRemoteGDBServer::CreateInstance ()
|
|
{
|
|
return new PlatformRemoteGDBServer ();
|
|
}
|
|
|
|
const char *
|
|
PlatformRemoteGDBServer::GetShortPluginNameStatic()
|
|
{
|
|
return "remote-gdb-server";
|
|
}
|
|
|
|
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();
|
|
}
|
|
|
|
Error
|
|
PlatformRemoteGDBServer::ResolveExecutable (const FileSpec &exe_file,
|
|
const ArchSpec &exe_arch,
|
|
lldb::ModuleSP &exe_module_sp)
|
|
{
|
|
Error error;
|
|
error.SetErrorString ("PlatformRemoteGDBServer::ResolveExecutable() is unimplemented");
|
|
return error;
|
|
}
|
|
|
|
Error
|
|
PlatformRemoteGDBServer::GetFile (const FileSpec &platform_file,
|
|
const UUID *uuid_ptr,
|
|
FileSpec &local_file)
|
|
{
|
|
// Default to the local case
|
|
local_file = platform_file;
|
|
return Error();
|
|
}
|
|
|
|
//------------------------------------------------------------------
|
|
/// Default Constructor
|
|
//------------------------------------------------------------------
|
|
PlatformRemoteGDBServer::PlatformRemoteGDBServer () :
|
|
Platform(false), // This is a remote platform
|
|
m_gdb_client(true)
|
|
{
|
|
}
|
|
|
|
//------------------------------------------------------------------
|
|
/// 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)
|
|
{
|
|
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();
|
|
}
|
|
|
|
bool
|
|
PlatformRemoteGDBServer::IsConnected () const
|
|
{
|
|
return m_gdb_client.IsConnected();
|
|
}
|
|
|
|
Error
|
|
PlatformRemoteGDBServer::ConnectRemote (Args& args)
|
|
{
|
|
Error 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)
|
|
{
|
|
const char *url = args.GetArgumentAtIndex(0);
|
|
m_gdb_client.SetConnection (new ConnectionFileDescriptor());
|
|
const ConnectionStatus status = m_gdb_client.Connect(url, &error);
|
|
if (status == eConnectionStatusSuccess)
|
|
{
|
|
if (m_gdb_client.HandshakeWithServer(&error))
|
|
{
|
|
m_gdb_client.QueryNoAckModeSupported();
|
|
m_gdb_client.GetHostInfo();
|
|
#if 0
|
|
m_gdb_client.TestPacketSpeed(10000);
|
|
#endif
|
|
}
|
|
else
|
|
{
|
|
m_gdb_client.Disconnect();
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
error.SetErrorString ("\"platform connect\" takes a single argument: <connect-url>");
|
|
}
|
|
}
|
|
|
|
return error;
|
|
}
|
|
|
|
Error
|
|
PlatformRemoteGDBServer::DisconnectRemote ()
|
|
{
|
|
Error error;
|
|
m_gdb_client.Disconnect(&error);
|
|
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);
|
|
}
|
|
|
|
|
|
Error
|
|
PlatformRemoteGDBServer::LaunchProcess (ProcessLaunchInfo &launch_info)
|
|
{
|
|
Error error;
|
|
lldb::pid_t pid = LLDB_INVALID_PROCESS_ID;
|
|
|
|
m_gdb_client.SetSTDIN ("/dev/null");
|
|
m_gdb_client.SetSTDOUT ("/dev/null");
|
|
m_gdb_client.SetSTDERR ("/dev/null");
|
|
m_gdb_client.SetDisableASLR (launch_info.GetFlags().Test (eLaunchFlagDisableASLR));
|
|
|
|
const char *working_dir = launch_info.GetWorkingDirectory();
|
|
if (working_dir && working_dir[0])
|
|
{
|
|
m_gdb_client.SetWorkingDir (working_dir);
|
|
}
|
|
|
|
// Send the environment and the program + arguments after we connect
|
|
const char **argv = launch_info.GetArguments().GetConstArgumentVector();
|
|
const char **envp = launch_info.GetEnvironmentEntries().GetConstArgumentVector();
|
|
|
|
if (envp)
|
|
{
|
|
const char *env_entry;
|
|
for (int i=0; (env_entry = envp[i]); ++i)
|
|
{
|
|
if (m_gdb_client.SendEnvironmentPacket(env_entry) != 0)
|
|
break;
|
|
}
|
|
}
|
|
const uint32_t old_packet_timeout = m_gdb_client.SetPacketTimeout (5);
|
|
int arg_packet_err = m_gdb_client.SendArgumentsPacket (argv);
|
|
m_gdb_client.SetPacketTimeout (old_packet_timeout);
|
|
if (arg_packet_err == 0)
|
|
{
|
|
std::string error_str;
|
|
if (m_gdb_client.GetLaunchSuccess (error_str))
|
|
{
|
|
pid = m_gdb_client.GetCurrentProcessID ();
|
|
if (pid != LLDB_INVALID_PROCESS_ID)
|
|
launch_info.SetProcessID (pid);
|
|
}
|
|
else
|
|
{
|
|
error.SetErrorString (error_str.c_str());
|
|
}
|
|
}
|
|
else
|
|
{
|
|
error.SetErrorStringWithFormat("'A' packet returned an error: %i.\n", arg_packet_err);
|
|
}
|
|
return error;
|
|
}
|
|
|
|
lldb::ProcessSP
|
|
PlatformRemoteGDBServer::Attach (lldb::pid_t pid,
|
|
Debugger &debugger,
|
|
Target *target, // Can be NULL, if NULL create a new target, else use existing one
|
|
Listener &listener,
|
|
Error &error)
|
|
{
|
|
lldb::ProcessSP process_sp;
|
|
if (IsRemote())
|
|
{
|
|
if (IsConnected())
|
|
{
|
|
uint16_t port = m_gdb_client.LaunchGDBserverAndGetPort();
|
|
|
|
if (port == 0)
|
|
{
|
|
error.SetErrorStringWithFormat ("unable to launch a GDB server on '%s'", GetHostname ());
|
|
}
|
|
else
|
|
{
|
|
if (target == NULL)
|
|
{
|
|
TargetSP new_target_sp;
|
|
FileSpec emptyFileSpec;
|
|
ArchSpec emptyArchSpec;
|
|
|
|
error = debugger.GetTargetList().CreateTarget (debugger,
|
|
emptyFileSpec,
|
|
emptyArchSpec,
|
|
false,
|
|
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 (listener, "gdb-remote");
|
|
|
|
if (process_sp)
|
|
{
|
|
char connect_url[256];
|
|
const int connect_url_len = ::snprintf (connect_url,
|
|
sizeof(connect_url),
|
|
"connect://%s:%u",
|
|
GetHostname (),
|
|
port);
|
|
assert (connect_url_len < sizeof(connect_url));
|
|
error = process_sp->ConnectRemote (connect_url);
|
|
if (error.Success())
|
|
error = process_sp->Attach(pid);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
else
|
|
{
|
|
error.SetErrorString("not connected to remote gdb server");
|
|
}
|
|
}
|
|
return process_sp;
|
|
}
|
|
|
|
|