124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//===-- CommandObjectApropos.cpp ---------------------------------*- C++ -*-===// 224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// The LLVM Compiler Infrastructure 424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// This file is distributed under the University of Illinois Open Source 624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// License. See LICENSE.TXT for details. 724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// 824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//===----------------------------------------------------------------------===// 924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 10d891f9b872103235cfd2ed452c6f14a4394d9b3aDaniel Malea#include "lldb/lldb-python.h" 11d891f9b872103235cfd2ed452c6f14a4394d9b3aDaniel Malea 1224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "CommandObjectApropos.h" 1324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 1424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// C Includes 1524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// C++ Includes 1624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Other libraries and framework includes 1724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// Project includes 1884cdc15005983e5244d665fa779e33c2b6fac95fJim Ingham#include "lldb/Interpreter/Args.h" 1984cdc15005983e5244d665fa779e33c2b6fac95fJim Ingham#include "lldb/Interpreter/Options.h" 2024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Interpreter/CommandInterpreter.h" 2224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner#include "lldb/Interpreter/CommandReturnObject.h" 2324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerusing namespace lldb; 2524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerusing namespace lldb_private; 2624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 2724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//------------------------------------------------------------------------- 2824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner// CommandObjectApropos 2924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner//------------------------------------------------------------------------- 3024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 31238c0a1e7b733cee539258faa656159c63f9e893Greg ClaytonCommandObjectApropos::CommandObjectApropos (CommandInterpreter &interpreter) : 32da26bd203cbb104291b39891febf7481794f205fJim Ingham CommandObjectParsed (interpreter, 33da26bd203cbb104291b39891febf7481794f205fJim Ingham "apropos", 34da26bd203cbb104291b39891febf7481794f205fJim Ingham "Find a list of debugger commands related to a particular word/subject.", 35da26bd203cbb104291b39891febf7481794f205fJim Ingham NULL) 3624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 3743b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice CommandArgumentEntry arg; 3843b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice CommandArgumentData search_word_arg; 3943b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice 4043b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice // Define the first (and only) variant of this arg. 4143b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice search_word_arg.arg_type = eArgTypeSearchWord; 4243b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice search_word_arg.arg_repetition = eArgRepeatPlain; 4343b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice 4443b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice // There is only one variant this argument could be; put it into the argument entry. 4543b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice arg.push_back (search_word_arg); 4643b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice 4743b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice // Push the data for the first argument into the m_arguments vector. 4843b014aa33e20e61790e16ed69a2c57aae2fbc6eCaroline Tice m_arguments.push_back (arg); 4924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} 5024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 5124943d2ee8bfaa7cf5893e4709143924157a5c1eChris LattnerCommandObjectApropos::~CommandObjectApropos() 5224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 5324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} 5424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 5524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 5624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattnerbool 57da26bd203cbb104291b39891febf7481794f205fJim InghamCommandObjectApropos::DoExecute (Args& args, CommandReturnObject &result) 5824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner{ 5936da2aa6dc5ad9994b638ed09eb81c44cc05540bGreg Clayton const size_t argc = args.GetArgumentCount (); 6024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 6124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner if (argc == 1) 6224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 6363094e0bb161580564954dee512955c1c79d3476Greg Clayton const char *search_word = args.GetArgumentAtIndex(0); 6424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner if ((search_word != NULL) 6524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner && (strlen (search_word) > 0)) 6624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 6724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // The bulk of the work must be done inside the Command Interpreter, since the command dictionary 6824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner // is private. 6924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StringList commands_found; 7024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner StringList commands_help; 71589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham StringList user_commands_found; 72589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham StringList user_commands_help; 73589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham 74589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham m_interpreter.FindCommandsForApropos (search_word, commands_found, commands_help, true, false); 75589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham m_interpreter.FindCommandsForApropos (search_word, user_commands_found, user_commands_help, false, true); 76589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham 77589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham if (commands_found.GetSize() == 0 && user_commands_found.GetSize() == 0) 7824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 7902c20f179f22def26469d3ec53fd4b3da4b5258bGreg Clayton result.AppendMessageWithFormat ("No commands found pertaining to '%s'. Try 'help' to see a complete list of debugger commands.\n", search_word); 8024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 8124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner else 8224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 83589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham if (commands_found.GetSize() > 0) 8424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 85589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham result.AppendMessageWithFormat ("The following built-in commands may relate to '%s':\n", search_word); 86589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham size_t max_len = 0; 87589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham 88589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham for (size_t i = 0; i < commands_found.GetSize(); ++i) 89589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham { 90589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham size_t len = strlen (commands_found.GetStringAtIndex (i)); 91589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham if (len > max_len) 92589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham max_len = len; 93589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham } 94589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham 95589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham for (size_t i = 0; i < commands_found.GetSize(); ++i) 96589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham m_interpreter.OutputFormattedHelpText (result.GetOutputStream(), 97589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham commands_found.GetStringAtIndex(i), 98589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham "--", 99589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham commands_help.GetStringAtIndex(i), 100589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham max_len); 101589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham if (user_commands_found.GetSize() > 0) 102589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham result.AppendMessage(""); 103589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham } 104589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham 105589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham if (user_commands_found.GetSize() > 0) 106589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham { 107589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham result.AppendMessageWithFormat ("The following user commands may relate to '%s':\n", search_word); 108589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham size_t max_len = 0; 109589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham 110589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham for (size_t i = 0; i < user_commands_found.GetSize(); ++i) 111589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham { 112589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham size_t len = strlen (user_commands_found.GetStringAtIndex (i)); 113589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham if (len > max_len) 114589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham max_len = len; 115589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham } 116589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham 117589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham for (size_t i = 0; i < user_commands_found.GetSize(); ++i) 118589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham m_interpreter.OutputFormattedHelpText (result.GetOutputStream(), 119589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham user_commands_found.GetStringAtIndex(i), 120589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham "--", 121589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham user_commands_help.GetStringAtIndex(i), 122589d3618411e8a757992482e4d0cb3cb79480f2eJim Ingham max_len); 12324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 124238c0a1e7b733cee539258faa656159c63f9e893Greg Clayton 12524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 126a04acd854c172427917054904dd0675d3cce4619Caroline Tice 127a04acd854c172427917054904dd0675d3cce4619Caroline Tice 12873844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton std::vector<const Property *> properties; 12973844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton const size_t num_properties = m_interpreter.GetDebugger().Apropos(search_word, properties); 13073844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton if (num_properties) 131a04acd854c172427917054904dd0675d3cce4619Caroline Tice { 13273844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton const bool dump_qualified_name = true; 133a04acd854c172427917054904dd0675d3cce4619Caroline Tice result.AppendMessageWithFormat ("\nThe following settings variables may relate to '%s': \n\n", search_word); 13473844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton for (size_t i=0; i<num_properties; ++i) 13573844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton properties[i]->DumpDescription (m_interpreter, result.GetOutputStream(), 0, dump_qualified_name); 13673844aa19a7360b662e2be710fc3c969d6c86606Greg Clayton 137a04acd854c172427917054904dd0675d3cce4619Caroline Tice } 138a04acd854c172427917054904dd0675d3cce4619Caroline Tice 13924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner result.SetStatus (eReturnStatusSuccessFinishNoResult); 14024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 14124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner else 14224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 14324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner result.AppendError ("'' is not a valid search word.\n"); 14424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner result.SetStatus (eReturnStatusFailed); 14524943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 14624943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 14724943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner else 14824943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner { 14924943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner result.AppendError ("'apropos' must be called with exactly one argument.\n"); 15024943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner result.SetStatus (eReturnStatusFailed); 15124943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner } 15224943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner 15324943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner return result.Succeeded(); 15424943d2ee8bfaa7cf5893e4709143924157a5c1eChris Lattner} 155