xref: /llvm-project/lldb/source/Commands/CommandObjectFrame.cpp (revision 016a95eb040364e47bc25ddbdfcdaf306ad7ce2b)
1 //===-- CommandObjectFrame.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 "CommandObjectFrame.h"
11 
12 // C Includes
13 // C++ Includes
14 // Other libraries and framework includes
15 // Project includes
16 #include "lldb/Core/Debugger.h"
17 #include "lldb/Core/Module.h"
18 #include "lldb/Core/StreamFile.h"
19 #include "lldb/Core/Timer.h"
20 #include "lldb/Core/Value.h"
21 #include "lldb/Core/ValueObject.h"
22 #include "lldb/Core/ValueObjectVariable.h"
23 #include "lldb/Interpreter/Args.h"
24 #include "lldb/Interpreter/CommandInterpreter.h"
25 #include "lldb/Interpreter/CommandReturnObject.h"
26 #include "lldb/Interpreter/Options.h"
27 #include "lldb/Symbol/ClangASTType.h"
28 #include "lldb/Symbol/ClangASTContext.h"
29 #include "lldb/Symbol/ObjectFile.h"
30 #include "lldb/Symbol/SymbolContext.h"
31 #include "lldb/Symbol/Type.h"
32 #include "lldb/Symbol/Variable.h"
33 #include "lldb/Symbol/VariableList.h"
34 #include "lldb/Target/Process.h"
35 #include "lldb/Target/StackFrame.h"
36 #include "lldb/Target/Thread.h"
37 #include "lldb/Target/Target.h"
38 
39 #include "CommandObjectThread.h"
40 
41 using namespace lldb;
42 using namespace lldb_private;
43 
44 #pragma mark CommandObjectFrameInfo
45 
46 //-------------------------------------------------------------------------
47 // CommandObjectFrameInfo
48 //-------------------------------------------------------------------------
49 
50 class CommandObjectFrameInfo : public CommandObject
51 {
52 public:
53 
54     CommandObjectFrameInfo () :
55     CommandObject ("frame info",
56                    "List information about the currently selected frame in the current thread.",
57                    "frame info",
58                    eFlagProcessMustBeLaunched | eFlagProcessMustBePaused)
59     {
60     }
61 
62     ~CommandObjectFrameInfo ()
63     {
64     }
65 
66     bool
67     Execute (CommandInterpreter &interpreter,
68              Args& command,
69              CommandReturnObject &result)
70     {
71         ExecutionContext exe_ctx(interpreter.GetDebugger().GetExecutionContext());
72         if (exe_ctx.frame)
73         {
74             exe_ctx.frame->Dump (&result.GetOutputStream(), true, false);
75             result.GetOutputStream().EOL();
76             result.SetStatus (eReturnStatusSuccessFinishResult);
77         }
78         else
79         {
80             result.AppendError ("no current frame");
81             result.SetStatus (eReturnStatusFailed);
82         }
83         return result.Succeeded();
84     }
85 };
86 
87 #pragma mark CommandObjectFrameSelect
88 
89 //-------------------------------------------------------------------------
90 // CommandObjectFrameSelect
91 //-------------------------------------------------------------------------
92 
93 class CommandObjectFrameSelect : public CommandObject
94 {
95 public:
96 
97     CommandObjectFrameSelect () :
98     CommandObject ("frame select",
99                    //"Select the current frame by index in the current thread.",
100                    "Select a frame by index from within the current thread and make it the current frame.",
101                    "frame select <frame-index>",
102                    eFlagProcessMustBeLaunched | eFlagProcessMustBePaused)
103     {
104     }
105 
106     ~CommandObjectFrameSelect ()
107     {
108     }
109 
110     bool
111     Execute (CommandInterpreter &interpreter,
112              Args& command,
113              CommandReturnObject &result)
114     {
115         ExecutionContext exe_ctx (interpreter.GetDebugger().GetExecutionContext());
116         if (exe_ctx.thread)
117         {
118             if (command.GetArgumentCount() == 1)
119             {
120                 const char *frame_idx_cstr = command.GetArgumentAtIndex(0);
121 
122                 const uint32_t num_frames = exe_ctx.thread->GetStackFrameCount();
123                 const uint32_t frame_idx = Args::StringToUInt32 (frame_idx_cstr, UINT32_MAX, 0);
124                 if (frame_idx < num_frames)
125                 {
126                     exe_ctx.thread->SetSelectedFrameByIndex (frame_idx);
127                     exe_ctx.frame = exe_ctx.thread->GetSelectedFrame ().get();
128 
129                     if (exe_ctx.frame)
130                     {
131                         bool already_shown = false;
132                         SymbolContext frame_sc(exe_ctx.frame->GetSymbolContext(eSymbolContextLineEntry));
133                         if (interpreter.GetDebugger().UseExternalEditor() && frame_sc.line_entry.file && frame_sc.line_entry.line != 0)
134                         {
135                             already_shown = Host::OpenFileInExternalEditor (frame_sc.line_entry.file, frame_sc.line_entry.line);
136                         }
137 
138                         if (DisplayFrameForExecutionContext (exe_ctx.thread,
139                                                              exe_ctx.frame,
140                                                              interpreter,
141                                                              result.GetOutputStream(),
142                                                              true,
143                                                              !already_shown,
144                                                              3,
145                                                              3))
146                         {
147                             result.SetStatus (eReturnStatusSuccessFinishResult);
148                             return result.Succeeded();
149                         }
150                     }
151                 }
152                 if (frame_idx == UINT32_MAX)
153                     result.AppendErrorWithFormat ("Invalid frame index: %s.\n", frame_idx_cstr);
154                 else
155                     result.AppendErrorWithFormat ("Frame index (%u) out of range.\n", frame_idx);
156             }
157             else
158             {
159                 result.AppendError ("invalid arguments");
160                 result.AppendErrorWithFormat ("Usage: %s\n", m_cmd_syntax.c_str());
161             }
162         }
163         else
164         {
165             result.AppendError ("no current thread");
166         }
167         result.SetStatus (eReturnStatusFailed);
168         return false;
169     }
170 };
171 
172 #pragma mark CommandObjectFrameVariable
173 //----------------------------------------------------------------------
174 // List images with associated information
175 //----------------------------------------------------------------------
176 class CommandObjectFrameVariable : public CommandObject
177 {
178 public:
179 
180     class CommandOptions : public Options
181     {
182     public:
183 
184         CommandOptions () :
185             Options()
186         {
187             ResetOptionValues ();
188         }
189 
190         virtual
191         ~CommandOptions ()
192         {
193         }
194 
195         virtual Error
196         SetOptionValue (int option_idx, const char *option_arg)
197         {
198             Error error;
199             bool success;
200             char short_option = (char) m_getopt_table[option_idx].val;
201             switch (short_option)
202             {
203             case 'o':   use_objc     = true;  break;
204             case 'n':   name = option_arg;    break;
205             case 'r':   use_regex    = true;  break;
206             case 'a':   show_args    = false; break;
207             case 'l':   show_locals  = false; break;
208             case 'g':   show_globals = true;  break;
209             case 't':   show_types   = false; break;
210             case 'y':   show_summary = false; break;
211             case 'L':   show_location= true;  break;
212             case 'c':   show_decl    = true;  break;
213             case 'D':   debug        = true;  break;
214             case 'd':
215                 max_depth = Args::StringToUInt32 (option_arg, UINT32_MAX, 0, &success);
216                 if (!success)
217                     error.SetErrorStringWithFormat("Invalid max depth '%s'.\n", option_arg);
218                 break;
219 
220             case 'p':
221                 ptr_depth = Args::StringToUInt32 (option_arg, 0, 0, &success);
222                 if (!success)
223                     error.SetErrorStringWithFormat("Invalid pointer depth '%s'.\n", option_arg);
224                 break;
225 
226             case 'G':
227                 globals.push_back(ConstString (option_arg));
228                 break;
229 
230             case 's':
231                 show_scope = true;
232                 break;
233 
234             default:
235                 error.SetErrorStringWithFormat("Invalid short option character '%c'.\n", short_option);
236                 break;
237             }
238 
239             return error;
240         }
241 
242         void
243         ResetOptionValues ()
244         {
245             Options::ResetOptionValues();
246 
247             name.clear();
248             use_objc      = false;
249             use_regex     = false;
250             show_args     = true;
251             show_locals   = true;
252             show_globals  = false;
253             show_types    = true;
254             show_scope    = false;
255             show_summary  = true;
256             show_location = false;
257             show_decl     = false;
258             debug         = false;
259             max_depth     = UINT32_MAX;
260             ptr_depth     = 0;
261             globals.clear();
262         }
263 
264         const lldb::OptionDefinition*
265         GetDefinitions ()
266         {
267             return g_option_table;
268         }
269 
270         // Options table: Required for subclasses of Options.
271 
272         static lldb::OptionDefinition g_option_table[];
273         std::string name;
274         bool use_objc:1,
275              use_regex:1,
276              show_args:1,
277              show_locals:1,
278              show_globals:1,
279              show_types:1,
280              show_scope:1,
281              show_summary:1,
282              show_location:1,
283              show_decl:1,
284              debug:1;
285         uint32_t max_depth; // The depth to print when dumping concrete (not pointers) aggreate values
286         uint32_t ptr_depth; // The default depth that is dumped when we find pointers
287         std::vector<ConstString> globals;
288         // Instance variables to hold the values for command options.
289     };
290 
291     CommandObjectFrameVariable () :
292         CommandObject (
293                 "frame variable",
294                 "Show specified argument, local variable, static variable or global variable for the current frame.  If none specified, list them all.",
295                 "frame variable [<cmd-options>] [<var-name1> [<var-name2>...]]")
296     {
297     }
298 
299     virtual
300     ~CommandObjectFrameVariable ()
301     {
302     }
303 
304     virtual
305     Options *
306     GetOptions ()
307     {
308         return &m_options;
309     }
310 
311     void
312     DumpValueObject (CommandReturnObject &result,
313                      ExecutionContextScope *exe_scope,
314                      ValueObject *valobj,
315                      const char *root_valobj_name,
316                      uint32_t ptr_depth,
317                      uint32_t curr_depth,
318                      uint32_t max_depth,
319                      bool use_objc)
320     {
321         if (valobj)
322         {
323             Stream &s = result.GetOutputStream();
324 
325             //const char *loc_cstr = valobj->GetLocationAsCString();
326             if (m_options.show_location)
327             {
328                 s.Printf("@ %s: ", valobj->GetLocationAsCString(exe_scope));
329             }
330             if (m_options.debug)
331                 s.Printf ("%p ValueObject{%u} ", valobj, valobj->GetID());
332 
333             s.Indent();
334 
335             if (m_options.show_types)
336                 s.Printf("(%s) ", valobj->GetTypeName().AsCString());
337 
338             const char *name_cstr = root_valobj_name ? root_valobj_name : valobj->GetName().AsCString("");
339             s.Printf ("%s = ", name_cstr);
340 
341             const char *val_cstr = valobj->GetValueAsCString(exe_scope);
342             const char *err_cstr = valobj->GetError().AsCString();
343 
344             if (err_cstr)
345             {
346                 s.Printf ("error: %s\n", err_cstr);
347             }
348             else
349             {
350                 const char *sum_cstr = valobj->GetSummaryAsCString(exe_scope);
351 
352                 const bool is_aggregate = ClangASTContext::IsAggregateType (valobj->GetOpaqueClangQualType());
353 
354                 if (val_cstr)
355                     s.PutCString(val_cstr);
356 
357                 if (sum_cstr)
358                     s.Printf(" %s", sum_cstr);
359 
360                 if (use_objc)
361                 {
362                     const char *object_desc = valobj->GetObjectDescription(exe_scope);
363                     if (object_desc)
364                         s.Printf("\n%s\n", object_desc);
365                     else
366                         s.Printf ("No description available.\n");
367                     return;
368                 }
369 
370 
371                 if (curr_depth < max_depth)
372                 {
373                     if (is_aggregate)
374                         s.PutChar('{');
375 
376                     bool is_ptr_or_ref = ClangASTContext::IsPointerOrReferenceType (valobj->GetOpaqueClangQualType());
377 
378                     if (is_ptr_or_ref && ptr_depth == 0)
379                         return;
380 
381                     const uint32_t num_children = valobj->GetNumChildren();
382                     if (num_children)
383                     {
384                         s.IndentMore();
385                         for (uint32_t idx=0; idx<num_children; ++idx)
386                         {
387                             ValueObjectSP child_sp(valobj->GetChildAtIndex(idx, true));
388                             if (child_sp.get())
389                             {
390                                 s.EOL();
391                                 DumpValueObject (result,
392                                                  exe_scope,
393                                                  child_sp.get(),
394                                                  NULL,
395                                                  is_ptr_or_ref ? ptr_depth - 1 : ptr_depth,
396                                                  curr_depth + 1,
397                                                  max_depth,
398                                                  false);
399                                 if (idx + 1 < num_children)
400                                     s.PutChar(',');
401                             }
402                         }
403                         s.IndentLess();
404                     }
405                     if (is_aggregate)
406                     {
407                         s.EOL();
408                         s.Indent("}");
409                     }
410                 }
411                 else
412                 {
413                     if (is_aggregate)
414                     {
415                         s.PutCString("{...}");
416                     }
417                 }
418 
419             }
420         }
421     }
422 
423     virtual bool
424     Execute
425     (
426         CommandInterpreter &interpreter,
427         Args& command,
428         CommandReturnObject &result
429     )
430     {
431         ExecutionContext exe_ctx(interpreter.GetDebugger().GetExecutionContext());
432         if (exe_ctx.frame == NULL)
433         {
434             result.AppendError ("invalid frame");
435             result.SetStatus (eReturnStatusFailed);
436             return false;
437         }
438         else
439         {
440             Stream &s = result.GetOutputStream();
441 
442             bool get_file_globals = true;
443             VariableList *variable_list = exe_ctx.frame->GetVariableList (get_file_globals);
444 
445             VariableSP var_sp;
446             ValueObjectSP valobj_sp;
447             //ValueObjectList &valobj_list = exe_ctx.frame->GetValueObjectList();
448             const char *name_cstr = NULL;
449             size_t idx;
450             if (!m_options.globals.empty())
451             {
452                 uint32_t fail_count = 0;
453                 if (exe_ctx.target)
454                 {
455                     const size_t num_globals = m_options.globals.size();
456                     for (idx = 0; idx < num_globals; ++idx)
457                     {
458                         VariableList global_var_list;
459                         const uint32_t num_matching_globals = exe_ctx.target->GetImages().FindGlobalVariables (m_options.globals[idx], true, UINT32_MAX, global_var_list);
460 
461                         if (num_matching_globals == 0)
462                         {
463                             ++fail_count;
464                             result.GetErrorStream().Printf ("error: can't find global variable '%s'\n", m_options.globals[idx].AsCString());
465                         }
466                         else
467                         {
468                             for (uint32_t global_idx=0; global_idx<num_matching_globals; ++global_idx)
469                             {
470                                 var_sp = global_var_list.GetVariableAtIndex(global_idx);
471                                 if (var_sp)
472                                 {
473                                     valobj_sp = exe_ctx.frame->GetValueObjectForFrameVariable (var_sp);
474                                     if (!valobj_sp)
475                                         valobj_sp = exe_ctx.frame->TrackGlobalVariable (var_sp);
476 
477                                     if (valobj_sp)
478                                     {
479                                         DumpValueObject (result, exe_ctx.frame, valobj_sp.get(), name_cstr, m_options.ptr_depth, 0, m_options.max_depth, false);
480 
481                                         if (m_options.show_decl && var_sp->GetDeclaration ().GetFile())
482                                         {
483                                             var_sp->GetDeclaration ().Dump (&s);
484                                         }
485 
486                                         s.EOL();
487                                     }
488                                 }
489                             }
490                         }
491                     }
492                 }
493                 if (fail_count)
494                     result.SetStatus (eReturnStatusFailed);
495             }
496             else if (variable_list)
497             {
498                 if (command.GetArgumentCount() > 0)
499                 {
500                     // If we have any args to the variable command, we will make
501                     // variable objects from them...
502                     for (idx = 0; (name_cstr = command.GetArgumentAtIndex(idx)) != NULL; ++idx)
503                     {
504                         uint32_t ptr_depth = m_options.ptr_depth;
505                         // If first character is a '*', then show pointer contents
506                         if (name_cstr[0] == '*')
507                         {
508                             ++ptr_depth;
509                             name_cstr++; // Skip the '*'
510                         }
511 
512                         std::string var_path (name_cstr);
513                         size_t separator_idx = var_path.find_first_of(".-[");
514 
515                         ConstString name_const_string;
516                         if (separator_idx == std::string::npos)
517                             name_const_string.SetCString (var_path.c_str());
518                         else
519                             name_const_string.SetCStringWithLength (var_path.c_str(), separator_idx);
520 
521                         var_sp = variable_list->FindVariable(name_const_string);
522                         if (var_sp)
523                         {
524                             valobj_sp = exe_ctx.frame->GetValueObjectForFrameVariable (var_sp);
525 
526                             var_path.erase (0, name_const_string.GetLength ());
527                             // We are dumping at least one child
528                             while (separator_idx != std::string::npos)
529                             {
530                                 // Calculate the next separator index ahead of time
531                                 ValueObjectSP child_valobj_sp;
532                                 const char separator_type = var_path[0];
533                                 switch (separator_type)
534                                 {
535 
536                                 case '-':
537                                     if (var_path.size() >= 2 && var_path[1] != '>')
538                                     {
539                                         result.GetErrorStream().Printf ("error: invalid character in variable path starting at '%s'\n",
540                                                                         var_path.c_str());
541                                         var_path.clear();
542                                         valobj_sp.reset();
543                                         break;
544                                     }
545                                     var_path.erase (0, 1); // Remove the '-'
546                                     // Fall through
547                                 case '.':
548                                     {
549                                         var_path.erase (0, 1); // Remove the '.' or '>'
550                                         separator_idx = var_path.find_first_of(".-[");
551                                         ConstString child_name;
552                                         if (separator_idx == std::string::npos)
553                                             child_name.SetCString (var_path.c_str());
554                                         else
555                                             child_name.SetCStringWithLength(var_path.c_str(), separator_idx);
556 
557                                         child_valobj_sp = valobj_sp->GetChildMemberWithName (child_name, true);
558                                         if (!child_valobj_sp)
559                                         {
560                                             result.GetErrorStream().Printf ("error: can't find child of '%s' named '%s'\n",
561                                                                             valobj_sp->GetName().AsCString(),
562                                                                             child_name.GetCString());
563                                             var_path.clear();
564                                             valobj_sp.reset();
565                                             break;
566                                         }
567                                         // Remove the child name from the path
568                                         var_path.erase(0, child_name.GetLength());
569                                     }
570                                     break;
571 
572                                 case '[':
573                                     // Array member access, or treating pointer as an array
574                                     if (var_path.size() > 2) // Need at least two brackets and a number
575                                     {
576                                         char *end = NULL;
577                                         int32_t child_index = ::strtol (&var_path[1], &end, 0);
578                                         if (end && *end == ']')
579                                         {
580 
581                                             if (valobj_sp->IsPointerType ())
582                                             {
583                                                 child_valobj_sp = valobj_sp->GetSyntheticArrayMemberFromPointer (child_index, true);
584                                             }
585                                             else
586                                             {
587                                                 child_valobj_sp = valobj_sp->GetChildAtIndex (child_index, true);
588                                             }
589 
590                                             if (!child_valobj_sp)
591                                             {
592                                                 result.GetErrorStream().Printf ("error: invalid array index %u in '%s'\n",
593                                                                                 child_index,
594                                                                                 valobj_sp->GetName().AsCString());
595                                                 var_path.clear();
596                                                 valobj_sp.reset();
597                                                 break;
598                                             }
599 
600                                             // Erase the array member specification '[%i]' where %i is the array index
601                                             var_path.erase(0, (end - var_path.c_str()) + 1);
602                                             separator_idx = var_path.find_first_of(".-[");
603 
604                                             // Break out early from the switch since we were able to find the child member
605                                             break;
606                                         }
607                                     }
608                                     result.GetErrorStream().Printf ("error: invalid array member specification for '%s' starting at '%s'\n",
609                                                                     valobj_sp->GetName().AsCString(),
610                                                                     var_path.c_str());
611                                     var_path.clear();
612                                     valobj_sp.reset();
613                                     break;
614 
615                                     break;
616 
617                                 default:
618                                     result.GetErrorStream().Printf ("error: invalid character in variable path starting at '%s'\n",
619                                                                         var_path.c_str());
620                                     var_path.clear();
621                                     valobj_sp.reset();
622                                     separator_idx = std::string::npos;
623                                     break;
624                                 }
625 
626                                 if (child_valobj_sp)
627                                     valobj_sp = child_valobj_sp;
628 
629                                 if (var_path.empty())
630                                     break;
631 
632                             }
633 
634                             if (valobj_sp)
635                             {
636                                 if (m_options.show_decl && var_sp->GetDeclaration ().GetFile())
637                                 {
638                                     var_sp->GetDeclaration ().DumpStopContext (&s, false);
639                                     s.PutCString (": ");
640                                 }
641 
642                                 DumpValueObject (result,
643                                                  exe_ctx.frame,
644                                                  valobj_sp.get(),
645                                                  name_cstr,
646                                                  ptr_depth,
647                                                  0,
648                                                  m_options.max_depth,
649                                                  m_options.use_objc);
650 
651                                 s.EOL();
652                             }
653                         }
654                         else
655                         {
656                             result.GetErrorStream().Printf ("error: unable to find any variables named '%s'\n", name_cstr);
657                             var_path.clear();
658                         }
659                     }
660                 }
661                 else
662                 {
663                     const uint32_t num_variables = variable_list->GetSize();
664 
665                     if (num_variables > 0)
666                     {
667                         for (uint32_t i=0; i<num_variables; i++)
668                         {
669                             VariableSP var_sp (variable_list->GetVariableAtIndex(i));
670                             bool dump_variable = true;
671 
672                             switch (var_sp->GetScope())
673                             {
674                             case eValueTypeVariableGlobal:
675                                 dump_variable = m_options.show_globals;
676                                 if (dump_variable && m_options.show_scope)
677                                     s.PutCString("GLOBAL: ");
678                                 break;
679 
680                             case eValueTypeVariableStatic:
681                                 dump_variable = m_options.show_globals;
682                                 if (dump_variable && m_options.show_scope)
683                                     s.PutCString("STATIC: ");
684                                 break;
685 
686                             case eValueTypeVariableArgument:
687                                 dump_variable = m_options.show_args;
688                                 if (dump_variable && m_options.show_scope)
689                                     s.PutCString("   ARG: ");
690                                 break;
691 
692                             case eValueTypeVariableLocal:
693                                 dump_variable = m_options.show_locals;
694                                 if (dump_variable && m_options.show_scope)
695                                     s.PutCString(" LOCAL: ");
696                                 break;
697 
698                             default:
699                                 break;
700                             }
701 
702                             if (dump_variable)
703                             {
704                                 //DumpVariable (result, &exe_ctx, var_sp.get());
705 
706                                 // Use the variable object code to make sure we are
707                                 // using the same APIs as the the public API will be
708                                 // using...
709                                 valobj_sp = exe_ctx.frame->GetValueObjectForFrameVariable (var_sp);
710                                 if (valobj_sp)
711                                 {
712 
713                                     if (m_options.show_decl && var_sp->GetDeclaration ().GetFile())
714                                     {
715                                         var_sp->GetDeclaration ().DumpStopContext (&s, false);
716                                         s.PutCString (": ");
717                                     }
718                                     DumpValueObject (result,
719                                                      exe_ctx.frame,
720                                                      valobj_sp.get(),
721                                                      name_cstr,
722                                                      m_options.ptr_depth,
723                                                      0,
724                                                      m_options.max_depth,
725                                                      m_options.use_objc);
726 
727                                     s.EOL();
728                                 }
729                             }
730                         }
731                     }
732                 }
733                 result.SetStatus (eReturnStatusSuccessFinishResult);
734             }
735         }
736         return result.Succeeded();
737     }
738 protected:
739 
740     CommandOptions m_options;
741 };
742 
743 lldb::OptionDefinition
744 CommandObjectFrameVariable::CommandOptions::g_option_table[] =
745 {
746 { LLDB_OPT_SET_1, false, "debug",      'D', no_argument,       NULL, 0, NULL,        "Enable verbose debug information."},
747 { LLDB_OPT_SET_1, false, "depth",      'd', required_argument, NULL, 0, "<count>",   "Set the max recurse depth when dumping aggregate types (default is infinity)."},
748 { LLDB_OPT_SET_1, false, "show-globals",'g', no_argument,      NULL, 0, NULL,        "Show the current frame source file global and static variables."},
749 { LLDB_OPT_SET_1, false, "find-global",'G', required_argument, NULL, 0, NULL,        "Find a global variable by name (which might not be in the current stack frame source file)."},
750 { LLDB_OPT_SET_1, false, "location",   'L', no_argument,       NULL, 0, NULL,        "Show variable location information."},
751 { LLDB_OPT_SET_1, false, "show-declaration", 'c', no_argument, NULL, 0, NULL,        "Show variable declaration information (source file and line where the variable was declared)."},
752 { LLDB_OPT_SET_1, false, "name",       'n', required_argument, NULL, 0, "<name>",    "Lookup a variable by name or regex (--regex) for the current execution context."},
753 { LLDB_OPT_SET_1, false, "no-args",    'a', no_argument,       NULL, 0, NULL,        "Omit function arguments."},
754 { LLDB_OPT_SET_1, false, "no-locals",  'l', no_argument,       NULL, 0, NULL,        "Omit local variables."},
755 { LLDB_OPT_SET_1, false, "no-types",   't', no_argument,       NULL, 0, NULL,        "Omit variable type names."},
756 { LLDB_OPT_SET_1, false, "no-summary", 'y', no_argument,       NULL, 0, NULL,        "Omit summary information."},
757 { LLDB_OPT_SET_1, false, "scope",      's', no_argument,       NULL, 0, NULL,        "Show variable scope (argument, local, global, static)."},
758 { LLDB_OPT_SET_1, false, "objc",       'o', no_argument,       NULL, 0, NULL,        "When looking up a variable by name (--name), print as an Objective-C object."},
759 { LLDB_OPT_SET_1, false, "ptr-depth",  'p', required_argument, NULL, 0, "<count>",   "The number of pointers to be traversed when dumping values (default is zero)."},
760 { LLDB_OPT_SET_1, false, "regex",      'r', no_argument,       NULL, 0, NULL,        "The <name> argument for name lookups are regular expressions."},
761 { 0, false, NULL, 0, 0, NULL, NULL, NULL, NULL }
762 };
763 #pragma mark CommandObjectMultiwordFrame
764 
765 //-------------------------------------------------------------------------
766 // CommandObjectMultiwordFrame
767 //-------------------------------------------------------------------------
768 
769 CommandObjectMultiwordFrame::CommandObjectMultiwordFrame (CommandInterpreter &interpreter) :
770     CommandObjectMultiword ("frame",
771                             "A set of commands for operating on the current thread's frames.",
772                             "frame <subcommand> [<subcommand-options>]")
773 {
774     LoadSubCommand (interpreter, "info",   CommandObjectSP (new CommandObjectFrameInfo ()));
775     LoadSubCommand (interpreter, "select", CommandObjectSP (new CommandObjectFrameSelect ()));
776     LoadSubCommand (interpreter, "variable", CommandObjectSP (new CommandObjectFrameVariable ()));
777 }
778 
779 CommandObjectMultiwordFrame::~CommandObjectMultiwordFrame ()
780 {
781 }
782 
783