ccd6cffba3
The standard remote debugging workflow with gdb is to start the application on the remote host under gdbserver (e.g.: gdbserver :5039 a.out) and then connect to it with gdb. The same workflow is supported by debugserver/lldb-gdbserver with a very similar syntax but to access all features of lldb we need to be connected also to an lldb-platform instance running on the target. Before this change this had to be done manually with starting a separate lldb-platform on the target machine and then connecting to it with lldb before connecting to the process. This change modifies the behavior of "platform connect" with automatically connecting to the process instance if it was started by the remote platform. With this command replacing gdbserver in a gdb based worflow is usually as simple as replacing the command to execute gdbserver with executing lldb-platform. Differential revision: http://reviews.llvm.org/D14952 llvm-svn: 255016
144 lines
4.0 KiB
C++
144 lines
4.0 KiB
C++
//===-- GDBRemoteCommunicationServerPlatform.h ------------------*- C++ -*-===//
|
|
//
|
|
// The LLVM Compiler Infrastructure
|
|
//
|
|
// This file is distributed under the University of Illinois Open Source
|
|
// License. See LICENSE.TXT for details.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#ifndef liblldb_GDBRemoteCommunicationServerPlatform_h_
|
|
#define liblldb_GDBRemoteCommunicationServerPlatform_h_
|
|
|
|
// C Includes
|
|
// C++ Includes
|
|
#include <map>
|
|
#include <set>
|
|
|
|
// Other libraries and framework includes
|
|
// Project includes
|
|
#include "GDBRemoteCommunicationServerCommon.h"
|
|
#include "lldb/Host/Socket.h"
|
|
|
|
namespace lldb_private {
|
|
namespace process_gdb_remote {
|
|
|
|
class GDBRemoteCommunicationServerPlatform :
|
|
public GDBRemoteCommunicationServerCommon
|
|
{
|
|
public:
|
|
typedef std::map<uint16_t, lldb::pid_t> PortMap;
|
|
|
|
GDBRemoteCommunicationServerPlatform(const Socket::SocketProtocol socket_protocol,
|
|
const char* socket_scheme);
|
|
|
|
~GDBRemoteCommunicationServerPlatform() override;
|
|
|
|
Error
|
|
LaunchProcess () override;
|
|
|
|
// Set both ports to zero to let the platform automatically bind to
|
|
// a port chosen by the OS.
|
|
void
|
|
SetPortMap (PortMap &&port_map);
|
|
|
|
//----------------------------------------------------------------------
|
|
// If we are using a port map where we can only use certain ports,
|
|
// get the next available port.
|
|
//
|
|
// If we are using a port map and we are out of ports, return UINT16_MAX
|
|
//
|
|
// If we aren't using a port map, return 0 to indicate we should bind to
|
|
// port 0 and then figure out which port we used.
|
|
//----------------------------------------------------------------------
|
|
uint16_t
|
|
GetNextAvailablePort ();
|
|
|
|
bool
|
|
AssociatePortWithProcess (uint16_t port, lldb::pid_t pid);
|
|
|
|
bool
|
|
FreePort (uint16_t port);
|
|
|
|
bool
|
|
FreePortForProcess (lldb::pid_t pid);
|
|
|
|
void
|
|
SetPortOffset (uint16_t port_offset);
|
|
|
|
void
|
|
SetInferiorArguments (const lldb_private::Args& args);
|
|
|
|
Error
|
|
LaunchGDBServer(const lldb_private::Args& args,
|
|
std::string hostname,
|
|
lldb::pid_t& pid,
|
|
uint16_t& port,
|
|
std::string& socket_name);
|
|
|
|
void
|
|
SetPendingGdbServer(lldb::pid_t pid, uint16_t port, const std::string& socket_name);
|
|
|
|
protected:
|
|
const Socket::SocketProtocol m_socket_protocol;
|
|
const std::string m_socket_scheme;
|
|
Mutex m_spawned_pids_mutex;
|
|
std::set<lldb::pid_t> m_spawned_pids;
|
|
lldb::PlatformSP m_platform_sp;
|
|
|
|
PortMap m_port_map;
|
|
uint16_t m_port_offset;
|
|
struct { lldb::pid_t pid; uint16_t port; std::string socket_name; } m_pending_gdb_server;
|
|
|
|
PacketResult
|
|
Handle_qLaunchGDBServer (StringExtractorGDBRemote &packet);
|
|
|
|
PacketResult
|
|
Handle_qQueryGDBServer (StringExtractorGDBRemote &packet);
|
|
|
|
PacketResult
|
|
Handle_qKillSpawnedProcess (StringExtractorGDBRemote &packet);
|
|
|
|
PacketResult
|
|
Handle_qProcessInfo (StringExtractorGDBRemote &packet);
|
|
|
|
PacketResult
|
|
Handle_qGetWorkingDir (StringExtractorGDBRemote &packet);
|
|
|
|
PacketResult
|
|
Handle_QSetWorkingDir (StringExtractorGDBRemote &packet);
|
|
|
|
PacketResult
|
|
Handle_qC (StringExtractorGDBRemote &packet);
|
|
|
|
PacketResult
|
|
Handle_jSignalsInfo(StringExtractorGDBRemote &packet);
|
|
|
|
private:
|
|
bool
|
|
KillSpawnedProcess (lldb::pid_t pid);
|
|
|
|
bool
|
|
DebugserverProcessReaped (lldb::pid_t pid);
|
|
|
|
static bool
|
|
ReapDebugserverProcess (void *callback_baton,
|
|
lldb::pid_t pid,
|
|
bool exited,
|
|
int signal,
|
|
int status);
|
|
|
|
static const FileSpec&
|
|
GetDomainSocketDir();
|
|
|
|
static FileSpec
|
|
GetDomainSocketPath(const char* prefix);
|
|
|
|
DISALLOW_COPY_AND_ASSIGN (GDBRemoteCommunicationServerPlatform);
|
|
};
|
|
|
|
} // namespace process_gdb_remote
|
|
} // namespace lldb_private
|
|
|
|
#endif // liblldb_GDBRemoteCommunicationServerPlatform_h_
|