1 //===-- Thread.cpp ----------------------------------------------*- C++ -*-===//
2 //
3 //                     The LLVM Compiler Infrastructure
4 //
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
7 //
8 //===----------------------------------------------------------------------===//
9 
10 #include "lldb/lldb-private-log.h"
11 #include "lldb/Breakpoint/BreakpointLocation.h"
12 #include "lldb/Core/Debugger.h"
13 #include "lldb/Core/Log.h"
14 #include "lldb/Core/Stream.h"
15 #include "lldb/Core/StreamString.h"
16 #include "lldb/Core/RegularExpression.h"
17 #include "lldb/Host/Host.h"
18 #include "lldb/Target/DynamicLoader.h"
19 #include "lldb/Target/ExecutionContext.h"
20 #include "lldb/Target/ObjCLanguageRuntime.h"
21 #include "lldb/Target/Process.h"
22 #include "lldb/Target/RegisterContext.h"
23 #include "lldb/Target/StopInfo.h"
24 #include "lldb/Target/Target.h"
25 #include "lldb/Target/Thread.h"
26 #include "lldb/Target/ThreadPlan.h"
27 #include "lldb/Target/ThreadPlanCallFunction.h"
28 #include "lldb/Target/ThreadPlanBase.h"
29 #include "lldb/Target/ThreadPlanStepInstruction.h"
30 #include "lldb/Target/ThreadPlanStepOut.h"
31 #include "lldb/Target/ThreadPlanStepOverBreakpoint.h"
32 #include "lldb/Target/ThreadPlanStepThrough.h"
33 #include "lldb/Target/ThreadPlanStepInRange.h"
34 #include "lldb/Target/ThreadPlanStepOverRange.h"
35 #include "lldb/Target/ThreadPlanRunToAddress.h"
36 #include "lldb/Target/ThreadPlanStepUntil.h"
37 #include "lldb/Target/ThreadSpec.h"
38 #include "lldb/Target/Unwind.h"
39 #include "Plugins/Process/Utility/UnwindLLDB.h"
40 #include "UnwindMacOSXFrameBackchain.h"
41 
42 
43 using namespace lldb;
44 using namespace lldb_private;
45 
46 Thread::Thread (Process &process, lldb::tid_t tid) :
47     UserID (tid),
48     ThreadInstanceSettings (*GetSettingsController()),
49     m_process (process),
50     m_actual_stop_info_sp (),
51     m_index_id (process.GetNextThreadIndexID ()),
52     m_reg_context_sp (),
53     m_state (eStateUnloaded),
54     m_state_mutex (Mutex::eMutexTypeRecursive),
55     m_plan_stack (),
56     m_completed_plan_stack(),
57     m_curr_frames_sp (),
58     m_prev_frames_sp (),
59     m_resume_signal (LLDB_INVALID_SIGNAL_NUMBER),
60     m_resume_state (eStateRunning),
61     m_unwinder_ap (),
62     m_destroy_called (false),
63     m_thread_stop_reason_stop_id (0)
64 
65 {
66     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_OBJECT));
67     if (log)
68         log->Printf ("%p Thread::Thread(tid = 0x%4.4llx)", this, GetID());
69 
70     QueueFundamentalPlan(true);
71     UpdateInstanceName();
72 }
73 
74 
75 Thread::~Thread()
76 {
77     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_OBJECT));
78     if (log)
79         log->Printf ("%p Thread::~Thread(tid = 0x%4.4llx)", this, GetID());
80     /// If you hit this assert, it means your derived class forgot to call DoDestroy in its destructor.
81     assert (m_destroy_called);
82 }
83 
84 void
85 Thread::DestroyThread ()
86 {
87     m_plan_stack.clear();
88     m_discarded_plan_stack.clear();
89     m_completed_plan_stack.clear();
90     m_destroy_called = true;
91 }
92 
93 lldb::StopInfoSP
94 Thread::GetStopInfo ()
95 {
96     ThreadPlanSP plan_sp (GetCompletedPlan());
97     if (plan_sp)
98         return StopInfo::CreateStopReasonWithPlan (plan_sp);
99     else
100     {
101         if (m_actual_stop_info_sp
102             && m_actual_stop_info_sp->IsValid()
103             && m_thread_stop_reason_stop_id == m_process.GetStopID())
104             return m_actual_stop_info_sp;
105         else
106             return GetPrivateStopReason ();
107     }
108 }
109 
110 void
111 Thread::SetStopInfo (const lldb::StopInfoSP &stop_info_sp)
112 {
113     m_actual_stop_info_sp = stop_info_sp;
114     if (m_actual_stop_info_sp)
115         m_actual_stop_info_sp->MakeStopInfoValid();
116     m_thread_stop_reason_stop_id = GetProcess().GetStopID();
117 }
118 
119 void
120 Thread::SetStopInfoToNothing()
121 {
122     // Note, we can't just NULL out the private reason, or the native thread implementation will try to
123     // go calculate it again.  For now, just set it to a Unix Signal with an invalid signal number.
124     SetStopInfo (StopInfo::CreateStopReasonWithSignal (*this,  LLDB_INVALID_SIGNAL_NUMBER));
125 }
126 
127 bool
128 Thread::ThreadStoppedForAReason (void)
129 {
130     return GetPrivateStopReason () != NULL;
131 }
132 
133 bool
134 Thread::CheckpointThreadState (ThreadStateCheckpoint &saved_state)
135 {
136     if (!SaveFrameZeroState(saved_state.register_backup))
137         return false;
138 
139     saved_state.stop_info_sp = GetStopInfo();
140     saved_state.orig_stop_id = GetProcess().GetStopID();
141 
142     return true;
143 }
144 
145 bool
146 Thread::RestoreThreadStateFromCheckpoint (ThreadStateCheckpoint &saved_state)
147 {
148     RestoreSaveFrameZero(saved_state.register_backup);
149     if (saved_state.stop_info_sp)
150         saved_state.stop_info_sp->MakeStopInfoValid();
151     SetStopInfo(saved_state.stop_info_sp);
152     return true;
153 }
154 
155 StateType
156 Thread::GetState() const
157 {
158     // If any other threads access this we will need a mutex for it
159     Mutex::Locker locker(m_state_mutex);
160     return m_state;
161 }
162 
163 void
164 Thread::SetState(StateType state)
165 {
166     Mutex::Locker locker(m_state_mutex);
167     m_state = state;
168 }
169 
170 void
171 Thread::WillStop()
172 {
173     ThreadPlan *current_plan = GetCurrentPlan();
174 
175     // FIXME: I may decide to disallow threads with no plans.  In which
176     // case this should go to an assert.
177 
178     if (!current_plan)
179         return;
180 
181     current_plan->WillStop();
182 }
183 
184 void
185 Thread::SetupForResume ()
186 {
187     if (GetResumeState() != eStateSuspended)
188     {
189 
190         // If we're at a breakpoint push the step-over breakpoint plan.  Do this before
191         // telling the current plan it will resume, since we might change what the current
192         // plan is.
193 
194         lldb::addr_t pc = GetRegisterContext()->GetPC();
195         BreakpointSiteSP bp_site_sp = GetProcess().GetBreakpointSiteList().FindByAddress(pc);
196         if (bp_site_sp && bp_site_sp->IsEnabled())
197         {
198             // Note, don't assume there's a ThreadPlanStepOverBreakpoint, the target may not require anything
199             // special to step over a breakpoint.
200 
201             ThreadPlan *cur_plan = GetCurrentPlan();
202 
203             if (cur_plan->GetKind() != ThreadPlan::eKindStepOverBreakpoint)
204             {
205                 ThreadPlanStepOverBreakpoint *step_bp_plan = new ThreadPlanStepOverBreakpoint (*this);
206                 if (step_bp_plan)
207                 {
208                     ThreadPlanSP step_bp_plan_sp;
209                     step_bp_plan->SetPrivate (true);
210 
211                     if (GetCurrentPlan()->RunState() != eStateStepping)
212                     {
213                         step_bp_plan->SetAutoContinue(true);
214                     }
215                     step_bp_plan_sp.reset (step_bp_plan);
216                     QueueThreadPlan (step_bp_plan_sp, false);
217                 }
218             }
219         }
220     }
221 }
222 
223 bool
224 Thread::WillResume (StateType resume_state)
225 {
226     // At this point clear the completed plan stack.
227     m_completed_plan_stack.clear();
228     m_discarded_plan_stack.clear();
229 
230     StopInfo *stop_info = GetPrivateStopReason().get();
231     if (stop_info)
232         stop_info->WillResume (resume_state);
233 
234     // Tell all the plans that we are about to resume in case they need to clear any state.
235     // We distinguish between the plan on the top of the stack and the lower
236     // plans in case a plan needs to do any special business before it runs.
237 
238     ThreadPlan *plan_ptr = GetCurrentPlan();
239     plan_ptr->WillResume(resume_state, true);
240 
241     while ((plan_ptr = GetPreviousPlan(plan_ptr)) != NULL)
242     {
243         plan_ptr->WillResume (resume_state, false);
244     }
245 
246     m_actual_stop_info_sp.reset();
247     return true;
248 }
249 
250 void
251 Thread::DidResume ()
252 {
253     SetResumeSignal (LLDB_INVALID_SIGNAL_NUMBER);
254 }
255 
256 bool
257 Thread::ShouldStop (Event* event_ptr)
258 {
259     ThreadPlan *current_plan = GetCurrentPlan();
260     bool should_stop = true;
261 
262     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_STEP));
263     if (log)
264     {
265         log->Printf ("^^^^^^^^ Thread::ShouldStop Begin ^^^^^^^^");
266         StreamString s;
267         s.IndentMore();
268         DumpThreadPlans(&s);
269         log->Printf ("Plan stack initial state:\n%s", s.GetData());
270     }
271 
272     // The top most plan always gets to do the trace log...
273     current_plan->DoTraceLog ();
274 
275     if (current_plan->PlanExplainsStop())
276     {
277         bool over_ride_stop = current_plan->ShouldAutoContinue(event_ptr);
278 
279         if (log)
280             log->Printf("Plan %s explains stop, auto-continue %i.", current_plan->GetName(), over_ride_stop);
281 
282         // We're starting from the base plan, so just let it decide;
283         if (PlanIsBasePlan(current_plan))
284         {
285             should_stop = current_plan->ShouldStop (event_ptr);
286             if (log)
287                 log->Printf("Base plan says should stop: %i.", should_stop);
288         }
289         else
290         {
291             // Otherwise, don't let the base plan override what the other plans say to do, since
292             // presumably if there were other plans they would know what to do...
293             while (1)
294             {
295                 if (PlanIsBasePlan(current_plan))
296                     break;
297 
298                 should_stop = current_plan->ShouldStop(event_ptr);
299                 if (log)
300                     log->Printf("Plan %s should stop: %d.", current_plan->GetName(), should_stop);
301                 if (current_plan->MischiefManaged())
302                 {
303                     if (should_stop)
304                         current_plan->WillStop();
305 
306                     // If a Master Plan wants to stop, and wants to stick on the stack, we let it.
307                     // Otherwise, see if the plan's parent wants to stop.
308 
309                     if (should_stop && current_plan->IsMasterPlan() && !current_plan->OkayToDiscard())
310                     {
311                         PopPlan();
312                         break;
313                     }
314                     else
315                     {
316 
317                         PopPlan();
318 
319                         current_plan = GetCurrentPlan();
320                         if (current_plan == NULL)
321                         {
322                             break;
323                         }
324                     }
325 
326                 }
327                 else
328                 {
329                     break;
330                 }
331             }
332         }
333         if (over_ride_stop)
334             should_stop = false;
335     }
336     else if (current_plan->TracerExplainsStop())
337     {
338         should_stop = false;
339     }
340     else
341     {
342         // If the current plan doesn't explain the stop, then, find one that
343         // does and let it handle the situation.
344         ThreadPlan *plan_ptr = current_plan;
345         while ((plan_ptr = GetPreviousPlan(plan_ptr)) != NULL)
346         {
347             if (plan_ptr->PlanExplainsStop())
348             {
349                 should_stop = plan_ptr->ShouldStop (event_ptr);
350                 break;
351             }
352 
353         }
354     }
355 
356     if (log)
357     {
358         StreamString s;
359         s.IndentMore();
360         DumpThreadPlans(&s);
361         log->Printf ("Plan stack final state:\n%s", s.GetData());
362         log->Printf ("vvvvvvvv Thread::ShouldStop End (returning %i) vvvvvvvv", should_stop);
363     }
364     return should_stop;
365 }
366 
367 Vote
368 Thread::ShouldReportStop (Event* event_ptr)
369 {
370     StateType thread_state = GetResumeState ();
371     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_STEP));
372 
373     if (thread_state == eStateSuspended || thread_state == eStateInvalid)
374     {
375         if (log)
376             log->Printf ("Thread::ShouldReportStop() tid = 0x%4.4llx: returning vote %i (state was suspended or invalid)\n", GetID(), eVoteNoOpinion);
377         return eVoteNoOpinion;
378     }
379 
380     if (m_completed_plan_stack.size() > 0)
381     {
382         // Don't use GetCompletedPlan here, since that suppresses private plans.
383         if (log)
384             log->Printf ("Thread::ShouldReportStop() tid = 0x%4.4llx: returning vote  for complete stack's back plan\n", GetID());
385         return m_completed_plan_stack.back()->ShouldReportStop (event_ptr);
386     }
387     else
388     {
389         if (log)
390             log->Printf ("Thread::ShouldReportStop() tid = 0x%4.4llx: returning vote  for current plan\n", GetID());
391         return GetCurrentPlan()->ShouldReportStop (event_ptr);
392     }
393 }
394 
395 Vote
396 Thread::ShouldReportRun (Event* event_ptr)
397 {
398     StateType thread_state = GetResumeState ();
399 
400     if (thread_state == eStateSuspended
401             || thread_state == eStateInvalid)
402     {
403         return eVoteNoOpinion;
404     }
405 
406     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_STEP));
407     if (m_completed_plan_stack.size() > 0)
408     {
409         // Don't use GetCompletedPlan here, since that suppresses private plans.
410         if (log)
411             log->Printf ("Current Plan for thread %d (0x%4.4llx): %s being asked whether we should report run.",
412                          GetIndexID(),
413                          GetID(),
414                          m_completed_plan_stack.back()->GetName());
415 
416         return m_completed_plan_stack.back()->ShouldReportRun (event_ptr);
417     }
418     else
419     {
420         if (log)
421             log->Printf ("Current Plan for thread %d (0x%4.4llx): %s being asked whether we should report run.",
422                          GetIndexID(),
423                          GetID(),
424                          GetCurrentPlan()->GetName());
425 
426         return GetCurrentPlan()->ShouldReportRun (event_ptr);
427      }
428 }
429 
430 bool
431 Thread::MatchesSpec (const ThreadSpec *spec)
432 {
433     if (spec == NULL)
434         return true;
435 
436     return spec->ThreadPassesBasicTests(this);
437 }
438 
439 void
440 Thread::PushPlan (ThreadPlanSP &thread_plan_sp)
441 {
442     if (thread_plan_sp)
443     {
444         // If the thread plan doesn't already have a tracer, give it its parent's tracer:
445         if (!thread_plan_sp->GetThreadPlanTracer())
446             thread_plan_sp->SetThreadPlanTracer(m_plan_stack.back()->GetThreadPlanTracer());
447         m_plan_stack.push_back (thread_plan_sp);
448 
449         thread_plan_sp->DidPush();
450 
451         LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_STEP));
452         if (log)
453         {
454             StreamString s;
455             thread_plan_sp->GetDescription (&s, lldb::eDescriptionLevelFull);
456             log->Printf("Pushing plan: \"%s\", tid = 0x%4.4llx.",
457                         s.GetData(),
458                         thread_plan_sp->GetThread().GetID());
459         }
460     }
461 }
462 
463 void
464 Thread::PopPlan ()
465 {
466     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_STEP));
467 
468     if (m_plan_stack.empty())
469         return;
470     else
471     {
472         ThreadPlanSP &plan = m_plan_stack.back();
473         if (log)
474         {
475             log->Printf("Popping plan: \"%s\", tid = 0x%4.4llx.", plan->GetName(), plan->GetThread().GetID());
476         }
477         m_completed_plan_stack.push_back (plan);
478         plan->WillPop();
479         m_plan_stack.pop_back();
480     }
481 }
482 
483 void
484 Thread::DiscardPlan ()
485 {
486     if (m_plan_stack.size() > 1)
487     {
488         ThreadPlanSP &plan = m_plan_stack.back();
489         m_discarded_plan_stack.push_back (plan);
490         plan->WillPop();
491         m_plan_stack.pop_back();
492     }
493 }
494 
495 ThreadPlan *
496 Thread::GetCurrentPlan ()
497 {
498     if (m_plan_stack.empty())
499         return NULL;
500     else
501         return m_plan_stack.back().get();
502 }
503 
504 ThreadPlanSP
505 Thread::GetCompletedPlan ()
506 {
507     ThreadPlanSP empty_plan_sp;
508     if (!m_completed_plan_stack.empty())
509     {
510         for (int i = m_completed_plan_stack.size() - 1; i >= 0; i--)
511         {
512             ThreadPlanSP completed_plan_sp;
513             completed_plan_sp = m_completed_plan_stack[i];
514             if (!completed_plan_sp->GetPrivate ())
515             return completed_plan_sp;
516         }
517     }
518     return empty_plan_sp;
519 }
520 
521 bool
522 Thread::IsThreadPlanDone (ThreadPlan *plan)
523 {
524     if (!m_completed_plan_stack.empty())
525     {
526         for (int i = m_completed_plan_stack.size() - 1; i >= 0; i--)
527         {
528             if (m_completed_plan_stack[i].get() == plan)
529                 return true;
530         }
531     }
532     return false;
533 }
534 
535 bool
536 Thread::WasThreadPlanDiscarded (ThreadPlan *plan)
537 {
538     if (!m_discarded_plan_stack.empty())
539     {
540         for (int i = m_discarded_plan_stack.size() - 1; i >= 0; i--)
541         {
542             if (m_discarded_plan_stack[i].get() == plan)
543                 return true;
544         }
545     }
546     return false;
547 }
548 
549 ThreadPlan *
550 Thread::GetPreviousPlan (ThreadPlan *current_plan)
551 {
552     if (current_plan == NULL)
553         return NULL;
554 
555     int stack_size = m_completed_plan_stack.size();
556     for (int i = stack_size - 1; i > 0; i--)
557     {
558         if (current_plan == m_completed_plan_stack[i].get())
559             return m_completed_plan_stack[i-1].get();
560     }
561 
562     if (stack_size > 0 && m_completed_plan_stack[0].get() == current_plan)
563     {
564         if (m_plan_stack.size() > 0)
565             return m_plan_stack.back().get();
566         else
567             return NULL;
568     }
569 
570     stack_size = m_plan_stack.size();
571     for (int i = stack_size - 1; i > 0; i--)
572     {
573         if (current_plan == m_plan_stack[i].get())
574             return m_plan_stack[i-1].get();
575     }
576     return NULL;
577 }
578 
579 void
580 Thread::QueueThreadPlan (ThreadPlanSP &thread_plan_sp, bool abort_other_plans)
581 {
582     if (abort_other_plans)
583        DiscardThreadPlans(true);
584 
585     PushPlan (thread_plan_sp);
586 }
587 
588 
589 void
590 Thread::EnableTracer (bool value, bool single_stepping)
591 {
592     int stack_size = m_plan_stack.size();
593     for (int i = 0; i < stack_size; i++)
594     {
595         if (m_plan_stack[i]->GetThreadPlanTracer())
596         {
597             m_plan_stack[i]->GetThreadPlanTracer()->EnableTracing(value);
598             m_plan_stack[i]->GetThreadPlanTracer()->EnableSingleStep(single_stepping);
599         }
600     }
601 }
602 
603 void
604 Thread::SetTracer (lldb::ThreadPlanTracerSP &tracer_sp)
605 {
606     int stack_size = m_plan_stack.size();
607     for (int i = 0; i < stack_size; i++)
608         m_plan_stack[i]->SetThreadPlanTracer(tracer_sp);
609 }
610 
611 void
612 Thread::DiscardThreadPlansUpToPlan (lldb::ThreadPlanSP &up_to_plan_sp)
613 {
614     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_STEP));
615     if (log)
616     {
617         log->Printf("Discarding thread plans for thread tid = 0x%4.4llx, up to %p", GetID(), up_to_plan_sp.get());
618     }
619 
620     int stack_size = m_plan_stack.size();
621 
622     // If the input plan is NULL, discard all plans.  Otherwise make sure this plan is in the
623     // stack, and if so discard up to and including it.
624 
625     if (up_to_plan_sp.get() == NULL)
626     {
627         for (int i = stack_size - 1; i > 0; i--)
628             DiscardPlan();
629     }
630     else
631     {
632         bool found_it = false;
633         for (int i = stack_size - 1; i > 0; i--)
634         {
635             if (m_plan_stack[i] == up_to_plan_sp)
636                 found_it = true;
637         }
638         if (found_it)
639         {
640             bool last_one = false;
641             for (int i = stack_size - 1; i > 0 && !last_one ; i--)
642             {
643                 if (GetCurrentPlan() == up_to_plan_sp.get())
644                     last_one = true;
645                 DiscardPlan();
646             }
647         }
648     }
649     return;
650 }
651 
652 void
653 Thread::DiscardThreadPlans(bool force)
654 {
655     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_STEP));
656     if (log)
657     {
658         log->Printf("Discarding thread plans for thread (tid = 0x%4.4llx, force %d)", GetID(), force);
659     }
660 
661     if (force)
662     {
663         int stack_size = m_plan_stack.size();
664         for (int i = stack_size - 1; i > 0; i--)
665         {
666             DiscardPlan();
667         }
668         return;
669     }
670 
671     while (1)
672     {
673 
674         int master_plan_idx;
675         bool discard;
676 
677         // Find the first master plan, see if it wants discarding, and if yes discard up to it.
678         for (master_plan_idx = m_plan_stack.size() - 1; master_plan_idx >= 0; master_plan_idx--)
679         {
680             if (m_plan_stack[master_plan_idx]->IsMasterPlan())
681             {
682                 discard = m_plan_stack[master_plan_idx]->OkayToDiscard();
683                 break;
684             }
685         }
686 
687         if (discard)
688         {
689             // First pop all the dependent plans:
690             for (int i = m_plan_stack.size() - 1; i > master_plan_idx; i--)
691             {
692 
693                 // FIXME: Do we need a finalize here, or is the rule that "PrepareForStop"
694                 // for the plan leaves it in a state that it is safe to pop the plan
695                 // with no more notice?
696                 DiscardPlan();
697             }
698 
699             // Now discard the master plan itself.
700             // The bottom-most plan never gets discarded.  "OkayToDiscard" for it means
701             // discard it's dependent plans, but not it...
702             if (master_plan_idx > 0)
703             {
704                 DiscardPlan();
705             }
706         }
707         else
708         {
709             // If the master plan doesn't want to get discarded, then we're done.
710             break;
711         }
712 
713     }
714 }
715 
716 ThreadPlan *
717 Thread::QueueFundamentalPlan (bool abort_other_plans)
718 {
719     ThreadPlanSP thread_plan_sp (new ThreadPlanBase(*this));
720     QueueThreadPlan (thread_plan_sp, abort_other_plans);
721     return thread_plan_sp.get();
722 }
723 
724 ThreadPlan *
725 Thread::QueueThreadPlanForStepSingleInstruction
726 (
727     bool step_over,
728     bool abort_other_plans,
729     bool stop_other_threads
730 )
731 {
732     ThreadPlanSP thread_plan_sp (new ThreadPlanStepInstruction (*this, step_over, stop_other_threads, eVoteNoOpinion, eVoteNoOpinion));
733     QueueThreadPlan (thread_plan_sp, abort_other_plans);
734     return thread_plan_sp.get();
735 }
736 
737 ThreadPlan *
738 Thread::QueueThreadPlanForStepRange
739 (
740     bool abort_other_plans,
741     StepType type,
742     const AddressRange &range,
743     const SymbolContext &addr_context,
744     lldb::RunMode stop_other_threads,
745     bool avoid_code_without_debug_info
746 )
747 {
748     ThreadPlanSP thread_plan_sp;
749     if (type == eStepTypeInto)
750     {
751         ThreadPlanStepInRange *plan = new ThreadPlanStepInRange (*this, range, addr_context, stop_other_threads);
752         if (avoid_code_without_debug_info)
753             plan->GetFlags().Set (ThreadPlanShouldStopHere::eAvoidNoDebug);
754         else
755             plan->GetFlags().Clear (ThreadPlanShouldStopHere::eAvoidNoDebug);
756         thread_plan_sp.reset (plan);
757     }
758     else
759         thread_plan_sp.reset (new ThreadPlanStepOverRange (*this, range, addr_context, stop_other_threads));
760 
761     QueueThreadPlan (thread_plan_sp, abort_other_plans);
762     return thread_plan_sp.get();
763 }
764 
765 
766 ThreadPlan *
767 Thread::QueueThreadPlanForStepOverBreakpointPlan (bool abort_other_plans)
768 {
769     ThreadPlanSP thread_plan_sp (new ThreadPlanStepOverBreakpoint (*this));
770     QueueThreadPlan (thread_plan_sp, abort_other_plans);
771     return thread_plan_sp.get();
772 }
773 
774 ThreadPlan *
775 Thread::QueueThreadPlanForStepOut
776 (
777     bool abort_other_plans,
778     SymbolContext *addr_context,
779     bool first_insn,
780     bool stop_other_threads,
781     Vote stop_vote,
782     Vote run_vote,
783     uint32_t frame_idx
784 )
785 {
786     ThreadPlanSP thread_plan_sp (new ThreadPlanStepOut (*this,
787                                                         addr_context,
788                                                         first_insn,
789                                                         stop_other_threads,
790                                                         stop_vote,
791                                                         run_vote,
792                                                         frame_idx));
793     QueueThreadPlan (thread_plan_sp, abort_other_plans);
794     return thread_plan_sp.get();
795 }
796 
797 ThreadPlan *
798 Thread::QueueThreadPlanForStepThrough (bool abort_other_plans, bool stop_other_threads)
799 {
800     // Try the dynamic loader first:
801     ThreadPlanSP thread_plan_sp(GetProcess().GetDynamicLoader()->GetStepThroughTrampolinePlan (*this, stop_other_threads));
802     // If that didn't come up with anything, try the ObjC runtime plugin:
803     if (thread_plan_sp.get() == NULL)
804     {
805         ObjCLanguageRuntime *objc_runtime = GetProcess().GetObjCLanguageRuntime();
806         if (objc_runtime)
807             thread_plan_sp = objc_runtime->GetStepThroughTrampolinePlan (*this, stop_other_threads);
808     }
809 
810     if (thread_plan_sp.get() == NULL)
811     {
812         thread_plan_sp.reset(new ThreadPlanStepThrough (*this, stop_other_threads));
813         if (thread_plan_sp && !thread_plan_sp->ValidatePlan (NULL))
814             return NULL;
815     }
816     QueueThreadPlan (thread_plan_sp, abort_other_plans);
817     return thread_plan_sp.get();
818 }
819 
820 ThreadPlan *
821 Thread::QueueThreadPlanForCallFunction (bool abort_other_plans,
822                                         Address& function,
823                                         lldb::addr_t arg,
824                                         bool stop_other_threads,
825                                         bool discard_on_error)
826 {
827     ThreadPlanSP thread_plan_sp (new ThreadPlanCallFunction (*this, function, arg, stop_other_threads, discard_on_error));
828     QueueThreadPlan (thread_plan_sp, abort_other_plans);
829     return thread_plan_sp.get();
830 }
831 
832 ThreadPlan *
833 Thread::QueueThreadPlanForRunToAddress (bool abort_other_plans,
834                                         Address &target_addr,
835                                         bool stop_other_threads)
836 {
837     ThreadPlanSP thread_plan_sp (new ThreadPlanRunToAddress (*this, target_addr, stop_other_threads));
838     QueueThreadPlan (thread_plan_sp, abort_other_plans);
839     return thread_plan_sp.get();
840 }
841 
842 ThreadPlan *
843 Thread::QueueThreadPlanForStepUntil (bool abort_other_plans,
844                                      lldb::addr_t *address_list,
845                                      size_t num_addresses,
846                                      bool stop_other_threads,
847                                      uint32_t frame_idx)
848 {
849     ThreadPlanSP thread_plan_sp (new ThreadPlanStepUntil (*this, address_list, num_addresses, stop_other_threads, frame_idx));
850     QueueThreadPlan (thread_plan_sp, abort_other_plans);
851     return thread_plan_sp.get();
852 
853 }
854 
855 uint32_t
856 Thread::GetIndexID () const
857 {
858     return m_index_id;
859 }
860 
861 void
862 Thread::DumpThreadPlans (lldb_private::Stream *s) const
863 {
864     uint32_t stack_size = m_plan_stack.size();
865     int i;
866     s->Indent();
867     s->Printf ("Plan Stack for thread #%u: tid = 0x%4.4llx, stack_size = %d\n", GetIndexID(), GetID(), stack_size);
868     for (i = stack_size - 1; i >= 0; i--)
869     {
870         s->IndentMore();
871         s->Indent();
872         s->Printf ("Element %d: ", i);
873         m_plan_stack[i]->GetDescription (s, eDescriptionLevelFull);
874         s->EOL();
875         s->IndentLess();
876     }
877 
878     stack_size = m_completed_plan_stack.size();
879     if (stack_size > 0)
880     {
881         s->Indent();
882         s->Printf ("Completed Plan Stack: %d elements.\n", stack_size);
883         for (i = stack_size - 1; i >= 0; i--)
884         {
885             s->IndentMore();
886             s->Indent();
887             s->Printf ("Element %d: ", i);
888             m_completed_plan_stack[i]->GetDescription (s, eDescriptionLevelFull);
889             s->EOL();
890             s->IndentLess();
891         }
892     }
893 
894     stack_size = m_discarded_plan_stack.size();
895     if (stack_size > 0)
896     {
897         s->Indent();
898         s->Printf ("Discarded Plan Stack: %d elements.\n", stack_size);
899         for (i = stack_size - 1; i >= 0; i--)
900         {
901             s->IndentMore();
902             s->Indent();
903             s->Printf ("Element %d: ", i);
904             m_discarded_plan_stack[i]->GetDescription (s, eDescriptionLevelFull);
905             s->EOL();
906             s->IndentLess();
907         }
908     }
909 
910 }
911 
912 Target *
913 Thread::CalculateTarget ()
914 {
915     return m_process.CalculateTarget();
916 }
917 
918 Process *
919 Thread::CalculateProcess ()
920 {
921     return &m_process;
922 }
923 
924 Thread *
925 Thread::CalculateThread ()
926 {
927     return this;
928 }
929 
930 StackFrame *
931 Thread::CalculateStackFrame ()
932 {
933     return NULL;
934 }
935 
936 void
937 Thread::CalculateExecutionContext (ExecutionContext &exe_ctx)
938 {
939     m_process.CalculateExecutionContext (exe_ctx);
940     exe_ctx.SetThreadPtr (this);
941     exe_ctx.SetFramePtr (NULL);
942 }
943 
944 
945 StackFrameList &
946 Thread::GetStackFrameList ()
947 {
948     if (!m_curr_frames_sp)
949         m_curr_frames_sp.reset (new StackFrameList (*this, m_prev_frames_sp, true));
950     return *m_curr_frames_sp;
951 }
952 
953 void
954 Thread::ClearStackFrames ()
955 {
956     if (m_curr_frames_sp && m_curr_frames_sp->GetNumFrames (false) > 1)
957         m_prev_frames_sp.swap (m_curr_frames_sp);
958     m_curr_frames_sp.reset();
959 }
960 
961 lldb::StackFrameSP
962 Thread::GetFrameWithConcreteFrameIndex (uint32_t unwind_idx)
963 {
964     return GetStackFrameList().GetFrameWithConcreteFrameIndex (unwind_idx);
965 }
966 
967 void
968 Thread::DumpUsingSettingsFormat (Stream &strm, uint32_t frame_idx)
969 {
970     ExecutionContext exe_ctx;
971     StackFrameSP frame_sp;
972     SymbolContext frame_sc;
973     CalculateExecutionContext (exe_ctx);
974 
975     if (frame_idx != LLDB_INVALID_INDEX32)
976     {
977         frame_sp = GetStackFrameAtIndex (frame_idx);
978         if (frame_sp)
979         {
980             exe_ctx.SetFrameSP(frame_sp);
981             frame_sc = frame_sp->GetSymbolContext(eSymbolContextEverything);
982         }
983     }
984 
985     const char *thread_format = GetProcess().GetTarget().GetDebugger().GetThreadFormat();
986     assert (thread_format);
987     const char *end = NULL;
988     Debugger::FormatPrompt (thread_format,
989                             frame_sp ? &frame_sc : NULL,
990                             &exe_ctx,
991                             NULL,
992                             strm,
993                             &end);
994 }
995 
996 lldb::ThreadSP
997 Thread::GetSP ()
998 {
999     // This object contains an instrusive ref count base class so we can
1000     // easily make a shared pointer to this object
1001     return ThreadSP(this);
1002 }
1003 
1004 
1005 void
1006 Thread::SettingsInitialize ()
1007 {
1008     UserSettingsControllerSP &usc = GetSettingsController();
1009     usc.reset (new SettingsController);
1010     UserSettingsController::InitializeSettingsController (usc,
1011                                                           SettingsController::global_settings_table,
1012                                                           SettingsController::instance_settings_table);
1013 
1014     // Now call SettingsInitialize() on each 'child' setting of Thread.
1015     // Currently there are none.
1016 }
1017 
1018 void
1019 Thread::SettingsTerminate ()
1020 {
1021     // Must call SettingsTerminate() on each 'child' setting of Thread before terminating Thread settings.
1022     // Currently there are none.
1023 
1024     // Now terminate Thread Settings.
1025 
1026     UserSettingsControllerSP &usc = GetSettingsController();
1027     UserSettingsController::FinalizeSettingsController (usc);
1028     usc.reset();
1029 }
1030 
1031 UserSettingsControllerSP &
1032 Thread::GetSettingsController ()
1033 {
1034     static UserSettingsControllerSP g_settings_controller;
1035     return g_settings_controller;
1036 }
1037 
1038 void
1039 Thread::UpdateInstanceName ()
1040 {
1041     StreamString sstr;
1042     const char *name = GetName();
1043 
1044     if (name && name[0] != '\0')
1045         sstr.Printf ("%s", name);
1046     else if ((GetIndexID() != 0) || (GetID() != 0))
1047         sstr.Printf ("0x%4.4x", GetIndexID());
1048 
1049     if (sstr.GetSize() > 0)
1050 	Thread::GetSettingsController()->RenameInstanceSettings (GetInstanceName().AsCString(), sstr.GetData());
1051 }
1052 
1053 lldb::StackFrameSP
1054 Thread::GetStackFrameSPForStackFramePtr (StackFrame *stack_frame_ptr)
1055 {
1056     return GetStackFrameList().GetStackFrameSPForStackFramePtr (stack_frame_ptr);
1057 }
1058 
1059 const char *
1060 Thread::StopReasonAsCString (lldb::StopReason reason)
1061 {
1062     switch (reason)
1063     {
1064     case eStopReasonInvalid:      return "invalid";
1065     case eStopReasonNone:         return "none";
1066     case eStopReasonTrace:        return "trace";
1067     case eStopReasonBreakpoint:   return "breakpoint";
1068     case eStopReasonWatchpoint:   return "watchpoint";
1069     case eStopReasonSignal:       return "signal";
1070     case eStopReasonException:    return "exception";
1071     case eStopReasonPlanComplete: return "plan complete";
1072     }
1073 
1074 
1075     static char unknown_state_string[64];
1076     snprintf(unknown_state_string, sizeof (unknown_state_string), "StopReason = %i", reason);
1077     return unknown_state_string;
1078 }
1079 
1080 const char *
1081 Thread::RunModeAsCString (lldb::RunMode mode)
1082 {
1083     switch (mode)
1084     {
1085     case eOnlyThisThread:     return "only this thread";
1086     case eAllThreads:         return "all threads";
1087     case eOnlyDuringStepping: return "only during stepping";
1088     }
1089 
1090     static char unknown_state_string[64];
1091     snprintf(unknown_state_string, sizeof (unknown_state_string), "RunMode = %i", mode);
1092     return unknown_state_string;
1093 }
1094 
1095 size_t
1096 Thread::GetStatus (Stream &strm, uint32_t start_frame, uint32_t num_frames, uint32_t num_frames_with_source)
1097 {
1098     size_t num_frames_shown = 0;
1099     strm.Indent();
1100     strm.Printf("%c ", GetProcess().GetThreadList().GetSelectedThread().get() == this ? '*' : ' ');
1101     if (GetProcess().GetTarget().GetDebugger().GetUseExternalEditor())
1102     {
1103         StackFrameSP frame_sp = GetStackFrameAtIndex(start_frame);
1104         if (frame_sp)
1105         {
1106             SymbolContext frame_sc(frame_sp->GetSymbolContext (eSymbolContextLineEntry));
1107             if (frame_sc.line_entry.line != 0 && frame_sc.line_entry.file)
1108             {
1109                 Host::OpenFileInExternalEditor (frame_sc.line_entry.file, frame_sc.line_entry.line);
1110             }
1111         }
1112     }
1113 
1114     DumpUsingSettingsFormat (strm, start_frame);
1115 
1116     if (num_frames > 0)
1117     {
1118         strm.IndentMore();
1119 
1120         const bool show_frame_info = true;
1121         const uint32_t source_lines_before = 3;
1122         const uint32_t source_lines_after = 3;
1123         strm.IndentMore ();
1124         num_frames_shown = GetStackFrameList ().GetStatus (strm,
1125                                                            start_frame,
1126                                                            num_frames,
1127                                                            show_frame_info,
1128                                                            num_frames_with_source,
1129                                                            source_lines_before,
1130                                                            source_lines_after);
1131         strm.IndentLess();
1132         strm.IndentLess();
1133     }
1134     return num_frames_shown;
1135 }
1136 
1137 size_t
1138 Thread::GetStackFrameStatus (Stream& strm,
1139                              uint32_t first_frame,
1140                              uint32_t num_frames,
1141                              bool show_frame_info,
1142                              uint32_t num_frames_with_source,
1143                              uint32_t source_lines_before,
1144                              uint32_t source_lines_after)
1145 {
1146     return GetStackFrameList().GetStatus (strm,
1147                                           first_frame,
1148                                           num_frames,
1149                                           show_frame_info,
1150                                           num_frames_with_source,
1151                                           source_lines_before,
1152                                           source_lines_after);
1153 }
1154 
1155 bool
1156 Thread::SaveFrameZeroState (RegisterCheckpoint &checkpoint)
1157 {
1158     lldb::StackFrameSP frame_sp(GetStackFrameAtIndex (0));
1159     if (frame_sp)
1160     {
1161         checkpoint.SetStackID(frame_sp->GetStackID());
1162         return frame_sp->GetRegisterContext()->ReadAllRegisterValues (checkpoint.GetData());
1163     }
1164     return false;
1165 }
1166 
1167 bool
1168 Thread::RestoreSaveFrameZero (const RegisterCheckpoint &checkpoint)
1169 {
1170     lldb::StackFrameSP frame_sp(GetStackFrameAtIndex (0));
1171     if (frame_sp)
1172     {
1173         bool ret = frame_sp->GetRegisterContext()->WriteAllRegisterValues (checkpoint.GetData());
1174 
1175         // Clear out all stack frames as our world just changed.
1176         ClearStackFrames();
1177         frame_sp->GetRegisterContext()->InvalidateIfNeeded(true);
1178 
1179         return ret;
1180     }
1181     return false;
1182 }
1183 
1184 Unwind *
1185 Thread::GetUnwinder ()
1186 {
1187     if (m_unwinder_ap.get() == NULL)
1188     {
1189         const ArchSpec target_arch (GetProcess().GetTarget().GetArchitecture ());
1190         const llvm::Triple::ArchType machine = target_arch.GetMachine();
1191         switch (machine)
1192         {
1193             case llvm::Triple::x86_64:
1194             case llvm::Triple::x86:
1195             case llvm::Triple::arm:
1196             case llvm::Triple::thumb:
1197                 m_unwinder_ap.reset (new UnwindLLDB (*this));
1198                 break;
1199 
1200             default:
1201                 if (target_arch.GetTriple().getVendor() == llvm::Triple::Apple)
1202                     m_unwinder_ap.reset (new UnwindMacOSXFrameBackchain (*this));
1203                 break;
1204         }
1205     }
1206     return m_unwinder_ap.get();
1207 }
1208 
1209 
1210 #pragma mark "Thread::SettingsController"
1211 //--------------------------------------------------------------
1212 // class Thread::SettingsController
1213 //--------------------------------------------------------------
1214 
1215 Thread::SettingsController::SettingsController () :
1216     UserSettingsController ("thread", Process::GetSettingsController())
1217 {
1218     m_default_settings.reset (new ThreadInstanceSettings (*this, false,
1219                                                           InstanceSettings::GetDefaultName().AsCString()));
1220 }
1221 
1222 Thread::SettingsController::~SettingsController ()
1223 {
1224 }
1225 
1226 lldb::InstanceSettingsSP
1227 Thread::SettingsController::CreateInstanceSettings (const char *instance_name)
1228 {
1229     ThreadInstanceSettings *new_settings = new ThreadInstanceSettings (*GetSettingsController(),
1230                                                                        false,
1231                                                                        instance_name);
1232     lldb::InstanceSettingsSP new_settings_sp (new_settings);
1233     return new_settings_sp;
1234 }
1235 
1236 #pragma mark "ThreadInstanceSettings"
1237 //--------------------------------------------------------------
1238 // class ThreadInstanceSettings
1239 //--------------------------------------------------------------
1240 
1241 ThreadInstanceSettings::ThreadInstanceSettings (UserSettingsController &owner, bool live_instance, const char *name) :
1242     InstanceSettings (owner, name ? name : InstanceSettings::InvalidName().AsCString(), live_instance),
1243     m_avoid_regexp_ap (),
1244     m_trace_enabled (false)
1245 {
1246     // CopyInstanceSettings is a pure virtual function in InstanceSettings; it therefore cannot be called
1247     // until the vtables for ThreadInstanceSettings are properly set up, i.e. AFTER all the initializers.
1248     // For this reason it has to be called here, rather than in the initializer or in the parent constructor.
1249     // This is true for CreateInstanceName() too.
1250 
1251     if (GetInstanceName() == InstanceSettings::InvalidName())
1252     {
1253         ChangeInstanceName (std::string (CreateInstanceName().AsCString()));
1254         m_owner.RegisterInstanceSettings (this);
1255     }
1256 
1257     if (live_instance)
1258     {
1259         const lldb::InstanceSettingsSP &pending_settings = m_owner.FindPendingSettings (m_instance_name);
1260         CopyInstanceSettings (pending_settings,false);
1261         //m_owner.RemovePendingSettings (m_instance_name);
1262     }
1263 }
1264 
1265 ThreadInstanceSettings::ThreadInstanceSettings (const ThreadInstanceSettings &rhs) :
1266     InstanceSettings (*Thread::GetSettingsController(), CreateInstanceName().AsCString()),
1267     m_avoid_regexp_ap (),
1268     m_trace_enabled (rhs.m_trace_enabled)
1269 {
1270     if (m_instance_name != InstanceSettings::GetDefaultName())
1271     {
1272         const lldb::InstanceSettingsSP &pending_settings = m_owner.FindPendingSettings (m_instance_name);
1273         CopyInstanceSettings (pending_settings,false);
1274         m_owner.RemovePendingSettings (m_instance_name);
1275     }
1276     if (rhs.m_avoid_regexp_ap.get() != NULL)
1277         m_avoid_regexp_ap.reset(new RegularExpression(rhs.m_avoid_regexp_ap->GetText()));
1278 }
1279 
1280 ThreadInstanceSettings::~ThreadInstanceSettings ()
1281 {
1282 }
1283 
1284 ThreadInstanceSettings&
1285 ThreadInstanceSettings::operator= (const ThreadInstanceSettings &rhs)
1286 {
1287     if (this != &rhs)
1288     {
1289         if (rhs.m_avoid_regexp_ap.get() != NULL)
1290             m_avoid_regexp_ap.reset(new RegularExpression(rhs.m_avoid_regexp_ap->GetText()));
1291         else
1292             m_avoid_regexp_ap.reset(NULL);
1293     }
1294     m_trace_enabled = rhs.m_trace_enabled;
1295     return *this;
1296 }
1297 
1298 
1299 void
1300 ThreadInstanceSettings::UpdateInstanceSettingsVariable (const ConstString &var_name,
1301                                                          const char *index_value,
1302                                                          const char *value,
1303                                                          const ConstString &instance_name,
1304                                                          const SettingEntry &entry,
1305                                                          VarSetOperationType op,
1306                                                          Error &err,
1307                                                          bool pending)
1308 {
1309     if (var_name == StepAvoidRegexpVarName())
1310     {
1311         std::string regexp_text;
1312         if (m_avoid_regexp_ap.get() != NULL)
1313             regexp_text.append (m_avoid_regexp_ap->GetText());
1314         UserSettingsController::UpdateStringVariable (op, regexp_text, value, err);
1315         if (regexp_text.empty())
1316             m_avoid_regexp_ap.reset();
1317         else
1318         {
1319             m_avoid_regexp_ap.reset(new RegularExpression(regexp_text.c_str()));
1320 
1321         }
1322     }
1323     else if (var_name == GetTraceThreadVarName())
1324     {
1325         bool success;
1326         bool result = Args::StringToBoolean(value, false, &success);
1327 
1328         if (success)
1329         {
1330             m_trace_enabled = result;
1331             if (!pending)
1332             {
1333                 Thread *myself = static_cast<Thread *> (this);
1334                 myself->EnableTracer(m_trace_enabled, true);
1335             }
1336         }
1337         else
1338         {
1339             err.SetErrorStringWithFormat ("Bad value \"%s\" for trace-thread, should be Boolean.", value);
1340         }
1341 
1342     }
1343 }
1344 
1345 void
1346 ThreadInstanceSettings::CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings,
1347                                                bool pending)
1348 {
1349     if (new_settings.get() == NULL)
1350         return;
1351 
1352     ThreadInstanceSettings *new_process_settings = (ThreadInstanceSettings *) new_settings.get();
1353     if (new_process_settings->GetSymbolsToAvoidRegexp() != NULL)
1354         m_avoid_regexp_ap.reset (new RegularExpression (new_process_settings->GetSymbolsToAvoidRegexp()->GetText()));
1355     else
1356         m_avoid_regexp_ap.reset ();
1357 }
1358 
1359 bool
1360 ThreadInstanceSettings::GetInstanceSettingsValue (const SettingEntry &entry,
1361                                                   const ConstString &var_name,
1362                                                   StringList &value,
1363                                                   Error *err)
1364 {
1365     if (var_name == StepAvoidRegexpVarName())
1366     {
1367         if (m_avoid_regexp_ap.get() != NULL)
1368         {
1369             std::string regexp_text("\"");
1370             regexp_text.append(m_avoid_regexp_ap->GetText());
1371             regexp_text.append ("\"");
1372             value.AppendString (regexp_text.c_str());
1373         }
1374 
1375     }
1376     else if (var_name == GetTraceThreadVarName())
1377     {
1378         value.AppendString(m_trace_enabled ? "true" : "false");
1379     }
1380     else
1381     {
1382         if (err)
1383             err->SetErrorStringWithFormat ("unrecognized variable name '%s'", var_name.AsCString());
1384         return false;
1385     }
1386     return true;
1387 }
1388 
1389 const ConstString
1390 ThreadInstanceSettings::CreateInstanceName ()
1391 {
1392     static int instance_count = 1;
1393     StreamString sstr;
1394 
1395     sstr.Printf ("thread_%d", instance_count);
1396     ++instance_count;
1397 
1398     const ConstString ret_val (sstr.GetData());
1399     return ret_val;
1400 }
1401 
1402 const ConstString &
1403 ThreadInstanceSettings::StepAvoidRegexpVarName ()
1404 {
1405     static ConstString step_avoid_var_name ("step-avoid-regexp");
1406 
1407     return step_avoid_var_name;
1408 }
1409 
1410 const ConstString &
1411 ThreadInstanceSettings::GetTraceThreadVarName ()
1412 {
1413     static ConstString trace_thread_var_name ("trace-thread");
1414 
1415     return trace_thread_var_name;
1416 }
1417 
1418 //--------------------------------------------------
1419 // SettingsController Variable Tables
1420 //--------------------------------------------------
1421 
1422 SettingEntry
1423 Thread::SettingsController::global_settings_table[] =
1424 {
1425   //{ "var-name",    var-type  ,        "default", enum-table, init'd, hidden, "help-text"},
1426     {  NULL, eSetVarTypeNone, NULL, NULL, 0, 0, NULL }
1427 };
1428 
1429 
1430 SettingEntry
1431 Thread::SettingsController::instance_settings_table[] =
1432 {
1433   //{ "var-name",    var-type,              "default",      enum-table, init'd, hidden, "help-text"},
1434     { "step-avoid-regexp",  eSetVarTypeString,      "",  NULL,       false,  false,  "A regular expression defining functions step-in won't stop in." },
1435     { "trace-thread",  eSetVarTypeBoolean,      "false",  NULL,       false,  false,  "If true, this thread will single-step and log execution." },
1436     {  NULL, eSetVarTypeNone, NULL, NULL, 0, 0, NULL }
1437 };
1438