xref: /freebsd-src/contrib/llvm-project/lldb/source/Commands/CommandObjectHelp.h (revision 0b57cec536236d46e3dba9bd041533462f33dbb7)
1 //===-- CommandObjectHelp.h -------------------------------------*- C++ -*-===//
2 //
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6 //
7 //===----------------------------------------------------------------------===//
8 
9 #ifndef liblldb_CommandObjectHelp_h_
10 #define liblldb_CommandObjectHelp_h_
11 
12 #include "lldb/Host/OptionParser.h"
13 #include "lldb/Interpreter/CommandObject.h"
14 #include "lldb/Interpreter/Options.h"
15 
16 namespace lldb_private {
17 
18 // CommandObjectHelp
19 
20 class CommandObjectHelp : public CommandObjectParsed {
21 public:
22   CommandObjectHelp(CommandInterpreter &interpreter);
23 
24   ~CommandObjectHelp() override;
25 
26   int HandleCompletion(CompletionRequest &request) override;
27 
28   static void GenerateAdditionalHelpAvenuesMessage(
29       Stream *s, llvm::StringRef command, llvm::StringRef prefix,
30       llvm::StringRef subcommand, bool include_upropos = true,
31       bool include_type_lookup = true);
32 
33   class CommandOptions : public Options {
34   public:
35     CommandOptions() : Options() {}
36 
37     ~CommandOptions() override {}
38 
39     Status SetOptionValue(uint32_t option_idx, llvm::StringRef option_arg,
40                           ExecutionContext *execution_context) override {
41       Status error;
42       const int short_option = m_getopt_table[option_idx].val;
43 
44       switch (short_option) {
45       case 'a':
46         m_show_aliases = false;
47         break;
48       case 'u':
49         m_show_user_defined = false;
50         break;
51       case 'h':
52         m_show_hidden = true;
53         break;
54       default:
55         error.SetErrorStringWithFormat("unrecognized option '%c'",
56                                        short_option);
57         break;
58       }
59 
60       return error;
61     }
62 
63     void OptionParsingStarting(ExecutionContext *execution_context) override {
64       m_show_aliases = true;
65       m_show_user_defined = true;
66       m_show_hidden = false;
67     }
68 
69     llvm::ArrayRef<OptionDefinition> GetDefinitions() override;
70 
71     // Instance variables to hold the values for command options.
72 
73     bool m_show_aliases;
74     bool m_show_user_defined;
75     bool m_show_hidden;
76   };
77 
78   Options *GetOptions() override { return &m_options; }
79 
80 protected:
81   bool DoExecute(Args &command, CommandReturnObject &result) override;
82 
83 private:
84   CommandOptions m_options;
85 };
86 
87 } // namespace lldb_private
88 
89 #endif // liblldb_CommandObjectHelp_h_
90