lldb_commands
Installation
lowmad
lowmad install git@github.com:bangerang/lldb_commands.git
Manual
Add the scripts manually to ~/.lldbinit
command script import /path/to/script
LLDB Scripts
diff
Performs a diff using git difftool. Accepts any expression that yields a result.
(lldb) diff model // Set lhs
(lldb) diff sameModelLater // Set rhs and performs diff
Also supports passing two arguments right away.
(lldb) diff frame variable self.dog == frame variable self.cat
diff also has support for locking the lhs.
(lldb) diff -l model
(lldb) diff sameModelLater // model == sameModelLater
(lldb) diff sameModelEvenLater // model == sameModelEvenLater
logger
Write expressions or a string message to a log. Log is saved to ~/Library/Logs/ which makes is available in the Console app.
(lldb) logger po self.view.frame
Description argument can be added for categorisation.
(lldb) logger -d "Layout" po self.view.frame
Can also log a regular string message, if this argument is passed the expression is ignored.
(lldb) logger -s "Hello world!"
rviews
Prints out the recursive description of a view expression.
(lldb) rviews self.view
<UIView: 0x7fd2eae09c40; frame = (0 0; 428 926); autoresize = W+H; layer = <CALayer: 0x600001f1ef40>>
| <UILabel: 0x7fd2daf094a0; frame = (195.667 453; 37 20.3333); text = 'error'; userInteractionEnabled = NO; layer = <_UILabelLayer: 0x600003c1c0a0>>
instruction
Returns the first occurence of given opcode.
(lldb) instruction jne
0x101d88520 <+160>: jne 0x101d8852c ; <+172> at ViewController.swift:141:9
You can also change the opcode on the fly.
(lldb) instruction jne -o 74
find_label
Prints out description of UILabel with given text.
(lldb) find_label Welcome to the jungle!
<UILabel: 0x7ffed2494e70; frame = (50 214; 328 36); text = 'Welcome to the jungle!'; userInteractionEnabled = NO; layer = <_UILabelLayer: 0x600000ae6ad0>>
Print out superview as well.
(lldb) find_label Welcome to the jungle! -s
<UIScrollView: 0x7ffed2895600; baseClass = UIScrollView; frame = (0 0; 428 926); clipsToBounds = YES; gestureRecognizers = <NSArray: 0x6000026896b0>; layer = <CALayer: 0x6000029e8d80>; contentOffset: {0, 0}; contentSize: {0, 532.66666666666674}; adjustedContentInset: {0, 0, 83, 0}>
| <UILabel: 0x7ffed2494e70; frame = (50 214; 328 36); text = 'Welcome to the jungle!'; userInteractionEnabled = NO; layer = <_UILabelLayer: 0x600000ae6ad0>>
vc
Prints out description of UIViewController responsible for view
(lldb) vc 0x7fe69a110e50
<Project.MyViewController: 0x7fe6b8d23300>
pipe
Transform output by piping commands together.
Example uses find_label and vc command to print out description of UIViewController responsible for the UILabel with text Welcome to the jungle!
(lldb) pipe find_label Welcome to the jungle! -a | vc
<Project.MyViewController: 0x7fe6b8d23300>
vcl
Convenience script for the pipe example above. Prints out description of UIViewController responsible for the UILabel with text Welcome to the jungle!
(lldb) vcl Welcome to the jungle!
<Project.MyViewController: 0x7fe6b8d23300>
c
If the given command yields an address, the address is copied to clipboard.
(lldb) c find_label Hel
Did copy address to clipboard.
<UILabel: 0x7fefb7a0cd20; frame = (56 377; 302 72); text = 'Hello!'; userInteractionEnabled = NO; layer = <_UILabelLayer: 0x600000ee3250>>
color
Change background color of given view.
(lldb) color 0x7ffed2895600 [UIColor greenColor]
json
Print out JSON representation of Encodable object.
(lldb) json johnDoe
"{\"name\":\"John Doe\",\"age\":32}"
pcopy
Copy output to pasteboard.
(lldb) pcopy po "foo"
variable
Assign a random variable to a given value
(lldb) variable self
$wxsi = <MyApp.ViewController: 0x7ff29280b720>
pdump
Copy output from Swift's dump to pasteboard.
(lldb) pdump "foo"
swiftui_log
Will automatically call Self._printChanges() for every SwiftUI view body redraw.
(lldb) swiftui_print
ContentView: _viewModel changed.
swiftui_diff
Outputs a diff for every @Published change on ObservableObject. Quite slow since it needs to evaluate code for each breakpoint hit. Does not work on intel machines.
(lldb) swiftui_diff
šµ ObjectWillChange for MyViewModel, _numbers did change to: 14
šµ ObjectWillChange for MyViewModel, _sum did change to: 5
š£ Called view body for ContentView