1 //===-- Target.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/Target/Target.h"
11 
12 // C Includes
13 // C++ Includes
14 // Other libraries and framework includes
15 // Project includes
16 #include "lldb/Breakpoint/BreakpointResolver.h"
17 #include "lldb/Breakpoint/BreakpointResolverAddress.h"
18 #include "lldb/Breakpoint/BreakpointResolverFileLine.h"
19 #include "lldb/Breakpoint/BreakpointResolverFileRegex.h"
20 #include "lldb/Breakpoint/BreakpointResolverName.h"
21 #include "lldb/Breakpoint/Watchpoint.h"
22 #include "lldb/Core/Debugger.h"
23 #include "lldb/Core/Event.h"
24 #include "lldb/Core/Log.h"
25 #include "lldb/Core/StreamString.h"
26 #include "lldb/Core/Timer.h"
27 #include "lldb/Core/ValueObject.h"
28 #include "lldb/Expression/ClangASTSource.h"
29 #include "lldb/Expression/ClangUserExpression.h"
30 #include "lldb/Host/Host.h"
31 #include "lldb/Interpreter/CommandInterpreter.h"
32 #include "lldb/Interpreter/CommandReturnObject.h"
33 #include "lldb/lldb-private-log.h"
34 #include "lldb/Symbol/ObjectFile.h"
35 #include "lldb/Target/Process.h"
36 #include "lldb/Target/StackFrame.h"
37 #include "lldb/Target/Thread.h"
38 #include "lldb/Target/ThreadSpec.h"
39 
40 using namespace lldb;
41 using namespace lldb_private;
42 
43 ConstString &
44 Target::GetStaticBroadcasterClass ()
45 {
46     static ConstString class_name ("lldb.target");
47     return class_name;
48 }
49 
50 //----------------------------------------------------------------------
51 // Target constructor
52 //----------------------------------------------------------------------
53 Target::Target(Debugger &debugger, const ArchSpec &target_arch, const lldb::PlatformSP &platform_sp) :
54     Broadcaster (&debugger, "lldb.target"),
55     ExecutionContextScope (),
56     TargetInstanceSettings (GetSettingsController()),
57     m_debugger (debugger),
58     m_platform_sp (platform_sp),
59     m_mutex (Mutex::eMutexTypeRecursive),
60     m_arch (target_arch),
61     m_images (),
62     m_section_load_list (),
63     m_breakpoint_list (false),
64     m_internal_breakpoint_list (true),
65     m_watchpoint_list (),
66     m_process_sp (),
67     m_search_filter_sp (),
68     m_image_search_paths (ImageSearchPathsChanged, this),
69     m_scratch_ast_context_ap (NULL),
70     m_scratch_ast_source_ap (NULL),
71     m_ast_importer_ap (NULL),
72     m_persistent_variables (),
73     m_source_manager(*this),
74     m_stop_hooks (),
75     m_stop_hook_next_id (0),
76     m_suppress_stop_hooks (false),
77     m_suppress_synthetic_value(false)
78 {
79     SetEventName (eBroadcastBitBreakpointChanged, "breakpoint-changed");
80     SetEventName (eBroadcastBitModulesLoaded, "modules-loaded");
81     SetEventName (eBroadcastBitModulesUnloaded, "modules-unloaded");
82 
83     CheckInWithManager();
84 
85     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_OBJECT));
86     if (log)
87         log->Printf ("%p Target::Target()", this);
88 }
89 
90 //----------------------------------------------------------------------
91 // Destructor
92 //----------------------------------------------------------------------
93 Target::~Target()
94 {
95     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_OBJECT));
96     if (log)
97         log->Printf ("%p Target::~Target()", this);
98     DeleteCurrentProcess ();
99 }
100 
101 void
102 Target::Dump (Stream *s, lldb::DescriptionLevel description_level)
103 {
104 //    s->Printf("%.*p: ", (int)sizeof(void*) * 2, this);
105     if (description_level != lldb::eDescriptionLevelBrief)
106     {
107         s->Indent();
108         s->PutCString("Target\n");
109         s->IndentMore();
110             m_images.Dump(s);
111             m_breakpoint_list.Dump(s);
112             m_internal_breakpoint_list.Dump(s);
113         s->IndentLess();
114     }
115     else
116     {
117         Module *exe_module = GetExecutableModulePointer();
118         if (exe_module)
119             s->PutCString (exe_module->GetFileSpec().GetFilename().GetCString());
120         else
121             s->PutCString ("No executable module.");
122     }
123 }
124 
125 void
126 Target::DeleteCurrentProcess ()
127 {
128     if (m_process_sp.get())
129     {
130         m_section_load_list.Clear();
131         if (m_process_sp->IsAlive())
132             m_process_sp->Destroy();
133 
134         m_process_sp->Finalize();
135 
136         // Do any cleanup of the target we need to do between process instances.
137         // NB It is better to do this before destroying the process in case the
138         // clean up needs some help from the process.
139         m_breakpoint_list.ClearAllBreakpointSites();
140         m_internal_breakpoint_list.ClearAllBreakpointSites();
141         // Disable watchpoints just on the debugger side.
142         Mutex::Locker locker;
143         this->GetWatchpointList().GetListMutex(locker);
144         DisableAllWatchpoints(false);
145         ClearAllWatchpointHitCounts();
146         m_process_sp.reset();
147     }
148 }
149 
150 const lldb::ProcessSP &
151 Target::CreateProcess (Listener &listener, const char *plugin_name, const FileSpec *crash_file)
152 {
153     DeleteCurrentProcess ();
154     m_process_sp = Process::FindPlugin(*this, plugin_name, listener, crash_file);
155     return m_process_sp;
156 }
157 
158 const lldb::ProcessSP &
159 Target::GetProcessSP () const
160 {
161     return m_process_sp;
162 }
163 
164 void
165 Target::Destroy()
166 {
167     Mutex::Locker locker (m_mutex);
168     DeleteCurrentProcess ();
169     m_platform_sp.reset();
170     m_arch.Clear();
171     m_images.Clear();
172     m_section_load_list.Clear();
173     const bool notify = false;
174     m_breakpoint_list.RemoveAll(notify);
175     m_internal_breakpoint_list.RemoveAll(notify);
176     m_last_created_breakpoint.reset();
177     m_last_created_watchpoint.reset();
178     m_search_filter_sp.reset();
179     m_image_search_paths.Clear(notify);
180     m_scratch_ast_context_ap.reset();
181     m_scratch_ast_source_ap.reset();
182     m_ast_importer_ap.reset();
183     m_persistent_variables.Clear();
184     m_stop_hooks.clear();
185     m_stop_hook_next_id = 0;
186     m_suppress_stop_hooks = false;
187     m_suppress_synthetic_value = false;
188 }
189 
190 
191 BreakpointList &
192 Target::GetBreakpointList(bool internal)
193 {
194     if (internal)
195         return m_internal_breakpoint_list;
196     else
197         return m_breakpoint_list;
198 }
199 
200 const BreakpointList &
201 Target::GetBreakpointList(bool internal) const
202 {
203     if (internal)
204         return m_internal_breakpoint_list;
205     else
206         return m_breakpoint_list;
207 }
208 
209 BreakpointSP
210 Target::GetBreakpointByID (break_id_t break_id)
211 {
212     BreakpointSP bp_sp;
213 
214     if (LLDB_BREAK_ID_IS_INTERNAL (break_id))
215         bp_sp = m_internal_breakpoint_list.FindBreakpointByID (break_id);
216     else
217         bp_sp = m_breakpoint_list.FindBreakpointByID (break_id);
218 
219     return bp_sp;
220 }
221 
222 BreakpointSP
223 Target::CreateSourceRegexBreakpoint (const FileSpecList *containingModules,
224                   const FileSpecList *source_file_spec_list,
225                   RegularExpression &source_regex,
226                   bool internal)
227 {
228     SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList (containingModules, source_file_spec_list));
229     BreakpointResolverSP resolver_sp(new BreakpointResolverFileRegex (NULL, source_regex));
230     return CreateBreakpoint (filter_sp, resolver_sp, internal);
231 }
232 
233 
234 BreakpointSP
235 Target::CreateBreakpoint (const FileSpecList *containingModules, const FileSpec &file, uint32_t line_no, bool check_inlines, bool internal)
236 {
237     SearchFilterSP filter_sp(GetSearchFilterForModuleList (containingModules));
238     BreakpointResolverSP resolver_sp(new BreakpointResolverFileLine (NULL, file, line_no, check_inlines));
239     return CreateBreakpoint (filter_sp, resolver_sp, internal);
240 }
241 
242 
243 BreakpointSP
244 Target::CreateBreakpoint (lldb::addr_t addr, bool internal)
245 {
246     Address so_addr;
247     // Attempt to resolve our load address if possible, though it is ok if
248     // it doesn't resolve to section/offset.
249 
250     // Try and resolve as a load address if possible
251     m_section_load_list.ResolveLoadAddress(addr, so_addr);
252     if (!so_addr.IsValid())
253     {
254         // The address didn't resolve, so just set this as an absolute address
255         so_addr.SetOffset (addr);
256     }
257     BreakpointSP bp_sp (CreateBreakpoint(so_addr, internal));
258     return bp_sp;
259 }
260 
261 BreakpointSP
262 Target::CreateBreakpoint (Address &addr, bool internal)
263 {
264     SearchFilterSP filter_sp(new SearchFilterForNonModuleSpecificSearches (shared_from_this()));
265     BreakpointResolverSP resolver_sp (new BreakpointResolverAddress (NULL, addr));
266     return CreateBreakpoint (filter_sp, resolver_sp, internal);
267 }
268 
269 BreakpointSP
270 Target::CreateBreakpoint (const FileSpecList *containingModules,
271                           const FileSpecList *containingSourceFiles,
272                           const char *func_name,
273                           uint32_t func_name_type_mask,
274                           bool internal,
275                           LazyBool skip_prologue)
276 {
277     BreakpointSP bp_sp;
278     if (func_name)
279     {
280         SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList (containingModules, containingSourceFiles));
281 
282         BreakpointResolverSP resolver_sp (new BreakpointResolverName (NULL,
283                                                                       func_name,
284                                                                       func_name_type_mask,
285                                                                       Breakpoint::Exact,
286                                                                       skip_prologue == eLazyBoolCalculate ? GetSkipPrologue() : skip_prologue));
287         bp_sp = CreateBreakpoint (filter_sp, resolver_sp, internal);
288     }
289     return bp_sp;
290 }
291 
292 lldb::BreakpointSP
293 Target::CreateBreakpoint (const FileSpecList *containingModules,
294                   const FileSpecList *containingSourceFiles,
295                   std::vector<std::string> func_names,
296                   uint32_t func_name_type_mask,
297                   bool internal,
298                   LazyBool skip_prologue)
299 {
300     BreakpointSP bp_sp;
301     size_t num_names = func_names.size();
302     if (num_names > 0)
303     {
304         SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList (containingModules, containingSourceFiles));
305 
306         BreakpointResolverSP resolver_sp (new BreakpointResolverName (NULL,
307                                                                       func_names,
308                                                                       func_name_type_mask,
309                                                                       skip_prologue == eLazyBoolCalculate ? GetSkipPrologue() : skip_prologue));
310         bp_sp = CreateBreakpoint (filter_sp, resolver_sp, internal);
311     }
312     return bp_sp;
313 }
314 
315 BreakpointSP
316 Target::CreateBreakpoint (const FileSpecList *containingModules,
317                           const FileSpecList *containingSourceFiles,
318                           const char *func_names[],
319                           size_t num_names,
320                           uint32_t func_name_type_mask,
321                           bool internal,
322                           LazyBool skip_prologue)
323 {
324     BreakpointSP bp_sp;
325     if (num_names > 0)
326     {
327         SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList (containingModules, containingSourceFiles));
328 
329         BreakpointResolverSP resolver_sp (new BreakpointResolverName (NULL,
330                                                                       func_names,
331                                                                       num_names,
332                                                                       func_name_type_mask,
333                                                                       skip_prologue == eLazyBoolCalculate ? GetSkipPrologue() : skip_prologue));
334         bp_sp = CreateBreakpoint (filter_sp, resolver_sp, internal);
335     }
336     return bp_sp;
337 }
338 
339 SearchFilterSP
340 Target::GetSearchFilterForModule (const FileSpec *containingModule)
341 {
342     SearchFilterSP filter_sp;
343     if (containingModule != NULL)
344     {
345         // TODO: We should look into sharing module based search filters
346         // across many breakpoints like we do for the simple target based one
347         filter_sp.reset (new SearchFilterByModule (shared_from_this(), *containingModule));
348     }
349     else
350     {
351         if (m_search_filter_sp.get() == NULL)
352             m_search_filter_sp.reset (new SearchFilterForNonModuleSpecificSearches (shared_from_this()));
353         filter_sp = m_search_filter_sp;
354     }
355     return filter_sp;
356 }
357 
358 SearchFilterSP
359 Target::GetSearchFilterForModuleList (const FileSpecList *containingModules)
360 {
361     SearchFilterSP filter_sp;
362     if (containingModules && containingModules->GetSize() != 0)
363     {
364         // TODO: We should look into sharing module based search filters
365         // across many breakpoints like we do for the simple target based one
366         filter_sp.reset (new SearchFilterByModuleList (shared_from_this(), *containingModules));
367     }
368     else
369     {
370         if (m_search_filter_sp.get() == NULL)
371             m_search_filter_sp.reset (new SearchFilterForNonModuleSpecificSearches (shared_from_this()));
372         filter_sp = m_search_filter_sp;
373     }
374     return filter_sp;
375 }
376 
377 SearchFilterSP
378 Target::GetSearchFilterForModuleAndCUList (const FileSpecList *containingModules, const FileSpecList *containingSourceFiles)
379 {
380     if (containingSourceFiles == NULL || containingSourceFiles->GetSize() == 0)
381         return GetSearchFilterForModuleList(containingModules);
382 
383     SearchFilterSP filter_sp;
384     if (containingModules == NULL)
385     {
386         // We could make a special "CU List only SearchFilter".  Better yet was if these could be composable,
387         // but that will take a little reworking.
388 
389         filter_sp.reset (new SearchFilterByModuleListAndCU (shared_from_this(), FileSpecList(), *containingSourceFiles));
390     }
391     else
392     {
393         filter_sp.reset (new SearchFilterByModuleListAndCU (shared_from_this(), *containingModules, *containingSourceFiles));
394     }
395     return filter_sp;
396 }
397 
398 BreakpointSP
399 Target::CreateFuncRegexBreakpoint (const FileSpecList *containingModules,
400                           const FileSpecList *containingSourceFiles,
401                           RegularExpression &func_regex,
402                           bool internal,
403                           LazyBool skip_prologue)
404 {
405     SearchFilterSP filter_sp(GetSearchFilterForModuleAndCUList (containingModules, containingSourceFiles));
406     BreakpointResolverSP resolver_sp(new BreakpointResolverName (NULL,
407                                                                  func_regex,
408                                                                  skip_prologue == eLazyBoolCalculate ? GetSkipPrologue() : skip_prologue));
409 
410     return CreateBreakpoint (filter_sp, resolver_sp, internal);
411 }
412 
413 lldb::BreakpointSP
414 Target::CreateExceptionBreakpoint (enum lldb::LanguageType language, bool catch_bp, bool throw_bp, bool internal)
415 {
416     return LanguageRuntime::CreateExceptionBreakpoint (*this, language, catch_bp, throw_bp, internal);
417 }
418 
419 BreakpointSP
420 Target::CreateBreakpoint (SearchFilterSP &filter_sp, BreakpointResolverSP &resolver_sp, bool internal)
421 {
422     BreakpointSP bp_sp;
423     if (filter_sp && resolver_sp)
424     {
425         bp_sp.reset(new Breakpoint (*this, filter_sp, resolver_sp));
426         resolver_sp->SetBreakpoint (bp_sp.get());
427 
428         if (internal)
429             m_internal_breakpoint_list.Add (bp_sp, false);
430         else
431             m_breakpoint_list.Add (bp_sp, true);
432 
433         LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
434         if (log)
435         {
436             StreamString s;
437             bp_sp->GetDescription(&s, lldb::eDescriptionLevelVerbose);
438             log->Printf ("Target::%s (internal = %s) => break_id = %s\n", __FUNCTION__, internal ? "yes" : "no", s.GetData());
439         }
440 
441         bp_sp->ResolveBreakpoint();
442     }
443 
444     if (!internal && bp_sp)
445     {
446         m_last_created_breakpoint = bp_sp;
447     }
448 
449     return bp_sp;
450 }
451 
452 bool
453 Target::ProcessIsValid()
454 {
455     return (m_process_sp && m_process_sp->IsAlive());
456 }
457 
458 // See also Watchpoint::SetWatchpointType(uint32_t type) and
459 // the OptionGroupWatchpoint::WatchType enum type.
460 WatchpointSP
461 Target::CreateWatchpoint(lldb::addr_t addr, size_t size, uint32_t type)
462 {
463     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
464     if (log)
465         log->Printf("Target::%s (addr = 0x%8.8llx size = %zu type = %u)\n",
466                     __FUNCTION__, addr, size, type);
467 
468     WatchpointSP wp_sp;
469     if (!ProcessIsValid())
470         return wp_sp;
471     if (addr == LLDB_INVALID_ADDRESS || size == 0)
472         return wp_sp;
473 
474     // Currently we only support one watchpoint per address, with total number
475     // of watchpoints limited by the hardware which the inferior is running on.
476     WatchpointSP matched_sp = m_watchpoint_list.FindByAddress(addr);
477     if (matched_sp)
478     {
479         size_t old_size = matched_sp->GetByteSize();
480         uint32_t old_type =
481             (matched_sp->WatchpointRead() ? LLDB_WATCH_TYPE_READ : 0) |
482             (matched_sp->WatchpointWrite() ? LLDB_WATCH_TYPE_WRITE : 0);
483         // Return the existing watchpoint if both size and type match.
484         if (size == old_size && type == old_type) {
485             wp_sp = matched_sp;
486             wp_sp->SetEnabled(false);
487         } else {
488             // Nil the matched watchpoint; we will be creating a new one.
489             m_process_sp->DisableWatchpoint(matched_sp.get());
490             m_watchpoint_list.Remove(matched_sp->GetID());
491         }
492     }
493 
494     if (!wp_sp) {
495         Watchpoint *new_wp = new Watchpoint(addr, size);
496         if (!new_wp) {
497             printf("Watchpoint ctor failed, out of memory?\n");
498             return wp_sp;
499         }
500         new_wp->SetWatchpointType(type);
501         new_wp->SetTarget(this);
502         wp_sp.reset(new_wp);
503         m_watchpoint_list.Add(wp_sp);
504     }
505 
506     Error rc = m_process_sp->EnableWatchpoint(wp_sp.get());
507     if (log)
508             log->Printf("Target::%s (creation of watchpoint %s with id = %u)\n",
509                         __FUNCTION__,
510                         rc.Success() ? "succeeded" : "failed",
511                         wp_sp->GetID());
512 
513     if (rc.Fail()) {
514         // Enabling the watchpoint on the device side failed.
515         // Remove the said watchpoint from the list maintained by the target instance.
516         m_watchpoint_list.Remove(wp_sp->GetID());
517         wp_sp.reset();
518     }
519     else
520         m_last_created_watchpoint = wp_sp;
521     return wp_sp;
522 }
523 
524 void
525 Target::RemoveAllBreakpoints (bool internal_also)
526 {
527     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
528     if (log)
529         log->Printf ("Target::%s (internal_also = %s)\n", __FUNCTION__, internal_also ? "yes" : "no");
530 
531     m_breakpoint_list.RemoveAll (true);
532     if (internal_also)
533         m_internal_breakpoint_list.RemoveAll (false);
534 
535     m_last_created_breakpoint.reset();
536 }
537 
538 void
539 Target::DisableAllBreakpoints (bool internal_also)
540 {
541     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
542     if (log)
543         log->Printf ("Target::%s (internal_also = %s)\n", __FUNCTION__, internal_also ? "yes" : "no");
544 
545     m_breakpoint_list.SetEnabledAll (false);
546     if (internal_also)
547         m_internal_breakpoint_list.SetEnabledAll (false);
548 }
549 
550 void
551 Target::EnableAllBreakpoints (bool internal_also)
552 {
553     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
554     if (log)
555         log->Printf ("Target::%s (internal_also = %s)\n", __FUNCTION__, internal_also ? "yes" : "no");
556 
557     m_breakpoint_list.SetEnabledAll (true);
558     if (internal_also)
559         m_internal_breakpoint_list.SetEnabledAll (true);
560 }
561 
562 bool
563 Target::RemoveBreakpointByID (break_id_t break_id)
564 {
565     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
566     if (log)
567         log->Printf ("Target::%s (break_id = %i, internal = %s)\n", __FUNCTION__, break_id, LLDB_BREAK_ID_IS_INTERNAL (break_id) ? "yes" : "no");
568 
569     if (DisableBreakpointByID (break_id))
570     {
571         if (LLDB_BREAK_ID_IS_INTERNAL (break_id))
572             m_internal_breakpoint_list.Remove(break_id, false);
573         else
574         {
575             if (m_last_created_breakpoint)
576             {
577                 if (m_last_created_breakpoint->GetID() == break_id)
578                     m_last_created_breakpoint.reset();
579             }
580             m_breakpoint_list.Remove(break_id, true);
581         }
582         return true;
583     }
584     return false;
585 }
586 
587 bool
588 Target::DisableBreakpointByID (break_id_t break_id)
589 {
590     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
591     if (log)
592         log->Printf ("Target::%s (break_id = %i, internal = %s)\n", __FUNCTION__, break_id, LLDB_BREAK_ID_IS_INTERNAL (break_id) ? "yes" : "no");
593 
594     BreakpointSP bp_sp;
595 
596     if (LLDB_BREAK_ID_IS_INTERNAL (break_id))
597         bp_sp = m_internal_breakpoint_list.FindBreakpointByID (break_id);
598     else
599         bp_sp = m_breakpoint_list.FindBreakpointByID (break_id);
600     if (bp_sp)
601     {
602         bp_sp->SetEnabled (false);
603         return true;
604     }
605     return false;
606 }
607 
608 bool
609 Target::EnableBreakpointByID (break_id_t break_id)
610 {
611     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_BREAKPOINTS));
612     if (log)
613         log->Printf ("Target::%s (break_id = %i, internal = %s)\n",
614                      __FUNCTION__,
615                      break_id,
616                      LLDB_BREAK_ID_IS_INTERNAL (break_id) ? "yes" : "no");
617 
618     BreakpointSP bp_sp;
619 
620     if (LLDB_BREAK_ID_IS_INTERNAL (break_id))
621         bp_sp = m_internal_breakpoint_list.FindBreakpointByID (break_id);
622     else
623         bp_sp = m_breakpoint_list.FindBreakpointByID (break_id);
624 
625     if (bp_sp)
626     {
627         bp_sp->SetEnabled (true);
628         return true;
629     }
630     return false;
631 }
632 
633 // The flag 'end_to_end', default to true, signifies that the operation is
634 // performed end to end, for both the debugger and the debuggee.
635 
636 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end
637 // to end operations.
638 bool
639 Target::RemoveAllWatchpoints (bool end_to_end)
640 {
641     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
642     if (log)
643         log->Printf ("Target::%s\n", __FUNCTION__);
644 
645     if (!end_to_end) {
646         m_watchpoint_list.RemoveAll();
647         return true;
648     }
649 
650     // Otherwise, it's an end to end operation.
651 
652     if (!ProcessIsValid())
653         return false;
654 
655     size_t num_watchpoints = m_watchpoint_list.GetSize();
656     for (size_t i = 0; i < num_watchpoints; ++i)
657     {
658         WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
659         if (!wp_sp)
660             return false;
661 
662         Error rc = m_process_sp->DisableWatchpoint(wp_sp.get());
663         if (rc.Fail())
664             return false;
665     }
666     m_watchpoint_list.RemoveAll ();
667     return true; // Success!
668 }
669 
670 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end to
671 // end operations.
672 bool
673 Target::DisableAllWatchpoints (bool end_to_end)
674 {
675     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
676     if (log)
677         log->Printf ("Target::%s\n", __FUNCTION__);
678 
679     if (!end_to_end) {
680         m_watchpoint_list.SetEnabledAll(false);
681         return true;
682     }
683 
684     // Otherwise, it's an end to end operation.
685 
686     if (!ProcessIsValid())
687         return false;
688 
689     size_t num_watchpoints = m_watchpoint_list.GetSize();
690     for (size_t i = 0; i < num_watchpoints; ++i)
691     {
692         WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
693         if (!wp_sp)
694             return false;
695 
696         Error rc = m_process_sp->DisableWatchpoint(wp_sp.get());
697         if (rc.Fail())
698             return false;
699     }
700     return true; // Success!
701 }
702 
703 // Assumption: Caller holds the list mutex lock for m_watchpoint_list for end to
704 // end operations.
705 bool
706 Target::EnableAllWatchpoints (bool end_to_end)
707 {
708     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
709     if (log)
710         log->Printf ("Target::%s\n", __FUNCTION__);
711 
712     if (!end_to_end) {
713         m_watchpoint_list.SetEnabledAll(true);
714         return true;
715     }
716 
717     // Otherwise, it's an end to end operation.
718 
719     if (!ProcessIsValid())
720         return false;
721 
722     size_t num_watchpoints = m_watchpoint_list.GetSize();
723     for (size_t i = 0; i < num_watchpoints; ++i)
724     {
725         WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
726         if (!wp_sp)
727             return false;
728 
729         Error rc = m_process_sp->EnableWatchpoint(wp_sp.get());
730         if (rc.Fail())
731             return false;
732     }
733     return true; // Success!
734 }
735 
736 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
737 bool
738 Target::ClearAllWatchpointHitCounts ()
739 {
740     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
741     if (log)
742         log->Printf ("Target::%s\n", __FUNCTION__);
743 
744     size_t num_watchpoints = m_watchpoint_list.GetSize();
745     for (size_t i = 0; i < num_watchpoints; ++i)
746     {
747         WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
748         if (!wp_sp)
749             return false;
750 
751         wp_sp->ResetHitCount();
752     }
753     return true; // Success!
754 }
755 
756 // Assumption: Caller holds the list mutex lock for m_watchpoint_list
757 // during these operations.
758 bool
759 Target::IgnoreAllWatchpoints (uint32_t ignore_count)
760 {
761     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
762     if (log)
763         log->Printf ("Target::%s\n", __FUNCTION__);
764 
765     if (!ProcessIsValid())
766         return false;
767 
768     size_t num_watchpoints = m_watchpoint_list.GetSize();
769     for (size_t i = 0; i < num_watchpoints; ++i)
770     {
771         WatchpointSP wp_sp = m_watchpoint_list.GetByIndex(i);
772         if (!wp_sp)
773             return false;
774 
775         wp_sp->SetIgnoreCount(ignore_count);
776     }
777     return true; // Success!
778 }
779 
780 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
781 bool
782 Target::DisableWatchpointByID (lldb::watch_id_t watch_id)
783 {
784     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
785     if (log)
786         log->Printf ("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id);
787 
788     if (!ProcessIsValid())
789         return false;
790 
791     WatchpointSP wp_sp = m_watchpoint_list.FindByID (watch_id);
792     if (wp_sp)
793     {
794         Error rc = m_process_sp->DisableWatchpoint(wp_sp.get());
795         if (rc.Success())
796             return true;
797 
798         // Else, fallthrough.
799     }
800     return false;
801 }
802 
803 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
804 bool
805 Target::EnableWatchpointByID (lldb::watch_id_t watch_id)
806 {
807     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
808     if (log)
809         log->Printf ("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id);
810 
811     if (!ProcessIsValid())
812         return false;
813 
814     WatchpointSP wp_sp = m_watchpoint_list.FindByID (watch_id);
815     if (wp_sp)
816     {
817         Error rc = m_process_sp->EnableWatchpoint(wp_sp.get());
818         if (rc.Success())
819             return true;
820 
821         // Else, fallthrough.
822     }
823     return false;
824 }
825 
826 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
827 bool
828 Target::RemoveWatchpointByID (lldb::watch_id_t watch_id)
829 {
830     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
831     if (log)
832         log->Printf ("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id);
833 
834     if (DisableWatchpointByID (watch_id))
835     {
836         m_watchpoint_list.Remove(watch_id);
837         return true;
838     }
839     return false;
840 }
841 
842 // Assumption: Caller holds the list mutex lock for m_watchpoint_list.
843 bool
844 Target::IgnoreWatchpointByID (lldb::watch_id_t watch_id, uint32_t ignore_count)
845 {
846     LogSP log(lldb_private::GetLogIfAllCategoriesSet (LIBLLDB_LOG_WATCHPOINTS));
847     if (log)
848         log->Printf ("Target::%s (watch_id = %i)\n", __FUNCTION__, watch_id);
849 
850     if (!ProcessIsValid())
851         return false;
852 
853     WatchpointSP wp_sp = m_watchpoint_list.FindByID (watch_id);
854     if (wp_sp)
855     {
856         wp_sp->SetIgnoreCount(ignore_count);
857         return true;
858     }
859     return false;
860 }
861 
862 ModuleSP
863 Target::GetExecutableModule ()
864 {
865     return m_images.GetModuleAtIndex(0);
866 }
867 
868 Module*
869 Target::GetExecutableModulePointer ()
870 {
871     return m_images.GetModulePointerAtIndex(0);
872 }
873 
874 void
875 Target::SetExecutableModule (ModuleSP& executable_sp, bool get_dependent_files)
876 {
877     m_images.Clear();
878     m_scratch_ast_context_ap.reset();
879     m_scratch_ast_source_ap.reset();
880     m_ast_importer_ap.reset();
881 
882     if (executable_sp.get())
883     {
884         Timer scoped_timer (__PRETTY_FUNCTION__,
885                             "Target::SetExecutableModule (executable = '%s/%s')",
886                             executable_sp->GetFileSpec().GetDirectory().AsCString(),
887                             executable_sp->GetFileSpec().GetFilename().AsCString());
888 
889         m_images.Append(executable_sp); // The first image is our exectuable file
890 
891         // If we haven't set an architecture yet, reset our architecture based on what we found in the executable module.
892         if (!m_arch.IsValid())
893             m_arch = executable_sp->GetArchitecture();
894 
895         FileSpecList dependent_files;
896         ObjectFile *executable_objfile = executable_sp->GetObjectFile();
897 
898         if (executable_objfile && get_dependent_files)
899         {
900             executable_objfile->GetDependentModules(dependent_files);
901             for (uint32_t i=0; i<dependent_files.GetSize(); i++)
902             {
903                 FileSpec dependent_file_spec (dependent_files.GetFileSpecPointerAtIndex(i));
904                 FileSpec platform_dependent_file_spec;
905                 if (m_platform_sp)
906                     m_platform_sp->GetFile (dependent_file_spec, NULL, platform_dependent_file_spec);
907                 else
908                     platform_dependent_file_spec = dependent_file_spec;
909 
910                 ModuleSpec module_spec (platform_dependent_file_spec, m_arch);
911                 ModuleSP image_module_sp(GetSharedModule (module_spec));
912                 if (image_module_sp.get())
913                 {
914                     ObjectFile *objfile = image_module_sp->GetObjectFile();
915                     if (objfile)
916                         objfile->GetDependentModules(dependent_files);
917                 }
918             }
919         }
920     }
921 
922     UpdateInstanceName();
923 }
924 
925 
926 bool
927 Target::SetArchitecture (const ArchSpec &arch_spec)
928 {
929     if (m_arch == arch_spec)
930     {
931         // If we're setting the architecture to our current architecture, we
932         // don't need to do anything.
933         return true;
934     }
935     else if (!m_arch.IsValid())
936     {
937         // If we haven't got a valid arch spec, then we just need to set it.
938         m_arch = arch_spec;
939         return true;
940     }
941     else
942     {
943         // If we have an executable file, try to reset the executable to the desired architecture
944         m_arch = arch_spec;
945         ModuleSP executable_sp = GetExecutableModule ();
946         m_images.Clear();
947         m_scratch_ast_context_ap.reset();
948         m_scratch_ast_source_ap.reset();
949         m_ast_importer_ap.reset();
950         // Need to do something about unsetting breakpoints.
951 
952         if (executable_sp)
953         {
954             ModuleSpec module_spec (executable_sp->GetFileSpec(), arch_spec);
955             Error error = ModuleList::GetSharedModule (module_spec,
956                                                        executable_sp,
957                                                        &GetExecutableSearchPaths(),
958                                                        NULL,
959                                                        NULL);
960 
961             if (!error.Fail() && executable_sp)
962             {
963                 SetExecutableModule (executable_sp, true);
964                 return true;
965             }
966             else
967             {
968                 return false;
969             }
970         }
971         else
972         {
973             return false;
974         }
975     }
976 }
977 
978 void
979 Target::ModuleAdded (ModuleSP &module_sp)
980 {
981     // A module is being added to this target for the first time
982     ModuleList module_list;
983     module_list.Append(module_sp);
984     ModulesDidLoad (module_list);
985 }
986 
987 void
988 Target::ModuleUpdated (ModuleSP &old_module_sp, ModuleSP &new_module_sp)
989 {
990     // A module is replacing an already added module
991     ModuleList module_list;
992     module_list.Append (old_module_sp);
993     ModulesDidUnload (module_list);
994     module_list.Clear ();
995     module_list.Append (new_module_sp);
996     ModulesDidLoad (module_list);
997 }
998 
999 void
1000 Target::ModulesDidLoad (ModuleList &module_list)
1001 {
1002     m_breakpoint_list.UpdateBreakpoints (module_list, true);
1003     // TODO: make event data that packages up the module_list
1004     BroadcastEvent (eBroadcastBitModulesLoaded, NULL);
1005 }
1006 
1007 void
1008 Target::ModulesDidUnload (ModuleList &module_list)
1009 {
1010     m_breakpoint_list.UpdateBreakpoints (module_list, false);
1011 
1012     // Remove the images from the target image list
1013     m_images.Remove(module_list);
1014 
1015     // TODO: make event data that packages up the module_list
1016     BroadcastEvent (eBroadcastBitModulesUnloaded, NULL);
1017 }
1018 
1019 
1020 bool
1021 Target::ModuleIsExcludedForNonModuleSpecificSearches (const FileSpec &module_file_spec)
1022 {
1023 
1024     if (!m_breakpoints_use_platform_avoid)
1025         return false;
1026     else
1027     {
1028         ModuleList matchingModules;
1029         ModuleSpec module_spec (module_file_spec);
1030         size_t num_modules = GetImages().FindModules(module_spec, matchingModules);
1031 
1032         // If there is more than one module for this file spec, only return true if ALL the modules are on the
1033         // black list.
1034         if (num_modules > 0)
1035         {
1036             for (int i  = 0; i < num_modules; i++)
1037             {
1038                 if (!ModuleIsExcludedForNonModuleSpecificSearches (matchingModules.GetModuleAtIndex(i)))
1039                     return false;
1040             }
1041             return true;
1042         }
1043         else
1044             return false;
1045     }
1046 }
1047 
1048 bool
1049 Target::ModuleIsExcludedForNonModuleSpecificSearches (const lldb::ModuleSP &module_sp)
1050 {
1051     if (!m_breakpoints_use_platform_avoid)
1052         return false;
1053     else if (GetPlatform())
1054     {
1055         return GetPlatform()->ModuleIsExcludedForNonModuleSpecificSearches (*this, module_sp);
1056     }
1057     else
1058         return false;
1059 }
1060 
1061 size_t
1062 Target::ReadMemoryFromFileCache (const Address& addr, void *dst, size_t dst_len, Error &error)
1063 {
1064     SectionSP section_sp (addr.GetSection());
1065     if (section_sp)
1066     {
1067         // If the contents of this section are encrypted, the on-disk file is unusuable.  Read only from live memory.
1068         if (section_sp->IsEncrypted())
1069         {
1070             return 0;
1071         }
1072         ModuleSP module_sp (section_sp->GetModule());
1073         if (module_sp)
1074         {
1075             ObjectFile *objfile = section_sp->GetModule()->GetObjectFile();
1076             if (objfile)
1077             {
1078                 size_t bytes_read = objfile->ReadSectionData (section_sp.get(),
1079                                                               addr.GetOffset(),
1080                                                               dst,
1081                                                               dst_len);
1082                 if (bytes_read > 0)
1083                     return bytes_read;
1084                 else
1085                     error.SetErrorStringWithFormat("error reading data from section %s", section_sp->GetName().GetCString());
1086             }
1087             else
1088                 error.SetErrorString("address isn't from a object file");
1089         }
1090         else
1091             error.SetErrorString("address isn't in a module");
1092     }
1093     else
1094         error.SetErrorString("address doesn't contain a section that points to a section in a object file");
1095 
1096     return 0;
1097 }
1098 
1099 size_t
1100 Target::ReadMemory (const Address& addr,
1101                     bool prefer_file_cache,
1102                     void *dst,
1103                     size_t dst_len,
1104                     Error &error,
1105                     lldb::addr_t *load_addr_ptr)
1106 {
1107     error.Clear();
1108 
1109     // if we end up reading this from process memory, we will fill this
1110     // with the actual load address
1111     if (load_addr_ptr)
1112         *load_addr_ptr = LLDB_INVALID_ADDRESS;
1113 
1114     size_t bytes_read = 0;
1115 
1116     addr_t load_addr = LLDB_INVALID_ADDRESS;
1117     addr_t file_addr = LLDB_INVALID_ADDRESS;
1118     Address resolved_addr;
1119     if (!addr.IsSectionOffset())
1120     {
1121         if (m_section_load_list.IsEmpty())
1122         {
1123             // No sections are loaded, so we must assume we are not running
1124             // yet and anything we are given is a file address.
1125             file_addr = addr.GetOffset(); // "addr" doesn't have a section, so its offset is the file address
1126             m_images.ResolveFileAddress (file_addr, resolved_addr);
1127         }
1128         else
1129         {
1130             // We have at least one section loaded. This can be becuase
1131             // we have manually loaded some sections with "target modules load ..."
1132             // or because we have have a live process that has sections loaded
1133             // through the dynamic loader
1134             load_addr = addr.GetOffset(); // "addr" doesn't have a section, so its offset is the load address
1135             m_section_load_list.ResolveLoadAddress (load_addr, resolved_addr);
1136         }
1137     }
1138     if (!resolved_addr.IsValid())
1139         resolved_addr = addr;
1140 
1141 
1142     if (prefer_file_cache)
1143     {
1144         bytes_read = ReadMemoryFromFileCache (resolved_addr, dst, dst_len, error);
1145         if (bytes_read > 0)
1146             return bytes_read;
1147     }
1148 
1149     if (ProcessIsValid())
1150     {
1151         if (load_addr == LLDB_INVALID_ADDRESS)
1152             load_addr = resolved_addr.GetLoadAddress (this);
1153 
1154         if (load_addr == LLDB_INVALID_ADDRESS)
1155         {
1156             ModuleSP addr_module_sp (resolved_addr.GetModule());
1157             if (addr_module_sp && addr_module_sp->GetFileSpec())
1158                 error.SetErrorStringWithFormat("%s[0x%llx] can't be resolved, %s in not currently loaded",
1159                                                addr_module_sp->GetFileSpec().GetFilename().AsCString(),
1160                                                resolved_addr.GetFileAddress(),
1161                                                addr_module_sp->GetFileSpec().GetFilename().AsCString());
1162             else
1163                 error.SetErrorStringWithFormat("0x%llx can't be resolved", resolved_addr.GetFileAddress());
1164         }
1165         else
1166         {
1167             bytes_read = m_process_sp->ReadMemory(load_addr, dst, dst_len, error);
1168             if (bytes_read != dst_len)
1169             {
1170                 if (error.Success())
1171                 {
1172                     if (bytes_read == 0)
1173                         error.SetErrorStringWithFormat("read memory from 0x%llx failed", load_addr);
1174                     else
1175                         error.SetErrorStringWithFormat("only %zu of %zu bytes were read from memory at 0x%llx", bytes_read, dst_len, load_addr);
1176                 }
1177             }
1178             if (bytes_read)
1179             {
1180                 if (load_addr_ptr)
1181                     *load_addr_ptr = load_addr;
1182                 return bytes_read;
1183             }
1184             // If the address is not section offset we have an address that
1185             // doesn't resolve to any address in any currently loaded shared
1186             // libaries and we failed to read memory so there isn't anything
1187             // more we can do. If it is section offset, we might be able to
1188             // read cached memory from the object file.
1189             if (!resolved_addr.IsSectionOffset())
1190                 return 0;
1191         }
1192     }
1193 
1194     if (!prefer_file_cache && resolved_addr.IsSectionOffset())
1195     {
1196         // If we didn't already try and read from the object file cache, then
1197         // try it after failing to read from the process.
1198         return ReadMemoryFromFileCache (resolved_addr, dst, dst_len, error);
1199     }
1200     return 0;
1201 }
1202 
1203 size_t
1204 Target::ReadScalarIntegerFromMemory (const Address& addr,
1205                                      bool prefer_file_cache,
1206                                      uint32_t byte_size,
1207                                      bool is_signed,
1208                                      Scalar &scalar,
1209                                      Error &error)
1210 {
1211     uint64_t uval;
1212 
1213     if (byte_size <= sizeof(uval))
1214     {
1215         size_t bytes_read = ReadMemory (addr, prefer_file_cache, &uval, byte_size, error);
1216         if (bytes_read == byte_size)
1217         {
1218             DataExtractor data (&uval, sizeof(uval), m_arch.GetByteOrder(), m_arch.GetAddressByteSize());
1219             uint32_t offset = 0;
1220             if (byte_size <= 4)
1221                 scalar = data.GetMaxU32 (&offset, byte_size);
1222             else
1223                 scalar = data.GetMaxU64 (&offset, byte_size);
1224 
1225             if (is_signed)
1226                 scalar.SignExtend(byte_size * 8);
1227             return bytes_read;
1228         }
1229     }
1230     else
1231     {
1232         error.SetErrorStringWithFormat ("byte size of %u is too large for integer scalar type", byte_size);
1233     }
1234     return 0;
1235 }
1236 
1237 uint64_t
1238 Target::ReadUnsignedIntegerFromMemory (const Address& addr,
1239                                        bool prefer_file_cache,
1240                                        size_t integer_byte_size,
1241                                        uint64_t fail_value,
1242                                        Error &error)
1243 {
1244     Scalar scalar;
1245     if (ReadScalarIntegerFromMemory (addr,
1246                                      prefer_file_cache,
1247                                      integer_byte_size,
1248                                      false,
1249                                      scalar,
1250                                      error))
1251         return scalar.ULongLong(fail_value);
1252     return fail_value;
1253 }
1254 
1255 bool
1256 Target::ReadPointerFromMemory (const Address& addr,
1257                                bool prefer_file_cache,
1258                                Error &error,
1259                                Address &pointer_addr)
1260 {
1261     Scalar scalar;
1262     if (ReadScalarIntegerFromMemory (addr,
1263                                      prefer_file_cache,
1264                                      m_arch.GetAddressByteSize(),
1265                                      false,
1266                                      scalar,
1267                                      error))
1268     {
1269         addr_t pointer_vm_addr = scalar.ULongLong(LLDB_INVALID_ADDRESS);
1270         if (pointer_vm_addr != LLDB_INVALID_ADDRESS)
1271         {
1272             if (m_section_load_list.IsEmpty())
1273             {
1274                 // No sections are loaded, so we must assume we are not running
1275                 // yet and anything we are given is a file address.
1276                 m_images.ResolveFileAddress (pointer_vm_addr, pointer_addr);
1277             }
1278             else
1279             {
1280                 // We have at least one section loaded. This can be becuase
1281                 // we have manually loaded some sections with "target modules load ..."
1282                 // or because we have have a live process that has sections loaded
1283                 // through the dynamic loader
1284                 m_section_load_list.ResolveLoadAddress (pointer_vm_addr, pointer_addr);
1285             }
1286             // We weren't able to resolve the pointer value, so just return
1287             // an address with no section
1288             if (!pointer_addr.IsValid())
1289                 pointer_addr.SetOffset (pointer_vm_addr);
1290             return true;
1291 
1292         }
1293     }
1294     return false;
1295 }
1296 
1297 ModuleSP
1298 Target::GetSharedModule (const ModuleSpec &module_spec, Error *error_ptr)
1299 {
1300     // Don't pass in the UUID so we can tell if we have a stale value in our list
1301     ModuleSP old_module_sp; // This will get filled in if we have a new version of the library
1302     bool did_create_module = false;
1303     ModuleSP module_sp;
1304 
1305     Error error;
1306 
1307     // If there are image search path entries, try to use them first to acquire a suitable image.
1308     if (m_image_search_paths.GetSize())
1309     {
1310         ModuleSpec transformed_spec (module_spec);
1311         if (m_image_search_paths.RemapPath (module_spec.GetFileSpec().GetDirectory(), transformed_spec.GetFileSpec().GetDirectory()))
1312         {
1313             transformed_spec.GetFileSpec().GetFilename() = module_spec.GetFileSpec().GetFilename();
1314             error = ModuleList::GetSharedModule (transformed_spec,
1315                                                  module_sp,
1316                                                  &GetExecutableSearchPaths(),
1317                                                  &old_module_sp,
1318                                                  &did_create_module);
1319         }
1320     }
1321 
1322     // The platform is responsible for finding and caching an appropriate
1323     // module in the shared module cache.
1324     if (m_platform_sp)
1325     {
1326         FileSpec platform_file_spec;
1327         error = m_platform_sp->GetSharedModule (module_spec,
1328                                                 module_sp,
1329                                                 &GetExecutableSearchPaths(),
1330                                                 &old_module_sp,
1331                                                 &did_create_module);
1332     }
1333     else
1334     {
1335         error.SetErrorString("no platform is currently set");
1336     }
1337 
1338     // If a module hasn't been found yet, use the unmodified path.
1339     if (module_sp)
1340     {
1341         m_images.Append (module_sp);
1342         if (did_create_module)
1343         {
1344             if (old_module_sp && m_images.GetIndexForModule (old_module_sp.get()) != LLDB_INVALID_INDEX32)
1345                 ModuleUpdated(old_module_sp, module_sp);
1346             else
1347                 ModuleAdded(module_sp);
1348         }
1349     }
1350     if (error_ptr)
1351         *error_ptr = error;
1352     return module_sp;
1353 }
1354 
1355 
1356 TargetSP
1357 Target::CalculateTarget ()
1358 {
1359     return shared_from_this();
1360 }
1361 
1362 ProcessSP
1363 Target::CalculateProcess ()
1364 {
1365     return ProcessSP();
1366 }
1367 
1368 ThreadSP
1369 Target::CalculateThread ()
1370 {
1371     return ThreadSP();
1372 }
1373 
1374 StackFrameSP
1375 Target::CalculateStackFrame ()
1376 {
1377     return StackFrameSP();
1378 }
1379 
1380 void
1381 Target::CalculateExecutionContext (ExecutionContext &exe_ctx)
1382 {
1383     exe_ctx.Clear();
1384     exe_ctx.SetTargetPtr(this);
1385 }
1386 
1387 PathMappingList &
1388 Target::GetImageSearchPathList ()
1389 {
1390     return m_image_search_paths;
1391 }
1392 
1393 void
1394 Target::ImageSearchPathsChanged
1395 (
1396     const PathMappingList &path_list,
1397     void *baton
1398 )
1399 {
1400     Target *target = (Target *)baton;
1401     ModuleSP exe_module_sp (target->GetExecutableModule());
1402     if (exe_module_sp)
1403     {
1404         target->m_images.Clear();
1405         target->SetExecutableModule (exe_module_sp, true);
1406     }
1407 }
1408 
1409 ClangASTContext *
1410 Target::GetScratchClangASTContext(bool create_on_demand)
1411 {
1412     // Now see if we know the target triple, and if so, create our scratch AST context:
1413     if (m_scratch_ast_context_ap.get() == NULL && m_arch.IsValid() && create_on_demand)
1414     {
1415         m_scratch_ast_context_ap.reset (new ClangASTContext(m_arch.GetTriple().str().c_str()));
1416         m_scratch_ast_source_ap.reset (new ClangASTSource(shared_from_this()));
1417         m_scratch_ast_source_ap->InstallASTContext(m_scratch_ast_context_ap->getASTContext());
1418         llvm::OwningPtr<clang::ExternalASTSource> proxy_ast_source(m_scratch_ast_source_ap->CreateProxy());
1419         m_scratch_ast_context_ap->SetExternalSource(proxy_ast_source);
1420     }
1421     return m_scratch_ast_context_ap.get();
1422 }
1423 
1424 ClangASTImporter *
1425 Target::GetClangASTImporter()
1426 {
1427     ClangASTImporter *ast_importer = m_ast_importer_ap.get();
1428 
1429     if (!ast_importer)
1430     {
1431         ast_importer = new ClangASTImporter();
1432         m_ast_importer_ap.reset(ast_importer);
1433     }
1434 
1435     return ast_importer;
1436 }
1437 
1438 void
1439 Target::SettingsInitialize ()
1440 {
1441     UserSettingsController::InitializeSettingsController (GetSettingsController(),
1442                                                           SettingsController::global_settings_table,
1443                                                           SettingsController::instance_settings_table);
1444 
1445     // Now call SettingsInitialize() on each 'child' setting of Target
1446     Process::SettingsInitialize ();
1447 }
1448 
1449 void
1450 Target::SettingsTerminate ()
1451 {
1452 
1453     // Must call SettingsTerminate() on each settings 'child' of Target, before terminating Target's Settings.
1454 
1455     Process::SettingsTerminate ();
1456 
1457     // Now terminate Target Settings.
1458 
1459     UserSettingsControllerSP &usc = GetSettingsController();
1460     UserSettingsController::FinalizeSettingsController (usc);
1461     usc.reset();
1462 }
1463 
1464 UserSettingsControllerSP &
1465 Target::GetSettingsController ()
1466 {
1467     static UserSettingsControllerSP g_settings_controller_sp;
1468     if (!g_settings_controller_sp)
1469     {
1470         g_settings_controller_sp.reset (new Target::SettingsController);
1471         // The first shared pointer to Target::SettingsController in
1472         // g_settings_controller_sp must be fully created above so that
1473         // the TargetInstanceSettings can use a weak_ptr to refer back
1474         // to the master setttings controller
1475         InstanceSettingsSP default_instance_settings_sp (new TargetInstanceSettings (g_settings_controller_sp,
1476                                                                                      false,
1477                                                                                      InstanceSettings::GetDefaultName().AsCString()));
1478         g_settings_controller_sp->SetDefaultInstanceSettings (default_instance_settings_sp);
1479     }
1480     return g_settings_controller_sp;
1481 }
1482 
1483 FileSpecList
1484 Target::GetDefaultExecutableSearchPaths ()
1485 {
1486     lldb::UserSettingsControllerSP settings_controller_sp (GetSettingsController());
1487     if (settings_controller_sp)
1488     {
1489         lldb::InstanceSettingsSP instance_settings_sp (settings_controller_sp->GetDefaultInstanceSettings ());
1490         if (instance_settings_sp)
1491             return static_cast<TargetInstanceSettings *>(instance_settings_sp.get())->GetExecutableSearchPaths ();
1492     }
1493     return FileSpecList();
1494 }
1495 
1496 
1497 ArchSpec
1498 Target::GetDefaultArchitecture ()
1499 {
1500     lldb::UserSettingsControllerSP settings_controller_sp (GetSettingsController());
1501 
1502     if (settings_controller_sp)
1503         return static_cast<Target::SettingsController *>(settings_controller_sp.get())->GetArchitecture ();
1504     return ArchSpec();
1505 }
1506 
1507 void
1508 Target::SetDefaultArchitecture (const ArchSpec& arch)
1509 {
1510     lldb::UserSettingsControllerSP settings_controller_sp (GetSettingsController());
1511 
1512     if (settings_controller_sp)
1513         static_cast<Target::SettingsController *>(settings_controller_sp.get())->GetArchitecture () = arch;
1514 }
1515 
1516 Target *
1517 Target::GetTargetFromContexts (const ExecutionContext *exe_ctx_ptr, const SymbolContext *sc_ptr)
1518 {
1519     // The target can either exist in the "process" of ExecutionContext, or in
1520     // the "target_sp" member of SymbolContext. This accessor helper function
1521     // will get the target from one of these locations.
1522 
1523     Target *target = NULL;
1524     if (sc_ptr != NULL)
1525         target = sc_ptr->target_sp.get();
1526     if (target == NULL && exe_ctx_ptr)
1527         target = exe_ctx_ptr->GetTargetPtr();
1528     return target;
1529 }
1530 
1531 
1532 void
1533 Target::UpdateInstanceName ()
1534 {
1535     StreamString sstr;
1536 
1537     Module *exe_module = GetExecutableModulePointer();
1538     if (exe_module)
1539     {
1540         sstr.Printf ("%s_%s",
1541                      exe_module->GetFileSpec().GetFilename().AsCString(),
1542                      exe_module->GetArchitecture().GetArchitectureName());
1543         GetSettingsController()->RenameInstanceSettings (GetInstanceName().AsCString(), sstr.GetData());
1544     }
1545 }
1546 
1547 const char *
1548 Target::GetExpressionPrefixContentsAsCString ()
1549 {
1550     if (!m_expr_prefix_contents.empty())
1551         return m_expr_prefix_contents.c_str();
1552     return NULL;
1553 }
1554 
1555 ExecutionResults
1556 Target::EvaluateExpression
1557 (
1558     const char *expr_cstr,
1559     StackFrame *frame,
1560     lldb_private::ExecutionPolicy execution_policy,
1561     bool coerce_to_id,
1562     bool unwind_on_error,
1563     bool keep_in_memory,
1564     lldb::DynamicValueType use_dynamic,
1565     lldb::ValueObjectSP &result_valobj_sp
1566 )
1567 {
1568     ExecutionResults execution_results = eExecutionSetupError;
1569 
1570     result_valobj_sp.reset();
1571 
1572     if (expr_cstr == NULL || expr_cstr[0] == '\0')
1573         return execution_results;
1574 
1575     // We shouldn't run stop hooks in expressions.
1576     // Be sure to reset this if you return anywhere within this function.
1577     bool old_suppress_value = m_suppress_stop_hooks;
1578     m_suppress_stop_hooks = true;
1579 
1580     ExecutionContext exe_ctx;
1581 
1582     const size_t expr_cstr_len = ::strlen (expr_cstr);
1583 
1584     if (frame)
1585     {
1586         frame->CalculateExecutionContext(exe_ctx);
1587         Error error;
1588         const uint32_t expr_path_options = StackFrame::eExpressionPathOptionCheckPtrVsMember |
1589                                            StackFrame::eExpressionPathOptionsNoFragileObjcIvar |
1590                                            StackFrame::eExpressionPathOptionsNoSyntheticChildren;
1591         lldb::VariableSP var_sp;
1592 
1593         // Make sure we don't have any things that we know a variable expression
1594         // won't be able to deal with before calling into it
1595         if (::strcspn (expr_cstr, "()+*&|!~<=/^%,?") == expr_cstr_len)
1596         {
1597             result_valobj_sp = frame->GetValueForVariableExpressionPath (expr_cstr,
1598                                                                          use_dynamic,
1599                                                                          expr_path_options,
1600                                                                          var_sp,
1601                                                                          error);
1602             // if this expression results in a bitfield, we give up and let the IR handle it
1603             if (result_valobj_sp && result_valobj_sp->IsBitfield())
1604                 result_valobj_sp.reset();
1605         }
1606     }
1607     else if (m_process_sp)
1608     {
1609         m_process_sp->CalculateExecutionContext(exe_ctx);
1610     }
1611     else
1612     {
1613         CalculateExecutionContext(exe_ctx);
1614     }
1615 
1616     if (result_valobj_sp)
1617     {
1618         execution_results = eExecutionCompleted;
1619         // We got a result from the frame variable expression path above...
1620         ConstString persistent_variable_name (m_persistent_variables.GetNextPersistentVariableName());
1621 
1622         lldb::ValueObjectSP const_valobj_sp;
1623 
1624         // Check in case our value is already a constant value
1625         if (result_valobj_sp->GetIsConstant())
1626         {
1627             const_valobj_sp = result_valobj_sp;
1628             const_valobj_sp->SetName (persistent_variable_name);
1629         }
1630         else
1631         {
1632             if (use_dynamic != lldb::eNoDynamicValues)
1633             {
1634                 ValueObjectSP dynamic_sp = result_valobj_sp->GetDynamicValue(use_dynamic);
1635                 if (dynamic_sp)
1636                     result_valobj_sp = dynamic_sp;
1637             }
1638 
1639             const_valobj_sp = result_valobj_sp->CreateConstantValue (persistent_variable_name);
1640         }
1641 
1642         lldb::ValueObjectSP live_valobj_sp = result_valobj_sp;
1643 
1644         result_valobj_sp = const_valobj_sp;
1645 
1646         ClangExpressionVariableSP clang_expr_variable_sp(m_persistent_variables.CreatePersistentVariable(result_valobj_sp));
1647         assert (clang_expr_variable_sp.get());
1648 
1649         // Set flags and live data as appropriate
1650 
1651         const Value &result_value = live_valobj_sp->GetValue();
1652 
1653         switch (result_value.GetValueType())
1654         {
1655         case Value::eValueTypeHostAddress:
1656         case Value::eValueTypeFileAddress:
1657             // we don't do anything with these for now
1658             break;
1659         case Value::eValueTypeScalar:
1660             clang_expr_variable_sp->m_flags |= ClangExpressionVariable::EVIsLLDBAllocated;
1661             clang_expr_variable_sp->m_flags |= ClangExpressionVariable::EVNeedsAllocation;
1662             break;
1663         case Value::eValueTypeLoadAddress:
1664             clang_expr_variable_sp->m_live_sp = live_valobj_sp;
1665             clang_expr_variable_sp->m_flags |= ClangExpressionVariable::EVIsProgramReference;
1666             break;
1667         }
1668     }
1669     else
1670     {
1671         // Make sure we aren't just trying to see the value of a persistent
1672         // variable (something like "$0")
1673         lldb::ClangExpressionVariableSP persistent_var_sp;
1674         // Only check for persistent variables the expression starts with a '$'
1675         if (expr_cstr[0] == '$')
1676             persistent_var_sp = m_persistent_variables.GetVariable (expr_cstr);
1677 
1678         if (persistent_var_sp)
1679         {
1680             result_valobj_sp = persistent_var_sp->GetValueObject ();
1681             execution_results = eExecutionCompleted;
1682         }
1683         else
1684         {
1685             const char *prefix = GetExpressionPrefixContentsAsCString();
1686 
1687             execution_results = ClangUserExpression::Evaluate (exe_ctx,
1688                                                                execution_policy,
1689                                                                lldb::eLanguageTypeUnknown,
1690                                                                coerce_to_id ? ClangUserExpression::eResultTypeId : ClangUserExpression::eResultTypeAny,
1691                                                                unwind_on_error,
1692                                                                expr_cstr,
1693                                                                prefix,
1694                                                                result_valobj_sp);
1695         }
1696     }
1697 
1698     m_suppress_stop_hooks = old_suppress_value;
1699 
1700     return execution_results;
1701 }
1702 
1703 lldb::addr_t
1704 Target::GetCallableLoadAddress (lldb::addr_t load_addr, AddressClass addr_class) const
1705 {
1706     addr_t code_addr = load_addr;
1707     switch (m_arch.GetMachine())
1708     {
1709     case llvm::Triple::arm:
1710     case llvm::Triple::thumb:
1711         switch (addr_class)
1712         {
1713         case eAddressClassData:
1714         case eAddressClassDebug:
1715             return LLDB_INVALID_ADDRESS;
1716 
1717         case eAddressClassUnknown:
1718         case eAddressClassInvalid:
1719         case eAddressClassCode:
1720         case eAddressClassCodeAlternateISA:
1721         case eAddressClassRuntime:
1722             // Check if bit zero it no set?
1723             if ((code_addr & 1ull) == 0)
1724             {
1725                 // Bit zero isn't set, check if the address is a multiple of 2?
1726                 if (code_addr & 2ull)
1727                 {
1728                     // The address is a multiple of 2 so it must be thumb, set bit zero
1729                     code_addr |= 1ull;
1730                 }
1731                 else if (addr_class == eAddressClassCodeAlternateISA)
1732                 {
1733                     // We checked the address and the address claims to be the alternate ISA
1734                     // which means thumb, so set bit zero.
1735                     code_addr |= 1ull;
1736                 }
1737             }
1738             break;
1739         }
1740         break;
1741 
1742     default:
1743         break;
1744     }
1745     return code_addr;
1746 }
1747 
1748 lldb::addr_t
1749 Target::GetOpcodeLoadAddress (lldb::addr_t load_addr, AddressClass addr_class) const
1750 {
1751     addr_t opcode_addr = load_addr;
1752     switch (m_arch.GetMachine())
1753     {
1754     case llvm::Triple::arm:
1755     case llvm::Triple::thumb:
1756         switch (addr_class)
1757         {
1758         case eAddressClassData:
1759         case eAddressClassDebug:
1760             return LLDB_INVALID_ADDRESS;
1761 
1762         case eAddressClassInvalid:
1763         case eAddressClassUnknown:
1764         case eAddressClassCode:
1765         case eAddressClassCodeAlternateISA:
1766         case eAddressClassRuntime:
1767             opcode_addr &= ~(1ull);
1768             break;
1769         }
1770         break;
1771 
1772     default:
1773         break;
1774     }
1775     return opcode_addr;
1776 }
1777 
1778 lldb::user_id_t
1779 Target::AddStopHook (Target::StopHookSP &new_hook_sp)
1780 {
1781     lldb::user_id_t new_uid = ++m_stop_hook_next_id;
1782     new_hook_sp.reset (new StopHook(shared_from_this(), new_uid));
1783     m_stop_hooks[new_uid] = new_hook_sp;
1784     return new_uid;
1785 }
1786 
1787 bool
1788 Target::RemoveStopHookByID (lldb::user_id_t user_id)
1789 {
1790     size_t num_removed;
1791     num_removed = m_stop_hooks.erase (user_id);
1792     if (num_removed == 0)
1793         return false;
1794     else
1795         return true;
1796 }
1797 
1798 void
1799 Target::RemoveAllStopHooks ()
1800 {
1801     m_stop_hooks.clear();
1802 }
1803 
1804 Target::StopHookSP
1805 Target::GetStopHookByID (lldb::user_id_t user_id)
1806 {
1807     StopHookSP found_hook;
1808 
1809     StopHookCollection::iterator specified_hook_iter;
1810     specified_hook_iter = m_stop_hooks.find (user_id);
1811     if (specified_hook_iter != m_stop_hooks.end())
1812         found_hook = (*specified_hook_iter).second;
1813     return found_hook;
1814 }
1815 
1816 bool
1817 Target::SetStopHookActiveStateByID (lldb::user_id_t user_id, bool active_state)
1818 {
1819     StopHookCollection::iterator specified_hook_iter;
1820     specified_hook_iter = m_stop_hooks.find (user_id);
1821     if (specified_hook_iter == m_stop_hooks.end())
1822         return false;
1823 
1824     (*specified_hook_iter).second->SetIsActive (active_state);
1825     return true;
1826 }
1827 
1828 void
1829 Target::SetAllStopHooksActiveState (bool active_state)
1830 {
1831     StopHookCollection::iterator pos, end = m_stop_hooks.end();
1832     for (pos = m_stop_hooks.begin(); pos != end; pos++)
1833     {
1834         (*pos).second->SetIsActive (active_state);
1835     }
1836 }
1837 
1838 void
1839 Target::RunStopHooks ()
1840 {
1841     if (m_suppress_stop_hooks)
1842         return;
1843 
1844     if (!m_process_sp)
1845         return;
1846 
1847     if (m_stop_hooks.empty())
1848         return;
1849 
1850     StopHookCollection::iterator pos, end = m_stop_hooks.end();
1851 
1852     // If there aren't any active stop hooks, don't bother either:
1853     bool any_active_hooks = false;
1854     for (pos = m_stop_hooks.begin(); pos != end; pos++)
1855     {
1856         if ((*pos).second->IsActive())
1857         {
1858             any_active_hooks = true;
1859             break;
1860         }
1861     }
1862     if (!any_active_hooks)
1863         return;
1864 
1865     CommandReturnObject result;
1866 
1867     std::vector<ExecutionContext> exc_ctx_with_reasons;
1868     std::vector<SymbolContext> sym_ctx_with_reasons;
1869 
1870     ThreadList &cur_threadlist = m_process_sp->GetThreadList();
1871     size_t num_threads = cur_threadlist.GetSize();
1872     for (size_t i = 0; i < num_threads; i++)
1873     {
1874         lldb::ThreadSP cur_thread_sp = cur_threadlist.GetThreadAtIndex (i);
1875         if (cur_thread_sp->ThreadStoppedForAReason())
1876         {
1877             lldb::StackFrameSP cur_frame_sp = cur_thread_sp->GetStackFrameAtIndex(0);
1878             exc_ctx_with_reasons.push_back(ExecutionContext(m_process_sp.get(), cur_thread_sp.get(), cur_frame_sp.get()));
1879             sym_ctx_with_reasons.push_back(cur_frame_sp->GetSymbolContext(eSymbolContextEverything));
1880         }
1881     }
1882 
1883     // If no threads stopped for a reason, don't run the stop-hooks.
1884     size_t num_exe_ctx = exc_ctx_with_reasons.size();
1885     if (num_exe_ctx == 0)
1886         return;
1887 
1888     result.SetImmediateOutputStream (m_debugger.GetAsyncOutputStream());
1889     result.SetImmediateErrorStream (m_debugger.GetAsyncErrorStream());
1890 
1891     bool keep_going = true;
1892     bool hooks_ran = false;
1893     bool print_hook_header;
1894     bool print_thread_header;
1895 
1896     if (num_exe_ctx == 1)
1897         print_thread_header = false;
1898     else
1899         print_thread_header = true;
1900 
1901     if (m_stop_hooks.size() == 1)
1902         print_hook_header = false;
1903     else
1904         print_hook_header = true;
1905 
1906     for (pos = m_stop_hooks.begin(); keep_going && pos != end; pos++)
1907     {
1908         // result.Clear();
1909         StopHookSP cur_hook_sp = (*pos).second;
1910         if (!cur_hook_sp->IsActive())
1911             continue;
1912 
1913         bool any_thread_matched = false;
1914         for (size_t i = 0; keep_going && i < num_exe_ctx; i++)
1915         {
1916             if ((cur_hook_sp->GetSpecifier () == NULL
1917                   || cur_hook_sp->GetSpecifier()->SymbolContextMatches(sym_ctx_with_reasons[i]))
1918                 && (cur_hook_sp->GetThreadSpecifier() == NULL
1919                     || cur_hook_sp->GetThreadSpecifier()->ThreadPassesBasicTests(exc_ctx_with_reasons[i].GetThreadRef())))
1920             {
1921                 if (!hooks_ran)
1922                 {
1923                     hooks_ran = true;
1924                 }
1925                 if (print_hook_header && !any_thread_matched)
1926                 {
1927                     const char *cmd = (cur_hook_sp->GetCommands().GetSize() == 1 ?
1928                                        cur_hook_sp->GetCommands().GetStringAtIndex(0) :
1929                                        NULL);
1930                     if (cmd)
1931                         result.AppendMessageWithFormat("\n- Hook %llu (%s)\n", cur_hook_sp->GetID(), cmd);
1932                     else
1933                         result.AppendMessageWithFormat("\n- Hook %llu\n", cur_hook_sp->GetID());
1934                     any_thread_matched = true;
1935                 }
1936 
1937                 if (print_thread_header)
1938                     result.AppendMessageWithFormat("-- Thread %d\n", exc_ctx_with_reasons[i].GetThreadPtr()->GetIndexID());
1939 
1940                 bool stop_on_continue = true;
1941                 bool stop_on_error = true;
1942                 bool echo_commands = false;
1943                 bool print_results = true;
1944                 GetDebugger().GetCommandInterpreter().HandleCommands (cur_hook_sp->GetCommands(),
1945                                                                       &exc_ctx_with_reasons[i],
1946                                                                       stop_on_continue,
1947                                                                       stop_on_error,
1948                                                                       echo_commands,
1949                                                                       print_results,
1950                                                                       result);
1951 
1952                 // If the command started the target going again, we should bag out of
1953                 // running the stop hooks.
1954                 if ((result.GetStatus() == eReturnStatusSuccessContinuingNoResult) ||
1955                     (result.GetStatus() == eReturnStatusSuccessContinuingResult))
1956                 {
1957                     result.AppendMessageWithFormat ("Aborting stop hooks, hook %llu set the program running.", cur_hook_sp->GetID());
1958                     keep_going = false;
1959                 }
1960             }
1961         }
1962     }
1963 
1964     result.GetImmediateOutputStream()->Flush();
1965     result.GetImmediateErrorStream()->Flush();
1966 }
1967 
1968 
1969 //--------------------------------------------------------------
1970 // class Target::StopHook
1971 //--------------------------------------------------------------
1972 
1973 
1974 Target::StopHook::StopHook (lldb::TargetSP target_sp, lldb::user_id_t uid) :
1975         UserID (uid),
1976         m_target_sp (target_sp),
1977         m_commands (),
1978         m_specifier_sp (),
1979         m_thread_spec_ap(NULL),
1980         m_active (true)
1981 {
1982 }
1983 
1984 Target::StopHook::StopHook (const StopHook &rhs) :
1985         UserID (rhs.GetID()),
1986         m_target_sp (rhs.m_target_sp),
1987         m_commands (rhs.m_commands),
1988         m_specifier_sp (rhs.m_specifier_sp),
1989         m_thread_spec_ap (NULL),
1990         m_active (rhs.m_active)
1991 {
1992     if (rhs.m_thread_spec_ap.get() != NULL)
1993         m_thread_spec_ap.reset (new ThreadSpec(*rhs.m_thread_spec_ap.get()));
1994 }
1995 
1996 
1997 Target::StopHook::~StopHook ()
1998 {
1999 }
2000 
2001 void
2002 Target::StopHook::SetThreadSpecifier (ThreadSpec *specifier)
2003 {
2004     m_thread_spec_ap.reset (specifier);
2005 }
2006 
2007 
2008 void
2009 Target::StopHook::GetDescription (Stream *s, lldb::DescriptionLevel level) const
2010 {
2011     int indent_level = s->GetIndentLevel();
2012 
2013     s->SetIndentLevel(indent_level + 2);
2014 
2015     s->Printf ("Hook: %llu\n", GetID());
2016     if (m_active)
2017         s->Indent ("State: enabled\n");
2018     else
2019         s->Indent ("State: disabled\n");
2020 
2021     if (m_specifier_sp)
2022     {
2023         s->Indent();
2024         s->PutCString ("Specifier:\n");
2025         s->SetIndentLevel (indent_level + 4);
2026         m_specifier_sp->GetDescription (s, level);
2027         s->SetIndentLevel (indent_level + 2);
2028     }
2029 
2030     if (m_thread_spec_ap.get() != NULL)
2031     {
2032         StreamString tmp;
2033         s->Indent("Thread:\n");
2034         m_thread_spec_ap->GetDescription (&tmp, level);
2035         s->SetIndentLevel (indent_level + 4);
2036         s->Indent (tmp.GetData());
2037         s->PutCString ("\n");
2038         s->SetIndentLevel (indent_level + 2);
2039     }
2040 
2041     s->Indent ("Commands: \n");
2042     s->SetIndentLevel (indent_level + 4);
2043     uint32_t num_commands = m_commands.GetSize();
2044     for (uint32_t i = 0; i < num_commands; i++)
2045     {
2046         s->Indent(m_commands.GetStringAtIndex(i));
2047         s->PutCString ("\n");
2048     }
2049     s->SetIndentLevel (indent_level);
2050 }
2051 
2052 
2053 //--------------------------------------------------------------
2054 // class Target::SettingsController
2055 //--------------------------------------------------------------
2056 
2057 Target::SettingsController::SettingsController () :
2058     UserSettingsController ("target", Debugger::GetSettingsController()),
2059     m_default_architecture ()
2060 {
2061 }
2062 
2063 Target::SettingsController::~SettingsController ()
2064 {
2065 }
2066 
2067 lldb::InstanceSettingsSP
2068 Target::SettingsController::CreateInstanceSettings (const char *instance_name)
2069 {
2070     lldb::InstanceSettingsSP new_settings_sp (new TargetInstanceSettings (GetSettingsController(),
2071                                                                           false,
2072                                                                           instance_name));
2073     return new_settings_sp;
2074 }
2075 
2076 
2077 #define TSC_DEFAULT_ARCH        "default-arch"
2078 #define TSC_EXPR_PREFIX         "expr-prefix"
2079 #define TSC_PREFER_DYNAMIC      "prefer-dynamic-value"
2080 #define TSC_ENABLE_SYNTHETIC    "enable-synthetic-value"
2081 #define TSC_SKIP_PROLOGUE       "skip-prologue"
2082 #define TSC_SOURCE_MAP          "source-map"
2083 #define TSC_EXE_SEARCH_PATHS    "exec-search-paths"
2084 #define TSC_MAX_CHILDREN        "max-children-count"
2085 #define TSC_MAX_STRLENSUMMARY   "max-string-summary-length"
2086 #define TSC_PLATFORM_AVOID      "breakpoints-use-platform-avoid-list"
2087 #define TSC_RUN_ARGS            "run-args"
2088 #define TSC_ENV_VARS            "env-vars"
2089 #define TSC_INHERIT_ENV         "inherit-env"
2090 #define TSC_STDIN_PATH          "input-path"
2091 #define TSC_STDOUT_PATH         "output-path"
2092 #define TSC_STDERR_PATH         "error-path"
2093 #define TSC_DISABLE_ASLR        "disable-aslr"
2094 #define TSC_DISABLE_STDIO       "disable-stdio"
2095 
2096 
2097 static const ConstString &
2098 GetSettingNameForDefaultArch ()
2099 {
2100     static ConstString g_const_string (TSC_DEFAULT_ARCH);
2101     return g_const_string;
2102 }
2103 
2104 static const ConstString &
2105 GetSettingNameForExpressionPrefix ()
2106 {
2107     static ConstString g_const_string (TSC_EXPR_PREFIX);
2108     return g_const_string;
2109 }
2110 
2111 static const ConstString &
2112 GetSettingNameForPreferDynamicValue ()
2113 {
2114     static ConstString g_const_string (TSC_PREFER_DYNAMIC);
2115     return g_const_string;
2116 }
2117 
2118 static const ConstString &
2119 GetSettingNameForEnableSyntheticValue ()
2120 {
2121     static ConstString g_const_string (TSC_ENABLE_SYNTHETIC);
2122     return g_const_string;
2123 }
2124 
2125 static const ConstString &
2126 GetSettingNameForSourcePathMap ()
2127 {
2128     static ConstString g_const_string (TSC_SOURCE_MAP);
2129     return g_const_string;
2130 }
2131 
2132 static const ConstString &
2133 GetSettingNameForExecutableSearchPaths ()
2134 {
2135     static ConstString g_const_string (TSC_EXE_SEARCH_PATHS);
2136     return g_const_string;
2137 }
2138 
2139 static const ConstString &
2140 GetSettingNameForSkipPrologue ()
2141 {
2142     static ConstString g_const_string (TSC_SKIP_PROLOGUE);
2143     return g_const_string;
2144 }
2145 
2146 static const ConstString &
2147 GetSettingNameForMaxChildren ()
2148 {
2149     static ConstString g_const_string (TSC_MAX_CHILDREN);
2150     return g_const_string;
2151 }
2152 
2153 static const ConstString &
2154 GetSettingNameForMaxStringSummaryLength ()
2155 {
2156     static ConstString g_const_string (TSC_MAX_STRLENSUMMARY);
2157     return g_const_string;
2158 }
2159 
2160 static const ConstString &
2161 GetSettingNameForPlatformAvoid ()
2162 {
2163     static ConstString g_const_string (TSC_PLATFORM_AVOID);
2164     return g_const_string;
2165 }
2166 
2167 const ConstString &
2168 GetSettingNameForRunArgs ()
2169 {
2170     static ConstString g_const_string (TSC_RUN_ARGS);
2171     return g_const_string;
2172 }
2173 
2174 const ConstString &
2175 GetSettingNameForEnvVars ()
2176 {
2177     static ConstString g_const_string (TSC_ENV_VARS);
2178     return g_const_string;
2179 }
2180 
2181 const ConstString &
2182 GetSettingNameForInheritHostEnv ()
2183 {
2184     static ConstString g_const_string (TSC_INHERIT_ENV);
2185     return g_const_string;
2186 }
2187 
2188 const ConstString &
2189 GetSettingNameForInputPath ()
2190 {
2191     static ConstString g_const_string (TSC_STDIN_PATH);
2192     return g_const_string;
2193 }
2194 
2195 const ConstString &
2196 GetSettingNameForOutputPath ()
2197 {
2198     static ConstString g_const_string (TSC_STDOUT_PATH);
2199     return g_const_string;
2200 }
2201 
2202 const ConstString &
2203 GetSettingNameForErrorPath ()
2204 {
2205     static ConstString g_const_string (TSC_STDERR_PATH);
2206     return g_const_string;
2207 }
2208 
2209 const ConstString &
2210 GetSettingNameForDisableASLR ()
2211 {
2212     static ConstString g_const_string (TSC_DISABLE_ASLR);
2213     return g_const_string;
2214 }
2215 
2216 const ConstString &
2217 GetSettingNameForDisableSTDIO ()
2218 {
2219     static ConstString g_const_string (TSC_DISABLE_STDIO);
2220     return g_const_string;
2221 }
2222 
2223 bool
2224 Target::SettingsController::SetGlobalVariable (const ConstString &var_name,
2225                                                const char *index_value,
2226                                                const char *value,
2227                                                const SettingEntry &entry,
2228                                                const VarSetOperationType op,
2229                                                Error&err)
2230 {
2231     if (var_name == GetSettingNameForDefaultArch())
2232     {
2233         m_default_architecture.SetTriple (value, NULL);
2234         if (!m_default_architecture.IsValid())
2235             err.SetErrorStringWithFormat ("'%s' is not a valid architecture or triple.", value);
2236     }
2237     return true;
2238 }
2239 
2240 
2241 bool
2242 Target::SettingsController::GetGlobalVariable (const ConstString &var_name,
2243                                                StringList &value,
2244                                                Error &err)
2245 {
2246     if (var_name == GetSettingNameForDefaultArch())
2247     {
2248         // If the arch is invalid (the default), don't show a string for it
2249         if (m_default_architecture.IsValid())
2250             value.AppendString (m_default_architecture.GetArchitectureName());
2251         return true;
2252     }
2253     else
2254         err.SetErrorStringWithFormat ("unrecognized variable name '%s'", var_name.AsCString());
2255 
2256     return false;
2257 }
2258 
2259 //--------------------------------------------------------------
2260 // class TargetInstanceSettings
2261 //--------------------------------------------------------------
2262 
2263 TargetInstanceSettings::TargetInstanceSettings
2264 (
2265     const lldb::UserSettingsControllerSP &owner_sp,
2266     bool live_instance,
2267     const char *name
2268 ) :
2269     InstanceSettings (owner_sp, name ? name : InstanceSettings::InvalidName().AsCString(), live_instance),
2270     m_expr_prefix_file (),
2271     m_expr_prefix_contents (),
2272     m_prefer_dynamic_value (2),
2273     m_enable_synthetic_value(true, true),
2274     m_skip_prologue (true, true),
2275     m_source_map (NULL, NULL),
2276     m_exe_search_paths (),
2277     m_max_children_display(256),
2278     m_max_strlen_length(1024),
2279     m_breakpoints_use_platform_avoid (true, true),
2280     m_run_args (),
2281     m_env_vars (),
2282     m_input_path (),
2283     m_output_path (),
2284     m_error_path (),
2285     m_disable_aslr (true),
2286     m_disable_stdio (false),
2287     m_inherit_host_env (true),
2288     m_got_host_env (false)
2289 {
2290     // CopyInstanceSettings is a pure virtual function in InstanceSettings; it therefore cannot be called
2291     // until the vtables for TargetInstanceSettings are properly set up, i.e. AFTER all the initializers.
2292     // For this reason it has to be called here, rather than in the initializer or in the parent constructor.
2293     // This is true for CreateInstanceName() too.
2294 
2295     if (GetInstanceName () == InstanceSettings::InvalidName())
2296     {
2297         ChangeInstanceName (std::string (CreateInstanceName().AsCString()));
2298         owner_sp->RegisterInstanceSettings (this);
2299     }
2300 
2301     if (live_instance)
2302     {
2303         const lldb::InstanceSettingsSP &pending_settings = owner_sp->FindPendingSettings (m_instance_name);
2304         CopyInstanceSettings (pending_settings,false);
2305     }
2306 }
2307 
2308 TargetInstanceSettings::TargetInstanceSettings (const TargetInstanceSettings &rhs) :
2309     InstanceSettings (Target::GetSettingsController(), CreateInstanceName().AsCString()),
2310     m_expr_prefix_file (rhs.m_expr_prefix_file),
2311     m_expr_prefix_contents (rhs.m_expr_prefix_contents),
2312     m_prefer_dynamic_value (rhs.m_prefer_dynamic_value),
2313     m_enable_synthetic_value(rhs.m_enable_synthetic_value),
2314     m_skip_prologue (rhs.m_skip_prologue),
2315     m_source_map (rhs.m_source_map),
2316     m_exe_search_paths (rhs.m_exe_search_paths),
2317     m_max_children_display (rhs.m_max_children_display),
2318     m_max_strlen_length (rhs.m_max_strlen_length),
2319     m_breakpoints_use_platform_avoid (rhs.m_breakpoints_use_platform_avoid),
2320     m_run_args (rhs.m_run_args),
2321     m_env_vars (rhs.m_env_vars),
2322     m_input_path (rhs.m_input_path),
2323     m_output_path (rhs.m_output_path),
2324     m_error_path (rhs.m_error_path),
2325     m_disable_aslr (rhs.m_disable_aslr),
2326     m_disable_stdio (rhs.m_disable_stdio),
2327     m_inherit_host_env (rhs.m_inherit_host_env)
2328 {
2329     if (m_instance_name != InstanceSettings::GetDefaultName())
2330     {
2331         UserSettingsControllerSP owner_sp (m_owner_wp.lock());
2332         if (owner_sp)
2333             CopyInstanceSettings (owner_sp->FindPendingSettings (m_instance_name),false);
2334     }
2335 }
2336 
2337 TargetInstanceSettings::~TargetInstanceSettings ()
2338 {
2339 }
2340 
2341 TargetInstanceSettings&
2342 TargetInstanceSettings::operator= (const TargetInstanceSettings &rhs)
2343 {
2344     if (this != &rhs)
2345     {
2346         m_expr_prefix_file = rhs.m_expr_prefix_file;
2347         m_expr_prefix_contents = rhs.m_expr_prefix_contents;
2348         m_prefer_dynamic_value = rhs.m_prefer_dynamic_value;
2349         m_enable_synthetic_value = rhs.m_enable_synthetic_value;
2350         m_skip_prologue = rhs.m_skip_prologue;
2351         m_source_map = rhs.m_source_map;
2352         m_exe_search_paths = rhs.m_exe_search_paths;
2353         m_max_children_display = rhs.m_max_children_display;
2354         m_max_strlen_length = rhs.m_max_strlen_length;
2355         m_breakpoints_use_platform_avoid = rhs.m_breakpoints_use_platform_avoid;
2356         m_run_args = rhs.m_run_args;
2357         m_env_vars = rhs.m_env_vars;
2358         m_input_path = rhs.m_input_path;
2359         m_output_path = rhs.m_output_path;
2360         m_error_path = rhs.m_error_path;
2361         m_disable_aslr = rhs.m_disable_aslr;
2362         m_disable_stdio = rhs.m_disable_stdio;
2363         m_inherit_host_env = rhs.m_inherit_host_env;
2364     }
2365 
2366     return *this;
2367 }
2368 
2369 void
2370 TargetInstanceSettings::UpdateInstanceSettingsVariable (const ConstString &var_name,
2371                                                         const char *index_value,
2372                                                         const char *value,
2373                                                         const ConstString &instance_name,
2374                                                         const SettingEntry &entry,
2375                                                         VarSetOperationType op,
2376                                                         Error &err,
2377                                                         bool pending)
2378 {
2379     if (var_name == GetSettingNameForExpressionPrefix ())
2380     {
2381         err = UserSettingsController::UpdateFileSpecOptionValue (value, op, m_expr_prefix_file);
2382         if (err.Success())
2383         {
2384             switch (op)
2385             {
2386             default:
2387                 break;
2388             case eVarSetOperationAssign:
2389             case eVarSetOperationAppend:
2390                 {
2391                     m_expr_prefix_contents.clear();
2392 
2393                     if (!m_expr_prefix_file.GetCurrentValue().Exists())
2394                     {
2395                         err.SetErrorToGenericError ();
2396                         err.SetErrorStringWithFormat ("%s does not exist", value);
2397                         return;
2398                     }
2399 
2400                     DataBufferSP file_data_sp (m_expr_prefix_file.GetCurrentValue().ReadFileContents(0, SIZE_MAX, &err));
2401 
2402                     if (err.Success())
2403                     {
2404                         if (file_data_sp && file_data_sp->GetByteSize() > 0)
2405                         {
2406                             m_expr_prefix_contents.assign((const char*)file_data_sp->GetBytes(), file_data_sp->GetByteSize());
2407                         }
2408                         else
2409                         {
2410                             err.SetErrorStringWithFormat ("couldn't read data from '%s'", value);
2411                         }
2412                     }
2413                 }
2414                 break;
2415             case eVarSetOperationClear:
2416                 m_expr_prefix_contents.clear();
2417             }
2418         }
2419     }
2420     else if (var_name == GetSettingNameForPreferDynamicValue())
2421     {
2422         int new_value;
2423         UserSettingsController::UpdateEnumVariable (g_dynamic_value_types, &new_value, value, err);
2424         if (err.Success())
2425             m_prefer_dynamic_value = new_value;
2426     }
2427     else if (var_name == GetSettingNameForEnableSyntheticValue())
2428     {
2429         bool ok;
2430         bool new_value = Args::StringToBoolean(value, true, &ok);
2431         if (ok)
2432             m_enable_synthetic_value.SetCurrentValue(new_value);
2433     }
2434     else if (var_name == GetSettingNameForSkipPrologue())
2435     {
2436         err = UserSettingsController::UpdateBooleanOptionValue (value, op, m_skip_prologue);
2437     }
2438     else if (var_name == GetSettingNameForMaxChildren())
2439     {
2440         bool ok;
2441         uint32_t new_value = Args::StringToUInt32(value, 0, 10, &ok);
2442         if (ok)
2443             m_max_children_display = new_value;
2444     }
2445     else if (var_name == GetSettingNameForMaxStringSummaryLength())
2446     {
2447         bool ok;
2448         uint32_t new_value = Args::StringToUInt32(value, 0, 10, &ok);
2449         if (ok)
2450             m_max_strlen_length = new_value;
2451     }
2452     else if (var_name == GetSettingNameForExecutableSearchPaths())
2453     {
2454         switch (op)
2455         {
2456             case eVarSetOperationReplace:
2457             case eVarSetOperationInsertBefore:
2458             case eVarSetOperationInsertAfter:
2459             case eVarSetOperationRemove:
2460             default:
2461                 break;
2462             case eVarSetOperationAssign:
2463                 m_exe_search_paths.Clear();
2464                 // Fall through to append....
2465             case eVarSetOperationAppend:
2466             {
2467                 Args args(value);
2468                 const uint32_t argc = args.GetArgumentCount();
2469                 if (argc > 0)
2470                 {
2471                     const char *exe_search_path_dir;
2472                     for (uint32_t idx = 0; (exe_search_path_dir = args.GetArgumentAtIndex(idx)) != NULL; ++idx)
2473                     {
2474                         FileSpec file_spec;
2475                         file_spec.GetDirectory().SetCString(exe_search_path_dir);
2476                         FileSpec::FileType file_type = file_spec.GetFileType();
2477                         if (file_type == FileSpec::eFileTypeDirectory || file_type == FileSpec::eFileTypeInvalid)
2478                         {
2479                             m_exe_search_paths.Append(file_spec);
2480                         }
2481                         else
2482                         {
2483                             err.SetErrorStringWithFormat("executable search path '%s' exists, but it does not resolve to a directory", exe_search_path_dir);
2484                         }
2485                     }
2486                 }
2487             }
2488                 break;
2489 
2490             case eVarSetOperationClear:
2491                 m_exe_search_paths.Clear();
2492                 break;
2493         }
2494     }
2495     else if (var_name == GetSettingNameForSourcePathMap ())
2496     {
2497         switch (op)
2498         {
2499             case eVarSetOperationReplace:
2500             case eVarSetOperationInsertBefore:
2501             case eVarSetOperationInsertAfter:
2502             case eVarSetOperationRemove:
2503             default:
2504                 break;
2505             case eVarSetOperationAssign:
2506                 m_source_map.Clear(true);
2507                 // Fall through to append....
2508             case eVarSetOperationAppend:
2509                 {
2510                     Args args(value);
2511                     const uint32_t argc = args.GetArgumentCount();
2512                     if (argc & 1 || argc == 0)
2513                     {
2514                         err.SetErrorStringWithFormat ("an even number of paths must be supplied to to the source-map setting: %u arguments given", argc);
2515                     }
2516                     else
2517                     {
2518                         char resolved_new_path[PATH_MAX];
2519                         FileSpec file_spec;
2520                         const char *old_path;
2521                         for (uint32_t idx = 0; (old_path = args.GetArgumentAtIndex(idx)) != NULL; idx += 2)
2522                         {
2523                             const char *new_path = args.GetArgumentAtIndex(idx+1);
2524                             assert (new_path); // We have an even number of paths, this shouldn't happen!
2525 
2526                             file_spec.SetFile(new_path, true);
2527                             if (file_spec.Exists())
2528                             {
2529                                 if (file_spec.GetPath (resolved_new_path, sizeof(resolved_new_path)) >= sizeof(resolved_new_path))
2530                                 {
2531                                     err.SetErrorStringWithFormat("new path '%s' is too long", new_path);
2532                                     return;
2533                                 }
2534                             }
2535                             else
2536                             {
2537                                 err.SetErrorStringWithFormat("new path '%s' doesn't exist", new_path);
2538                                 return;
2539                             }
2540                             m_source_map.Append(ConstString (old_path), ConstString (resolved_new_path), true);
2541                         }
2542                     }
2543                 }
2544                 break;
2545 
2546             case eVarSetOperationClear:
2547                 m_source_map.Clear(true);
2548                 break;
2549         }
2550     }
2551     else if (var_name == GetSettingNameForPlatformAvoid ())
2552     {
2553         err = UserSettingsController::UpdateBooleanOptionValue (value, op, m_breakpoints_use_platform_avoid);
2554     }
2555     else if (var_name == GetSettingNameForRunArgs())
2556     {
2557         UserSettingsController::UpdateStringArrayVariable (op, index_value, m_run_args, value, err);
2558     }
2559     else if (var_name == GetSettingNameForEnvVars())
2560     {
2561         // This is nice for local debugging, but it is isn't correct for
2562         // remote debugging. We need to stop process.env-vars from being
2563         // populated with the host environment and add this as a launch option
2564         // and get the correct environment from the Target's platform.
2565         // GetHostEnvironmentIfNeeded ();
2566         UserSettingsController::UpdateDictionaryVariable (op, index_value, m_env_vars, value, err);
2567     }
2568     else if (var_name == GetSettingNameForInputPath())
2569     {
2570         UserSettingsController::UpdateStringVariable (op, m_input_path, value, err);
2571     }
2572     else if (var_name == GetSettingNameForOutputPath())
2573     {
2574         UserSettingsController::UpdateStringVariable (op, m_output_path, value, err);
2575     }
2576     else if (var_name == GetSettingNameForErrorPath())
2577     {
2578         UserSettingsController::UpdateStringVariable (op, m_error_path, value, err);
2579     }
2580     else if (var_name == GetSettingNameForDisableASLR())
2581     {
2582         UserSettingsController::UpdateBooleanVariable (op, m_disable_aslr, value, true, err);
2583     }
2584     else if (var_name == GetSettingNameForDisableSTDIO ())
2585     {
2586         UserSettingsController::UpdateBooleanVariable (op, m_disable_stdio, value, false, err);
2587     }
2588 }
2589 
2590 void
2591 TargetInstanceSettings::CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, bool pending)
2592 {
2593     TargetInstanceSettings *new_settings_ptr = static_cast <TargetInstanceSettings *> (new_settings.get());
2594 
2595     if (!new_settings_ptr)
2596         return;
2597 
2598     *this = *new_settings_ptr;
2599 }
2600 
2601 bool
2602 TargetInstanceSettings::GetInstanceSettingsValue (const SettingEntry &entry,
2603                                                   const ConstString &var_name,
2604                                                   StringList &value,
2605                                                   Error *err)
2606 {
2607     if (var_name == GetSettingNameForExpressionPrefix ())
2608     {
2609         char path[PATH_MAX];
2610         const size_t path_len = m_expr_prefix_file.GetCurrentValue().GetPath (path, sizeof(path));
2611         if (path_len > 0)
2612             value.AppendString (path, path_len);
2613     }
2614     else if (var_name == GetSettingNameForPreferDynamicValue())
2615     {
2616         value.AppendString (g_dynamic_value_types[m_prefer_dynamic_value].string_value);
2617     }
2618     else if (var_name == GetSettingNameForEnableSyntheticValue())
2619     {
2620         if (m_skip_prologue)
2621             value.AppendString ("true");
2622         else
2623             value.AppendString ("false");
2624     }
2625     else if (var_name == GetSettingNameForSkipPrologue())
2626     {
2627         if (m_skip_prologue)
2628             value.AppendString ("true");
2629         else
2630             value.AppendString ("false");
2631     }
2632     else if (var_name == GetSettingNameForExecutableSearchPaths())
2633     {
2634         if (m_exe_search_paths.GetSize())
2635         {
2636             for (size_t i = 0, n = m_exe_search_paths.GetSize(); i < n; ++i)
2637             {
2638                 value.AppendString(m_exe_search_paths.GetFileSpecAtIndex (i).GetDirectory().AsCString());
2639             }
2640         }
2641     }
2642     else if (var_name == GetSettingNameForSourcePathMap ())
2643     {
2644         if (m_source_map.GetSize())
2645         {
2646             size_t i;
2647             for (i = 0; i < m_source_map.GetSize(); ++i) {
2648                 StreamString sstr;
2649                 m_source_map.Dump(&sstr, i);
2650                 value.AppendString(sstr.GetData());
2651             }
2652         }
2653     }
2654     else if (var_name == GetSettingNameForMaxChildren())
2655     {
2656         StreamString count_str;
2657         count_str.Printf ("%d", m_max_children_display);
2658         value.AppendString (count_str.GetData());
2659     }
2660     else if (var_name == GetSettingNameForMaxStringSummaryLength())
2661     {
2662         StreamString count_str;
2663         count_str.Printf ("%d", m_max_strlen_length);
2664         value.AppendString (count_str.GetData());
2665     }
2666     else if (var_name == GetSettingNameForPlatformAvoid())
2667     {
2668         if (m_breakpoints_use_platform_avoid)
2669             value.AppendString ("true");
2670         else
2671             value.AppendString ("false");
2672     }
2673     else if (var_name == GetSettingNameForRunArgs())
2674     {
2675         if (m_run_args.GetArgumentCount() > 0)
2676         {
2677             for (int i = 0; i < m_run_args.GetArgumentCount(); ++i)
2678                 value.AppendString (m_run_args.GetArgumentAtIndex (i));
2679         }
2680     }
2681     else if (var_name == GetSettingNameForEnvVars())
2682     {
2683         GetHostEnvironmentIfNeeded ();
2684 
2685         if (m_env_vars.size() > 0)
2686         {
2687             std::map<std::string, std::string>::iterator pos;
2688             for (pos = m_env_vars.begin(); pos != m_env_vars.end(); ++pos)
2689             {
2690                 StreamString value_str;
2691                 value_str.Printf ("%s=%s", pos->first.c_str(), pos->second.c_str());
2692                 value.AppendString (value_str.GetData());
2693             }
2694         }
2695     }
2696     else if (var_name == GetSettingNameForInputPath())
2697     {
2698         value.AppendString (m_input_path.c_str());
2699     }
2700     else if (var_name == GetSettingNameForOutputPath())
2701     {
2702         value.AppendString (m_output_path.c_str());
2703     }
2704     else if (var_name == GetSettingNameForErrorPath())
2705     {
2706         value.AppendString (m_error_path.c_str());
2707     }
2708     else if (var_name == GetSettingNameForInheritHostEnv())
2709     {
2710         if (m_inherit_host_env)
2711             value.AppendString ("true");
2712         else
2713             value.AppendString ("false");
2714     }
2715     else if (var_name == GetSettingNameForDisableASLR())
2716     {
2717         if (m_disable_aslr)
2718             value.AppendString ("true");
2719         else
2720             value.AppendString ("false");
2721     }
2722     else if (var_name == GetSettingNameForDisableSTDIO())
2723     {
2724         if (m_disable_stdio)
2725             value.AppendString ("true");
2726         else
2727             value.AppendString ("false");
2728     }
2729     else
2730     {
2731         if (err)
2732             err->SetErrorStringWithFormat ("unrecognized variable name '%s'", var_name.AsCString());
2733         return false;
2734     }
2735     return true;
2736 }
2737 
2738 void
2739 Target::TargetInstanceSettings::GetHostEnvironmentIfNeeded ()
2740 {
2741     if (m_inherit_host_env && !m_got_host_env)
2742     {
2743         m_got_host_env = true;
2744         StringList host_env;
2745         const size_t host_env_count = Host::GetEnvironment (host_env);
2746         for (size_t idx=0; idx<host_env_count; idx++)
2747         {
2748             const char *env_entry = host_env.GetStringAtIndex (idx);
2749             if (env_entry)
2750             {
2751                 const char *equal_pos = ::strchr(env_entry, '=');
2752                 if (equal_pos)
2753                 {
2754                     std::string key (env_entry, equal_pos - env_entry);
2755                     std::string value (equal_pos + 1);
2756                     if (m_env_vars.find (key) == m_env_vars.end())
2757                         m_env_vars[key] = value;
2758                 }
2759             }
2760         }
2761     }
2762 }
2763 
2764 
2765 size_t
2766 Target::TargetInstanceSettings::GetEnvironmentAsArgs (Args &env)
2767 {
2768     GetHostEnvironmentIfNeeded ();
2769 
2770     dictionary::const_iterator pos, end = m_env_vars.end();
2771     for (pos = m_env_vars.begin(); pos != end; ++pos)
2772     {
2773         std::string env_var_equal_value (pos->first);
2774         env_var_equal_value.append(1, '=');
2775         env_var_equal_value.append (pos->second);
2776         env.AppendArgument (env_var_equal_value.c_str());
2777     }
2778     return env.GetArgumentCount();
2779 }
2780 
2781 
2782 const ConstString
2783 TargetInstanceSettings::CreateInstanceName ()
2784 {
2785     StreamString sstr;
2786     static int instance_count = 1;
2787 
2788     sstr.Printf ("target_%d", instance_count);
2789     ++instance_count;
2790 
2791     const ConstString ret_val (sstr.GetData());
2792     return ret_val;
2793 }
2794 
2795 //--------------------------------------------------
2796 // Target::SettingsController Variable Tables
2797 //--------------------------------------------------
2798 OptionEnumValueElement
2799 TargetInstanceSettings::g_dynamic_value_types[] =
2800 {
2801 { eNoDynamicValues,      "no-dynamic-values", "Don't calculate the dynamic type of values"},
2802 { eDynamicCanRunTarget,  "run-target",        "Calculate the dynamic type of values even if you have to run the target."},
2803 { eDynamicDontRunTarget, "no-run-target",     "Calculate the dynamic type of values, but don't run the target."},
2804 { 0, NULL, NULL }
2805 };
2806 
2807 SettingEntry
2808 Target::SettingsController::global_settings_table[] =
2809 {
2810     // var-name           var-type           default      enum  init'd hidden help-text
2811     // =================  ================== ===========  ====  ====== ====== =========================================================================
2812     { TSC_DEFAULT_ARCH  , eSetVarTypeString , NULL      , NULL, false, false, "Default architecture to choose, when there's a choice." },
2813     { NULL              , eSetVarTypeNone   , NULL      , NULL, false, false, NULL }
2814 };
2815 
2816 SettingEntry
2817 Target::SettingsController::instance_settings_table[] =
2818 {
2819     // var-name             var-type            default         enum                    init'd hidden help-text
2820     // =================    ==================  =============== ======================= ====== ====== =========================================================================
2821     { TSC_EXPR_PREFIX       , eSetVarTypeString , NULL          , NULL,                  false, false, "Path to a file containing expressions to be prepended to all expressions." },
2822     { TSC_PREFER_DYNAMIC    , eSetVarTypeEnum   , NULL          , g_dynamic_value_types, false, false, "Should printed values be shown as their dynamic value." },
2823     { TSC_ENABLE_SYNTHETIC  , eSetVarTypeBoolean, "true"        , NULL,                  false, false, "Should synthetic values be used by default whenever available." },
2824     { TSC_SKIP_PROLOGUE     , eSetVarTypeBoolean, "true"        , NULL,                  false, false, "Skip function prologues when setting breakpoints by name." },
2825     { TSC_SOURCE_MAP        , eSetVarTypeArray  , NULL          , NULL,                  false, false, "Source path remappings to use when locating source files from debug information." },
2826     { TSC_EXE_SEARCH_PATHS  , eSetVarTypeArray  , NULL          , NULL,                  false, false, "Executable search paths to use when locating executable files whose paths don't match the local file system." },
2827     { TSC_MAX_CHILDREN      , eSetVarTypeInt    , "256"         , NULL,                  true,  false, "Maximum number of children to expand in any level of depth." },
2828     { TSC_MAX_STRLENSUMMARY , eSetVarTypeInt    , "1024"        , NULL,                  true,  false, "Maximum number of characters to show when using %s in summary strings." },
2829     { TSC_PLATFORM_AVOID    , eSetVarTypeBoolean, "true"        , NULL,                  false, false, "Consult the platform module avoid list when setting non-module specific breakpoints." },
2830     { TSC_RUN_ARGS          , eSetVarTypeArray  , NULL          , NULL,                  false,  false,  "A list containing all the arguments to be passed to the executable when it is run." },
2831     { TSC_ENV_VARS          , eSetVarTypeDictionary, NULL       , NULL,                  false,  false,  "A list of all the environment variables to be passed to the executable's environment, and their values." },
2832     { TSC_INHERIT_ENV       , eSetVarTypeBoolean, "true"        , NULL,                  false,  false,  "Inherit the environment from the process that is running LLDB." },
2833     { TSC_STDIN_PATH        , eSetVarTypeString , NULL          , NULL,                  false,  false,  "The file/path to be used by the executable program for reading its standard input." },
2834     { TSC_STDOUT_PATH       , eSetVarTypeString , NULL          , NULL,                  false,  false,  "The file/path to be used by the executable program for writing its standard output." },
2835     { TSC_STDERR_PATH       , eSetVarTypeString , NULL          , NULL,                  false,  false,  "The file/path to be used by the executable program for writing its standard error." },
2836 //    { "plugin",         eSetVarTypeEnum,        NULL,           NULL,                  false,  false,  "The plugin to be used to run the process." },
2837     { TSC_DISABLE_ASLR      , eSetVarTypeBoolean, "true"        , NULL,                  false,  false,  "Disable Address Space Layout Randomization (ASLR)" },
2838     { TSC_DISABLE_STDIO     , eSetVarTypeBoolean, "false"       , NULL,                  false,  false,  "Disable stdin/stdout for process (e.g. for a GUI application)" },
2839     { NULL                  , eSetVarTypeNone   , NULL          , NULL,                  false, false, NULL }
2840 };
2841 
2842 const ConstString &
2843 Target::TargetEventData::GetFlavorString ()
2844 {
2845     static ConstString g_flavor ("Target::TargetEventData");
2846     return g_flavor;
2847 }
2848 
2849 const ConstString &
2850 Target::TargetEventData::GetFlavor () const
2851 {
2852     return TargetEventData::GetFlavorString ();
2853 }
2854 
2855 Target::TargetEventData::TargetEventData (const lldb::TargetSP &new_target_sp) :
2856     EventData(),
2857     m_target_sp (new_target_sp)
2858 {
2859 }
2860 
2861 Target::TargetEventData::~TargetEventData()
2862 {
2863 
2864 }
2865 
2866 void
2867 Target::TargetEventData::Dump (Stream *s) const
2868 {
2869 
2870 }
2871 
2872 const TargetSP
2873 Target::TargetEventData::GetTargetFromEvent (const lldb::EventSP &event_sp)
2874 {
2875     TargetSP target_sp;
2876 
2877     const TargetEventData *data = GetEventDataFromEvent (event_sp.get());
2878     if (data)
2879         target_sp = data->m_target_sp;
2880 
2881     return target_sp;
2882 }
2883 
2884 const Target::TargetEventData *
2885 Target::TargetEventData::GetEventDataFromEvent (const Event *event_ptr)
2886 {
2887     if (event_ptr)
2888     {
2889         const EventData *event_data = event_ptr->GetData();
2890         if (event_data && event_data->GetFlavor() == TargetEventData::GetFlavorString())
2891             return static_cast <const TargetEventData *> (event_ptr->GetData());
2892     }
2893     return NULL;
2894 }
2895 
2896