(patrick  17-Dec-21) 

1

: #!/usr/bin/env python

 (patrick  03-Aug-20) 

2

: 

 (patrick  03-Aug-20) 

3

: # ---------------------------------------------------------------------

 (patrick  03-Aug-20) 

4

: # Be sure to add the python path that points to the LLDB shared library.

 (patrick  03-Aug-20) 

5

: #

 (patrick  03-Aug-20) 

6

: # # To use this in the embedded python interpreter using "lldb" just

 (patrick  03-Aug-20) 

7

: # import it with the full path using the "command script import"

 (patrick  03-Aug-20) 

8

: # command

 (patrick  03-Aug-20) 

9

: #   (lldb) command script import /path/to/cmdtemplate.py

 (patrick  03-Aug-20) 

10

: # ---------------------------------------------------------------------

 (patrick  03-Aug-20) 

11

: 

 (patrick  03-Aug-20) 

12

: import inspect

 (patrick  03-Aug-20) 

13

: import lldb

 (patrick  03-Aug-20) 

14

: import sys

 (robert   11-Jun-25) 

15

: from lldb.plugins.parsed_cmd import ParsedCommand

 (patrick  03-Aug-20) 

16

: 

 (robert   11-Jun-25) 

17

: class FrameStatCommand(ParsedCommand):

 (robert   11-Jun-25) 

18

:     program = "framestats"

 (patrick  03-Aug-20) 

19

: 

 (patrick  03-Aug-20) 

20

:     @classmethod

 (patrick  03-Aug-20) 

21

:     def register_lldb_command(cls, debugger, module_name):

 (robert   11-Jun-25) 

22

:         ParsedCommand.do_register_cmd(cls, debugger, module_name)

 (robert   11-Jun-25) 

23

:         print(

 (robert   11-Jun-25) 

24

:             'The "{0}" command has been installed, type "help {0}" or "{0} '

 (robert   11-Jun-25) 

25

:             '--help" for detailed help.'.format(cls.program)

 (robert   11-Jun-25) 

26

:         )

 (robert   11-Jun-25) 

27

: 

 (robert   11-Jun-25) 

28

:     def setup_command_definition(self):

 (robert   11-Jun-25) 

29

: 

 (robert   11-Jun-25) 

30

:         self.ov_parser.add_option(

 (robert   11-Jun-25) 

31

:             "i",

 (robert   11-Jun-25) 

32

:             "in-scope",

 (robert   11-Jun-25) 

33

:             help = "in_scope_only = True",

 (robert   11-Jun-25) 

34

:             value_type = lldb.eArgTypeBoolean,

 (robert   11-Jun-25) 

35

:             dest = "bool_arg",

 (robert   11-Jun-25) 

36

:             default = True,

 (robert   11-Jun-25) 

37

:         )

 (robert   11-Jun-25) 

38

: 

 (robert   11-Jun-25) 

39

:         self.ov_parser.add_option(

 (robert   11-Jun-25) 

40

:             "i",

 (robert   11-Jun-25) 

41

:             "in-scope",

 (robert   11-Jun-25) 

42

:             help = "in_scope_only = True",

 (robert   11-Jun-25) 

43

:             value_type = lldb.eArgTypeBoolean,

 (robert   11-Jun-25) 

44

:             dest = "inscope",

 (robert   11-Jun-25) 

45

:             default=True,

 (robert   11-Jun-25) 

46

:         )

 (robert   11-Jun-25) 

47

:         

 (robert   11-Jun-25) 

48

:         self.ov_parser.add_option(

 (robert   11-Jun-25) 

49

:             "a",

 (robert   11-Jun-25) 

50

:             "arguments",

 (robert   11-Jun-25) 

51

:             help = "arguments = True",

 (robert   11-Jun-25) 

52

:             value_type = lldb.eArgTypeBoolean,

 (robert   11-Jun-25) 

53

:             dest = "arguments",

 (robert   11-Jun-25) 

54

:             default = True,

 (robert   11-Jun-25) 

55

:         )

 (robert   11-Jun-25) 

56

: 

 (robert   11-Jun-25) 

57

:         self.ov_parser.add_option(

 (robert   11-Jun-25) 

58

:             "l",

 (robert   11-Jun-25) 

59

:             "locals",

 (robert   11-Jun-25) 

60

:             help = "locals = True",

 (robert   11-Jun-25) 

61

:             value_type = lldb.eArgTypeBoolean,

 (robert   11-Jun-25) 

62

:             dest = "locals",

 (robert   11-Jun-25) 

63

:             default = True,

 (robert   11-Jun-25) 

64

:         )

 (robert   11-Jun-25) 

65

: 

 (robert   11-Jun-25) 

66

:         self.ov_parser.add_option(

 (robert   11-Jun-25) 

67

:             "s",

 (robert   11-Jun-25) 

68

:             "statics",

 (robert   11-Jun-25) 

69

:             help = "statics = True",

 (robert   11-Jun-25) 

70

:             value_type = lldb.eArgTypeBoolean,

 (robert   11-Jun-25) 

71

:             dest = "statics",

 (robert   11-Jun-25) 

72

:             default = True,

 (robert   11-Jun-25) 

73

:         )

 (robert   11-Jun-25) 

74

: 

 (robert   11-Jun-25) 

75

:     def get_repeat_command(self, args):

 (robert   11-Jun-25) 

76

:         """As an example, make the command not auto-repeat:"""

 (robert   11-Jun-25) 

77

:         return ""

 (patrick  03-Aug-20) 

78

: 

 (patrick  03-Aug-20) 

79

:     def get_short_help(self):

 (patrick  03-Aug-20) 

80

:         return "Example command for use in debugging"

 (patrick  03-Aug-20) 

81

: 

 (patrick  03-Aug-20) 

82

:     def get_long_help(self):

 (robert   11-Jun-25) 

83

:         return ("This command is meant to be an example of how to make "

 (robert   11-Jun-25) 

84

:             "an LLDB command that does something useful, follows "

 (robert   11-Jun-25) 

85

:             "best practices, and exploits the SB API. "

 (robert   11-Jun-25) 

86

:             "Specifically, this command computes the aggregate "

 (robert   11-Jun-25) 

87

:             "and average size of the variables in the current "

 (robert   11-Jun-25) 

88

:             "frame and allows you to tweak exactly which variables "

 (robert   11-Jun-25) 

89

:             "are to be accounted in the computation.")

 (robert   11-Jun-25) 

90

: 

 (patrick  03-Aug-20) 

91

: 

 (patrick  03-Aug-20) 

92

:     def __init__(self, debugger, unused):

 (robert   11-Jun-25) 

93

:         super().__init__(debugger, unused)

 (patrick  03-Aug-20) 

94

: 

 (patrick  03-Aug-20) 

95

:     def __call__(self, debugger, command, exe_ctx, result):

 (patrick  03-Aug-20) 

96

:         # Always get program state from the lldb.SBExecutionContext passed

 (patrick  03-Aug-20) 

97

:         # in as exe_ctx

 (patrick  03-Aug-20) 

98

:         frame = exe_ctx.GetFrame()

 (patrick  03-Aug-20) 

99

:         if not frame.IsValid():

 (patrick  03-Aug-20) 

100

:             result.SetError("invalid frame")

 (patrick  03-Aug-20) 

101

:             return

 (patrick  03-Aug-20) 

102

: 

 (patrick  03-Aug-20) 

103

:         variables_list = frame.GetVariables(

 (robert   11-Jun-25) 

104

:             self.ov_parser.arguments, self.ov_parser.locals, self.ov_parser.statics, self.ov_parser.inscope

 (robert   11-Jun-25) 

105

:         )

 (patrick  03-Aug-20) 

106

:         variables_count = variables_list.GetSize()

 (patrick  03-Aug-20) 

107

:         if variables_count == 0:

 (patrick  03-Aug-20) 

108

:             print("no variables here", file=result)

 (patrick  03-Aug-20) 

109

:             return

 (patrick  03-Aug-20) 

110

:         total_size = 0

 (patrick  03-Aug-20) 

111

:         for i in range(0, variables_count):

 (patrick  03-Aug-20) 

112

:             variable = variables_list.GetValueAtIndex(i)

 (patrick  03-Aug-20) 

113

:             variable_type = variable.GetType()

 (patrick  03-Aug-20) 

114

:             total_size = total_size + variable_type.GetByteSize()

 (patrick  03-Aug-20) 

115

:             average_size = float(total_size) / variables_count

 (robert   11-Jun-25) 

116

:             print(

 (robert   11-Jun-25) 

117

:                 "Your frame has %d variables. Their total size "

 (robert   11-Jun-25) 

118

:                 "is %d bytes. The average size is %f bytes"

 (robert   11-Jun-25) 

119

:                 % (variables_count, total_size, average_size),

 (robert   11-Jun-25) 

120

:                 file=result,

 (robert   11-Jun-25) 

121

:             )

 (patrick  03-Aug-20) 

122

:         # not returning anything is akin to returning success

 (patrick  03-Aug-20) 

123

: 

 (patrick  03-Aug-20) 

124

: 

 (patrick  03-Aug-20) 

125

: def __lldb_init_module(debugger, dict):

 (patrick  03-Aug-20) 

126

:     # Register all classes that have a register_lldb_command method

 (patrick  03-Aug-20) 

127

:     for _name, cls in inspect.getmembers(sys.modules[__name__]):

 (robert   11-Jun-25) 

128

:         if inspect.isclass(cls) and callable(

 (robert   11-Jun-25) 

129

:             getattr(cls, "register_lldb_command", None)

 (robert   11-Jun-25) 

130

:         ):

 (patrick  03-Aug-20) 

131

:             cls.register_lldb_command(debugger, __name__)