1 //===-- NativeProcessLinux.cpp -------------------------------- -*- C++ -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 #include "NativeProcessLinux.h"
23 #include <unordered_map>
25 // Other libraries and framework includes
26 #include "lldb/Core/EmulateInstruction.h"
27 #include "lldb/Core/Error.h"
28 #include "lldb/Core/Module.h"
29 #include "lldb/Core/ModuleSpec.h"
30 #include "lldb/Core/RegisterValue.h"
31 #include "lldb/Core/State.h"
32 #include "lldb/Host/common/NativeBreakpoint.h"
33 #include "lldb/Host/common/NativeRegisterContext.h"
34 #include "lldb/Host/Host.h"
35 #include "lldb/Host/ThreadLauncher.h"
36 #include "lldb/Target/Platform.h"
37 #include "lldb/Target/Process.h"
38 #include "lldb/Target/ProcessLaunchInfo.h"
39 #include "lldb/Target/Target.h"
40 #include "lldb/Utility/LLDBAssert.h"
41 #include "lldb/Utility/PseudoTerminal.h"
42 #include "lldb/Utility/StringExtractor.h"
44 #include "Plugins/Process/POSIX/ProcessPOSIXLog.h"
45 #include "NativeThreadLinux.h"
46 #include "ProcFileReader.h"
49 // System includes - They have to be included after framework includes because they define some
50 // macros which collide with variable names in other modules
51 #include <linux/unistd.h>
52 #include <sys/socket.h>
54 #include <sys/syscall.h>
55 #include <sys/types.h>
59 #include "lldb/Host/linux/Personality.h"
60 #include "lldb/Host/linux/Ptrace.h"
61 #include "lldb/Host/linux/Signalfd.h"
62 #include "lldb/Host/linux/Uio.h"
63 #include "lldb/Host/android/Android.h"
65 #define LLDB_PERSONALITY_GET_CURRENT_SETTINGS 0xffffffff
67 // Support hardware breakpoints in case it has not been defined
73 using namespace lldb_private;
74 using namespace lldb_private::process_linux;
77 // Private bits we only need internally.
79 static bool ProcessVmReadvSupported()
81 static bool is_supported;
82 static std::once_flag flag;
84 std::call_once(flag, [] {
85 Log *log(GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
87 uint32_t source = 0x47424742;
90 struct iovec local, remote;
91 remote.iov_base = &source;
92 local.iov_base = &dest;
93 remote.iov_len = local.iov_len = sizeof source;
95 // We shall try if cross-process-memory reads work by attempting to read a value from our own process.
96 ssize_t res = process_vm_readv(getpid(), &local, 1, &remote, 1, 0);
97 is_supported = (res == sizeof(source) && source == dest);
101 log->Printf("%s: Detected kernel support for process_vm_readv syscall. Fast memory reads enabled.",
104 log->Printf("%s: syscall process_vm_readv failed (error: %s). Fast memory reads disabled.",
105 __FUNCTION__, strerror(errno));
115 ResolveProcessArchitecture (lldb::pid_t pid, Platform &platform, ArchSpec &arch)
117 // Grab process info for the running process.
118 ProcessInstanceInfo process_info;
119 if (!platform.GetProcessInfo (pid, process_info))
120 return Error("failed to get process info");
122 // Resolve the executable module.
123 ModuleSP exe_module_sp;
124 ModuleSpec exe_module_spec(process_info.GetExecutableFile(), process_info.GetArchitecture());
125 FileSpecList executable_search_paths (Target::GetDefaultExecutableSearchPaths ());
126 Error error = platform.ResolveExecutable(
129 executable_search_paths.GetSize () ? &executable_search_paths : NULL);
131 if (!error.Success ())
134 // Check if we've got our architecture from the exe_module.
135 arch = exe_module_sp->GetArchitecture ();
139 return Error("failed to retrieve a valid architecture from the exe module");
143 DisplayBytes (StreamString &s, void *bytes, uint32_t count)
145 uint8_t *ptr = (uint8_t *)bytes;
146 const uint32_t loop_count = std::min<uint32_t>(DEBUG_PTRACE_MAXBYTES, count);
147 for(uint32_t i=0; i<loop_count; i++)
149 s.Printf ("[%x]", *ptr);
155 PtraceDisplayBytes(int &req, void *data, size_t data_size)
158 Log *verbose_log (ProcessPOSIXLog::GetLogIfAllCategoriesSet (
159 POSIX_LOG_PTRACE | POSIX_LOG_VERBOSE));
165 case PTRACE_POKETEXT:
167 DisplayBytes(buf, &data, 8);
168 verbose_log->Printf("PTRACE_POKETEXT %s", buf.GetData());
171 case PTRACE_POKEDATA:
173 DisplayBytes(buf, &data, 8);
174 verbose_log->Printf("PTRACE_POKEDATA %s", buf.GetData());
177 case PTRACE_POKEUSER:
179 DisplayBytes(buf, &data, 8);
180 verbose_log->Printf("PTRACE_POKEUSER %s", buf.GetData());
185 DisplayBytes(buf, data, data_size);
186 verbose_log->Printf("PTRACE_SETREGS %s", buf.GetData());
189 case PTRACE_SETFPREGS:
191 DisplayBytes(buf, data, data_size);
192 verbose_log->Printf("PTRACE_SETFPREGS %s", buf.GetData());
195 case PTRACE_SETSIGINFO:
197 DisplayBytes(buf, data, sizeof(siginfo_t));
198 verbose_log->Printf("PTRACE_SETSIGINFO %s", buf.GetData());
201 case PTRACE_SETREGSET:
203 // Extract iov_base from data, which is a pointer to the struct IOVEC
204 DisplayBytes(buf, *(void **)data, data_size);
205 verbose_log->Printf("PTRACE_SETREGSET %s", buf.GetData());
215 static constexpr unsigned k_ptrace_word_size = sizeof(void*);
216 static_assert(sizeof(long) >= k_ptrace_word_size, "Size of long must be larger than ptrace word size");
217 } // end of anonymous namespace
219 // Simple helper function to ensure flags are enabled on the given file
222 EnsureFDFlags(int fd, int flags)
226 int status = fcntl(fd, F_GETFL);
229 error.SetErrorToErrno();
233 if (fcntl(fd, F_SETFL, status | flags) == -1)
235 error.SetErrorToErrno();
242 NativeProcessLinux::LaunchArgs::LaunchArgs(Module *module,
245 const FileSpec &stdin_file_spec,
246 const FileSpec &stdout_file_spec,
247 const FileSpec &stderr_file_spec,
248 const FileSpec &working_dir,
249 const ProcessLaunchInfo &launch_info)
253 m_stdin_file_spec(stdin_file_spec),
254 m_stdout_file_spec(stdout_file_spec),
255 m_stderr_file_spec(stderr_file_spec),
256 m_working_dir(working_dir),
257 m_launch_info(launch_info)
261 NativeProcessLinux::LaunchArgs::~LaunchArgs()
264 // -----------------------------------------------------------------------------
265 // Public Static Methods
266 // -----------------------------------------------------------------------------
269 NativeProcessProtocol::Launch (
270 ProcessLaunchInfo &launch_info,
271 NativeProcessProtocol::NativeDelegate &native_delegate,
273 NativeProcessProtocolSP &native_process_sp)
275 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
277 lldb::ModuleSP exe_module_sp;
278 PlatformSP platform_sp (Platform::GetHostPlatform ());
279 Error error = platform_sp->ResolveExecutable(
280 ModuleSpec(launch_info.GetExecutableFile(), launch_info.GetArchitecture()),
284 if (! error.Success())
287 // Verify the working directory is valid if one was specified.
288 FileSpec working_dir{launch_info.GetWorkingDirectory()};
290 (!working_dir.ResolvePath() ||
291 working_dir.GetFileType() != FileSpec::eFileTypeDirectory))
293 error.SetErrorStringWithFormat ("No such file or directory: %s",
294 working_dir.GetCString());
298 const FileAction *file_action;
300 // Default of empty will mean to use existing open file descriptors.
301 FileSpec stdin_file_spec{};
302 FileSpec stdout_file_spec{};
303 FileSpec stderr_file_spec{};
305 file_action = launch_info.GetFileActionForFD (STDIN_FILENO);
307 stdin_file_spec = file_action->GetFileSpec();
309 file_action = launch_info.GetFileActionForFD (STDOUT_FILENO);
311 stdout_file_spec = file_action->GetFileSpec();
313 file_action = launch_info.GetFileActionForFD (STDERR_FILENO);
315 stderr_file_spec = file_action->GetFileSpec();
320 log->Printf ("NativeProcessLinux::%s setting STDIN to '%s'",
321 __FUNCTION__, stdin_file_spec.GetCString());
323 log->Printf ("NativeProcessLinux::%s leaving STDIN as is", __FUNCTION__);
325 if (stdout_file_spec)
326 log->Printf ("NativeProcessLinux::%s setting STDOUT to '%s'",
327 __FUNCTION__, stdout_file_spec.GetCString());
329 log->Printf ("NativeProcessLinux::%s leaving STDOUT as is", __FUNCTION__);
331 if (stderr_file_spec)
332 log->Printf ("NativeProcessLinux::%s setting STDERR to '%s'",
333 __FUNCTION__, stderr_file_spec.GetCString());
335 log->Printf ("NativeProcessLinux::%s leaving STDERR as is", __FUNCTION__);
338 // Create the NativeProcessLinux in launch mode.
339 native_process_sp.reset (new NativeProcessLinux ());
344 for (const char **args = launch_info.GetArguments ().GetConstArgumentVector (); *args; ++args, ++i)
346 log->Printf ("NativeProcessLinux::%s arg %d: \"%s\"", __FUNCTION__, i, *args ? *args : "nullptr");
351 if (!native_process_sp->RegisterNativeDelegate (native_delegate))
353 native_process_sp.reset ();
354 error.SetErrorStringWithFormat ("failed to register the native delegate");
358 std::static_pointer_cast<NativeProcessLinux> (native_process_sp)->LaunchInferior (
361 launch_info.GetArguments ().GetConstArgumentVector (),
362 launch_info.GetEnvironmentEntries ().GetConstArgumentVector (),
372 native_process_sp.reset ();
374 log->Printf ("NativeProcessLinux::%s failed to launch process: %s", __FUNCTION__, error.AsCString ());
378 launch_info.SetProcessID (native_process_sp->GetID ());
384 NativeProcessProtocol::Attach (
386 NativeProcessProtocol::NativeDelegate &native_delegate,
388 NativeProcessProtocolSP &native_process_sp)
390 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
391 if (log && log->GetMask ().Test (POSIX_LOG_VERBOSE))
392 log->Printf ("NativeProcessLinux::%s(pid = %" PRIi64 ")", __FUNCTION__, pid);
394 // Grab the current platform architecture. This should be Linux,
395 // since this code is only intended to run on a Linux host.
396 PlatformSP platform_sp (Platform::GetHostPlatform ());
398 return Error("failed to get a valid default platform");
400 // Retrieve the architecture for the running process.
401 ArchSpec process_arch;
402 Error error = ResolveProcessArchitecture (pid, *platform_sp.get (), process_arch);
403 if (!error.Success ())
406 std::shared_ptr<NativeProcessLinux> native_process_linux_sp (new NativeProcessLinux ());
408 if (!native_process_linux_sp->RegisterNativeDelegate (native_delegate))
410 error.SetErrorStringWithFormat ("failed to register the native delegate");
414 native_process_linux_sp->AttachToInferior (mainloop, pid, error);
415 if (!error.Success ())
418 native_process_sp = native_process_linux_sp;
422 // -----------------------------------------------------------------------------
423 // Public Instance Methods
424 // -----------------------------------------------------------------------------
426 NativeProcessLinux::NativeProcessLinux () :
427 NativeProcessProtocol (LLDB_INVALID_PROCESS_ID),
429 m_supports_mem_region (eLazyBoolCalculate),
430 m_mem_region_cache (),
431 m_mem_region_cache_mutex(),
432 m_pending_notification_tid(LLDB_INVALID_THREAD_ID)
437 NativeProcessLinux::LaunchInferior (
442 const FileSpec &stdin_file_spec,
443 const FileSpec &stdout_file_spec,
444 const FileSpec &stderr_file_spec,
445 const FileSpec &working_dir,
446 const ProcessLaunchInfo &launch_info,
449 m_sigchld_handle = mainloop.RegisterSignal(SIGCHLD,
450 [this] (MainLoopBase &) { SigchldHandler(); }, error);
451 if (! m_sigchld_handle)
455 m_arch = module->GetArchitecture ();
457 SetState (eStateLaunching);
459 std::unique_ptr<LaunchArgs> args(
460 new LaunchArgs(module, argv, envp,
467 Launch(args.get(), error);
471 NativeProcessLinux::AttachToInferior (MainLoop &mainloop, lldb::pid_t pid, Error &error)
473 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
475 log->Printf ("NativeProcessLinux::%s (pid = %" PRIi64 ")", __FUNCTION__, pid);
477 m_sigchld_handle = mainloop.RegisterSignal(SIGCHLD,
478 [this] (MainLoopBase &) { SigchldHandler(); }, error);
479 if (! m_sigchld_handle)
482 // We can use the Host for everything except the ResolveExecutable portion.
483 PlatformSP platform_sp = Platform::GetHostPlatform ();
487 log->Printf ("NativeProcessLinux::%s (pid = %" PRIi64 "): no default platform set", __FUNCTION__, pid);
488 error.SetErrorString ("no default platform available");
492 // Gather info about the process.
493 ProcessInstanceInfo process_info;
494 if (!platform_sp->GetProcessInfo (pid, process_info))
497 log->Printf ("NativeProcessLinux::%s (pid = %" PRIi64 "): failed to get process info", __FUNCTION__, pid);
498 error.SetErrorString ("failed to get process info");
502 // Resolve the executable module
503 ModuleSP exe_module_sp;
504 FileSpecList executable_search_paths (Target::GetDefaultExecutableSearchPaths());
505 ModuleSpec exe_module_spec(process_info.GetExecutableFile(), process_info.GetArchitecture());
506 error = platform_sp->ResolveExecutable(exe_module_spec, exe_module_sp,
507 executable_search_paths.GetSize() ? &executable_search_paths : NULL);
508 if (!error.Success())
511 // Set the architecture to the exe architecture.
512 m_arch = exe_module_sp->GetArchitecture();
514 log->Printf ("NativeProcessLinux::%s (pid = %" PRIi64 ") detected architecture %s", __FUNCTION__, pid, m_arch.GetArchitectureName ());
517 SetState(eStateAttaching);
523 NativeProcessLinux::Launch(LaunchArgs *args, Error &error)
525 assert (args && "null args");
527 const char **argv = args->m_argv;
528 const char **envp = args->m_envp;
529 const FileSpec working_dir = args->m_working_dir;
531 lldb_utility::PseudoTerminal terminal;
532 const size_t err_len = 1024;
533 char err_str[err_len];
536 // Propagate the environment if one is not supplied.
537 if (envp == NULL || envp[0] == NULL)
538 envp = const_cast<const char **>(environ);
540 if ((pid = terminal.Fork(err_str, err_len)) == static_cast<lldb::pid_t> (-1))
542 error.SetErrorToGenericError();
543 error.SetErrorStringWithFormat("Process fork failed: %s", err_str);
547 // Recognized child exit status codes.
562 // First, make sure we disable all logging. If we are logging to stdout, our logs can be
563 // mistaken for inferior output.
564 Log::DisableAllLogChannels(nullptr);
565 // FIXME consider opening a pipe between parent/child and have this forked child
566 // send log info to parent re: launch status.
568 // Start tracing this child that is about to exec.
569 error = PtraceWrapper(PTRACE_TRACEME, 0);
573 // terminal has already dupped the tty descriptors to stdin/out/err.
574 // This closes original fd from which they were copied (and avoids
575 // leaking descriptors to the debugged process.
576 terminal.CloseSlaveFileDescriptor();
578 // Do not inherit setgid powers.
579 if (setgid(getgid()) != 0)
582 // Attempt to have our own process group.
583 if (setpgid(0, 0) != 0)
585 // FIXME log that this failed. This is common.
586 // Don't allow this to prevent an inferior exec.
589 // Dup file descriptors if needed.
590 if (args->m_stdin_file_spec)
591 if (!DupDescriptor(args->m_stdin_file_spec, STDIN_FILENO, O_RDONLY))
592 exit(eDupStdinFailed);
594 if (args->m_stdout_file_spec)
595 if (!DupDescriptor(args->m_stdout_file_spec, STDOUT_FILENO, O_WRONLY | O_CREAT | O_TRUNC))
596 exit(eDupStdoutFailed);
598 if (args->m_stderr_file_spec)
599 if (!DupDescriptor(args->m_stderr_file_spec, STDERR_FILENO, O_WRONLY | O_CREAT | O_TRUNC))
600 exit(eDupStderrFailed);
602 // Close everything besides stdin, stdout, and stderr that has no file
603 // action to avoid leaking
604 for (int fd = 3; fd < sysconf(_SC_OPEN_MAX); ++fd)
605 if (!args->m_launch_info.GetFileActionForFD(fd))
608 // Change working directory
609 if (working_dir && 0 != ::chdir(working_dir.GetCString()))
612 // Disable ASLR if requested.
613 if (args->m_launch_info.GetFlags ().Test (lldb::eLaunchFlagDisableASLR))
615 const int old_personality = personality (LLDB_PERSONALITY_GET_CURRENT_SETTINGS);
616 if (old_personality == -1)
618 // Can't retrieve Linux personality. Cannot disable ASLR.
622 const int new_personality = personality (ADDR_NO_RANDOMIZE | old_personality);
623 if (new_personality == -1)
625 // Disabling ASLR failed.
629 // Disabling ASLR succeeded.
634 // Clear the signal mask to prevent the child from being affected by
635 // any masking done by the parent.
637 if (sigemptyset(&set) != 0 || pthread_sigmask(SIG_SETMASK, &set, nullptr) != 0)
638 exit(eSetSigMaskFailed);
640 // Execute. We should never return...
642 const_cast<char *const *>(argv),
643 const_cast<char *const *>(envp));
645 // ...unless exec fails. In which case we definitely need to end the child here.
650 // This is the parent code here.
652 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
654 // Wait for the child process to trap on its call to execve.
657 if ((wpid = waitpid(pid, &status, 0)) < 0)
659 error.SetErrorToErrno();
661 log->Printf ("NativeProcessLinux::%s waitpid for inferior failed with %s",
662 __FUNCTION__, error.AsCString ());
664 // Mark the inferior as invalid.
665 // FIXME this could really use a new state - eStateLaunchFailure. For now, using eStateInvalid.
666 SetState (StateType::eStateInvalid);
670 else if (WIFEXITED(status))
672 // open, dup or execve likely failed for some reason.
673 error.SetErrorToGenericError();
674 switch (WEXITSTATUS(status))
677 error.SetErrorString("Child ptrace failed.");
679 case eDupStdinFailed:
680 error.SetErrorString("Child open stdin failed.");
682 case eDupStdoutFailed:
683 error.SetErrorString("Child open stdout failed.");
685 case eDupStderrFailed:
686 error.SetErrorString("Child open stderr failed.");
689 error.SetErrorString("Child failed to set working directory.");
692 error.SetErrorString("Child exec failed.");
695 error.SetErrorString("Child setgid failed.");
697 case eSetSigMaskFailed:
698 error.SetErrorString("Child failed to set signal mask.");
701 error.SetErrorString("Child returned unknown exit status.");
707 log->Printf ("NativeProcessLinux::%s inferior exited with status %d before issuing a STOP",
709 WEXITSTATUS(status));
712 // Mark the inferior as invalid.
713 // FIXME this could really use a new state - eStateLaunchFailure. For now, using eStateInvalid.
714 SetState (StateType::eStateInvalid);
718 assert(WIFSTOPPED(status) && (wpid == static_cast< ::pid_t> (pid)) &&
719 "Could not sync with inferior process.");
722 log->Printf ("NativeProcessLinux::%s inferior started, now in stopped state", __FUNCTION__);
724 error = SetDefaultPtraceOpts(pid);
728 log->Printf ("NativeProcessLinux::%s inferior failed to set default ptrace options: %s",
729 __FUNCTION__, error.AsCString ());
731 // Mark the inferior as invalid.
732 // FIXME this could really use a new state - eStateLaunchFailure. For now, using eStateInvalid.
733 SetState (StateType::eStateInvalid);
738 // Release the master terminal descriptor and pass it off to the
739 // NativeProcessLinux instance. Similarly stash the inferior pid.
740 m_terminal_fd = terminal.ReleaseMasterFileDescriptor();
743 // Set the terminal fd to be in non blocking mode (it simplifies the
744 // implementation of ProcessLinux::GetSTDOUT to have a non-blocking
745 // descriptor to read from).
746 error = EnsureFDFlags(m_terminal_fd, O_NONBLOCK);
750 log->Printf ("NativeProcessLinux::%s inferior EnsureFDFlags failed for ensuring terminal O_NONBLOCK setting: %s",
751 __FUNCTION__, error.AsCString ());
753 // Mark the inferior as invalid.
754 // FIXME this could really use a new state - eStateLaunchFailure. For now, using eStateInvalid.
755 SetState (StateType::eStateInvalid);
761 log->Printf ("NativeProcessLinux::%s() adding pid = %" PRIu64, __FUNCTION__, pid);
763 NativeThreadLinuxSP thread_sp = AddThread(pid);
764 assert (thread_sp && "AddThread() returned a nullptr thread");
765 thread_sp->SetStoppedBySignal(SIGSTOP);
766 ThreadWasCreated(*thread_sp);
768 // Let our process instance know the thread has stopped.
769 SetCurrentThreadID (thread_sp->GetID ());
770 SetState (StateType::eStateStopped);
774 if (error.Success ())
776 log->Printf ("NativeProcessLinux::%s inferior launching succeeded", __FUNCTION__);
780 log->Printf ("NativeProcessLinux::%s inferior launching failed: %s",
781 __FUNCTION__, error.AsCString ());
789 NativeProcessLinux::Attach(lldb::pid_t pid, Error &error)
791 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
793 // Use a map to keep track of the threads which we have attached/need to attach.
794 Host::TidMap tids_to_attach;
797 error.SetErrorToGenericError();
798 error.SetErrorString("Attaching to process 1 is not allowed.");
802 while (Host::FindProcessThreads(pid, tids_to_attach))
804 for (Host::TidMap::iterator it = tids_to_attach.begin();
805 it != tids_to_attach.end();)
807 if (it->second == false)
809 lldb::tid_t tid = it->first;
811 // Attach to the requested process.
812 // An attach will cause the thread to stop with a SIGSTOP.
813 error = PtraceWrapper(PTRACE_ATTACH, tid);
816 // No such thread. The thread may have exited.
817 // More error handling may be needed.
818 if (error.GetError() == ESRCH)
820 it = tids_to_attach.erase(it);
828 // Need to use __WALL otherwise we receive an error with errno=ECHLD
829 // At this point we should have a thread stopped if waitpid succeeds.
830 if ((status = waitpid(tid, NULL, __WALL)) < 0)
832 // No such thread. The thread may have exited.
833 // More error handling may be needed.
836 it = tids_to_attach.erase(it);
841 error.SetErrorToErrno();
846 error = SetDefaultPtraceOpts(tid);
851 log->Printf ("NativeProcessLinux::%s() adding tid = %" PRIu64, __FUNCTION__, tid);
855 // Create the thread, mark it as stopped.
856 NativeThreadLinuxSP thread_sp (AddThread(static_cast<lldb::tid_t>(tid)));
857 assert (thread_sp && "AddThread() returned a nullptr");
859 // This will notify this is a new thread and tell the system it is stopped.
860 thread_sp->SetStoppedBySignal(SIGSTOP);
861 ThreadWasCreated(*thread_sp);
862 SetCurrentThreadID (thread_sp->GetID ());
865 // move the loop forward
870 if (tids_to_attach.size() > 0)
873 // Let our process instance know the thread has stopped.
874 SetState (StateType::eStateStopped);
878 error.SetErrorToGenericError();
879 error.SetErrorString("No such process.");
887 NativeProcessLinux::SetDefaultPtraceOpts(lldb::pid_t pid)
889 long ptrace_opts = 0;
891 // Have the child raise an event on exit. This is used to keep the child in
892 // limbo until it is destroyed.
893 ptrace_opts |= PTRACE_O_TRACEEXIT;
895 // Have the tracer trace threads which spawn in the inferior process.
896 // TODO: if we want to support tracing the inferiors' child, add the
897 // appropriate ptrace flags here (PTRACE_O_TRACEFORK, PTRACE_O_TRACEVFORK)
898 ptrace_opts |= PTRACE_O_TRACECLONE;
900 // Have the tracer notify us before execve returns
901 // (needed to disable legacy SIGTRAP generation)
902 ptrace_opts |= PTRACE_O_TRACEEXEC;
904 return PtraceWrapper(PTRACE_SETOPTIONS, pid, nullptr, (void*)ptrace_opts);
907 static ExitType convert_pid_status_to_exit_type (int status)
909 if (WIFEXITED (status))
910 return ExitType::eExitTypeExit;
911 else if (WIFSIGNALED (status))
912 return ExitType::eExitTypeSignal;
913 else if (WIFSTOPPED (status))
914 return ExitType::eExitTypeStop;
917 // We don't know what this is.
918 return ExitType::eExitTypeInvalid;
922 static int convert_pid_status_to_return_code (int status)
924 if (WIFEXITED (status))
925 return WEXITSTATUS (status);
926 else if (WIFSIGNALED (status))
927 return WTERMSIG (status);
928 else if (WIFSTOPPED (status))
929 return WSTOPSIG (status);
932 // We don't know what this is.
933 return ExitType::eExitTypeInvalid;
937 // Handles all waitpid events from the inferior process.
939 NativeProcessLinux::MonitorCallback(lldb::pid_t pid,
944 Log *log (GetLogIfAnyCategoriesSet (LIBLLDB_LOG_PROCESS));
946 // Certain activities differ based on whether the pid is the tid of the main thread.
947 const bool is_main_thread = (pid == GetID ());
949 // Handle when the thread exits.
953 log->Printf ("NativeProcessLinux::%s() got exit signal(%d) , tid = %" PRIu64 " (%s main thread)", __FUNCTION__, signal, pid, is_main_thread ? "is" : "is not");
955 // This is a thread that exited. Ensure we're not tracking it anymore.
956 const bool thread_found = StopTrackingThread (pid);
960 // We only set the exit status and notify the delegate if we haven't already set the process
961 // state to an exited state. We normally should have received a SIGTRAP | (PTRACE_EVENT_EXIT << 8)
962 // for the main thread.
963 const bool already_notified = (GetState() == StateType::eStateExited) || (GetState () == StateType::eStateCrashed);
964 if (!already_notified)
967 log->Printf ("NativeProcessLinux::%s() tid = %" PRIu64 " handling main thread exit (%s), expected exit state already set but state was %s instead, setting exit state now", __FUNCTION__, pid, thread_found ? "stopped tracking thread metadata" : "thread metadata not found", StateAsCString (GetState ()));
968 // The main thread exited. We're done monitoring. Report to delegate.
969 SetExitStatus (convert_pid_status_to_exit_type (status), convert_pid_status_to_return_code (status), nullptr, true);
971 // Notify delegate that our process has exited.
972 SetState (StateType::eStateExited, true);
977 log->Printf ("NativeProcessLinux::%s() tid = %" PRIu64 " main thread now exited (%s)", __FUNCTION__, pid, thread_found ? "stopped tracking thread metadata" : "thread metadata not found");
982 // Do we want to report to the delegate in this case? I think not. If this was an orderly
983 // thread exit, we would already have received the SIGTRAP | (PTRACE_EVENT_EXIT << 8) signal,
984 // and we would have done an all-stop then.
986 log->Printf ("NativeProcessLinux::%s() tid = %" PRIu64 " handling non-main thread exit (%s)", __FUNCTION__, pid, thread_found ? "stopped tracking thread metadata" : "thread metadata not found");
992 const auto info_err = GetSignalInfo(pid, &info);
993 auto thread_sp = GetThreadByID(pid);
997 // Normally, the only situation when we cannot find the thread is if we have just
998 // received a new thread notification. This is indicated by GetSignalInfo() returning
999 // si_code == SI_USER and si_pid == 0
1001 log->Printf("NativeProcessLinux::%s received notification about an unknown tid %" PRIu64 ".", __FUNCTION__, pid);
1003 if (info_err.Fail())
1006 log->Printf("NativeProcessLinux::%s (tid %" PRIu64 ") GetSignalInfo failed (%s). Ingoring this notification.", __FUNCTION__, pid, info_err.AsCString());
1010 if (log && (info.si_code != SI_USER || info.si_pid != 0))
1011 log->Printf("NativeProcessLinux::%s (tid %" PRIu64 ") unexpected signal info (si_code: %d, si_pid: %d). Treating as a new thread notification anyway.", __FUNCTION__, pid, info.si_code, info.si_pid);
1013 auto thread_sp = AddThread(pid);
1014 // Resume the newly created thread.
1015 ResumeThread(*thread_sp, eStateRunning, LLDB_INVALID_SIGNAL_NUMBER);
1016 ThreadWasCreated(*thread_sp);
1020 // Get details on the signal raised.
1021 if (info_err.Success())
1023 // We have retrieved the signal info. Dispatch appropriately.
1024 if (info.si_signo == SIGTRAP)
1025 MonitorSIGTRAP(info, *thread_sp);
1027 MonitorSignal(info, *thread_sp, exited);
1031 if (info_err.GetError() == EINVAL)
1033 // This is a group stop reception for this tid.
1034 // We can reach here if we reinject SIGSTOP, SIGSTP, SIGTTIN or SIGTTOU into the
1035 // tracee, triggering the group-stop mechanism. Normally receiving these would stop
1036 // the process, pending a SIGCONT. Simulating this state in a debugger is hard and is
1037 // generally not needed (one use case is debugging background task being managed by a
1038 // shell). For general use, it is sufficient to stop the process in a signal-delivery
1039 // stop which happens before the group stop. This done by MonitorSignal and works
1040 // correctly for all signals.
1042 log->Printf("NativeProcessLinux::%s received a group stop for pid %" PRIu64 " tid %" PRIu64 ". Transparent handling of group stops not supported, resuming the thread.", __FUNCTION__, GetID (), pid);
1043 ResumeThread(*thread_sp, thread_sp->GetState(), LLDB_INVALID_SIGNAL_NUMBER);
1047 // ptrace(GETSIGINFO) failed (but not due to group-stop).
1049 // A return value of ESRCH means the thread/process is no longer on the system,
1050 // so it was killed somehow outside of our control. Either way, we can't do anything
1053 // Stop tracking the metadata for the thread since it's entirely off the system now.
1054 const bool thread_found = StopTrackingThread (pid);
1057 log->Printf ("NativeProcessLinux::%s GetSignalInfo failed: %s, tid = %" PRIu64 ", signal = %d, status = %d (%s, %s, %s)",
1058 __FUNCTION__, info_err.AsCString(), pid, signal, status, info_err.GetError() == ESRCH ? "thread/process killed" : "unknown reason", is_main_thread ? "is main thread" : "is not main thread", thread_found ? "thread metadata removed" : "thread metadata not found");
1062 // Notify the delegate - our process is not available but appears to have been killed outside
1063 // our control. Is eStateExited the right exit state in this case?
1064 SetExitStatus (convert_pid_status_to_exit_type (status), convert_pid_status_to_return_code (status), nullptr, true);
1065 SetState (StateType::eStateExited, true);
1069 // This thread was pulled out from underneath us. Anything to do here? Do we want to do an all stop?
1071 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 " tid %" PRIu64 " non-main thread exit occurred, didn't tell delegate anything since thread disappeared out from underneath us", __FUNCTION__, GetID (), pid);
1078 NativeProcessLinux::WaitForNewThread(::pid_t tid)
1080 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1082 NativeThreadLinuxSP new_thread_sp = GetThreadByID(tid);
1086 // We are already tracking the thread - we got the event on the new thread (see
1087 // MonitorSignal) before this one. We are done.
1091 // The thread is not tracked yet, let's wait for it to appear.
1097 log->Printf ("NativeProcessLinux::%s() received thread creation event for tid %" PRIu32 ". tid not tracked yet, waiting for thread to appear...", __FUNCTION__, tid);
1098 wait_pid = waitpid(tid, &status, __WALL);
1100 while (wait_pid == -1 && errno == EINTR);
1101 // Since we are waiting on a specific tid, this must be the creation event. But let's do
1102 // some checks just in case.
1103 if (wait_pid != tid) {
1105 log->Printf ("NativeProcessLinux::%s() waiting for tid %" PRIu32 " failed. Assuming the thread has disappeared in the meantime", __FUNCTION__, tid);
1106 // The only way I know of this could happen is if the whole process was
1107 // SIGKILLed in the mean time. In any case, we can't do anything about that now.
1110 if (WIFEXITED(status))
1113 log->Printf ("NativeProcessLinux::%s() waiting for tid %" PRIu32 " returned an 'exited' event. Not tracking the thread.", __FUNCTION__, tid);
1114 // Also a very improbable event.
1119 Error error = GetSignalInfo(tid, &info);
1123 log->Printf ("NativeProcessLinux::%s() GetSignalInfo for tid %" PRIu32 " failed. Assuming the thread has disappeared in the meantime.", __FUNCTION__, tid);
1127 if (((info.si_pid != 0) || (info.si_code != SI_USER)) && log)
1129 // We should be getting a thread creation signal here, but we received something
1130 // else. There isn't much we can do about it now, so we will just log that. Since the
1131 // thread is alive and we are receiving events from it, we shall pretend that it was
1132 // created properly.
1133 log->Printf ("NativeProcessLinux::%s() GetSignalInfo for tid %" PRIu32 " received unexpected signal with code %d from pid %d.", __FUNCTION__, tid, info.si_code, info.si_pid);
1137 log->Printf ("NativeProcessLinux::%s() pid = %" PRIu64 ": tracking new thread tid %" PRIu32,
1138 __FUNCTION__, GetID (), tid);
1140 new_thread_sp = AddThread(tid);
1141 ResumeThread(*new_thread_sp, eStateRunning, LLDB_INVALID_SIGNAL_NUMBER);
1142 ThreadWasCreated(*new_thread_sp);
1146 NativeProcessLinux::MonitorSIGTRAP(const siginfo_t &info, NativeThreadLinux &thread)
1148 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1149 const bool is_main_thread = (thread.GetID() == GetID ());
1151 assert(info.si_signo == SIGTRAP && "Unexpected child signal!");
1153 Mutex::Locker locker (m_threads_mutex);
1155 switch (info.si_code)
1157 // TODO: these two cases are required if we want to support tracing of the inferiors' children. We'd need this to debug a monitor.
1158 // case (SIGTRAP | (PTRACE_EVENT_FORK << 8)):
1159 // case (SIGTRAP | (PTRACE_EVENT_VFORK << 8)):
1161 case (SIGTRAP | (PTRACE_EVENT_CLONE << 8)):
1163 // This is the notification on the parent thread which informs us of new thread
1165 // We don't want to do anything with the parent thread so we just resume it. In case we
1166 // want to implement "break on thread creation" functionality, we would need to stop
1169 unsigned long event_message = 0;
1170 if (GetEventMessage(thread.GetID(), &event_message).Fail())
1173 log->Printf ("NativeProcessLinux::%s() pid %" PRIu64 " received thread creation event but GetEventMessage failed so we don't know the new tid", __FUNCTION__, thread.GetID());
1175 WaitForNewThread(event_message);
1177 ResumeThread(thread, thread.GetState(), LLDB_INVALID_SIGNAL_NUMBER);
1181 case (SIGTRAP | (PTRACE_EVENT_EXEC << 8)):
1183 NativeThreadLinuxSP main_thread_sp;
1185 log->Printf ("NativeProcessLinux::%s() received exec event, code = %d", __FUNCTION__, info.si_code ^ SIGTRAP);
1187 // Exec clears any pending notifications.
1188 m_pending_notification_tid = LLDB_INVALID_THREAD_ID;
1190 // Remove all but the main thread here. Linux fork creates a new process which only copies the main thread. Mutexes are in undefined state.
1192 log->Printf ("NativeProcessLinux::%s exec received, stop tracking all but main thread", __FUNCTION__);
1194 for (auto thread_sp : m_threads)
1196 const bool is_main_thread = thread_sp && thread_sp->GetID () == GetID ();
1199 main_thread_sp = std::static_pointer_cast<NativeThreadLinux>(thread_sp);
1201 log->Printf ("NativeProcessLinux::%s found main thread with tid %" PRIu64 ", keeping", __FUNCTION__, main_thread_sp->GetID ());
1206 log->Printf ("NativeProcessLinux::%s discarding non-main-thread tid %" PRIu64 " due to exec", __FUNCTION__, thread_sp->GetID ());
1214 m_threads.push_back (main_thread_sp);
1215 SetCurrentThreadID (main_thread_sp->GetID ());
1216 main_thread_sp->SetStoppedByExec();
1220 SetCurrentThreadID (LLDB_INVALID_THREAD_ID);
1222 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 "no main thread found, discarded all threads, we're in a no-thread state!", __FUNCTION__, GetID ());
1225 // Tell coordinator about about the "new" (since exec) stopped main thread.
1226 ThreadWasCreated(*main_thread_sp);
1228 // Let our delegate know we have just exec'd.
1231 // If we have a main thread, indicate we are stopped.
1232 assert (main_thread_sp && "exec called during ptraced process but no main thread metadata tracked");
1234 // Let the process know we're stopped.
1235 StopRunningThreads(main_thread_sp->GetID());
1240 case (SIGTRAP | (PTRACE_EVENT_EXIT << 8)):
1242 // The inferior process or one of its threads is about to exit.
1243 // We don't want to do anything with the thread so we just resume it. In case we
1244 // want to implement "break on thread exit" functionality, we would need to stop
1247 unsigned long data = 0;
1248 if (GetEventMessage(thread.GetID(), &data).Fail())
1253 log->Printf ("NativeProcessLinux::%s() received PTRACE_EVENT_EXIT, data = %lx (WIFEXITED=%s,WIFSIGNALED=%s), pid = %" PRIu64 " (%s)",
1255 data, WIFEXITED (data) ? "true" : "false", WIFSIGNALED (data) ? "true" : "false",
1257 is_main_thread ? "is main thread" : "not main thread");
1262 SetExitStatus (convert_pid_status_to_exit_type (data), convert_pid_status_to_return_code (data), nullptr, true);
1265 StateType state = thread.GetState();
1266 if (! StateIsRunningState(state))
1268 // Due to a kernel bug, we may sometimes get this stop after the inferior gets a
1269 // SIGKILL. This confuses our state tracking logic in ResumeThread(), since normally,
1270 // we should not be receiving any ptrace events while the inferior is stopped. This
1271 // makes sure that the inferior is resumed and exits normally.
1272 state = eStateRunning;
1274 ResumeThread(thread, state, LLDB_INVALID_SIGNAL_NUMBER);
1280 case TRAP_TRACE: // We receive this on single stepping.
1281 case TRAP_HWBKPT: // We receive this on watchpoint hit
1283 // If a watchpoint was hit, report it
1285 Error error = thread.GetRegisterContext()->GetWatchpointHitIndex(wp_index, (uintptr_t)info.si_addr);
1286 if (error.Fail() && log)
1287 log->Printf("NativeProcessLinux::%s() "
1288 "received error while checking for watchpoint hits, "
1289 "pid = %" PRIu64 " error = %s",
1290 __FUNCTION__, thread.GetID(), error.AsCString());
1291 if (wp_index != LLDB_INVALID_INDEX32)
1293 MonitorWatchpoint(thread, wp_index);
1297 // Otherwise, report step over
1298 MonitorTrace(thread);
1303 #if defined __mips__
1304 // For mips there is no special signal for watchpoint
1305 // So we check for watchpoint in kernel trap
1307 // If a watchpoint was hit, report it
1309 Error error = thread.GetRegisterContext()->GetWatchpointHitIndex(wp_index, LLDB_INVALID_ADDRESS);
1310 if (error.Fail() && log)
1311 log->Printf("NativeProcessLinux::%s() "
1312 "received error while checking for watchpoint hits, "
1313 "pid = %" PRIu64 " error = %s",
1314 __FUNCTION__, thread.GetID(), error.AsCString());
1315 if (wp_index != LLDB_INVALID_INDEX32)
1317 MonitorWatchpoint(thread, wp_index);
1324 MonitorBreakpoint(thread);
1328 case (SIGTRAP | 0x80):
1330 log->Printf ("NativeProcessLinux::%s() received unknown SIGTRAP system call stop event, pid %" PRIu64 "tid %" PRIu64 ", resuming", __FUNCTION__, GetID (), thread.GetID());
1332 // Ignore these signals until we know more about them.
1333 ResumeThread(thread, thread.GetState(), LLDB_INVALID_SIGNAL_NUMBER);
1337 assert(false && "Unexpected SIGTRAP code!");
1339 log->Printf ("NativeProcessLinux::%s() pid %" PRIu64 "tid %" PRIu64 " received unhandled SIGTRAP code: 0x%d",
1340 __FUNCTION__, GetID(), thread.GetID(), info.si_code);
1347 NativeProcessLinux::MonitorTrace(NativeThreadLinux &thread)
1349 Log *log(GetLogIfAllCategoriesSet(LIBLLDB_LOG_PROCESS));
1351 log->Printf("NativeProcessLinux::%s() received trace event, pid = %" PRIu64 " (single stepping)",
1352 __FUNCTION__, thread.GetID());
1354 // This thread is currently stopped.
1355 thread.SetStoppedByTrace();
1357 StopRunningThreads(thread.GetID());
1361 NativeProcessLinux::MonitorBreakpoint(NativeThreadLinux &thread)
1363 Log *log(GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PROCESS | LIBLLDB_LOG_BREAKPOINTS));
1365 log->Printf("NativeProcessLinux::%s() received breakpoint event, pid = %" PRIu64,
1366 __FUNCTION__, thread.GetID());
1368 // Mark the thread as stopped at breakpoint.
1369 thread.SetStoppedByBreakpoint();
1370 Error error = FixupBreakpointPCAsNeeded(thread);
1373 log->Printf("NativeProcessLinux::%s() pid = %" PRIu64 " fixup: %s",
1374 __FUNCTION__, thread.GetID(), error.AsCString());
1376 if (m_threads_stepping_with_breakpoint.find(thread.GetID()) != m_threads_stepping_with_breakpoint.end())
1377 thread.SetStoppedByTrace();
1379 StopRunningThreads(thread.GetID());
1383 NativeProcessLinux::MonitorWatchpoint(NativeThreadLinux &thread, uint32_t wp_index)
1385 Log *log(GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PROCESS | LIBLLDB_LOG_WATCHPOINTS));
1387 log->Printf("NativeProcessLinux::%s() received watchpoint event, "
1388 "pid = %" PRIu64 ", wp_index = %" PRIu32,
1389 __FUNCTION__, thread.GetID(), wp_index);
1391 // Mark the thread as stopped at watchpoint.
1392 // The address is at (lldb::addr_t)info->si_addr if we need it.
1393 thread.SetStoppedByWatchpoint(wp_index);
1395 // We need to tell all other running threads before we notify the delegate about this stop.
1396 StopRunningThreads(thread.GetID());
1400 NativeProcessLinux::MonitorSignal(const siginfo_t &info, NativeThreadLinux &thread, bool exited)
1402 const int signo = info.si_signo;
1403 const bool is_from_llgs = info.si_pid == getpid ();
1405 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1407 // POSIX says that process behaviour is undefined after it ignores a SIGFPE,
1408 // SIGILL, SIGSEGV, or SIGBUS *unless* that signal was generated by a
1409 // kill(2) or raise(3). Similarly for tgkill(2) on Linux.
1411 // IOW, user generated signals never generate what we consider to be a
1414 // Similarly, ACK signals generated by this monitor.
1416 Mutex::Locker locker (m_threads_mutex);
1418 // Handle the signal.
1419 if (info.si_code == SI_TKILL || info.si_code == SI_USER)
1422 log->Printf ("NativeProcessLinux::%s() received signal %s (%d) with code %s, (siginfo pid = %d (%s), waitpid pid = %" PRIu64 ")",
1424 Host::GetSignalAsCString(signo),
1426 (info.si_code == SI_TKILL ? "SI_TKILL" : "SI_USER"),
1428 is_from_llgs ? "from llgs" : "not from llgs",
1432 // Check for thread stop notification.
1433 if (is_from_llgs && (info.si_code == SI_TKILL) && (signo == SIGSTOP))
1435 // This is a tgkill()-based stop.
1437 log->Printf ("NativeProcessLinux::%s() pid %" PRIu64 " tid %" PRIu64 ", thread stopped",
1442 // Check that we're not already marked with a stop reason.
1443 // Note this thread really shouldn't already be marked as stopped - if we were, that would imply that
1444 // the kernel signaled us with the thread stopping which we handled and marked as stopped,
1445 // and that, without an intervening resume, we received another stop. It is more likely
1446 // that we are missing the marking of a run state somewhere if we find that the thread was
1447 // marked as stopped.
1448 const StateType thread_state = thread.GetState();
1449 if (!StateIsStoppedState (thread_state, false))
1451 // An inferior thread has stopped because of a SIGSTOP we have sent it.
1452 // Generally, these are not important stops and we don't want to report them as
1453 // they are just used to stop other threads when one thread (the one with the
1454 // *real* stop reason) hits a breakpoint (watchpoint, etc...). However, in the
1455 // case of an asynchronous Interrupt(), this *is* the real stop reason, so we
1456 // leave the signal intact if this is the thread that was chosen as the
1457 // triggering thread.
1458 if (m_pending_notification_tid != LLDB_INVALID_THREAD_ID)
1460 if (m_pending_notification_tid == thread.GetID())
1461 thread.SetStoppedBySignal(SIGSTOP, &info);
1463 thread.SetStoppedWithNoReason();
1465 SetCurrentThreadID (thread.GetID ());
1466 SignalIfAllThreadsStopped();
1470 // We can end up here if stop was initiated by LLGS but by this time a
1471 // thread stop has occurred - maybe initiated by another event.
1472 Error error = ResumeThread(thread, thread.GetState(), 0);
1473 if (error.Fail() && log)
1475 log->Printf("NativeProcessLinux::%s failed to resume thread tid %" PRIu64 ": %s",
1476 __FUNCTION__, thread.GetID(), error.AsCString());
1484 // Retrieve the signal name if the thread was stopped by a signal.
1486 const bool stopped_by_signal = thread.IsStopped(&stop_signo);
1487 const char *signal_name = stopped_by_signal ? Host::GetSignalAsCString(stop_signo) : "<not stopped by signal>";
1489 signal_name = "<no-signal-name>";
1491 log->Printf ("NativeProcessLinux::%s() pid %" PRIu64 " tid %" PRIu64 ", thread was already marked as a stopped state (state=%s, signal=%d (%s)), leaving stop signal as is",
1495 StateAsCString (thread_state),
1499 SignalIfAllThreadsStopped();
1507 log->Printf ("NativeProcessLinux::%s() received signal %s", __FUNCTION__, Host::GetSignalAsCString(signo));
1509 // This thread is stopped.
1510 thread.SetStoppedBySignal(signo, &info);
1512 // Send a stop to the debugger after we get all other threads to stop.
1513 StopRunningThreads(thread.GetID());
1518 struct EmulatorBaton
1520 NativeProcessLinux* m_process;
1521 NativeRegisterContext* m_reg_context;
1523 // eRegisterKindDWARF -> RegsiterValue
1524 std::unordered_map<uint32_t, RegisterValue> m_register_values;
1526 EmulatorBaton(NativeProcessLinux* process, NativeRegisterContext* reg_context) :
1527 m_process(process), m_reg_context(reg_context) {}
1530 } // anonymous namespace
1533 ReadMemoryCallback (EmulateInstruction *instruction,
1535 const EmulateInstruction::Context &context,
1540 EmulatorBaton* emulator_baton = static_cast<EmulatorBaton*>(baton);
1543 emulator_baton->m_process->ReadMemory(addr, dst, length, bytes_read);
1548 ReadRegisterCallback (EmulateInstruction *instruction,
1550 const RegisterInfo *reg_info,
1551 RegisterValue ®_value)
1553 EmulatorBaton* emulator_baton = static_cast<EmulatorBaton*>(baton);
1555 auto it = emulator_baton->m_register_values.find(reg_info->kinds[eRegisterKindDWARF]);
1556 if (it != emulator_baton->m_register_values.end())
1558 reg_value = it->second;
1562 // The emulator only fill in the dwarf regsiter numbers (and in some case
1563 // the generic register numbers). Get the full register info from the
1564 // register context based on the dwarf register numbers.
1565 const RegisterInfo* full_reg_info = emulator_baton->m_reg_context->GetRegisterInfo(
1566 eRegisterKindDWARF, reg_info->kinds[eRegisterKindDWARF]);
1568 Error error = emulator_baton->m_reg_context->ReadRegister(full_reg_info, reg_value);
1569 if (error.Success())
1576 WriteRegisterCallback (EmulateInstruction *instruction,
1578 const EmulateInstruction::Context &context,
1579 const RegisterInfo *reg_info,
1580 const RegisterValue ®_value)
1582 EmulatorBaton* emulator_baton = static_cast<EmulatorBaton*>(baton);
1583 emulator_baton->m_register_values[reg_info->kinds[eRegisterKindDWARF]] = reg_value;
1588 WriteMemoryCallback (EmulateInstruction *instruction,
1590 const EmulateInstruction::Context &context,
1599 ReadFlags (NativeRegisterContext* regsiter_context)
1601 const RegisterInfo* flags_info = regsiter_context->GetRegisterInfo(
1602 eRegisterKindGeneric, LLDB_REGNUM_GENERIC_FLAGS);
1603 return regsiter_context->ReadRegisterAsUnsigned(flags_info, LLDB_INVALID_ADDRESS);
1607 NativeProcessLinux::SetupSoftwareSingleStepping(NativeThreadLinux &thread)
1610 NativeRegisterContextSP register_context_sp = thread.GetRegisterContext();
1612 std::unique_ptr<EmulateInstruction> emulator_ap(
1613 EmulateInstruction::FindPlugin(m_arch, eInstructionTypePCModifying, nullptr));
1615 if (emulator_ap == nullptr)
1616 return Error("Instruction emulator not found!");
1618 EmulatorBaton baton(this, register_context_sp.get());
1619 emulator_ap->SetBaton(&baton);
1620 emulator_ap->SetReadMemCallback(&ReadMemoryCallback);
1621 emulator_ap->SetReadRegCallback(&ReadRegisterCallback);
1622 emulator_ap->SetWriteMemCallback(&WriteMemoryCallback);
1623 emulator_ap->SetWriteRegCallback(&WriteRegisterCallback);
1625 if (!emulator_ap->ReadInstruction())
1626 return Error("Read instruction failed!");
1628 bool emulation_result = emulator_ap->EvaluateInstruction(eEmulateInstructionOptionAutoAdvancePC);
1630 const RegisterInfo* reg_info_pc = register_context_sp->GetRegisterInfo(eRegisterKindGeneric, LLDB_REGNUM_GENERIC_PC);
1631 const RegisterInfo* reg_info_flags = register_context_sp->GetRegisterInfo(eRegisterKindGeneric, LLDB_REGNUM_GENERIC_FLAGS);
1633 auto pc_it = baton.m_register_values.find(reg_info_pc->kinds[eRegisterKindDWARF]);
1634 auto flags_it = baton.m_register_values.find(reg_info_flags->kinds[eRegisterKindDWARF]);
1636 lldb::addr_t next_pc;
1637 lldb::addr_t next_flags;
1638 if (emulation_result)
1640 assert(pc_it != baton.m_register_values.end() && "Emulation was successfull but PC wasn't updated");
1641 next_pc = pc_it->second.GetAsUInt64();
1643 if (flags_it != baton.m_register_values.end())
1644 next_flags = flags_it->second.GetAsUInt64();
1646 next_flags = ReadFlags (register_context_sp.get());
1648 else if (pc_it == baton.m_register_values.end())
1650 // Emulate instruction failed and it haven't changed PC. Advance PC
1651 // with the size of the current opcode because the emulation of all
1652 // PC modifying instruction should be successful. The failure most
1653 // likely caused by a not supported instruction which don't modify PC.
1654 next_pc = register_context_sp->GetPC() + emulator_ap->GetOpcode().GetByteSize();
1655 next_flags = ReadFlags (register_context_sp.get());
1659 // The instruction emulation failed after it modified the PC. It is an
1660 // unknown error where we can't continue because the next instruction is
1661 // modifying the PC but we don't know how.
1662 return Error ("Instruction emulation failed unexpectedly.");
1665 if (m_arch.GetMachine() == llvm::Triple::arm)
1667 if (next_flags & 0x20)
1670 error = SetSoftwareBreakpoint(next_pc, 2);
1675 error = SetSoftwareBreakpoint(next_pc, 4);
1678 else if (m_arch.GetMachine() == llvm::Triple::mips64
1679 || m_arch.GetMachine() == llvm::Triple::mips64el
1680 || m_arch.GetMachine() == llvm::Triple::mips
1681 || m_arch.GetMachine() == llvm::Triple::mipsel)
1682 error = SetSoftwareBreakpoint(next_pc, 4);
1685 // No size hint is given for the next breakpoint
1686 error = SetSoftwareBreakpoint(next_pc, 0);
1692 m_threads_stepping_with_breakpoint.insert({thread.GetID(), next_pc});
1698 NativeProcessLinux::SupportHardwareSingleStepping() const
1700 if (m_arch.GetMachine() == llvm::Triple::arm
1701 || m_arch.GetMachine() == llvm::Triple::mips64 || m_arch.GetMachine() == llvm::Triple::mips64el
1702 || m_arch.GetMachine() == llvm::Triple::mips || m_arch.GetMachine() == llvm::Triple::mipsel)
1708 NativeProcessLinux::Resume (const ResumeActionList &resume_actions)
1710 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS | LIBLLDB_LOG_THREAD));
1712 log->Printf ("NativeProcessLinux::%s called: pid %" PRIu64, __FUNCTION__, GetID ());
1714 bool software_single_step = !SupportHardwareSingleStepping();
1716 Mutex::Locker locker (m_threads_mutex);
1718 if (software_single_step)
1720 for (auto thread_sp : m_threads)
1722 assert (thread_sp && "thread list should not contain NULL threads");
1724 const ResumeAction *const action = resume_actions.GetActionForThread (thread_sp->GetID (), true);
1725 if (action == nullptr)
1728 if (action->state == eStateStepping)
1730 Error error = SetupSoftwareSingleStepping(static_cast<NativeThreadLinux &>(*thread_sp));
1737 for (auto thread_sp : m_threads)
1739 assert (thread_sp && "thread list should not contain NULL threads");
1741 const ResumeAction *const action = resume_actions.GetActionForThread (thread_sp->GetID (), true);
1743 if (action == nullptr)
1746 log->Printf ("NativeProcessLinux::%s no action specified for pid %" PRIu64 " tid %" PRIu64,
1747 __FUNCTION__, GetID (), thread_sp->GetID ());
1753 log->Printf ("NativeProcessLinux::%s processing resume action state %s for pid %" PRIu64 " tid %" PRIu64,
1754 __FUNCTION__, StateAsCString (action->state), GetID (), thread_sp->GetID ());
1757 switch (action->state)
1760 case eStateStepping:
1762 // Run the thread, possibly feeding it the signal.
1763 const int signo = action->signal;
1764 ResumeThread(static_cast<NativeThreadLinux &>(*thread_sp), action->state, signo);
1768 case eStateSuspended:
1770 lldbassert(0 && "Unexpected state");
1773 return Error ("NativeProcessLinux::%s (): unexpected state %s specified for pid %" PRIu64 ", tid %" PRIu64,
1774 __FUNCTION__, StateAsCString (action->state), GetID (), thread_sp->GetID ());
1782 NativeProcessLinux::Halt ()
1786 if (kill (GetID (), SIGSTOP) != 0)
1787 error.SetErrorToErrno ();
1793 NativeProcessLinux::Detach ()
1797 // Stop monitoring the inferior.
1798 m_sigchld_handle.reset();
1800 // Tell ptrace to detach from the process.
1801 if (GetID () == LLDB_INVALID_PROCESS_ID)
1804 for (auto thread_sp : m_threads)
1806 Error e = Detach(thread_sp->GetID());
1808 error = e; // Save the error, but still attempt to detach from other threads.
1815 NativeProcessLinux::Signal (int signo)
1819 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1821 log->Printf ("NativeProcessLinux::%s: sending signal %d (%s) to pid %" PRIu64,
1822 __FUNCTION__, signo, Host::GetSignalAsCString(signo), GetID());
1824 if (kill(GetID(), signo))
1825 error.SetErrorToErrno();
1831 NativeProcessLinux::Interrupt ()
1833 // Pick a running thread (or if none, a not-dead stopped thread) as
1834 // the chosen thread that will be the stop-reason thread.
1835 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1837 NativeThreadProtocolSP running_thread_sp;
1838 NativeThreadProtocolSP stopped_thread_sp;
1841 log->Printf ("NativeProcessLinux::%s selecting running thread for interrupt target", __FUNCTION__);
1843 Mutex::Locker locker (m_threads_mutex);
1845 for (auto thread_sp : m_threads)
1847 // The thread shouldn't be null but lets just cover that here.
1851 // If we have a running or stepping thread, we'll call that the
1852 // target of the interrupt.
1853 const auto thread_state = thread_sp->GetState ();
1854 if (thread_state == eStateRunning ||
1855 thread_state == eStateStepping)
1857 running_thread_sp = thread_sp;
1860 else if (!stopped_thread_sp && StateIsStoppedState (thread_state, true))
1862 // Remember the first non-dead stopped thread. We'll use that as a backup if there are no running threads.
1863 stopped_thread_sp = thread_sp;
1867 if (!running_thread_sp && !stopped_thread_sp)
1869 Error error("found no running/stepping or live stopped threads as target for interrupt");
1871 log->Printf ("NativeProcessLinux::%s skipping due to error: %s", __FUNCTION__, error.AsCString ());
1876 NativeThreadProtocolSP deferred_signal_thread_sp = running_thread_sp ? running_thread_sp : stopped_thread_sp;
1879 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 " %s tid %" PRIu64 " chosen for interrupt target",
1882 running_thread_sp ? "running" : "stopped",
1883 deferred_signal_thread_sp->GetID ());
1885 StopRunningThreads(deferred_signal_thread_sp->GetID());
1891 NativeProcessLinux::Kill ()
1893 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
1895 log->Printf ("NativeProcessLinux::%s called for PID %" PRIu64, __FUNCTION__, GetID ());
1901 case StateType::eStateInvalid:
1902 case StateType::eStateExited:
1903 case StateType::eStateCrashed:
1904 case StateType::eStateDetached:
1905 case StateType::eStateUnloaded:
1906 // Nothing to do - the process is already dead.
1908 log->Printf ("NativeProcessLinux::%s ignored for PID %" PRIu64 " due to current state: %s", __FUNCTION__, GetID (), StateAsCString (m_state));
1911 case StateType::eStateConnected:
1912 case StateType::eStateAttaching:
1913 case StateType::eStateLaunching:
1914 case StateType::eStateStopped:
1915 case StateType::eStateRunning:
1916 case StateType::eStateStepping:
1917 case StateType::eStateSuspended:
1918 // We can try to kill a process in these states.
1922 if (kill (GetID (), SIGKILL) != 0)
1924 error.SetErrorToErrno ();
1932 ParseMemoryRegionInfoFromProcMapsLine (const std::string &maps_line, MemoryRegionInfo &memory_region_info)
1934 memory_region_info.Clear();
1936 StringExtractor line_extractor (maps_line.c_str ());
1938 // Format: {address_start_hex}-{address_end_hex} perms offset dev inode pathname
1939 // perms: rwxp (letter is present if set, '-' if not, final character is p=private, s=shared).
1941 // Parse out the starting address
1942 lldb::addr_t start_address = line_extractor.GetHexMaxU64 (false, 0);
1944 // Parse out hyphen separating start and end address from range.
1945 if (!line_extractor.GetBytesLeft () || (line_extractor.GetChar () != '-'))
1946 return Error ("malformed /proc/{pid}/maps entry, missing dash between address range");
1948 // Parse out the ending address
1949 lldb::addr_t end_address = line_extractor.GetHexMaxU64 (false, start_address);
1951 // Parse out the space after the address.
1952 if (!line_extractor.GetBytesLeft () || (line_extractor.GetChar () != ' '))
1953 return Error ("malformed /proc/{pid}/maps entry, missing space after range");
1956 memory_region_info.GetRange ().SetRangeBase (start_address);
1957 memory_region_info.GetRange ().SetRangeEnd (end_address);
1959 // Parse out each permission entry.
1960 if (line_extractor.GetBytesLeft () < 4)
1961 return Error ("malformed /proc/{pid}/maps entry, missing some portion of permissions");
1963 // Handle read permission.
1964 const char read_perm_char = line_extractor.GetChar ();
1965 if (read_perm_char == 'r')
1966 memory_region_info.SetReadable (MemoryRegionInfo::OptionalBool::eYes);
1969 assert ( (read_perm_char == '-') && "unexpected /proc/{pid}/maps read permission char" );
1970 memory_region_info.SetReadable (MemoryRegionInfo::OptionalBool::eNo);
1973 // Handle write permission.
1974 const char write_perm_char = line_extractor.GetChar ();
1975 if (write_perm_char == 'w')
1976 memory_region_info.SetWritable (MemoryRegionInfo::OptionalBool::eYes);
1979 assert ( (write_perm_char == '-') && "unexpected /proc/{pid}/maps write permission char" );
1980 memory_region_info.SetWritable (MemoryRegionInfo::OptionalBool::eNo);
1983 // Handle execute permission.
1984 const char exec_perm_char = line_extractor.GetChar ();
1985 if (exec_perm_char == 'x')
1986 memory_region_info.SetExecutable (MemoryRegionInfo::OptionalBool::eYes);
1989 assert ( (exec_perm_char == '-') && "unexpected /proc/{pid}/maps exec permission char" );
1990 memory_region_info.SetExecutable (MemoryRegionInfo::OptionalBool::eNo);
1997 NativeProcessLinux::GetMemoryRegionInfo (lldb::addr_t load_addr, MemoryRegionInfo &range_info)
1999 // FIXME review that the final memory region returned extends to the end of the virtual address space,
2000 // with no perms if it is not mapped.
2002 // Use an approach that reads memory regions from /proc/{pid}/maps.
2003 // Assume proc maps entries are in ascending order.
2004 // FIXME assert if we find differently.
2005 Mutex::Locker locker (m_mem_region_cache_mutex);
2007 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2010 if (m_supports_mem_region == LazyBool::eLazyBoolNo)
2013 error.SetErrorString ("unsupported");
2017 // If our cache is empty, pull the latest. There should always be at least one memory region
2018 // if memory region handling is supported.
2019 if (m_mem_region_cache.empty ())
2021 error = ProcFileReader::ProcessLineByLine (GetID (), "maps",
2022 [&] (const std::string &line) -> bool
2024 MemoryRegionInfo info;
2025 const Error parse_error = ParseMemoryRegionInfoFromProcMapsLine (line, info);
2026 if (parse_error.Success ())
2028 m_mem_region_cache.push_back (info);
2034 log->Printf ("NativeProcessLinux::%s failed to parse proc maps line '%s': %s", __FUNCTION__, line.c_str (), error.AsCString ());
2039 // If we had an error, we'll mark unsupported.
2042 m_supports_mem_region = LazyBool::eLazyBoolNo;
2045 else if (m_mem_region_cache.empty ())
2047 // No entries after attempting to read them. This shouldn't happen if /proc/{pid}/maps
2048 // is supported. Assume we don't support map entries via procfs.
2050 log->Printf ("NativeProcessLinux::%s failed to find any procfs maps entries, assuming no support for memory region metadata retrieval", __FUNCTION__);
2051 m_supports_mem_region = LazyBool::eLazyBoolNo;
2052 error.SetErrorString ("not supported");
2057 log->Printf ("NativeProcessLinux::%s read %" PRIu64 " memory region entries from /proc/%" PRIu64 "/maps", __FUNCTION__, static_cast<uint64_t> (m_mem_region_cache.size ()), GetID ());
2059 // We support memory retrieval, remember that.
2060 m_supports_mem_region = LazyBool::eLazyBoolYes;
2065 log->Printf ("NativeProcessLinux::%s reusing %" PRIu64 " cached memory region entries", __FUNCTION__, static_cast<uint64_t> (m_mem_region_cache.size ()));
2068 lldb::addr_t prev_base_address = 0;
2070 // FIXME start by finding the last region that is <= target address using binary search. Data is sorted.
2071 // There can be a ton of regions on pthreads apps with lots of threads.
2072 for (auto it = m_mem_region_cache.begin(); it != m_mem_region_cache.end (); ++it)
2074 MemoryRegionInfo &proc_entry_info = *it;
2076 // Sanity check assumption that /proc/{pid}/maps entries are ascending.
2077 assert ((proc_entry_info.GetRange ().GetRangeBase () >= prev_base_address) && "descending /proc/pid/maps entries detected, unexpected");
2078 prev_base_address = proc_entry_info.GetRange ().GetRangeBase ();
2080 // If the target address comes before this entry, indicate distance to next region.
2081 if (load_addr < proc_entry_info.GetRange ().GetRangeBase ())
2083 range_info.GetRange ().SetRangeBase (load_addr);
2084 range_info.GetRange ().SetByteSize (proc_entry_info.GetRange ().GetRangeBase () - load_addr);
2085 range_info.SetReadable (MemoryRegionInfo::OptionalBool::eNo);
2086 range_info.SetWritable (MemoryRegionInfo::OptionalBool::eNo);
2087 range_info.SetExecutable (MemoryRegionInfo::OptionalBool::eNo);
2091 else if (proc_entry_info.GetRange ().Contains (load_addr))
2093 // The target address is within the memory region we're processing here.
2094 range_info = proc_entry_info;
2098 // The target memory address comes somewhere after the region we just parsed.
2101 // If we made it here, we didn't find an entry that contained the given address. Return the
2102 // load_addr as start and the amount of bytes betwwen load address and the end of the memory as
2104 range_info.GetRange ().SetRangeBase (load_addr);
2105 switch (m_arch.GetAddressByteSize())
2108 range_info.GetRange ().SetByteSize (0x100000000ull - load_addr);
2111 range_info.GetRange ().SetByteSize (0ull - load_addr);
2114 assert(false && "Unrecognized data byte size");
2117 range_info.SetReadable (MemoryRegionInfo::OptionalBool::eNo);
2118 range_info.SetWritable (MemoryRegionInfo::OptionalBool::eNo);
2119 range_info.SetExecutable (MemoryRegionInfo::OptionalBool::eNo);
2124 NativeProcessLinux::DoStopIDBumped (uint32_t newBumpId)
2126 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2128 log->Printf ("NativeProcessLinux::%s(newBumpId=%" PRIu32 ") called", __FUNCTION__, newBumpId);
2131 Mutex::Locker locker (m_mem_region_cache_mutex);
2133 log->Printf ("NativeProcessLinux::%s clearing %" PRIu64 " entries from the cache", __FUNCTION__, static_cast<uint64_t> (m_mem_region_cache.size ()));
2134 m_mem_region_cache.clear ();
2139 NativeProcessLinux::AllocateMemory(size_t size, uint32_t permissions, lldb::addr_t &addr)
2141 // FIXME implementing this requires the equivalent of
2142 // InferiorCallPOSIX::InferiorCallMmap, which depends on
2143 // functional ThreadPlans working with Native*Protocol.
2145 return Error ("not implemented yet");
2147 addr = LLDB_INVALID_ADDRESS;
2150 if (permissions & lldb::ePermissionsReadable)
2151 prot |= eMmapProtRead;
2152 if (permissions & lldb::ePermissionsWritable)
2153 prot |= eMmapProtWrite;
2154 if (permissions & lldb::ePermissionsExecutable)
2155 prot |= eMmapProtExec;
2157 // TODO implement this directly in NativeProcessLinux
2158 // (and lift to NativeProcessPOSIX if/when that class is
2160 if (InferiorCallMmap(this, addr, 0, size, prot,
2161 eMmapFlagsAnon | eMmapFlagsPrivate, -1, 0)) {
2162 m_addr_to_mmap_size[addr] = size;
2165 addr = LLDB_INVALID_ADDRESS;
2166 return Error("unable to allocate %" PRIu64 " bytes of memory with permissions %s", size, GetPermissionsAsCString (permissions));
2172 NativeProcessLinux::DeallocateMemory (lldb::addr_t addr)
2174 // FIXME see comments in AllocateMemory - required lower-level
2175 // bits not in place yet (ThreadPlans)
2176 return Error ("not implemented");
2180 NativeProcessLinux::GetSharedLibraryInfoAddress ()
2183 // punt on this for now
2184 return LLDB_INVALID_ADDRESS;
2186 // Return the image info address for the exe module
2188 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2191 Error error = GetExeModuleSP (module_sp);
2195 log->Warning ("NativeProcessLinux::%s failed to retrieve exe module: %s", __FUNCTION__, error.AsCString ());
2196 return LLDB_INVALID_ADDRESS;
2199 if (module_sp == nullptr)
2202 log->Warning ("NativeProcessLinux::%s exe module returned was NULL", __FUNCTION__);
2203 return LLDB_INVALID_ADDRESS;
2206 ObjectFileSP object_file_sp = module_sp->GetObjectFile ();
2207 if (object_file_sp == nullptr)
2210 log->Warning ("NativeProcessLinux::%s exe module returned a NULL object file", __FUNCTION__);
2211 return LLDB_INVALID_ADDRESS;
2214 return obj_file_sp->GetImageInfoAddress();
2216 Target *target = &GetTarget();
2217 ObjectFile *obj_file = target->GetExecutableModule()->GetObjectFile();
2218 Address addr = obj_file->GetImageInfoAddress(target);
2221 return addr.GetLoadAddress(target);
2222 return LLDB_INVALID_ADDRESS;
2224 #endif // punt on this for now
2228 NativeProcessLinux::UpdateThreads ()
2230 // The NativeProcessLinux monitoring threads are always up to date
2231 // with respect to thread state and they keep the thread list
2232 // populated properly. All this method needs to do is return the
2234 Mutex::Locker locker (m_threads_mutex);
2235 return m_threads.size ();
2239 NativeProcessLinux::GetArchitecture (ArchSpec &arch) const
2246 NativeProcessLinux::GetSoftwareBreakpointPCOffset(uint32_t &actual_opcode_size)
2248 // FIXME put this behind a breakpoint protocol class that can be
2249 // set per architecture. Need ARM, MIPS support here.
2250 static const uint8_t g_i386_opcode [] = { 0xCC };
2252 switch (m_arch.GetMachine ())
2254 case llvm::Triple::x86:
2255 case llvm::Triple::x86_64:
2256 actual_opcode_size = static_cast<uint32_t> (sizeof(g_i386_opcode));
2259 case llvm::Triple::arm:
2260 case llvm::Triple::aarch64:
2261 case llvm::Triple::mips64:
2262 case llvm::Triple::mips64el:
2263 case llvm::Triple::mips:
2264 case llvm::Triple::mipsel:
2265 // On these architectures the PC don't get updated for breakpoint hits
2266 actual_opcode_size = 0;
2270 assert(false && "CPU type not supported!");
2271 return Error ("CPU type not supported");
2276 NativeProcessLinux::SetBreakpoint (lldb::addr_t addr, uint32_t size, bool hardware)
2279 return Error ("NativeProcessLinux does not support hardware breakpoints");
2281 return SetSoftwareBreakpoint (addr, size);
2285 NativeProcessLinux::GetSoftwareBreakpointTrapOpcode (size_t trap_opcode_size_hint,
2286 size_t &actual_opcode_size,
2287 const uint8_t *&trap_opcode_bytes)
2289 // FIXME put this behind a breakpoint protocol class that can be set per
2290 // architecture. Need MIPS support here.
2291 static const uint8_t g_aarch64_opcode[] = { 0x00, 0x00, 0x20, 0xd4 };
2292 // The ARM reference recommends the use of 0xe7fddefe and 0xdefe but the
2293 // linux kernel does otherwise.
2294 static const uint8_t g_arm_breakpoint_opcode[] = { 0xf0, 0x01, 0xf0, 0xe7 };
2295 static const uint8_t g_i386_opcode [] = { 0xCC };
2296 static const uint8_t g_mips64_opcode[] = { 0x00, 0x00, 0x00, 0x0d };
2297 static const uint8_t g_mips64el_opcode[] = { 0x0d, 0x00, 0x00, 0x00 };
2298 static const uint8_t g_thumb_breakpoint_opcode[] = { 0x01, 0xde };
2300 switch (m_arch.GetMachine ())
2302 case llvm::Triple::aarch64:
2303 trap_opcode_bytes = g_aarch64_opcode;
2304 actual_opcode_size = sizeof(g_aarch64_opcode);
2307 case llvm::Triple::arm:
2308 switch (trap_opcode_size_hint)
2311 trap_opcode_bytes = g_thumb_breakpoint_opcode;
2312 actual_opcode_size = sizeof(g_thumb_breakpoint_opcode);
2315 trap_opcode_bytes = g_arm_breakpoint_opcode;
2316 actual_opcode_size = sizeof(g_arm_breakpoint_opcode);
2319 assert(false && "Unrecognised trap opcode size hint!");
2320 return Error ("Unrecognised trap opcode size hint!");
2323 case llvm::Triple::x86:
2324 case llvm::Triple::x86_64:
2325 trap_opcode_bytes = g_i386_opcode;
2326 actual_opcode_size = sizeof(g_i386_opcode);
2329 case llvm::Triple::mips:
2330 case llvm::Triple::mips64:
2331 trap_opcode_bytes = g_mips64_opcode;
2332 actual_opcode_size = sizeof(g_mips64_opcode);
2335 case llvm::Triple::mipsel:
2336 case llvm::Triple::mips64el:
2337 trap_opcode_bytes = g_mips64el_opcode;
2338 actual_opcode_size = sizeof(g_mips64el_opcode);
2342 assert(false && "CPU type not supported!");
2343 return Error ("CPU type not supported");
2348 ProcessMessage::CrashReason
2349 NativeProcessLinux::GetCrashReasonForSIGSEGV(const siginfo_t *info)
2351 ProcessMessage::CrashReason reason;
2352 assert(info->si_signo == SIGSEGV);
2354 reason = ProcessMessage::eInvalidCrashReason;
2356 switch (info->si_code)
2359 assert(false && "unexpected si_code for SIGSEGV");
2362 // Linux will occasionally send spurious SI_KERNEL codes.
2363 // (this is poorly documented in sigaction)
2364 // One way to get this is via unaligned SIMD loads.
2365 reason = ProcessMessage::eInvalidAddress; // for lack of anything better
2368 reason = ProcessMessage::eInvalidAddress;
2371 reason = ProcessMessage::ePrivilegedAddress;
2381 ProcessMessage::CrashReason
2382 NativeProcessLinux::GetCrashReasonForSIGILL(const siginfo_t *info)
2384 ProcessMessage::CrashReason reason;
2385 assert(info->si_signo == SIGILL);
2387 reason = ProcessMessage::eInvalidCrashReason;
2389 switch (info->si_code)
2392 assert(false && "unexpected si_code for SIGILL");
2395 reason = ProcessMessage::eIllegalOpcode;
2398 reason = ProcessMessage::eIllegalOperand;
2401 reason = ProcessMessage::eIllegalAddressingMode;
2404 reason = ProcessMessage::eIllegalTrap;
2407 reason = ProcessMessage::ePrivilegedOpcode;
2410 reason = ProcessMessage::ePrivilegedRegister;
2413 reason = ProcessMessage::eCoprocessorError;
2416 reason = ProcessMessage::eInternalStackError;
2425 ProcessMessage::CrashReason
2426 NativeProcessLinux::GetCrashReasonForSIGFPE(const siginfo_t *info)
2428 ProcessMessage::CrashReason reason;
2429 assert(info->si_signo == SIGFPE);
2431 reason = ProcessMessage::eInvalidCrashReason;
2433 switch (info->si_code)
2436 assert(false && "unexpected si_code for SIGFPE");
2439 reason = ProcessMessage::eIntegerDivideByZero;
2442 reason = ProcessMessage::eIntegerOverflow;
2445 reason = ProcessMessage::eFloatDivideByZero;
2448 reason = ProcessMessage::eFloatOverflow;
2451 reason = ProcessMessage::eFloatUnderflow;
2454 reason = ProcessMessage::eFloatInexactResult;
2457 reason = ProcessMessage::eFloatInvalidOperation;
2460 reason = ProcessMessage::eFloatSubscriptRange;
2469 ProcessMessage::CrashReason
2470 NativeProcessLinux::GetCrashReasonForSIGBUS(const siginfo_t *info)
2472 ProcessMessage::CrashReason reason;
2473 assert(info->si_signo == SIGBUS);
2475 reason = ProcessMessage::eInvalidCrashReason;
2477 switch (info->si_code)
2480 assert(false && "unexpected si_code for SIGBUS");
2483 reason = ProcessMessage::eIllegalAlignment;
2486 reason = ProcessMessage::eIllegalAddress;
2489 reason = ProcessMessage::eHardwareError;
2498 NativeProcessLinux::ReadMemory (lldb::addr_t addr, void *buf, size_t size, size_t &bytes_read)
2500 if (ProcessVmReadvSupported()) {
2501 // The process_vm_readv path is about 50 times faster than ptrace api. We want to use
2502 // this syscall if it is supported.
2504 const ::pid_t pid = GetID();
2506 struct iovec local_iov, remote_iov;
2507 local_iov.iov_base = buf;
2508 local_iov.iov_len = size;
2509 remote_iov.iov_base = reinterpret_cast<void *>(addr);
2510 remote_iov.iov_len = size;
2512 bytes_read = process_vm_readv(pid, &local_iov, 1, &remote_iov, 1, 0);
2513 const bool success = bytes_read == size;
2515 Log *log(GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2517 log->Printf ("NativeProcessLinux::%s using process_vm_readv to read %zd bytes from inferior address 0x%" PRIx64": %s",
2518 __FUNCTION__, size, addr, success ? "Success" : strerror(errno));
2523 // the call failed for some reason, let's retry the read using ptrace api.
2526 unsigned char *dst = static_cast<unsigned char*>(buf);
2530 Log *log (ProcessPOSIXLog::GetLogIfAllCategoriesSet (POSIX_LOG_ALL));
2532 ProcessPOSIXLog::IncNestLevel();
2533 if (log && ProcessPOSIXLog::AtTopNestLevel() && log->GetMask().Test(POSIX_LOG_MEMORY))
2534 log->Printf ("NativeProcessLinux::%s(%p, %p, %zd, _)", __FUNCTION__, (void*)addr, buf, size);
2536 for (bytes_read = 0; bytes_read < size; bytes_read += remainder)
2538 Error error = NativeProcessLinux::PtraceWrapper(PTRACE_PEEKDATA, GetID(), (void*)addr, nullptr, 0, &data);
2542 ProcessPOSIXLog::DecNestLevel();
2546 remainder = size - bytes_read;
2547 remainder = remainder > k_ptrace_word_size ? k_ptrace_word_size : remainder;
2549 // Copy the data into our buffer
2550 memcpy(dst, &data, remainder);
2552 if (log && ProcessPOSIXLog::AtTopNestLevel() &&
2553 (log->GetMask().Test(POSIX_LOG_MEMORY_DATA_LONG) ||
2554 (log->GetMask().Test(POSIX_LOG_MEMORY_DATA_SHORT) &&
2555 size <= POSIX_LOG_MEMORY_SHORT_BYTES)))
2557 uintptr_t print_dst = 0;
2558 // Format bytes from data by moving into print_dst for log output
2559 for (unsigned i = 0; i < remainder; ++i)
2560 print_dst |= (((data >> i*8) & 0xFF) << i*8);
2561 log->Printf ("NativeProcessLinux::%s() [0x%" PRIx64 "]:0x%" PRIx64 " (0x%" PRIx64 ")",
2562 __FUNCTION__, addr, uint64_t(print_dst), uint64_t(data));
2564 addr += k_ptrace_word_size;
2565 dst += k_ptrace_word_size;
2569 ProcessPOSIXLog::DecNestLevel();
2574 NativeProcessLinux::ReadMemoryWithoutTrap(lldb::addr_t addr, void *buf, size_t size, size_t &bytes_read)
2576 Error error = ReadMemory(addr, buf, size, bytes_read);
2577 if (error.Fail()) return error;
2578 return m_breakpoint_list.RemoveTrapsFromBuffer(addr, buf, size);
2582 NativeProcessLinux::WriteMemory(lldb::addr_t addr, const void *buf, size_t size, size_t &bytes_written)
2584 const unsigned char *src = static_cast<const unsigned char*>(buf);
2588 Log *log (ProcessPOSIXLog::GetLogIfAllCategoriesSet (POSIX_LOG_ALL));
2590 ProcessPOSIXLog::IncNestLevel();
2591 if (log && ProcessPOSIXLog::AtTopNestLevel() && log->GetMask().Test(POSIX_LOG_MEMORY))
2592 log->Printf ("NativeProcessLinux::%s(0x%" PRIx64 ", %p, %zu)", __FUNCTION__, addr, buf, size);
2594 for (bytes_written = 0; bytes_written < size; bytes_written += remainder)
2596 remainder = size - bytes_written;
2597 remainder = remainder > k_ptrace_word_size ? k_ptrace_word_size : remainder;
2599 if (remainder == k_ptrace_word_size)
2601 unsigned long data = 0;
2602 memcpy(&data, src, k_ptrace_word_size);
2604 if (log && ProcessPOSIXLog::AtTopNestLevel() &&
2605 (log->GetMask().Test(POSIX_LOG_MEMORY_DATA_LONG) ||
2606 (log->GetMask().Test(POSIX_LOG_MEMORY_DATA_SHORT) &&
2607 size <= POSIX_LOG_MEMORY_SHORT_BYTES)))
2608 log->Printf ("NativeProcessLinux::%s() [%p]:0x%lx (0x%lx)", __FUNCTION__,
2609 (void*)addr, *(const unsigned long*)src, data);
2611 error = NativeProcessLinux::PtraceWrapper(PTRACE_POKEDATA, GetID(), (void*)addr, (void*)data);
2615 ProcessPOSIXLog::DecNestLevel();
2621 unsigned char buff[8];
2623 error = ReadMemory(addr, buff, k_ptrace_word_size, bytes_read);
2627 ProcessPOSIXLog::DecNestLevel();
2631 memcpy(buff, src, remainder);
2633 size_t bytes_written_rec;
2634 error = WriteMemory(addr, buff, k_ptrace_word_size, bytes_written_rec);
2638 ProcessPOSIXLog::DecNestLevel();
2642 if (log && ProcessPOSIXLog::AtTopNestLevel() &&
2643 (log->GetMask().Test(POSIX_LOG_MEMORY_DATA_LONG) ||
2644 (log->GetMask().Test(POSIX_LOG_MEMORY_DATA_SHORT) &&
2645 size <= POSIX_LOG_MEMORY_SHORT_BYTES)))
2646 log->Printf ("NativeProcessLinux::%s() [%p]:0x%lx (0x%lx)", __FUNCTION__,
2647 (void*)addr, *(const unsigned long*)src, *(unsigned long*)buff);
2650 addr += k_ptrace_word_size;
2651 src += k_ptrace_word_size;
2654 ProcessPOSIXLog::DecNestLevel();
2659 NativeProcessLinux::Resume (lldb::tid_t tid, uint32_t signo)
2661 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_PROCESS));
2664 log->Printf ("NativeProcessLinux::%s() resuming thread = %" PRIu64 " with signal %s", __FUNCTION__, tid,
2665 Host::GetSignalAsCString(signo));
2671 if (signo != LLDB_INVALID_SIGNAL_NUMBER)
2674 Error error = PtraceWrapper(PTRACE_CONT, tid, nullptr, (void*)data);
2677 log->Printf ("NativeProcessLinux::%s() resuming thread = %" PRIu64 " result = %s", __FUNCTION__, tid, error.Success() ? "true" : "false");
2682 NativeProcessLinux::SingleStep(lldb::tid_t tid, uint32_t signo)
2686 if (signo != LLDB_INVALID_SIGNAL_NUMBER)
2689 // If hardware single-stepping is not supported, we just do a continue. The breakpoint on the
2690 // next instruction has been setup in NativeProcessLinux::Resume.
2691 return PtraceWrapper(SupportHardwareSingleStepping() ? PTRACE_SINGLESTEP : PTRACE_CONT,
2692 tid, nullptr, (void*)data);
2696 NativeProcessLinux::GetSignalInfo(lldb::tid_t tid, void *siginfo)
2698 return PtraceWrapper(PTRACE_GETSIGINFO, tid, nullptr, siginfo);
2702 NativeProcessLinux::GetEventMessage(lldb::tid_t tid, unsigned long *message)
2704 return PtraceWrapper(PTRACE_GETEVENTMSG, tid, nullptr, message);
2708 NativeProcessLinux::Detach(lldb::tid_t tid)
2710 if (tid == LLDB_INVALID_THREAD_ID)
2713 return PtraceWrapper(PTRACE_DETACH, tid);
2717 NativeProcessLinux::DupDescriptor(const FileSpec &file_spec, int fd, int flags)
2719 int target_fd = open(file_spec.GetCString(), flags, 0666);
2721 if (target_fd == -1)
2724 if (dup2(target_fd, fd) == -1)
2727 return (close(target_fd) == -1) ? false : true;
2731 NativeProcessLinux::HasThreadNoLock (lldb::tid_t thread_id)
2733 for (auto thread_sp : m_threads)
2735 assert (thread_sp && "thread list should not contain NULL threads");
2736 if (thread_sp->GetID () == thread_id)
2738 // We have this thread.
2743 // We don't have this thread.
2748 NativeProcessLinux::StopTrackingThread (lldb::tid_t thread_id)
2750 Log *const log = GetLogIfAllCategoriesSet (LIBLLDB_LOG_THREAD);
2753 log->Printf("NativeProcessLinux::%s (tid: %" PRIu64 ")", __FUNCTION__, thread_id);
2757 Mutex::Locker locker (m_threads_mutex);
2758 for (auto it = m_threads.begin (); it != m_threads.end (); ++it)
2760 if (*it && ((*it)->GetID () == thread_id))
2762 m_threads.erase (it);
2768 SignalIfAllThreadsStopped();
2774 NativeProcessLinux::AddThread (lldb::tid_t thread_id)
2776 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_THREAD));
2778 Mutex::Locker locker (m_threads_mutex);
2782 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 " adding thread with tid %" PRIu64,
2788 assert (!HasThreadNoLock (thread_id) && "attempted to add a thread by id that already exists");
2790 // If this is the first thread, save it as the current thread
2791 if (m_threads.empty ())
2792 SetCurrentThreadID (thread_id);
2794 auto thread_sp = std::make_shared<NativeThreadLinux>(this, thread_id);
2795 m_threads.push_back (thread_sp);
2800 NativeProcessLinux::FixupBreakpointPCAsNeeded(NativeThreadLinux &thread)
2802 Log *log (GetLogIfAllCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
2806 // Find out the size of a breakpoint (might depend on where we are in the code).
2807 NativeRegisterContextSP context_sp = thread.GetRegisterContext();
2810 error.SetErrorString ("cannot get a NativeRegisterContext for the thread");
2812 log->Printf ("NativeProcessLinux::%s failed: %s", __FUNCTION__, error.AsCString ());
2816 uint32_t breakpoint_size = 0;
2817 error = GetSoftwareBreakpointPCOffset(breakpoint_size);
2821 log->Printf ("NativeProcessLinux::%s GetBreakpointSize() failed: %s", __FUNCTION__, error.AsCString ());
2827 log->Printf ("NativeProcessLinux::%s breakpoint size: %" PRIu32, __FUNCTION__, breakpoint_size);
2830 // First try probing for a breakpoint at a software breakpoint location: PC - breakpoint size.
2831 const lldb::addr_t initial_pc_addr = context_sp->GetPCfromBreakpointLocation ();
2832 lldb::addr_t breakpoint_addr = initial_pc_addr;
2833 if (breakpoint_size > 0)
2835 // Do not allow breakpoint probe to wrap around.
2836 if (breakpoint_addr >= breakpoint_size)
2837 breakpoint_addr -= breakpoint_size;
2840 // Check if we stopped because of a breakpoint.
2841 NativeBreakpointSP breakpoint_sp;
2842 error = m_breakpoint_list.GetBreakpoint (breakpoint_addr, breakpoint_sp);
2843 if (!error.Success () || !breakpoint_sp)
2845 // We didn't find one at a software probe location. Nothing to do.
2847 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 " no lldb breakpoint found at current pc with adjustment: 0x%" PRIx64, __FUNCTION__, GetID (), breakpoint_addr);
2851 // If the breakpoint is not a software breakpoint, nothing to do.
2852 if (!breakpoint_sp->IsSoftwareBreakpoint ())
2855 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 " breakpoint found at 0x%" PRIx64 ", not software, nothing to adjust", __FUNCTION__, GetID (), breakpoint_addr);
2860 // We have a software breakpoint and need to adjust the PC.
2864 if (breakpoint_size == 0)
2866 // Nothing to do! How did we get here?
2868 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 " breakpoint found at 0x%" PRIx64 ", it is software, but the size is zero, nothing to do (unexpected)", __FUNCTION__, GetID (), breakpoint_addr);
2872 // Change the program counter.
2874 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 " tid %" PRIu64 ": changing PC from 0x%" PRIx64 " to 0x%" PRIx64, __FUNCTION__, GetID(), thread.GetID(), initial_pc_addr, breakpoint_addr);
2876 error = context_sp->SetPC (breakpoint_addr);
2880 log->Printf ("NativeProcessLinux::%s pid %" PRIu64 " tid %" PRIu64 ": failed to set PC: %s", __FUNCTION__, GetID(), thread.GetID(), error.AsCString ());
2888 NativeProcessLinux::GetLoadedModuleFileSpec(const char* module_path, FileSpec& file_spec)
2890 FileSpec module_file_spec(module_path, true);
2894 ProcFileReader::ProcessLineByLine(GetID(), "maps",
2895 [&] (const std::string &line)
2897 SmallVector<StringRef, 16> columns;
2898 StringRef(line).split(columns, " ", -1, false);
2899 if (columns.size() < 6)
2900 return true; // continue searching
2902 FileSpec this_file_spec(columns[5].str().c_str(), false);
2903 if (this_file_spec.GetFilename() != module_file_spec.GetFilename())
2904 return true; // continue searching
2906 file_spec = this_file_spec;
2908 return false; // we are done
2912 return Error("Module file (%s) not found in /proc/%" PRIu64 "/maps file!",
2913 module_file_spec.GetFilename().AsCString(), GetID());
2919 NativeProcessLinux::GetFileLoadAddress(const llvm::StringRef& file_name, lldb::addr_t& load_addr)
2921 load_addr = LLDB_INVALID_ADDRESS;
2922 Error error = ProcFileReader::ProcessLineByLine (GetID (), "maps",
2923 [&] (const std::string &line) -> bool
2925 StringRef maps_row(line);
2927 SmallVector<StringRef, 16> maps_columns;
2928 maps_row.split(maps_columns, StringRef(" "), -1, false);
2930 if (maps_columns.size() < 6)
2932 // Return true to continue reading the proc file
2936 if (maps_columns[5] == file_name)
2938 StringExtractor addr_extractor(maps_columns[0].str().c_str());
2939 load_addr = addr_extractor.GetHexMaxU64(false, LLDB_INVALID_ADDRESS);
2941 // Return false to stop reading the proc file further
2945 // Return true to continue reading the proc file
2952 NativeProcessLinux::GetThreadByID(lldb::tid_t tid)
2954 return std::static_pointer_cast<NativeThreadLinux>(NativeProcessProtocol::GetThreadByID(tid));
2958 NativeProcessLinux::ResumeThread(NativeThreadLinux &thread, lldb::StateType state, int signo)
2960 Log *const log = GetLogIfAllCategoriesSet (LIBLLDB_LOG_THREAD);
2963 log->Printf("NativeProcessLinux::%s (tid: %" PRIu64 ")",
2964 __FUNCTION__, thread.GetID());
2966 // Before we do the resume below, first check if we have a pending
2967 // stop notification that is currently waiting for
2968 // all threads to stop. This is potentially a buggy situation since
2969 // we're ostensibly waiting for threads to stop before we send out the
2970 // pending notification, and here we are resuming one before we send
2971 // out the pending stop notification.
2972 if (m_pending_notification_tid != LLDB_INVALID_THREAD_ID && log)
2974 log->Printf("NativeProcessLinux::%s about to resume tid %" PRIu64 " per explicit request but we have a pending stop notification (tid %" PRIu64 ") that is actively waiting for this thread to stop. Valid sequence of events?", __FUNCTION__, thread.GetID(), m_pending_notification_tid);
2977 // Request a resume. We expect this to be synchronous and the system
2978 // to reflect it is running after this completes.
2983 thread.SetRunning();
2984 const auto resume_result = Resume(thread.GetID(), signo);
2985 if (resume_result.Success())
2986 SetState(eStateRunning, true);
2987 return resume_result;
2989 case eStateStepping:
2991 thread.SetStepping();
2992 const auto step_result = SingleStep(thread.GetID(), signo);
2993 if (step_result.Success())
2994 SetState(eStateRunning, true);
2999 log->Printf("NativeProcessLinux::%s Unhandled state %s.",
3000 __FUNCTION__, StateAsCString(state));
3001 llvm_unreachable("Unhandled state for resume");
3005 //===----------------------------------------------------------------------===//
3008 NativeProcessLinux::StopRunningThreads(const lldb::tid_t triggering_tid)
3010 Log *const log = GetLogIfAllCategoriesSet (LIBLLDB_LOG_THREAD);
3014 log->Printf("NativeProcessLinux::%s about to process event: (triggering_tid: %" PRIu64 ")",
3015 __FUNCTION__, triggering_tid);
3018 m_pending_notification_tid = triggering_tid;
3020 // Request a stop for all the thread stops that need to be stopped
3021 // and are not already known to be stopped.
3022 for (const auto &thread_sp: m_threads)
3024 if (StateIsRunningState(thread_sp->GetState()))
3025 static_pointer_cast<NativeThreadLinux>(thread_sp)->RequestStop();
3028 SignalIfAllThreadsStopped();
3032 log->Printf("NativeProcessLinux::%s event processing done", __FUNCTION__);
3037 NativeProcessLinux::SignalIfAllThreadsStopped()
3039 if (m_pending_notification_tid == LLDB_INVALID_THREAD_ID)
3040 return; // No pending notification. Nothing to do.
3042 for (const auto &thread_sp: m_threads)
3044 if (StateIsRunningState(thread_sp->GetState()))
3045 return; // Some threads are still running. Don't signal yet.
3048 // We have a pending notification and all threads have stopped.
3049 Log *log(GetLogIfAnyCategoriesSet(LIBLLDB_LOG_PROCESS | LIBLLDB_LOG_BREAKPOINTS));
3051 // Clear any temporary breakpoints we used to implement software single stepping.
3052 for (const auto &thread_info: m_threads_stepping_with_breakpoint)
3054 Error error = RemoveBreakpoint (thread_info.second);
3057 log->Printf("NativeProcessLinux::%s() pid = %" PRIu64 " remove stepping breakpoint: %s",
3058 __FUNCTION__, thread_info.first, error.AsCString());
3060 m_threads_stepping_with_breakpoint.clear();
3062 // Notify the delegate about the stop
3063 SetCurrentThreadID(m_pending_notification_tid);
3064 SetState(StateType::eStateStopped, true);
3065 m_pending_notification_tid = LLDB_INVALID_THREAD_ID;
3069 NativeProcessLinux::ThreadWasCreated(NativeThreadLinux &thread)
3071 Log *const log = GetLogIfAllCategoriesSet (LIBLLDB_LOG_THREAD);
3074 log->Printf("NativeProcessLinux::%s (tid: %" PRIu64 ")", __FUNCTION__, thread.GetID());
3076 if (m_pending_notification_tid != LLDB_INVALID_THREAD_ID && StateIsRunningState(thread.GetState()))
3078 // We will need to wait for this new thread to stop as well before firing the
3080 thread.RequestStop();
3085 NativeProcessLinux::SigchldHandler()
3087 Log *log(GetLogIfAllCategoriesSet(LIBLLDB_LOG_PROCESS));
3088 // Process all pending waitpid notifications.
3092 ::pid_t wait_pid = waitpid(-1, &status, __WALL | __WNOTHREAD | WNOHANG);
3095 break; // We are done.
3102 Error error(errno, eErrorTypePOSIX);
3104 log->Printf("NativeProcessLinux::%s waitpid (-1, &status, __WALL | __WNOTHREAD | WNOHANG) failed: %s",
3105 __FUNCTION__, error.AsCString());
3109 bool exited = false;
3111 int exit_status = 0;
3112 const char *status_cstr = nullptr;
3113 if (WIFSTOPPED(status))
3115 signal = WSTOPSIG(status);
3116 status_cstr = "STOPPED";
3118 else if (WIFEXITED(status))
3120 exit_status = WEXITSTATUS(status);
3121 status_cstr = "EXITED";
3124 else if (WIFSIGNALED(status))
3126 signal = WTERMSIG(status);
3127 status_cstr = "SIGNALED";
3128 if (wait_pid == static_cast< ::pid_t>(GetID())) {
3134 status_cstr = "(\?\?\?)";
3137 log->Printf("NativeProcessLinux::%s: waitpid (-1, &status, __WALL | __WNOTHREAD | WNOHANG)"
3138 "=> pid = %" PRIi32 ", status = 0x%8.8x (%s), signal = %i, exit_state = %i",
3139 __FUNCTION__, wait_pid, status, status_cstr, signal, exit_status);
3141 MonitorCallback (wait_pid, exited, signal, exit_status);
3145 // Wrapper for ptrace to catch errors and log calls.
3146 // Note that ptrace sets errno on error because -1 can be a valid result (i.e. for PTRACE_PEEK*)
3148 NativeProcessLinux::PtraceWrapper(int req, lldb::pid_t pid, void *addr, void *data, size_t data_size, long *result)
3153 Log *log (ProcessPOSIXLog::GetLogIfAllCategoriesSet (POSIX_LOG_PTRACE));
3155 PtraceDisplayBytes(req, data, data_size);
3158 if (req == PTRACE_GETREGSET || req == PTRACE_SETREGSET)
3159 ret = ptrace(static_cast<__ptrace_request>(req), static_cast< ::pid_t>(pid), *(unsigned int *)addr, data);
3161 ret = ptrace(static_cast<__ptrace_request>(req), static_cast< ::pid_t>(pid), addr, data);
3164 error.SetErrorToErrno();
3170 log->Printf("ptrace(%d, %" PRIu64 ", %p, %p, %zu)=%lX", req, pid, addr, data, data_size, ret);
3172 PtraceDisplayBytes(req, data, data_size);
3174 if (log && error.GetError() != 0)
3177 switch (error.GetError())
3179 case ESRCH: str = "ESRCH"; break;
3180 case EINVAL: str = "EINVAL"; break;
3181 case EBUSY: str = "EBUSY"; break;
3182 case EPERM: str = "EPERM"; break;
3183 default: str = error.AsCString();
3185 log->Printf("ptrace() failed; errno=%d (%s)", error.GetError(), str);