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         ModuleSP module_sp (section_sp->GetModule());
1068         if (module_sp)
1069         {
1070             ObjectFile *objfile = section_sp->GetModule()->GetObjectFile();
1071             if (objfile)
1072             {
1073                 size_t bytes_read = objfile->ReadSectionData (section_sp.get(),
1074                                                               addr.GetOffset(),
1075                                                               dst,
1076                                                               dst_len);
1077                 if (bytes_read > 0)
1078                     return bytes_read;
1079                 else
1080                     error.SetErrorStringWithFormat("error reading data from section %s", section_sp->GetName().GetCString());
1081             }
1082             else
1083                 error.SetErrorString("address isn't from a object file");
1084         }
1085         else
1086             error.SetErrorString("address isn't in a module");
1087     }
1088     else
1089         error.SetErrorString("address doesn't contain a section that points to a section in a object file");
1090 
1091     return 0;
1092 }
1093 
1094 size_t
1095 Target::ReadMemory (const Address& addr,
1096                     bool prefer_file_cache,
1097                     void *dst,
1098                     size_t dst_len,
1099                     Error &error,
1100                     lldb::addr_t *load_addr_ptr)
1101 {
1102     error.Clear();
1103 
1104     // if we end up reading this from process memory, we will fill this
1105     // with the actual load address
1106     if (load_addr_ptr)
1107         *load_addr_ptr = LLDB_INVALID_ADDRESS;
1108 
1109     size_t bytes_read = 0;
1110 
1111     addr_t load_addr = LLDB_INVALID_ADDRESS;
1112     addr_t file_addr = LLDB_INVALID_ADDRESS;
1113     Address resolved_addr;
1114     if (!addr.IsSectionOffset())
1115     {
1116         if (m_section_load_list.IsEmpty())
1117         {
1118             // No sections are loaded, so we must assume we are not running
1119             // yet and anything we are given is a file address.
1120             file_addr = addr.GetOffset(); // "addr" doesn't have a section, so its offset is the file address
1121             m_images.ResolveFileAddress (file_addr, resolved_addr);
1122         }
1123         else
1124         {
1125             // We have at least one section loaded. This can be becuase
1126             // we have manually loaded some sections with "target modules load ..."
1127             // or because we have have a live process that has sections loaded
1128             // through the dynamic loader
1129             load_addr = addr.GetOffset(); // "addr" doesn't have a section, so its offset is the load address
1130             m_section_load_list.ResolveLoadAddress (load_addr, resolved_addr);
1131         }
1132     }
1133     if (!resolved_addr.IsValid())
1134         resolved_addr = addr;
1135 
1136 
1137     if (prefer_file_cache)
1138     {
1139         bytes_read = ReadMemoryFromFileCache (resolved_addr, dst, dst_len, error);
1140         if (bytes_read > 0)
1141             return bytes_read;
1142     }
1143 
1144     if (ProcessIsValid())
1145     {
1146         if (load_addr == LLDB_INVALID_ADDRESS)
1147             load_addr = resolved_addr.GetLoadAddress (this);
1148 
1149         if (load_addr == LLDB_INVALID_ADDRESS)
1150         {
1151             ModuleSP addr_module_sp (resolved_addr.GetModule());
1152             if (addr_module_sp && addr_module_sp->GetFileSpec())
1153                 error.SetErrorStringWithFormat("%s[0x%llx] can't be resolved, %s in not currently loaded",
1154                                                addr_module_sp->GetFileSpec().GetFilename().AsCString(),
1155                                                resolved_addr.GetFileAddress(),
1156                                                addr_module_sp->GetFileSpec().GetFilename().AsCString());
1157             else
1158                 error.SetErrorStringWithFormat("0x%llx can't be resolved", resolved_addr.GetFileAddress());
1159         }
1160         else
1161         {
1162             bytes_read = m_process_sp->ReadMemory(load_addr, dst, dst_len, error);
1163             if (bytes_read != dst_len)
1164             {
1165                 if (error.Success())
1166                 {
1167                     if (bytes_read == 0)
1168                         error.SetErrorStringWithFormat("read memory from 0x%llx failed", load_addr);
1169                     else
1170                         error.SetErrorStringWithFormat("only %zu of %zu bytes were read from memory at 0x%llx", bytes_read, dst_len, load_addr);
1171                 }
1172             }
1173             if (bytes_read)
1174             {
1175                 if (load_addr_ptr)
1176                     *load_addr_ptr = load_addr;
1177                 return bytes_read;
1178             }
1179             // If the address is not section offset we have an address that
1180             // doesn't resolve to any address in any currently loaded shared
1181             // libaries and we failed to read memory so there isn't anything
1182             // more we can do. If it is section offset, we might be able to
1183             // read cached memory from the object file.
1184             if (!resolved_addr.IsSectionOffset())
1185                 return 0;
1186         }
1187     }
1188 
1189     if (!prefer_file_cache && resolved_addr.IsSectionOffset())
1190     {
1191         // If we didn't already try and read from the object file cache, then
1192         // try it after failing to read from the process.
1193         return ReadMemoryFromFileCache (resolved_addr, dst, dst_len, error);
1194     }
1195     return 0;
1196 }
1197 
1198 size_t
1199 Target::ReadScalarIntegerFromMemory (const Address& addr,
1200                                      bool prefer_file_cache,
1201                                      uint32_t byte_size,
1202                                      bool is_signed,
1203                                      Scalar &scalar,
1204                                      Error &error)
1205 {
1206     uint64_t uval;
1207 
1208     if (byte_size <= sizeof(uval))
1209     {
1210         size_t bytes_read = ReadMemory (addr, prefer_file_cache, &uval, byte_size, error);
1211         if (bytes_read == byte_size)
1212         {
1213             DataExtractor data (&uval, sizeof(uval), m_arch.GetByteOrder(), m_arch.GetAddressByteSize());
1214             uint32_t offset = 0;
1215             if (byte_size <= 4)
1216                 scalar = data.GetMaxU32 (&offset, byte_size);
1217             else
1218                 scalar = data.GetMaxU64 (&offset, byte_size);
1219 
1220             if (is_signed)
1221                 scalar.SignExtend(byte_size * 8);
1222             return bytes_read;
1223         }
1224     }
1225     else
1226     {
1227         error.SetErrorStringWithFormat ("byte size of %u is too large for integer scalar type", byte_size);
1228     }
1229     return 0;
1230 }
1231 
1232 uint64_t
1233 Target::ReadUnsignedIntegerFromMemory (const Address& addr,
1234                                        bool prefer_file_cache,
1235                                        size_t integer_byte_size,
1236                                        uint64_t fail_value,
1237                                        Error &error)
1238 {
1239     Scalar scalar;
1240     if (ReadScalarIntegerFromMemory (addr,
1241                                      prefer_file_cache,
1242                                      integer_byte_size,
1243                                      false,
1244                                      scalar,
1245                                      error))
1246         return scalar.ULongLong(fail_value);
1247     return fail_value;
1248 }
1249 
1250 bool
1251 Target::ReadPointerFromMemory (const Address& addr,
1252                                bool prefer_file_cache,
1253                                Error &error,
1254                                Address &pointer_addr)
1255 {
1256     Scalar scalar;
1257     if (ReadScalarIntegerFromMemory (addr,
1258                                      prefer_file_cache,
1259                                      m_arch.GetAddressByteSize(),
1260                                      false,
1261                                      scalar,
1262                                      error))
1263     {
1264         addr_t pointer_vm_addr = scalar.ULongLong(LLDB_INVALID_ADDRESS);
1265         if (pointer_vm_addr != LLDB_INVALID_ADDRESS)
1266         {
1267             if (m_section_load_list.IsEmpty())
1268             {
1269                 // No sections are loaded, so we must assume we are not running
1270                 // yet and anything we are given is a file address.
1271                 m_images.ResolveFileAddress (pointer_vm_addr, pointer_addr);
1272             }
1273             else
1274             {
1275                 // We have at least one section loaded. This can be becuase
1276                 // we have manually loaded some sections with "target modules load ..."
1277                 // or because we have have a live process that has sections loaded
1278                 // through the dynamic loader
1279                 m_section_load_list.ResolveLoadAddress (pointer_vm_addr, pointer_addr);
1280             }
1281             // We weren't able to resolve the pointer value, so just return
1282             // an address with no section
1283             if (!pointer_addr.IsValid())
1284                 pointer_addr.SetOffset (pointer_vm_addr);
1285             return true;
1286 
1287         }
1288     }
1289     return false;
1290 }
1291 
1292 ModuleSP
1293 Target::GetSharedModule (const ModuleSpec &module_spec, Error *error_ptr)
1294 {
1295     // Don't pass in the UUID so we can tell if we have a stale value in our list
1296     ModuleSP old_module_sp; // This will get filled in if we have a new version of the library
1297     bool did_create_module = false;
1298     ModuleSP module_sp;
1299 
1300     Error error;
1301 
1302     // If there are image search path entries, try to use them first to acquire a suitable image.
1303     if (m_image_search_paths.GetSize())
1304     {
1305         ModuleSpec transformed_spec (module_spec);
1306         if (m_image_search_paths.RemapPath (module_spec.GetFileSpec().GetDirectory(), transformed_spec.GetFileSpec().GetDirectory()))
1307         {
1308             transformed_spec.GetFileSpec().GetFilename() = module_spec.GetFileSpec().GetFilename();
1309             error = ModuleList::GetSharedModule (transformed_spec,
1310                                                  module_sp,
1311                                                  &GetExecutableSearchPaths(),
1312                                                  &old_module_sp,
1313                                                  &did_create_module);
1314         }
1315     }
1316 
1317     // The platform is responsible for finding and caching an appropriate
1318     // module in the shared module cache.
1319     if (m_platform_sp)
1320     {
1321         FileSpec platform_file_spec;
1322         error = m_platform_sp->GetSharedModule (module_spec,
1323                                                 module_sp,
1324                                                 &GetExecutableSearchPaths(),
1325                                                 &old_module_sp,
1326                                                 &did_create_module);
1327     }
1328     else
1329     {
1330         error.SetErrorString("no platform is currently set");
1331     }
1332 
1333     // If a module hasn't been found yet, use the unmodified path.
1334     if (module_sp)
1335     {
1336         m_images.Append (module_sp);
1337         if (did_create_module)
1338         {
1339             if (old_module_sp && m_images.GetIndexForModule (old_module_sp.get()) != LLDB_INVALID_INDEX32)
1340                 ModuleUpdated(old_module_sp, module_sp);
1341             else
1342                 ModuleAdded(module_sp);
1343         }
1344     }
1345     if (error_ptr)
1346         *error_ptr = error;
1347     return module_sp;
1348 }
1349 
1350 
1351 TargetSP
1352 Target::CalculateTarget ()
1353 {
1354     return shared_from_this();
1355 }
1356 
1357 ProcessSP
1358 Target::CalculateProcess ()
1359 {
1360     return ProcessSP();
1361 }
1362 
1363 ThreadSP
1364 Target::CalculateThread ()
1365 {
1366     return ThreadSP();
1367 }
1368 
1369 StackFrameSP
1370 Target::CalculateStackFrame ()
1371 {
1372     return StackFrameSP();
1373 }
1374 
1375 void
1376 Target::CalculateExecutionContext (ExecutionContext &exe_ctx)
1377 {
1378     exe_ctx.Clear();
1379     exe_ctx.SetTargetPtr(this);
1380 }
1381 
1382 PathMappingList &
1383 Target::GetImageSearchPathList ()
1384 {
1385     return m_image_search_paths;
1386 }
1387 
1388 void
1389 Target::ImageSearchPathsChanged
1390 (
1391     const PathMappingList &path_list,
1392     void *baton
1393 )
1394 {
1395     Target *target = (Target *)baton;
1396     ModuleSP exe_module_sp (target->GetExecutableModule());
1397     if (exe_module_sp)
1398     {
1399         target->m_images.Clear();
1400         target->SetExecutableModule (exe_module_sp, true);
1401     }
1402 }
1403 
1404 ClangASTContext *
1405 Target::GetScratchClangASTContext(bool create_on_demand)
1406 {
1407     // Now see if we know the target triple, and if so, create our scratch AST context:
1408     if (m_scratch_ast_context_ap.get() == NULL && m_arch.IsValid() && create_on_demand)
1409     {
1410         m_scratch_ast_context_ap.reset (new ClangASTContext(m_arch.GetTriple().str().c_str()));
1411         m_scratch_ast_source_ap.reset (new ClangASTSource(shared_from_this()));
1412         m_scratch_ast_source_ap->InstallASTContext(m_scratch_ast_context_ap->getASTContext());
1413         llvm::OwningPtr<clang::ExternalASTSource> proxy_ast_source(m_scratch_ast_source_ap->CreateProxy());
1414         m_scratch_ast_context_ap->SetExternalSource(proxy_ast_source);
1415     }
1416     return m_scratch_ast_context_ap.get();
1417 }
1418 
1419 ClangASTImporter *
1420 Target::GetClangASTImporter()
1421 {
1422     ClangASTImporter *ast_importer = m_ast_importer_ap.get();
1423 
1424     if (!ast_importer)
1425     {
1426         ast_importer = new ClangASTImporter();
1427         m_ast_importer_ap.reset(ast_importer);
1428     }
1429 
1430     return ast_importer;
1431 }
1432 
1433 void
1434 Target::SettingsInitialize ()
1435 {
1436     UserSettingsController::InitializeSettingsController (GetSettingsController(),
1437                                                           SettingsController::global_settings_table,
1438                                                           SettingsController::instance_settings_table);
1439 
1440     // Now call SettingsInitialize() on each 'child' setting of Target
1441     Process::SettingsInitialize ();
1442 }
1443 
1444 void
1445 Target::SettingsTerminate ()
1446 {
1447 
1448     // Must call SettingsTerminate() on each settings 'child' of Target, before terminating Target's Settings.
1449 
1450     Process::SettingsTerminate ();
1451 
1452     // Now terminate Target Settings.
1453 
1454     UserSettingsControllerSP &usc = GetSettingsController();
1455     UserSettingsController::FinalizeSettingsController (usc);
1456     usc.reset();
1457 }
1458 
1459 UserSettingsControllerSP &
1460 Target::GetSettingsController ()
1461 {
1462     static UserSettingsControllerSP g_settings_controller_sp;
1463     if (!g_settings_controller_sp)
1464     {
1465         g_settings_controller_sp.reset (new Target::SettingsController);
1466         // The first shared pointer to Target::SettingsController in
1467         // g_settings_controller_sp must be fully created above so that
1468         // the TargetInstanceSettings can use a weak_ptr to refer back
1469         // to the master setttings controller
1470         InstanceSettingsSP default_instance_settings_sp (new TargetInstanceSettings (g_settings_controller_sp,
1471                                                                                      false,
1472                                                                                      InstanceSettings::GetDefaultName().AsCString()));
1473         g_settings_controller_sp->SetDefaultInstanceSettings (default_instance_settings_sp);
1474     }
1475     return g_settings_controller_sp;
1476 }
1477 
1478 FileSpecList
1479 Target::GetDefaultExecutableSearchPaths ()
1480 {
1481     lldb::UserSettingsControllerSP settings_controller_sp (GetSettingsController());
1482     if (settings_controller_sp)
1483     {
1484         lldb::InstanceSettingsSP instance_settings_sp (settings_controller_sp->GetDefaultInstanceSettings ());
1485         if (instance_settings_sp)
1486             return static_cast<TargetInstanceSettings *>(instance_settings_sp.get())->GetExecutableSearchPaths ();
1487     }
1488     return FileSpecList();
1489 }
1490 
1491 
1492 ArchSpec
1493 Target::GetDefaultArchitecture ()
1494 {
1495     lldb::UserSettingsControllerSP settings_controller_sp (GetSettingsController());
1496 
1497     if (settings_controller_sp)
1498         return static_cast<Target::SettingsController *>(settings_controller_sp.get())->GetArchitecture ();
1499     return ArchSpec();
1500 }
1501 
1502 void
1503 Target::SetDefaultArchitecture (const ArchSpec& arch)
1504 {
1505     lldb::UserSettingsControllerSP settings_controller_sp (GetSettingsController());
1506 
1507     if (settings_controller_sp)
1508         static_cast<Target::SettingsController *>(settings_controller_sp.get())->GetArchitecture () = arch;
1509 }
1510 
1511 Target *
1512 Target::GetTargetFromContexts (const ExecutionContext *exe_ctx_ptr, const SymbolContext *sc_ptr)
1513 {
1514     // The target can either exist in the "process" of ExecutionContext, or in
1515     // the "target_sp" member of SymbolContext. This accessor helper function
1516     // will get the target from one of these locations.
1517 
1518     Target *target = NULL;
1519     if (sc_ptr != NULL)
1520         target = sc_ptr->target_sp.get();
1521     if (target == NULL && exe_ctx_ptr)
1522         target = exe_ctx_ptr->GetTargetPtr();
1523     return target;
1524 }
1525 
1526 
1527 void
1528 Target::UpdateInstanceName ()
1529 {
1530     StreamString sstr;
1531 
1532     Module *exe_module = GetExecutableModulePointer();
1533     if (exe_module)
1534     {
1535         sstr.Printf ("%s_%s",
1536                      exe_module->GetFileSpec().GetFilename().AsCString(),
1537                      exe_module->GetArchitecture().GetArchitectureName());
1538         GetSettingsController()->RenameInstanceSettings (GetInstanceName().AsCString(), sstr.GetData());
1539     }
1540 }
1541 
1542 const char *
1543 Target::GetExpressionPrefixContentsAsCString ()
1544 {
1545     if (!m_expr_prefix_contents.empty())
1546         return m_expr_prefix_contents.c_str();
1547     return NULL;
1548 }
1549 
1550 ExecutionResults
1551 Target::EvaluateExpression
1552 (
1553     const char *expr_cstr,
1554     StackFrame *frame,
1555     lldb_private::ExecutionPolicy execution_policy,
1556     bool coerce_to_id,
1557     bool unwind_on_error,
1558     bool keep_in_memory,
1559     lldb::DynamicValueType use_dynamic,
1560     lldb::ValueObjectSP &result_valobj_sp
1561 )
1562 {
1563     ExecutionResults execution_results = eExecutionSetupError;
1564 
1565     result_valobj_sp.reset();
1566 
1567     if (expr_cstr == NULL || expr_cstr[0] == '\0')
1568         return execution_results;
1569 
1570     // We shouldn't run stop hooks in expressions.
1571     // Be sure to reset this if you return anywhere within this function.
1572     bool old_suppress_value = m_suppress_stop_hooks;
1573     m_suppress_stop_hooks = true;
1574 
1575     ExecutionContext exe_ctx;
1576 
1577     const size_t expr_cstr_len = ::strlen (expr_cstr);
1578 
1579     if (frame)
1580     {
1581         frame->CalculateExecutionContext(exe_ctx);
1582         Error error;
1583         const uint32_t expr_path_options = StackFrame::eExpressionPathOptionCheckPtrVsMember |
1584                                            StackFrame::eExpressionPathOptionsNoFragileObjcIvar |
1585                                            StackFrame::eExpressionPathOptionsNoSyntheticChildren;
1586         lldb::VariableSP var_sp;
1587 
1588         // Make sure we don't have any things that we know a variable expression
1589         // won't be able to deal with before calling into it
1590         if (::strcspn (expr_cstr, "()+*&|!~<=/^%,?") == expr_cstr_len)
1591         {
1592             result_valobj_sp = frame->GetValueForVariableExpressionPath (expr_cstr,
1593                                                                          use_dynamic,
1594                                                                          expr_path_options,
1595                                                                          var_sp,
1596                                                                          error);
1597         }
1598     }
1599     else if (m_process_sp)
1600     {
1601         m_process_sp->CalculateExecutionContext(exe_ctx);
1602     }
1603     else
1604     {
1605         CalculateExecutionContext(exe_ctx);
1606     }
1607 
1608     if (result_valobj_sp)
1609     {
1610         execution_results = eExecutionCompleted;
1611         // We got a result from the frame variable expression path above...
1612         ConstString persistent_variable_name (m_persistent_variables.GetNextPersistentVariableName());
1613 
1614         lldb::ValueObjectSP const_valobj_sp;
1615 
1616         // Check in case our value is already a constant value
1617         if (result_valobj_sp->GetIsConstant())
1618         {
1619             const_valobj_sp = result_valobj_sp;
1620             const_valobj_sp->SetName (persistent_variable_name);
1621         }
1622         else
1623         {
1624             if (use_dynamic != lldb::eNoDynamicValues)
1625             {
1626                 ValueObjectSP dynamic_sp = result_valobj_sp->GetDynamicValue(use_dynamic);
1627                 if (dynamic_sp)
1628                     result_valobj_sp = dynamic_sp;
1629             }
1630 
1631             const_valobj_sp = result_valobj_sp->CreateConstantValue (persistent_variable_name);
1632         }
1633 
1634         lldb::ValueObjectSP live_valobj_sp = result_valobj_sp;
1635 
1636         result_valobj_sp = const_valobj_sp;
1637 
1638         ClangExpressionVariableSP clang_expr_variable_sp(m_persistent_variables.CreatePersistentVariable(result_valobj_sp));
1639         assert (clang_expr_variable_sp.get());
1640 
1641         // Set flags and live data as appropriate
1642 
1643         const Value &result_value = live_valobj_sp->GetValue();
1644 
1645         switch (result_value.GetValueType())
1646         {
1647         case Value::eValueTypeHostAddress:
1648         case Value::eValueTypeFileAddress:
1649             // we don't do anything with these for now
1650             break;
1651         case Value::eValueTypeScalar:
1652             clang_expr_variable_sp->m_flags |= ClangExpressionVariable::EVIsLLDBAllocated;
1653             clang_expr_variable_sp->m_flags |= ClangExpressionVariable::EVNeedsAllocation;
1654             break;
1655         case Value::eValueTypeLoadAddress:
1656             clang_expr_variable_sp->m_live_sp = live_valobj_sp;
1657             clang_expr_variable_sp->m_flags |= ClangExpressionVariable::EVIsProgramReference;
1658             break;
1659         }
1660     }
1661     else
1662     {
1663         // Make sure we aren't just trying to see the value of a persistent
1664         // variable (something like "$0")
1665         lldb::ClangExpressionVariableSP persistent_var_sp;
1666         // Only check for persistent variables the expression starts with a '$'
1667         if (expr_cstr[0] == '$')
1668             persistent_var_sp = m_persistent_variables.GetVariable (expr_cstr);
1669 
1670         if (persistent_var_sp)
1671         {
1672             result_valobj_sp = persistent_var_sp->GetValueObject ();
1673             execution_results = eExecutionCompleted;
1674         }
1675         else
1676         {
1677             const char *prefix = GetExpressionPrefixContentsAsCString();
1678 
1679             execution_results = ClangUserExpression::Evaluate (exe_ctx,
1680                                                                execution_policy,
1681                                                                lldb::eLanguageTypeUnknown,
1682                                                                coerce_to_id ? ClangUserExpression::eResultTypeId : ClangUserExpression::eResultTypeAny,
1683                                                                unwind_on_error,
1684                                                                expr_cstr,
1685                                                                prefix,
1686                                                                result_valobj_sp);
1687         }
1688     }
1689 
1690     m_suppress_stop_hooks = old_suppress_value;
1691 
1692     return execution_results;
1693 }
1694 
1695 lldb::addr_t
1696 Target::GetCallableLoadAddress (lldb::addr_t load_addr, AddressClass addr_class) const
1697 {
1698     addr_t code_addr = load_addr;
1699     switch (m_arch.GetMachine())
1700     {
1701     case llvm::Triple::arm:
1702     case llvm::Triple::thumb:
1703         switch (addr_class)
1704         {
1705         case eAddressClassData:
1706         case eAddressClassDebug:
1707             return LLDB_INVALID_ADDRESS;
1708 
1709         case eAddressClassUnknown:
1710         case eAddressClassInvalid:
1711         case eAddressClassCode:
1712         case eAddressClassCodeAlternateISA:
1713         case eAddressClassRuntime:
1714             // Check if bit zero it no set?
1715             if ((code_addr & 1ull) == 0)
1716             {
1717                 // Bit zero isn't set, check if the address is a multiple of 2?
1718                 if (code_addr & 2ull)
1719                 {
1720                     // The address is a multiple of 2 so it must be thumb, set bit zero
1721                     code_addr |= 1ull;
1722                 }
1723                 else if (addr_class == eAddressClassCodeAlternateISA)
1724                 {
1725                     // We checked the address and the address claims to be the alternate ISA
1726                     // which means thumb, so set bit zero.
1727                     code_addr |= 1ull;
1728                 }
1729             }
1730             break;
1731         }
1732         break;
1733 
1734     default:
1735         break;
1736     }
1737     return code_addr;
1738 }
1739 
1740 lldb::addr_t
1741 Target::GetOpcodeLoadAddress (lldb::addr_t load_addr, AddressClass addr_class) const
1742 {
1743     addr_t opcode_addr = load_addr;
1744     switch (m_arch.GetMachine())
1745     {
1746     case llvm::Triple::arm:
1747     case llvm::Triple::thumb:
1748         switch (addr_class)
1749         {
1750         case eAddressClassData:
1751         case eAddressClassDebug:
1752             return LLDB_INVALID_ADDRESS;
1753 
1754         case eAddressClassInvalid:
1755         case eAddressClassUnknown:
1756         case eAddressClassCode:
1757         case eAddressClassCodeAlternateISA:
1758         case eAddressClassRuntime:
1759             opcode_addr &= ~(1ull);
1760             break;
1761         }
1762         break;
1763 
1764     default:
1765         break;
1766     }
1767     return opcode_addr;
1768 }
1769 
1770 lldb::user_id_t
1771 Target::AddStopHook (Target::StopHookSP &new_hook_sp)
1772 {
1773     lldb::user_id_t new_uid = ++m_stop_hook_next_id;
1774     new_hook_sp.reset (new StopHook(shared_from_this(), new_uid));
1775     m_stop_hooks[new_uid] = new_hook_sp;
1776     return new_uid;
1777 }
1778 
1779 bool
1780 Target::RemoveStopHookByID (lldb::user_id_t user_id)
1781 {
1782     size_t num_removed;
1783     num_removed = m_stop_hooks.erase (user_id);
1784     if (num_removed == 0)
1785         return false;
1786     else
1787         return true;
1788 }
1789 
1790 void
1791 Target::RemoveAllStopHooks ()
1792 {
1793     m_stop_hooks.clear();
1794 }
1795 
1796 Target::StopHookSP
1797 Target::GetStopHookByID (lldb::user_id_t user_id)
1798 {
1799     StopHookSP found_hook;
1800 
1801     StopHookCollection::iterator specified_hook_iter;
1802     specified_hook_iter = m_stop_hooks.find (user_id);
1803     if (specified_hook_iter != m_stop_hooks.end())
1804         found_hook = (*specified_hook_iter).second;
1805     return found_hook;
1806 }
1807 
1808 bool
1809 Target::SetStopHookActiveStateByID (lldb::user_id_t user_id, bool active_state)
1810 {
1811     StopHookCollection::iterator specified_hook_iter;
1812     specified_hook_iter = m_stop_hooks.find (user_id);
1813     if (specified_hook_iter == m_stop_hooks.end())
1814         return false;
1815 
1816     (*specified_hook_iter).second->SetIsActive (active_state);
1817     return true;
1818 }
1819 
1820 void
1821 Target::SetAllStopHooksActiveState (bool active_state)
1822 {
1823     StopHookCollection::iterator pos, end = m_stop_hooks.end();
1824     for (pos = m_stop_hooks.begin(); pos != end; pos++)
1825     {
1826         (*pos).second->SetIsActive (active_state);
1827     }
1828 }
1829 
1830 void
1831 Target::RunStopHooks ()
1832 {
1833     if (m_suppress_stop_hooks)
1834         return;
1835 
1836     if (!m_process_sp)
1837         return;
1838 
1839     if (m_stop_hooks.empty())
1840         return;
1841 
1842     StopHookCollection::iterator pos, end = m_stop_hooks.end();
1843 
1844     // If there aren't any active stop hooks, don't bother either:
1845     bool any_active_hooks = false;
1846     for (pos = m_stop_hooks.begin(); pos != end; pos++)
1847     {
1848         if ((*pos).second->IsActive())
1849         {
1850             any_active_hooks = true;
1851             break;
1852         }
1853     }
1854     if (!any_active_hooks)
1855         return;
1856 
1857     CommandReturnObject result;
1858 
1859     std::vector<ExecutionContext> exc_ctx_with_reasons;
1860     std::vector<SymbolContext> sym_ctx_with_reasons;
1861 
1862     ThreadList &cur_threadlist = m_process_sp->GetThreadList();
1863     size_t num_threads = cur_threadlist.GetSize();
1864     for (size_t i = 0; i < num_threads; i++)
1865     {
1866         lldb::ThreadSP cur_thread_sp = cur_threadlist.GetThreadAtIndex (i);
1867         if (cur_thread_sp->ThreadStoppedForAReason())
1868         {
1869             lldb::StackFrameSP cur_frame_sp = cur_thread_sp->GetStackFrameAtIndex(0);
1870             exc_ctx_with_reasons.push_back(ExecutionContext(m_process_sp.get(), cur_thread_sp.get(), cur_frame_sp.get()));
1871             sym_ctx_with_reasons.push_back(cur_frame_sp->GetSymbolContext(eSymbolContextEverything));
1872         }
1873     }
1874 
1875     // If no threads stopped for a reason, don't run the stop-hooks.
1876     size_t num_exe_ctx = exc_ctx_with_reasons.size();
1877     if (num_exe_ctx == 0)
1878         return;
1879 
1880     result.SetImmediateOutputStream (m_debugger.GetAsyncOutputStream());
1881     result.SetImmediateErrorStream (m_debugger.GetAsyncErrorStream());
1882 
1883     bool keep_going = true;
1884     bool hooks_ran = false;
1885     bool print_hook_header;
1886     bool print_thread_header;
1887 
1888     if (num_exe_ctx == 1)
1889         print_thread_header = false;
1890     else
1891         print_thread_header = true;
1892 
1893     if (m_stop_hooks.size() == 1)
1894         print_hook_header = false;
1895     else
1896         print_hook_header = true;
1897 
1898     for (pos = m_stop_hooks.begin(); keep_going && pos != end; pos++)
1899     {
1900         // result.Clear();
1901         StopHookSP cur_hook_sp = (*pos).second;
1902         if (!cur_hook_sp->IsActive())
1903             continue;
1904 
1905         bool any_thread_matched = false;
1906         for (size_t i = 0; keep_going && i < num_exe_ctx; i++)
1907         {
1908             if ((cur_hook_sp->GetSpecifier () == NULL
1909                   || cur_hook_sp->GetSpecifier()->SymbolContextMatches(sym_ctx_with_reasons[i]))
1910                 && (cur_hook_sp->GetThreadSpecifier() == NULL
1911                     || cur_hook_sp->GetThreadSpecifier()->ThreadPassesBasicTests(exc_ctx_with_reasons[i].GetThreadRef())))
1912             {
1913                 if (!hooks_ran)
1914                 {
1915                     hooks_ran = true;
1916                 }
1917                 if (print_hook_header && !any_thread_matched)
1918                 {
1919                     const char *cmd = (cur_hook_sp->GetCommands().GetSize() == 1 ?
1920                                        cur_hook_sp->GetCommands().GetStringAtIndex(0) :
1921                                        NULL);
1922                     if (cmd)
1923                         result.AppendMessageWithFormat("\n- Hook %llu (%s)\n", cur_hook_sp->GetID(), cmd);
1924                     else
1925                         result.AppendMessageWithFormat("\n- Hook %llu\n", cur_hook_sp->GetID());
1926                     any_thread_matched = true;
1927                 }
1928 
1929                 if (print_thread_header)
1930                     result.AppendMessageWithFormat("-- Thread %d\n", exc_ctx_with_reasons[i].GetThreadPtr()->GetIndexID());
1931 
1932                 bool stop_on_continue = true;
1933                 bool stop_on_error = true;
1934                 bool echo_commands = false;
1935                 bool print_results = true;
1936                 GetDebugger().GetCommandInterpreter().HandleCommands (cur_hook_sp->GetCommands(),
1937                                                                       &exc_ctx_with_reasons[i],
1938                                                                       stop_on_continue,
1939                                                                       stop_on_error,
1940                                                                       echo_commands,
1941                                                                       print_results,
1942                                                                       result);
1943 
1944                 // If the command started the target going again, we should bag out of
1945                 // running the stop hooks.
1946                 if ((result.GetStatus() == eReturnStatusSuccessContinuingNoResult) ||
1947                     (result.GetStatus() == eReturnStatusSuccessContinuingResult))
1948                 {
1949                     result.AppendMessageWithFormat ("Aborting stop hooks, hook %llu set the program running.", cur_hook_sp->GetID());
1950                     keep_going = false;
1951                 }
1952             }
1953         }
1954     }
1955 
1956     result.GetImmediateOutputStream()->Flush();
1957     result.GetImmediateErrorStream()->Flush();
1958 }
1959 
1960 
1961 //--------------------------------------------------------------
1962 // class Target::StopHook
1963 //--------------------------------------------------------------
1964 
1965 
1966 Target::StopHook::StopHook (lldb::TargetSP target_sp, lldb::user_id_t uid) :
1967         UserID (uid),
1968         m_target_sp (target_sp),
1969         m_commands (),
1970         m_specifier_sp (),
1971         m_thread_spec_ap(NULL),
1972         m_active (true)
1973 {
1974 }
1975 
1976 Target::StopHook::StopHook (const StopHook &rhs) :
1977         UserID (rhs.GetID()),
1978         m_target_sp (rhs.m_target_sp),
1979         m_commands (rhs.m_commands),
1980         m_specifier_sp (rhs.m_specifier_sp),
1981         m_thread_spec_ap (NULL),
1982         m_active (rhs.m_active)
1983 {
1984     if (rhs.m_thread_spec_ap.get() != NULL)
1985         m_thread_spec_ap.reset (new ThreadSpec(*rhs.m_thread_spec_ap.get()));
1986 }
1987 
1988 
1989 Target::StopHook::~StopHook ()
1990 {
1991 }
1992 
1993 void
1994 Target::StopHook::SetThreadSpecifier (ThreadSpec *specifier)
1995 {
1996     m_thread_spec_ap.reset (specifier);
1997 }
1998 
1999 
2000 void
2001 Target::StopHook::GetDescription (Stream *s, lldb::DescriptionLevel level) const
2002 {
2003     int indent_level = s->GetIndentLevel();
2004 
2005     s->SetIndentLevel(indent_level + 2);
2006 
2007     s->Printf ("Hook: %llu\n", GetID());
2008     if (m_active)
2009         s->Indent ("State: enabled\n");
2010     else
2011         s->Indent ("State: disabled\n");
2012 
2013     if (m_specifier_sp)
2014     {
2015         s->Indent();
2016         s->PutCString ("Specifier:\n");
2017         s->SetIndentLevel (indent_level + 4);
2018         m_specifier_sp->GetDescription (s, level);
2019         s->SetIndentLevel (indent_level + 2);
2020     }
2021 
2022     if (m_thread_spec_ap.get() != NULL)
2023     {
2024         StreamString tmp;
2025         s->Indent("Thread:\n");
2026         m_thread_spec_ap->GetDescription (&tmp, level);
2027         s->SetIndentLevel (indent_level + 4);
2028         s->Indent (tmp.GetData());
2029         s->PutCString ("\n");
2030         s->SetIndentLevel (indent_level + 2);
2031     }
2032 
2033     s->Indent ("Commands: \n");
2034     s->SetIndentLevel (indent_level + 4);
2035     uint32_t num_commands = m_commands.GetSize();
2036     for (uint32_t i = 0; i < num_commands; i++)
2037     {
2038         s->Indent(m_commands.GetStringAtIndex(i));
2039         s->PutCString ("\n");
2040     }
2041     s->SetIndentLevel (indent_level);
2042 }
2043 
2044 
2045 //--------------------------------------------------------------
2046 // class Target::SettingsController
2047 //--------------------------------------------------------------
2048 
2049 Target::SettingsController::SettingsController () :
2050     UserSettingsController ("target", Debugger::GetSettingsController()),
2051     m_default_architecture ()
2052 {
2053 }
2054 
2055 Target::SettingsController::~SettingsController ()
2056 {
2057 }
2058 
2059 lldb::InstanceSettingsSP
2060 Target::SettingsController::CreateInstanceSettings (const char *instance_name)
2061 {
2062     lldb::InstanceSettingsSP new_settings_sp (new TargetInstanceSettings (GetSettingsController(),
2063                                                                           false,
2064                                                                           instance_name));
2065     return new_settings_sp;
2066 }
2067 
2068 
2069 #define TSC_DEFAULT_ARCH        "default-arch"
2070 #define TSC_EXPR_PREFIX         "expr-prefix"
2071 #define TSC_PREFER_DYNAMIC      "prefer-dynamic-value"
2072 #define TSC_ENABLE_SYNTHETIC    "enable-synthetic-value"
2073 #define TSC_SKIP_PROLOGUE       "skip-prologue"
2074 #define TSC_SOURCE_MAP          "source-map"
2075 #define TSC_EXE_SEARCH_PATHS    "exec-search-paths"
2076 #define TSC_MAX_CHILDREN        "max-children-count"
2077 #define TSC_MAX_STRLENSUMMARY   "max-string-summary-length"
2078 #define TSC_PLATFORM_AVOID      "breakpoints-use-platform-avoid-list"
2079 #define TSC_RUN_ARGS            "run-args"
2080 #define TSC_ENV_VARS            "env-vars"
2081 #define TSC_INHERIT_ENV         "inherit-env"
2082 #define TSC_STDIN_PATH          "input-path"
2083 #define TSC_STDOUT_PATH         "output-path"
2084 #define TSC_STDERR_PATH         "error-path"
2085 #define TSC_DISABLE_ASLR        "disable-aslr"
2086 #define TSC_DISABLE_STDIO       "disable-stdio"
2087 
2088 
2089 static const ConstString &
2090 GetSettingNameForDefaultArch ()
2091 {
2092     static ConstString g_const_string (TSC_DEFAULT_ARCH);
2093     return g_const_string;
2094 }
2095 
2096 static const ConstString &
2097 GetSettingNameForExpressionPrefix ()
2098 {
2099     static ConstString g_const_string (TSC_EXPR_PREFIX);
2100     return g_const_string;
2101 }
2102 
2103 static const ConstString &
2104 GetSettingNameForPreferDynamicValue ()
2105 {
2106     static ConstString g_const_string (TSC_PREFER_DYNAMIC);
2107     return g_const_string;
2108 }
2109 
2110 static const ConstString &
2111 GetSettingNameForEnableSyntheticValue ()
2112 {
2113     static ConstString g_const_string (TSC_ENABLE_SYNTHETIC);
2114     return g_const_string;
2115 }
2116 
2117 static const ConstString &
2118 GetSettingNameForSourcePathMap ()
2119 {
2120     static ConstString g_const_string (TSC_SOURCE_MAP);
2121     return g_const_string;
2122 }
2123 
2124 static const ConstString &
2125 GetSettingNameForExecutableSearchPaths ()
2126 {
2127     static ConstString g_const_string (TSC_EXE_SEARCH_PATHS);
2128     return g_const_string;
2129 }
2130 
2131 static const ConstString &
2132 GetSettingNameForSkipPrologue ()
2133 {
2134     static ConstString g_const_string (TSC_SKIP_PROLOGUE);
2135     return g_const_string;
2136 }
2137 
2138 static const ConstString &
2139 GetSettingNameForMaxChildren ()
2140 {
2141     static ConstString g_const_string (TSC_MAX_CHILDREN);
2142     return g_const_string;
2143 }
2144 
2145 static const ConstString &
2146 GetSettingNameForMaxStringSummaryLength ()
2147 {
2148     static ConstString g_const_string (TSC_MAX_STRLENSUMMARY);
2149     return g_const_string;
2150 }
2151 
2152 static const ConstString &
2153 GetSettingNameForPlatformAvoid ()
2154 {
2155     static ConstString g_const_string (TSC_PLATFORM_AVOID);
2156     return g_const_string;
2157 }
2158 
2159 const ConstString &
2160 GetSettingNameForRunArgs ()
2161 {
2162     static ConstString g_const_string (TSC_RUN_ARGS);
2163     return g_const_string;
2164 }
2165 
2166 const ConstString &
2167 GetSettingNameForEnvVars ()
2168 {
2169     static ConstString g_const_string (TSC_ENV_VARS);
2170     return g_const_string;
2171 }
2172 
2173 const ConstString &
2174 GetSettingNameForInheritHostEnv ()
2175 {
2176     static ConstString g_const_string (TSC_INHERIT_ENV);
2177     return g_const_string;
2178 }
2179 
2180 const ConstString &
2181 GetSettingNameForInputPath ()
2182 {
2183     static ConstString g_const_string (TSC_STDIN_PATH);
2184     return g_const_string;
2185 }
2186 
2187 const ConstString &
2188 GetSettingNameForOutputPath ()
2189 {
2190     static ConstString g_const_string (TSC_STDOUT_PATH);
2191     return g_const_string;
2192 }
2193 
2194 const ConstString &
2195 GetSettingNameForErrorPath ()
2196 {
2197     static ConstString g_const_string (TSC_STDERR_PATH);
2198     return g_const_string;
2199 }
2200 
2201 const ConstString &
2202 GetSettingNameForDisableASLR ()
2203 {
2204     static ConstString g_const_string (TSC_DISABLE_ASLR);
2205     return g_const_string;
2206 }
2207 
2208 const ConstString &
2209 GetSettingNameForDisableSTDIO ()
2210 {
2211     static ConstString g_const_string (TSC_DISABLE_STDIO);
2212     return g_const_string;
2213 }
2214 
2215 bool
2216 Target::SettingsController::SetGlobalVariable (const ConstString &var_name,
2217                                                const char *index_value,
2218                                                const char *value,
2219                                                const SettingEntry &entry,
2220                                                const VarSetOperationType op,
2221                                                Error&err)
2222 {
2223     if (var_name == GetSettingNameForDefaultArch())
2224     {
2225         m_default_architecture.SetTriple (value, NULL);
2226         if (!m_default_architecture.IsValid())
2227             err.SetErrorStringWithFormat ("'%s' is not a valid architecture or triple.", value);
2228     }
2229     return true;
2230 }
2231 
2232 
2233 bool
2234 Target::SettingsController::GetGlobalVariable (const ConstString &var_name,
2235                                                StringList &value,
2236                                                Error &err)
2237 {
2238     if (var_name == GetSettingNameForDefaultArch())
2239     {
2240         // If the arch is invalid (the default), don't show a string for it
2241         if (m_default_architecture.IsValid())
2242             value.AppendString (m_default_architecture.GetArchitectureName());
2243         return true;
2244     }
2245     else
2246         err.SetErrorStringWithFormat ("unrecognized variable name '%s'", var_name.AsCString());
2247 
2248     return false;
2249 }
2250 
2251 //--------------------------------------------------------------
2252 // class TargetInstanceSettings
2253 //--------------------------------------------------------------
2254 
2255 TargetInstanceSettings::TargetInstanceSettings
2256 (
2257     const lldb::UserSettingsControllerSP &owner_sp,
2258     bool live_instance,
2259     const char *name
2260 ) :
2261     InstanceSettings (owner_sp, name ? name : InstanceSettings::InvalidName().AsCString(), live_instance),
2262     m_expr_prefix_file (),
2263     m_expr_prefix_contents (),
2264     m_prefer_dynamic_value (2),
2265     m_enable_synthetic_value(true, true),
2266     m_skip_prologue (true, true),
2267     m_source_map (NULL, NULL),
2268     m_exe_search_paths (),
2269     m_max_children_display(256),
2270     m_max_strlen_length(1024),
2271     m_breakpoints_use_platform_avoid (true, true),
2272     m_run_args (),
2273     m_env_vars (),
2274     m_input_path (),
2275     m_output_path (),
2276     m_error_path (),
2277     m_disable_aslr (true),
2278     m_disable_stdio (false),
2279     m_inherit_host_env (true),
2280     m_got_host_env (false)
2281 {
2282     // CopyInstanceSettings is a pure virtual function in InstanceSettings; it therefore cannot be called
2283     // until the vtables for TargetInstanceSettings are properly set up, i.e. AFTER all the initializers.
2284     // For this reason it has to be called here, rather than in the initializer or in the parent constructor.
2285     // This is true for CreateInstanceName() too.
2286 
2287     if (GetInstanceName () == InstanceSettings::InvalidName())
2288     {
2289         ChangeInstanceName (std::string (CreateInstanceName().AsCString()));
2290         owner_sp->RegisterInstanceSettings (this);
2291     }
2292 
2293     if (live_instance)
2294     {
2295         const lldb::InstanceSettingsSP &pending_settings = owner_sp->FindPendingSettings (m_instance_name);
2296         CopyInstanceSettings (pending_settings,false);
2297     }
2298 }
2299 
2300 TargetInstanceSettings::TargetInstanceSettings (const TargetInstanceSettings &rhs) :
2301     InstanceSettings (Target::GetSettingsController(), CreateInstanceName().AsCString()),
2302     m_expr_prefix_file (rhs.m_expr_prefix_file),
2303     m_expr_prefix_contents (rhs.m_expr_prefix_contents),
2304     m_prefer_dynamic_value (rhs.m_prefer_dynamic_value),
2305     m_enable_synthetic_value(rhs.m_enable_synthetic_value),
2306     m_skip_prologue (rhs.m_skip_prologue),
2307     m_source_map (rhs.m_source_map),
2308     m_exe_search_paths (rhs.m_exe_search_paths),
2309     m_max_children_display (rhs.m_max_children_display),
2310     m_max_strlen_length (rhs.m_max_strlen_length),
2311     m_breakpoints_use_platform_avoid (rhs.m_breakpoints_use_platform_avoid),
2312     m_run_args (rhs.m_run_args),
2313     m_env_vars (rhs.m_env_vars),
2314     m_input_path (rhs.m_input_path),
2315     m_output_path (rhs.m_output_path),
2316     m_error_path (rhs.m_error_path),
2317     m_disable_aslr (rhs.m_disable_aslr),
2318     m_disable_stdio (rhs.m_disable_stdio),
2319     m_inherit_host_env (rhs.m_inherit_host_env)
2320 {
2321     if (m_instance_name != InstanceSettings::GetDefaultName())
2322     {
2323         UserSettingsControllerSP owner_sp (m_owner_wp.lock());
2324         if (owner_sp)
2325             CopyInstanceSettings (owner_sp->FindPendingSettings (m_instance_name),false);
2326     }
2327 }
2328 
2329 TargetInstanceSettings::~TargetInstanceSettings ()
2330 {
2331 }
2332 
2333 TargetInstanceSettings&
2334 TargetInstanceSettings::operator= (const TargetInstanceSettings &rhs)
2335 {
2336     if (this != &rhs)
2337     {
2338         m_expr_prefix_file = rhs.m_expr_prefix_file;
2339         m_expr_prefix_contents = rhs.m_expr_prefix_contents;
2340         m_prefer_dynamic_value = rhs.m_prefer_dynamic_value;
2341         m_enable_synthetic_value = rhs.m_enable_synthetic_value;
2342         m_skip_prologue = rhs.m_skip_prologue;
2343         m_source_map = rhs.m_source_map;
2344         m_exe_search_paths = rhs.m_exe_search_paths;
2345         m_max_children_display = rhs.m_max_children_display;
2346         m_max_strlen_length = rhs.m_max_strlen_length;
2347         m_breakpoints_use_platform_avoid = rhs.m_breakpoints_use_platform_avoid;
2348         m_run_args = rhs.m_run_args;
2349         m_env_vars = rhs.m_env_vars;
2350         m_input_path = rhs.m_input_path;
2351         m_output_path = rhs.m_output_path;
2352         m_error_path = rhs.m_error_path;
2353         m_disable_aslr = rhs.m_disable_aslr;
2354         m_disable_stdio = rhs.m_disable_stdio;
2355         m_inherit_host_env = rhs.m_inherit_host_env;
2356     }
2357 
2358     return *this;
2359 }
2360 
2361 void
2362 TargetInstanceSettings::UpdateInstanceSettingsVariable (const ConstString &var_name,
2363                                                         const char *index_value,
2364                                                         const char *value,
2365                                                         const ConstString &instance_name,
2366                                                         const SettingEntry &entry,
2367                                                         VarSetOperationType op,
2368                                                         Error &err,
2369                                                         bool pending)
2370 {
2371     if (var_name == GetSettingNameForExpressionPrefix ())
2372     {
2373         err = UserSettingsController::UpdateFileSpecOptionValue (value, op, m_expr_prefix_file);
2374         if (err.Success())
2375         {
2376             switch (op)
2377             {
2378             default:
2379                 break;
2380             case eVarSetOperationAssign:
2381             case eVarSetOperationAppend:
2382                 {
2383                     m_expr_prefix_contents.clear();
2384 
2385                     if (!m_expr_prefix_file.GetCurrentValue().Exists())
2386                     {
2387                         err.SetErrorToGenericError ();
2388                         err.SetErrorStringWithFormat ("%s does not exist", value);
2389                         return;
2390                     }
2391 
2392                     DataBufferSP file_data_sp (m_expr_prefix_file.GetCurrentValue().ReadFileContents(0, SIZE_MAX, &err));
2393 
2394                     if (err.Success())
2395                     {
2396                         if (file_data_sp && file_data_sp->GetByteSize() > 0)
2397                         {
2398                             m_expr_prefix_contents.assign((const char*)file_data_sp->GetBytes(), file_data_sp->GetByteSize());
2399                         }
2400                         else
2401                         {
2402                             err.SetErrorStringWithFormat ("couldn't read data from '%s'", value);
2403                         }
2404                     }
2405                 }
2406                 break;
2407             case eVarSetOperationClear:
2408                 m_expr_prefix_contents.clear();
2409             }
2410         }
2411     }
2412     else if (var_name == GetSettingNameForPreferDynamicValue())
2413     {
2414         int new_value;
2415         UserSettingsController::UpdateEnumVariable (g_dynamic_value_types, &new_value, value, err);
2416         if (err.Success())
2417             m_prefer_dynamic_value = new_value;
2418     }
2419     else if (var_name == GetSettingNameForEnableSyntheticValue())
2420     {
2421         bool ok;
2422         bool new_value = Args::StringToBoolean(value, true, &ok);
2423         if (ok)
2424             m_enable_synthetic_value.SetCurrentValue(new_value);
2425     }
2426     else if (var_name == GetSettingNameForSkipPrologue())
2427     {
2428         err = UserSettingsController::UpdateBooleanOptionValue (value, op, m_skip_prologue);
2429     }
2430     else if (var_name == GetSettingNameForMaxChildren())
2431     {
2432         bool ok;
2433         uint32_t new_value = Args::StringToUInt32(value, 0, 10, &ok);
2434         if (ok)
2435             m_max_children_display = new_value;
2436     }
2437     else if (var_name == GetSettingNameForMaxStringSummaryLength())
2438     {
2439         bool ok;
2440         uint32_t new_value = Args::StringToUInt32(value, 0, 10, &ok);
2441         if (ok)
2442             m_max_strlen_length = new_value;
2443     }
2444     else if (var_name == GetSettingNameForExecutableSearchPaths())
2445     {
2446         switch (op)
2447         {
2448             case eVarSetOperationReplace:
2449             case eVarSetOperationInsertBefore:
2450             case eVarSetOperationInsertAfter:
2451             case eVarSetOperationRemove:
2452             default:
2453                 break;
2454             case eVarSetOperationAssign:
2455                 m_exe_search_paths.Clear();
2456                 // Fall through to append....
2457             case eVarSetOperationAppend:
2458             {
2459                 Args args(value);
2460                 const uint32_t argc = args.GetArgumentCount();
2461                 if (argc > 0)
2462                 {
2463                     const char *exe_search_path_dir;
2464                     for (uint32_t idx = 0; (exe_search_path_dir = args.GetArgumentAtIndex(idx)) != NULL; ++idx)
2465                     {
2466                         FileSpec file_spec;
2467                         file_spec.GetDirectory().SetCString(exe_search_path_dir);
2468                         FileSpec::FileType file_type = file_spec.GetFileType();
2469                         if (file_type == FileSpec::eFileTypeDirectory || file_type == FileSpec::eFileTypeInvalid)
2470                         {
2471                             m_exe_search_paths.Append(file_spec);
2472                         }
2473                         else
2474                         {
2475                             err.SetErrorStringWithFormat("executable search path '%s' exists, but it does not resolve to a directory", exe_search_path_dir);
2476                         }
2477                     }
2478                 }
2479             }
2480                 break;
2481 
2482             case eVarSetOperationClear:
2483                 m_exe_search_paths.Clear();
2484                 break;
2485         }
2486     }
2487     else if (var_name == GetSettingNameForSourcePathMap ())
2488     {
2489         switch (op)
2490         {
2491             case eVarSetOperationReplace:
2492             case eVarSetOperationInsertBefore:
2493             case eVarSetOperationInsertAfter:
2494             case eVarSetOperationRemove:
2495             default:
2496                 break;
2497             case eVarSetOperationAssign:
2498                 m_source_map.Clear(true);
2499                 // Fall through to append....
2500             case eVarSetOperationAppend:
2501                 {
2502                     Args args(value);
2503                     const uint32_t argc = args.GetArgumentCount();
2504                     if (argc & 1 || argc == 0)
2505                     {
2506                         err.SetErrorStringWithFormat ("an even number of paths must be supplied to to the source-map setting: %u arguments given", argc);
2507                     }
2508                     else
2509                     {
2510                         char resolved_new_path[PATH_MAX];
2511                         FileSpec file_spec;
2512                         const char *old_path;
2513                         for (uint32_t idx = 0; (old_path = args.GetArgumentAtIndex(idx)) != NULL; idx += 2)
2514                         {
2515                             const char *new_path = args.GetArgumentAtIndex(idx+1);
2516                             assert (new_path); // We have an even number of paths, this shouldn't happen!
2517 
2518                             file_spec.SetFile(new_path, true);
2519                             if (file_spec.Exists())
2520                             {
2521                                 if (file_spec.GetPath (resolved_new_path, sizeof(resolved_new_path)) >= sizeof(resolved_new_path))
2522                                 {
2523                                     err.SetErrorStringWithFormat("new path '%s' is too long", new_path);
2524                                     return;
2525                                 }
2526                             }
2527                             else
2528                             {
2529                                 err.SetErrorStringWithFormat("new path '%s' doesn't exist", new_path);
2530                                 return;
2531                             }
2532                             m_source_map.Append(ConstString (old_path), ConstString (resolved_new_path), true);
2533                         }
2534                     }
2535                 }
2536                 break;
2537 
2538             case eVarSetOperationClear:
2539                 m_source_map.Clear(true);
2540                 break;
2541         }
2542     }
2543     else if (var_name == GetSettingNameForPlatformAvoid ())
2544     {
2545         err = UserSettingsController::UpdateBooleanOptionValue (value, op, m_breakpoints_use_platform_avoid);
2546     }
2547     else if (var_name == GetSettingNameForRunArgs())
2548     {
2549         UserSettingsController::UpdateStringArrayVariable (op, index_value, m_run_args, value, err);
2550     }
2551     else if (var_name == GetSettingNameForEnvVars())
2552     {
2553         // This is nice for local debugging, but it is isn't correct for
2554         // remote debugging. We need to stop process.env-vars from being
2555         // populated with the host environment and add this as a launch option
2556         // and get the correct environment from the Target's platform.
2557         // GetHostEnvironmentIfNeeded ();
2558         UserSettingsController::UpdateDictionaryVariable (op, index_value, m_env_vars, value, err);
2559     }
2560     else if (var_name == GetSettingNameForInputPath())
2561     {
2562         UserSettingsController::UpdateStringVariable (op, m_input_path, value, err);
2563     }
2564     else if (var_name == GetSettingNameForOutputPath())
2565     {
2566         UserSettingsController::UpdateStringVariable (op, m_output_path, value, err);
2567     }
2568     else if (var_name == GetSettingNameForErrorPath())
2569     {
2570         UserSettingsController::UpdateStringVariable (op, m_error_path, value, err);
2571     }
2572     else if (var_name == GetSettingNameForDisableASLR())
2573     {
2574         UserSettingsController::UpdateBooleanVariable (op, m_disable_aslr, value, true, err);
2575     }
2576     else if (var_name == GetSettingNameForDisableSTDIO ())
2577     {
2578         UserSettingsController::UpdateBooleanVariable (op, m_disable_stdio, value, false, err);
2579     }
2580 }
2581 
2582 void
2583 TargetInstanceSettings::CopyInstanceSettings (const lldb::InstanceSettingsSP &new_settings, bool pending)
2584 {
2585     TargetInstanceSettings *new_settings_ptr = static_cast <TargetInstanceSettings *> (new_settings.get());
2586 
2587     if (!new_settings_ptr)
2588         return;
2589 
2590     *this = *new_settings_ptr;
2591 }
2592 
2593 bool
2594 TargetInstanceSettings::GetInstanceSettingsValue (const SettingEntry &entry,
2595                                                   const ConstString &var_name,
2596                                                   StringList &value,
2597                                                   Error *err)
2598 {
2599     if (var_name == GetSettingNameForExpressionPrefix ())
2600     {
2601         char path[PATH_MAX];
2602         const size_t path_len = m_expr_prefix_file.GetCurrentValue().GetPath (path, sizeof(path));
2603         if (path_len > 0)
2604             value.AppendString (path, path_len);
2605     }
2606     else if (var_name == GetSettingNameForPreferDynamicValue())
2607     {
2608         value.AppendString (g_dynamic_value_types[m_prefer_dynamic_value].string_value);
2609     }
2610     else if (var_name == GetSettingNameForEnableSyntheticValue())
2611     {
2612         if (m_skip_prologue)
2613             value.AppendString ("true");
2614         else
2615             value.AppendString ("false");
2616     }
2617     else if (var_name == GetSettingNameForSkipPrologue())
2618     {
2619         if (m_skip_prologue)
2620             value.AppendString ("true");
2621         else
2622             value.AppendString ("false");
2623     }
2624     else if (var_name == GetSettingNameForExecutableSearchPaths())
2625     {
2626         if (m_exe_search_paths.GetSize())
2627         {
2628             for (size_t i = 0, n = m_exe_search_paths.GetSize(); i < n; ++i)
2629             {
2630                 value.AppendString(m_exe_search_paths.GetFileSpecAtIndex (i).GetDirectory().AsCString());
2631             }
2632         }
2633     }
2634     else if (var_name == GetSettingNameForSourcePathMap ())
2635     {
2636         if (m_source_map.GetSize())
2637         {
2638             size_t i;
2639             for (i = 0; i < m_source_map.GetSize(); ++i) {
2640                 StreamString sstr;
2641                 m_source_map.Dump(&sstr, i);
2642                 value.AppendString(sstr.GetData());
2643             }
2644         }
2645     }
2646     else if (var_name == GetSettingNameForMaxChildren())
2647     {
2648         StreamString count_str;
2649         count_str.Printf ("%d", m_max_children_display);
2650         value.AppendString (count_str.GetData());
2651     }
2652     else if (var_name == GetSettingNameForMaxStringSummaryLength())
2653     {
2654         StreamString count_str;
2655         count_str.Printf ("%d", m_max_strlen_length);
2656         value.AppendString (count_str.GetData());
2657     }
2658     else if (var_name == GetSettingNameForPlatformAvoid())
2659     {
2660         if (m_breakpoints_use_platform_avoid)
2661             value.AppendString ("true");
2662         else
2663             value.AppendString ("false");
2664     }
2665     else if (var_name == GetSettingNameForRunArgs())
2666     {
2667         if (m_run_args.GetArgumentCount() > 0)
2668         {
2669             for (int i = 0; i < m_run_args.GetArgumentCount(); ++i)
2670                 value.AppendString (m_run_args.GetArgumentAtIndex (i));
2671         }
2672     }
2673     else if (var_name == GetSettingNameForEnvVars())
2674     {
2675         GetHostEnvironmentIfNeeded ();
2676 
2677         if (m_env_vars.size() > 0)
2678         {
2679             std::map<std::string, std::string>::iterator pos;
2680             for (pos = m_env_vars.begin(); pos != m_env_vars.end(); ++pos)
2681             {
2682                 StreamString value_str;
2683                 value_str.Printf ("%s=%s", pos->first.c_str(), pos->second.c_str());
2684                 value.AppendString (value_str.GetData());
2685             }
2686         }
2687     }
2688     else if (var_name == GetSettingNameForInputPath())
2689     {
2690         value.AppendString (m_input_path.c_str());
2691     }
2692     else if (var_name == GetSettingNameForOutputPath())
2693     {
2694         value.AppendString (m_output_path.c_str());
2695     }
2696     else if (var_name == GetSettingNameForErrorPath())
2697     {
2698         value.AppendString (m_error_path.c_str());
2699     }
2700     else if (var_name == GetSettingNameForInheritHostEnv())
2701     {
2702         if (m_inherit_host_env)
2703             value.AppendString ("true");
2704         else
2705             value.AppendString ("false");
2706     }
2707     else if (var_name == GetSettingNameForDisableASLR())
2708     {
2709         if (m_disable_aslr)
2710             value.AppendString ("true");
2711         else
2712             value.AppendString ("false");
2713     }
2714     else if (var_name == GetSettingNameForDisableSTDIO())
2715     {
2716         if (m_disable_stdio)
2717             value.AppendString ("true");
2718         else
2719             value.AppendString ("false");
2720     }
2721     else
2722     {
2723         if (err)
2724             err->SetErrorStringWithFormat ("unrecognized variable name '%s'", var_name.AsCString());
2725         return false;
2726     }
2727     return true;
2728 }
2729 
2730 void
2731 Target::TargetInstanceSettings::GetHostEnvironmentIfNeeded ()
2732 {
2733     if (m_inherit_host_env && !m_got_host_env)
2734     {
2735         m_got_host_env = true;
2736         StringList host_env;
2737         const size_t host_env_count = Host::GetEnvironment (host_env);
2738         for (size_t idx=0; idx<host_env_count; idx++)
2739         {
2740             const char *env_entry = host_env.GetStringAtIndex (idx);
2741             if (env_entry)
2742             {
2743                 const char *equal_pos = ::strchr(env_entry, '=');
2744                 if (equal_pos)
2745                 {
2746                     std::string key (env_entry, equal_pos - env_entry);
2747                     std::string value (equal_pos + 1);
2748                     if (m_env_vars.find (key) == m_env_vars.end())
2749                         m_env_vars[key] = value;
2750                 }
2751             }
2752         }
2753     }
2754 }
2755 
2756 
2757 size_t
2758 Target::TargetInstanceSettings::GetEnvironmentAsArgs (Args &env)
2759 {
2760     GetHostEnvironmentIfNeeded ();
2761 
2762     dictionary::const_iterator pos, end = m_env_vars.end();
2763     for (pos = m_env_vars.begin(); pos != end; ++pos)
2764     {
2765         std::string env_var_equal_value (pos->first);
2766         env_var_equal_value.append(1, '=');
2767         env_var_equal_value.append (pos->second);
2768         env.AppendArgument (env_var_equal_value.c_str());
2769     }
2770     return env.GetArgumentCount();
2771 }
2772 
2773 
2774 const ConstString
2775 TargetInstanceSettings::CreateInstanceName ()
2776 {
2777     StreamString sstr;
2778     static int instance_count = 1;
2779 
2780     sstr.Printf ("target_%d", instance_count);
2781     ++instance_count;
2782 
2783     const ConstString ret_val (sstr.GetData());
2784     return ret_val;
2785 }
2786 
2787 //--------------------------------------------------
2788 // Target::SettingsController Variable Tables
2789 //--------------------------------------------------
2790 OptionEnumValueElement
2791 TargetInstanceSettings::g_dynamic_value_types[] =
2792 {
2793 { eNoDynamicValues,      "no-dynamic-values", "Don't calculate the dynamic type of values"},
2794 { eDynamicCanRunTarget,  "run-target",        "Calculate the dynamic type of values even if you have to run the target."},
2795 { eDynamicDontRunTarget, "no-run-target",     "Calculate the dynamic type of values, but don't run the target."},
2796 { 0, NULL, NULL }
2797 };
2798 
2799 SettingEntry
2800 Target::SettingsController::global_settings_table[] =
2801 {
2802     // var-name           var-type           default      enum  init'd hidden help-text
2803     // =================  ================== ===========  ====  ====== ====== =========================================================================
2804     { TSC_DEFAULT_ARCH  , eSetVarTypeString , NULL      , NULL, false, false, "Default architecture to choose, when there's a choice." },
2805     { NULL              , eSetVarTypeNone   , NULL      , NULL, false, false, NULL }
2806 };
2807 
2808 SettingEntry
2809 Target::SettingsController::instance_settings_table[] =
2810 {
2811     // var-name             var-type            default         enum                    init'd hidden help-text
2812     // =================    ==================  =============== ======================= ====== ====== =========================================================================
2813     { TSC_EXPR_PREFIX       , eSetVarTypeString , NULL          , NULL,                  false, false, "Path to a file containing expressions to be prepended to all expressions." },
2814     { TSC_PREFER_DYNAMIC    , eSetVarTypeEnum   , NULL          , g_dynamic_value_types, false, false, "Should printed values be shown as their dynamic value." },
2815     { TSC_ENABLE_SYNTHETIC  , eSetVarTypeBoolean, "true"        , NULL,                  false, false, "Should synthetic values be used by default whenever available." },
2816     { TSC_SKIP_PROLOGUE     , eSetVarTypeBoolean, "true"        , NULL,                  false, false, "Skip function prologues when setting breakpoints by name." },
2817     { TSC_SOURCE_MAP        , eSetVarTypeArray  , NULL          , NULL,                  false, false, "Source path remappings to use when locating source files from debug information." },
2818     { 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." },
2819     { TSC_MAX_CHILDREN      , eSetVarTypeInt    , "256"         , NULL,                  true,  false, "Maximum number of children to expand in any level of depth." },
2820     { TSC_MAX_STRLENSUMMARY , eSetVarTypeInt    , "1024"        , NULL,                  true,  false, "Maximum number of characters to show when using %s in summary strings." },
2821     { TSC_PLATFORM_AVOID    , eSetVarTypeBoolean, "true"        , NULL,                  false, false, "Consult the platform module avoid list when setting non-module specific breakpoints." },
2822     { TSC_RUN_ARGS          , eSetVarTypeArray  , NULL          , NULL,                  false,  false,  "A list containing all the arguments to be passed to the executable when it is run." },
2823     { 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." },
2824     { TSC_INHERIT_ENV       , eSetVarTypeBoolean, "true"        , NULL,                  false,  false,  "Inherit the environment from the process that is running LLDB." },
2825     { TSC_STDIN_PATH        , eSetVarTypeString , NULL          , NULL,                  false,  false,  "The file/path to be used by the executable program for reading its standard input." },
2826     { TSC_STDOUT_PATH       , eSetVarTypeString , NULL          , NULL,                  false,  false,  "The file/path to be used by the executable program for writing its standard output." },
2827     { TSC_STDERR_PATH       , eSetVarTypeString , NULL          , NULL,                  false,  false,  "The file/path to be used by the executable program for writing its standard error." },
2828 //    { "plugin",         eSetVarTypeEnum,        NULL,           NULL,                  false,  false,  "The plugin to be used to run the process." },
2829     { TSC_DISABLE_ASLR      , eSetVarTypeBoolean, "true"        , NULL,                  false,  false,  "Disable Address Space Layout Randomization (ASLR)" },
2830     { TSC_DISABLE_STDIO     , eSetVarTypeBoolean, "false"       , NULL,                  false,  false,  "Disable stdin/stdout for process (e.g. for a GUI application)" },
2831     { NULL                  , eSetVarTypeNone   , NULL          , NULL,                  false, false, NULL }
2832 };
2833 
2834 const ConstString &
2835 Target::TargetEventData::GetFlavorString ()
2836 {
2837     static ConstString g_flavor ("Target::TargetEventData");
2838     return g_flavor;
2839 }
2840 
2841 const ConstString &
2842 Target::TargetEventData::GetFlavor () const
2843 {
2844     return TargetEventData::GetFlavorString ();
2845 }
2846 
2847 Target::TargetEventData::TargetEventData (const lldb::TargetSP &new_target_sp) :
2848     EventData(),
2849     m_target_sp (new_target_sp)
2850 {
2851 }
2852 
2853 Target::TargetEventData::~TargetEventData()
2854 {
2855 
2856 }
2857 
2858 void
2859 Target::TargetEventData::Dump (Stream *s) const
2860 {
2861 
2862 }
2863 
2864 const TargetSP
2865 Target::TargetEventData::GetTargetFromEvent (const lldb::EventSP &event_sp)
2866 {
2867     TargetSP target_sp;
2868 
2869     const TargetEventData *data = GetEventDataFromEvent (event_sp.get());
2870     if (data)
2871         target_sp = data->m_target_sp;
2872 
2873     return target_sp;
2874 }
2875 
2876 const Target::TargetEventData *
2877 Target::TargetEventData::GetEventDataFromEvent (const Event *event_ptr)
2878 {
2879     if (event_ptr)
2880     {
2881         const EventData *event_data = event_ptr->GetData();
2882         if (event_data && event_data->GetFlavor() == TargetEventData::GetFlavorString())
2883             return static_cast <const TargetEventData *> (event_ptr->GetData());
2884     }
2885     return NULL;
2886 }
2887 
2888