dotfiles

Description

Dotfiles are a collection of configuration files used to customize the command-line environment and development tools.

📋 Table of Contents

• LLDB Commands
  • Custom Python Commands
  • Useful Aliases & Regex Commands
  • Command Infrastructure
• Installation
• Author
• License

LLDB Commands

This project enhances the LLDB debugging experience with custom Python commands, aliases, and a structured infrastructure.

Custom Python Commands

Command	Description	Arguments & Options
alcheck	Highlights UIViews with Auto Layout issues by outlining them in red.	[-c color] [-w width]
pdefaults	Dumps NSUserDefaults contents as a formatted key-value table.	[-s suite] [-f filter] [-o]
hex_dump	Reads memory at a specific address and returns a formatted hex dump.	<address> [-c count] [-o offset]
print_frame	Displays a detailed low-level architectural snapshot and resolved symbolic context of the current stack frame.	None
list_threads	Iterates through all process threads and displays their status, name, and queue info.	None

Useful Aliases & Regex Commands

A collection of shortcuts for common debugging tasks (defined in cmds.txt):

Command	Description
reload_lldbinit	Reloads the ~/.lldbinit file to apply changes without restarting LLDB.
rlook <regex>	Performs a regex-based image lookup (e.g., rlook UIViewController).
cp / cpo	Executes Objective-C expressions (with optional -O optimization).
sp / spo	Executes Swift expressions (with optional -O optimization).
lp / lpo / lpn	Executes expressions with a specified language (e.g., lp swift <expr>).
cpx / spx	Prints values in hexadecimal format for ObjC and Swift respectively.
doc <class>	Opens the official LLDB documentation for the specified class in your browser.
cpd / cpb / cpoo	Prints values in decimal, binary, or octal formats.

Command Infrastructure

The following files manage the loading and execution of custom commands:

File	Description
lldbinit.py	The main entry point that dynamically registers Python commands and sources configuration files.
lldbbase.py	Provides the BaseCommand abstract class and expression evaluation utilities used by all custom commands.
cmds.txt	A plain text file containing LLDB alias and regex command definitions.
settings.txt	Contains global LLDB settings (e.g., skip-prologue).

Installation

./bootstrap.sh

Author

Nikita Vasilev

• Email: nv3212@gmail.com
• GitHub: @ns-vasilev

License

dotfiles is available under the MIT license. See the LICENSE file for more info.

---

⬆ back to top

Made with ❤️ by space-code