1 //===-- CommandObjectApropos.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 "CommandObjectApropos.h"
11 
12 // C Includes
13 // C++ Includes
14 // Other libraries and framework includes
15 // Project includes
16 #include "lldb/Interpreter/Args.h"
17 #include "lldb/Interpreter/Options.h"
18 
19 #include "lldb/Interpreter/CommandInterpreter.h"
20 #include "lldb/Interpreter/CommandReturnObject.h"
21 
22 using namespace lldb;
23 using namespace lldb_private;
24 
25 //-------------------------------------------------------------------------
26 // CommandObjectApropos
27 //-------------------------------------------------------------------------
28 
29 CommandObjectApropos::CommandObjectApropos (CommandInterpreter &interpreter) :
30     CommandObjectParsed (interpreter,
31                          "apropos",
32                          "Find a list of debugger commands related to a particular word/subject.",
33                          NULL)
34 {
35     CommandArgumentEntry arg;
36     CommandArgumentData search_word_arg;
37 
38     // Define the first (and only) variant of this arg.
39     search_word_arg.arg_type = eArgTypeSearchWord;
40     search_word_arg.arg_repetition = eArgRepeatPlain;
41 
42     // There is only one variant this argument could be; put it into the argument entry.
43     arg.push_back (search_word_arg);
44 
45     // Push the data for the first argument into the m_arguments vector.
46     m_arguments.push_back (arg);
47 }
48 
49 CommandObjectApropos::~CommandObjectApropos()
50 {
51 }
52 
53 
54 bool
55 CommandObjectApropos::DoExecute (Args& args, CommandReturnObject &result)
56 {
57     const int argc = args.GetArgumentCount ();
58 
59     if (argc == 1)
60     {
61         const char *search_word = args.GetArgumentAtIndex(0);
62         if ((search_word != NULL)
63             && (strlen (search_word) > 0))
64         {
65             // The bulk of the work must be done inside the Command Interpreter, since the command dictionary
66             // is private.
67             StringList commands_found;
68             StringList commands_help;
69             m_interpreter.FindCommandsForApropos (search_word, commands_found, commands_help);
70             if (commands_found.GetSize() == 0)
71             {
72                 result.AppendMessageWithFormat ("No commands found pertaining to '%s'. Try 'help' to see a complete list of debugger commands.\n", search_word);
73             }
74             else
75             {
76                 result.AppendMessageWithFormat ("The following commands may relate to '%s':\n", search_word);
77                 size_t max_len = 0;
78 
79                 for (size_t i = 0; i < commands_found.GetSize(); ++i)
80                 {
81                     size_t len = strlen (commands_found.GetStringAtIndex (i));
82                     if (len > max_len)
83                         max_len = len;
84                 }
85 
86                 for (size_t i = 0; i < commands_found.GetSize(); ++i)
87                     m_interpreter.OutputFormattedHelpText (result.GetOutputStream(),
88                                                            commands_found.GetStringAtIndex(i),
89                                                            "--", commands_help.
90                                                            GetStringAtIndex(i),
91                                                            max_len);
92 
93             }
94 
95 
96             StreamString settings_search_results;
97             lldb::UserSettingsControllerSP root = Debugger::GetSettingsController ();
98             const char *settings_prefix = root->GetLevelName().GetCString();
99 
100             UserSettingsController::SearchAllSettingsDescriptions (m_interpreter,
101                                                                    root,
102                                                                    settings_prefix,
103                                                                    search_word,
104                                                                    settings_search_results);
105 
106             if (settings_search_results.GetSize() > 0)
107             {
108                 result.AppendMessageWithFormat ("\nThe following settings variables may relate to '%s': \n\n", search_word);
109                 result.AppendMessageWithFormat ("%s", settings_search_results.GetData());
110             }
111 
112             result.SetStatus (eReturnStatusSuccessFinishNoResult);
113         }
114         else
115         {
116             result.AppendError ("'' is not a valid search word.\n");
117             result.SetStatus (eReturnStatusFailed);
118         }
119     }
120     else
121     {
122         result.AppendError ("'apropos' must be called with exactly one argument.\n");
123         result.SetStatus (eReturnStatusFailed);
124     }
125 
126     return result.Succeeded();
127 }
128