1 //===-- lldb-gdbserver.cpp --------------------------------------*- C++ -*-===// 2 // 3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions. 4 // See https://llvm.org/LICENSE.txt for license information. 5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception 6 // 7 //===----------------------------------------------------------------------===// 8 9 #include <cerrno> 10 #include <cstdint> 11 #include <cstdio> 12 #include <cstdlib> 13 #include <cstring> 14 15 #ifndef _WIN32 16 #include <csignal> 17 #include <unistd.h> 18 #endif 19 20 #include "LLDBServerUtilities.h" 21 #include "Plugins/Process/gdb-remote/GDBRemoteCommunicationServerLLGS.h" 22 #include "Plugins/Process/gdb-remote/ProcessGDBRemoteLog.h" 23 #include "lldb/Host/Config.h" 24 #include "lldb/Host/ConnectionFileDescriptor.h" 25 #include "lldb/Host/FileSystem.h" 26 #include "lldb/Host/Pipe.h" 27 #include "lldb/Host/Socket.h" 28 #include "lldb/Host/common/NativeProcessProtocol.h" 29 #include "lldb/Target/Process.h" 30 #include "lldb/Utility/Logging.h" 31 #include "lldb/Utility/Status.h" 32 #include "llvm/ADT/StringRef.h" 33 #include "llvm/Option/ArgList.h" 34 #include "llvm/Option/OptTable.h" 35 #include "llvm/Option/Option.h" 36 #include "llvm/Support/Errno.h" 37 #include "llvm/Support/WithColor.h" 38 39 #if defined(__linux__) 40 #include "Plugins/Process/Linux/NativeProcessLinux.h" 41 #elif defined(__FreeBSD__) 42 #include "Plugins/Process/FreeBSD/NativeProcessFreeBSD.h" 43 #elif defined(__NetBSD__) 44 #include "Plugins/Process/NetBSD/NativeProcessNetBSD.h" 45 #elif defined(_WIN32) 46 #include "Plugins/Process/Windows/Common/NativeProcessWindows.h" 47 #endif 48 49 #ifndef LLGS_PROGRAM_NAME 50 #define LLGS_PROGRAM_NAME "lldb-server" 51 #endif 52 53 #ifndef LLGS_VERSION_STR 54 #define LLGS_VERSION_STR "local_build" 55 #endif 56 57 using namespace llvm; 58 using namespace lldb; 59 using namespace lldb_private; 60 using namespace lldb_private::lldb_server; 61 using namespace lldb_private::process_gdb_remote; 62 63 namespace { 64 #if defined(__linux__) 65 typedef process_linux::NativeProcessLinux::Factory NativeProcessFactory; 66 #elif defined(__FreeBSD__) 67 typedef process_freebsd::NativeProcessFreeBSD::Factory NativeProcessFactory; 68 #elif defined(__NetBSD__) 69 typedef process_netbsd::NativeProcessNetBSD::Factory NativeProcessFactory; 70 #elif defined(_WIN32) 71 typedef NativeProcessWindows::Factory NativeProcessFactory; 72 #else 73 // Dummy implementation to make sure the code compiles 74 class NativeProcessFactory : public NativeProcessProtocol::Factory { 75 public: 76 llvm::Expected<std::unique_ptr<NativeProcessProtocol>> 77 Launch(ProcessLaunchInfo &launch_info, 78 NativeProcessProtocol::NativeDelegate &delegate, 79 MainLoop &mainloop) const override { 80 llvm_unreachable("Not implemented"); 81 } 82 llvm::Expected<std::unique_ptr<NativeProcessProtocol>> 83 Attach(lldb::pid_t pid, NativeProcessProtocol::NativeDelegate &delegate, 84 MainLoop &mainloop) const override { 85 llvm_unreachable("Not implemented"); 86 } 87 }; 88 #endif 89 } 90 91 #ifndef _WIN32 92 // Watch for signals 93 static int g_sighup_received_count = 0; 94 95 static void sighup_handler(MainLoopBase &mainloop) { 96 ++g_sighup_received_count; 97 98 Log *log(GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PROCESS)); 99 LLDB_LOGF(log, "lldb-server:%s swallowing SIGHUP (receive count=%d)", 100 __FUNCTION__, g_sighup_received_count); 101 102 if (g_sighup_received_count >= 2) 103 mainloop.RequestTermination(); 104 } 105 #endif // #ifndef _WIN32 106 107 void handle_attach_to_pid(GDBRemoteCommunicationServerLLGS &gdb_server, 108 lldb::pid_t pid) { 109 Status error = gdb_server.AttachToProcess(pid); 110 if (error.Fail()) { 111 fprintf(stderr, "error: failed to attach to pid %" PRIu64 ": %s\n", pid, 112 error.AsCString()); 113 exit(1); 114 } 115 } 116 117 void handle_attach_to_process_name(GDBRemoteCommunicationServerLLGS &gdb_server, 118 const std::string &process_name) { 119 // FIXME implement. 120 } 121 122 void handle_attach(GDBRemoteCommunicationServerLLGS &gdb_server, 123 const std::string &attach_target) { 124 assert(!attach_target.empty() && "attach_target cannot be empty"); 125 126 // First check if the attach_target is convertible to a long. If so, we'll use 127 // it as a pid. 128 char *end_p = nullptr; 129 const long int pid = strtol(attach_target.c_str(), &end_p, 10); 130 131 // We'll call it a match if the entire argument is consumed. 132 if (end_p && 133 static_cast<size_t>(end_p - attach_target.c_str()) == 134 attach_target.size()) 135 handle_attach_to_pid(gdb_server, static_cast<lldb::pid_t>(pid)); 136 else 137 handle_attach_to_process_name(gdb_server, attach_target); 138 } 139 140 void handle_launch(GDBRemoteCommunicationServerLLGS &gdb_server, 141 llvm::ArrayRef<llvm::StringRef> Arguments) { 142 ProcessLaunchInfo info; 143 info.GetFlags().Set(eLaunchFlagStopAtEntry | eLaunchFlagDebug | 144 eLaunchFlagDisableASLR); 145 info.SetArguments(Args(Arguments), true); 146 147 llvm::SmallString<64> cwd; 148 if (std::error_code ec = llvm::sys::fs::current_path(cwd)) { 149 llvm::errs() << "Error getting current directory: " << ec.message() << "\n"; 150 exit(1); 151 } 152 FileSpec cwd_spec(cwd); 153 FileSystem::Instance().Resolve(cwd_spec); 154 info.SetWorkingDirectory(cwd_spec); 155 info.GetEnvironment() = Host::GetEnvironment(); 156 157 gdb_server.SetLaunchInfo(info); 158 159 Status error = gdb_server.LaunchProcess(); 160 if (error.Fail()) { 161 llvm::errs() << llvm::formatv("error: failed to launch '{0}': {1}\n", 162 Arguments[0], error); 163 exit(1); 164 } 165 } 166 167 Status writeSocketIdToPipe(Pipe &port_pipe, llvm::StringRef socket_id) { 168 size_t bytes_written = 0; 169 // Write the port number as a C string with the NULL terminator. 170 return port_pipe.Write(socket_id.data(), socket_id.size() + 1, bytes_written); 171 } 172 173 Status writeSocketIdToPipe(const char *const named_pipe_path, 174 llvm::StringRef socket_id) { 175 Pipe port_name_pipe; 176 // Wait for 10 seconds for pipe to be opened. 177 auto error = port_name_pipe.OpenAsWriterWithTimeout(named_pipe_path, false, 178 std::chrono::seconds{10}); 179 if (error.Fail()) 180 return error; 181 return writeSocketIdToPipe(port_name_pipe, socket_id); 182 } 183 184 Status writeSocketIdToPipe(lldb::pipe_t unnamed_pipe, 185 llvm::StringRef socket_id) { 186 Pipe port_pipe{LLDB_INVALID_PIPE, unnamed_pipe}; 187 return writeSocketIdToPipe(port_pipe, socket_id); 188 } 189 190 void ConnectToRemote(MainLoop &mainloop, 191 GDBRemoteCommunicationServerLLGS &gdb_server, 192 bool reverse_connect, llvm::StringRef host_and_port, 193 const char *const progname, const char *const subcommand, 194 const char *const named_pipe_path, pipe_t unnamed_pipe, 195 int connection_fd) { 196 Status error; 197 198 std::unique_ptr<Connection> connection_up; 199 std::string url; 200 201 if (connection_fd != -1) { 202 url = llvm::formatv("fd://{0}", connection_fd).str(); 203 204 // Create the connection. 205 #if LLDB_ENABLE_POSIX && !defined _WIN32 206 ::fcntl(connection_fd, F_SETFD, FD_CLOEXEC); 207 #endif 208 } else if (!host_and_port.empty()) { 209 llvm::Expected<std::string> url_exp = 210 LLGSArgToURL(host_and_port, reverse_connect); 211 if (!url_exp) { 212 llvm::errs() << llvm::formatv("error: invalid host:port or URL '{0}': " 213 "{1}\n", 214 host_and_port, 215 llvm::toString(url_exp.takeError())); 216 exit(-1); 217 } 218 219 url = std::move(url_exp.get()); 220 } 221 222 if (!url.empty()) { 223 // Create the connection or server. 224 std::unique_ptr<ConnectionFileDescriptor> conn_fd_up{ 225 new ConnectionFileDescriptor}; 226 auto connection_result = conn_fd_up->Connect( 227 url, 228 [named_pipe_path, unnamed_pipe](llvm::StringRef socket_id) { 229 // If we have a named pipe to write the socket id back to, do that 230 // now. 231 if (named_pipe_path && named_pipe_path[0]) { 232 Status error = writeSocketIdToPipe(named_pipe_path, socket_id); 233 if (error.Fail()) 234 llvm::errs() << llvm::formatv( 235 "failed to write to the named peipe '{0}': {1}\n", 236 named_pipe_path, error.AsCString()); 237 } 238 // If we have an unnamed pipe to write the socket id back to, do 239 // that now. 240 else if (unnamed_pipe != LLDB_INVALID_PIPE) { 241 Status error = writeSocketIdToPipe(unnamed_pipe, socket_id); 242 if (error.Fail()) 243 llvm::errs() << llvm::formatv( 244 "failed to write to the unnamed pipe: {0}\n", error); 245 } 246 }, 247 &error); 248 249 if (error.Fail()) { 250 llvm::errs() << llvm::formatv( 251 "error: failed to connect to client at '{0}': {1}\n", url, error); 252 exit(-1); 253 } 254 if (connection_result != eConnectionStatusSuccess) { 255 llvm::errs() << llvm::formatv( 256 "error: failed to connect to client at '{0}' " 257 "(connection status: {1})\n", 258 url, static_cast<int>(connection_result)); 259 exit(-1); 260 } 261 connection_up = std::move(conn_fd_up); 262 } 263 error = gdb_server.InitializeConnection(std::move(connection_up)); 264 if (error.Fail()) { 265 llvm::errs() << llvm::formatv("failed to initialize connection\n", error); 266 exit(-1); 267 } 268 llvm::outs() << "Connection established.\n"; 269 } 270 271 namespace { 272 enum ID { 273 OPT_INVALID = 0, // This is not an option ID. 274 #define OPTION(PREFIX, NAME, ID, KIND, GROUP, ALIAS, ALIASARGS, FLAGS, PARAM, \ 275 HELPTEXT, METAVAR, VALUES) \ 276 OPT_##ID, 277 #include "LLGSOptions.inc" 278 #undef OPTION 279 }; 280 281 #define PREFIX(NAME, VALUE) const char *const NAME[] = VALUE; 282 #include "LLGSOptions.inc" 283 #undef PREFIX 284 285 const opt::OptTable::Info InfoTable[] = { 286 #define OPTION(PREFIX, NAME, ID, KIND, GROUP, ALIAS, ALIASARGS, FLAGS, PARAM, \ 287 HELPTEXT, METAVAR, VALUES) \ 288 { \ 289 PREFIX, NAME, HELPTEXT, \ 290 METAVAR, OPT_##ID, opt::Option::KIND##Class, \ 291 PARAM, FLAGS, OPT_##GROUP, \ 292 OPT_##ALIAS, ALIASARGS, VALUES}, 293 #include "LLGSOptions.inc" 294 #undef OPTION 295 }; 296 297 class LLGSOptTable : public opt::OptTable { 298 public: 299 LLGSOptTable() : OptTable(InfoTable) {} 300 301 void PrintHelp(llvm::StringRef Name) { 302 std::string Usage = 303 (Name + " [options] [[host]:port] [[--] program args...]").str(); 304 OptTable::printHelp(llvm::outs(), Usage.c_str(), "lldb-server"); 305 llvm::outs() << R"( 306 DESCRIPTION 307 lldb-server connects to the LLDB client, which drives the debugging session. 308 If no connection options are given, the [host]:port argument must be present 309 and will denote the address that lldb-server will listen on. [host] defaults 310 to "localhost" if empty. Port can be zero, in which case the port number will 311 be chosen dynamically and written to destinations given by --named-pipe and 312 --pipe arguments. 313 314 If no target is selected at startup, lldb-server can be directed by the LLDB 315 client to launch or attach to a process. 316 317 )"; 318 } 319 }; 320 } // namespace 321 322 int main_gdbserver(int argc, char *argv[]) { 323 Status error; 324 MainLoop mainloop; 325 #ifndef _WIN32 326 // Setup signal handlers first thing. 327 signal(SIGPIPE, SIG_IGN); 328 MainLoop::SignalHandleUP sighup_handle = 329 mainloop.RegisterSignal(SIGHUP, sighup_handler, error); 330 #endif 331 332 const char *progname = argv[0]; 333 const char *subcommand = argv[1]; 334 std::string attach_target; 335 std::string named_pipe_path; 336 std::string log_file; 337 StringRef 338 log_channels; // e.g. "lldb process threads:gdb-remote default:linux all" 339 lldb::pipe_t unnamed_pipe = LLDB_INVALID_PIPE; 340 bool reverse_connect = false; 341 int connection_fd = -1; 342 343 // ProcessLaunchInfo launch_info; 344 ProcessAttachInfo attach_info; 345 346 LLGSOptTable Opts; 347 llvm::BumpPtrAllocator Alloc; 348 llvm::StringSaver Saver(Alloc); 349 bool HasError = false; 350 opt::InputArgList Args = Opts.parseArgs(argc - 1, argv + 1, OPT_UNKNOWN, 351 Saver, [&](llvm::StringRef Msg) { 352 WithColor::error() << Msg << "\n"; 353 HasError = true; 354 }); 355 std::string Name = 356 (llvm::sys::path::filename(argv[0]) + " g[dbserver]").str(); 357 std::string HelpText = 358 "Use '" + Name + " --help' for a complete list of options.\n"; 359 if (HasError) { 360 llvm::errs() << HelpText; 361 return 1; 362 } 363 364 if (Args.hasArg(OPT_help)) { 365 Opts.PrintHelp(Name); 366 return 0; 367 } 368 369 #ifndef _WIN32 370 if (Args.hasArg(OPT_setsid)) { 371 // Put llgs into a new session. Terminals group processes 372 // into sessions and when a special terminal key sequences 373 // (like control+c) are typed they can cause signals to go out to 374 // all processes in a session. Using this --setsid (-S) option 375 // will cause debugserver to run in its own sessions and be free 376 // from such issues. 377 // 378 // This is useful when llgs is spawned from a command 379 // line application that uses llgs to do the debugging, 380 // yet that application doesn't want llgs receiving the 381 // signals sent to the session (i.e. dying when anyone hits ^C). 382 { 383 const ::pid_t new_sid = setsid(); 384 if (new_sid == -1) { 385 WithColor::warning() 386 << llvm::formatv("failed to set new session id for {0} ({1})\n", 387 LLGS_PROGRAM_NAME, llvm::sys::StrError()); 388 } 389 } 390 } 391 #endif 392 393 log_file = Args.getLastArgValue(OPT_log_file).str(); 394 log_channels = Args.getLastArgValue(OPT_log_channels); 395 named_pipe_path = Args.getLastArgValue(OPT_named_pipe).str(); 396 reverse_connect = Args.hasArg(OPT_reverse_connect); 397 attach_target = Args.getLastArgValue(OPT_attach).str(); 398 if (Args.hasArg(OPT_pipe)) { 399 uint64_t Arg; 400 if (!llvm::to_integer(Args.getLastArgValue(OPT_pipe), Arg)) { 401 WithColor::error() << "invalid '--pipe' argument\n" << HelpText; 402 return 1; 403 } 404 unnamed_pipe = (pipe_t)Arg; 405 } 406 if (Args.hasArg(OPT_fd)) { 407 if (!llvm::to_integer(Args.getLastArgValue(OPT_fd), connection_fd)) { 408 WithColor::error() << "invalid '--fd' argument\n" << HelpText; 409 return 1; 410 } 411 } 412 413 if (!LLDBServerUtilities::SetupLogging( 414 log_file, log_channels, 415 LLDB_LOG_OPTION_PREPEND_TIMESTAMP | 416 LLDB_LOG_OPTION_PREPEND_FILE_FUNCTION)) 417 return -1; 418 419 std::vector<llvm::StringRef> Inputs; 420 for (opt::Arg *Arg : Args.filtered(OPT_INPUT)) 421 Inputs.push_back(Arg->getValue()); 422 if (opt::Arg *Arg = Args.getLastArg(OPT_REM)) { 423 for (const char *Val : Arg->getValues()) 424 Inputs.push_back(Val); 425 } 426 if (Inputs.empty() && connection_fd == -1) { 427 WithColor::error() << "no connection arguments\n" << HelpText; 428 return 1; 429 } 430 431 NativeProcessFactory factory; 432 GDBRemoteCommunicationServerLLGS gdb_server(mainloop, factory); 433 434 llvm::StringRef host_and_port; 435 if (!Inputs.empty()) { 436 host_and_port = Inputs.front(); 437 Inputs.erase(Inputs.begin()); 438 } 439 440 // Any arguments left over are for the program that we need to launch. If 441 // there 442 // are no arguments, then the GDB server will start up and wait for an 'A' 443 // packet 444 // to launch a program, or a vAttach packet to attach to an existing process, 445 // unless 446 // explicitly asked to attach with the --attach={pid|program_name} form. 447 if (!attach_target.empty()) 448 handle_attach(gdb_server, attach_target); 449 else if (!Inputs.empty()) 450 handle_launch(gdb_server, Inputs); 451 452 // Print version info. 453 printf("%s-%s\n", LLGS_PROGRAM_NAME, LLGS_VERSION_STR); 454 455 ConnectToRemote(mainloop, gdb_server, reverse_connect, host_and_port, 456 progname, subcommand, named_pipe_path.c_str(), 457 unnamed_pipe, connection_fd); 458 459 if (!gdb_server.IsConnected()) { 460 fprintf(stderr, "no connection information provided, unable to run\n"); 461 return 1; 462 } 463 464 Status ret = mainloop.Run(); 465 if (ret.Fail()) { 466 fprintf(stderr, "lldb-server terminating due to error: %s\n", 467 ret.AsCString()); 468 return 1; 469 } 470 fprintf(stderr, "lldb-server exiting...\n"); 471 472 return 0; 473 } 474