|
2 | 2 |
|
3 | 3 | `classdumpctl` is a command line tool to dump Objective-C class and protocol headers. |
4 | 4 |
|
5 | | -classdumpctl is built on top of [ClassDumpRuntime](https://github.com/leptos-null/ClassDumpRuntime) |
| 5 | +`classdumpctl` is built on top of [ClassDumpRuntime](https://github.com/leptos-null/ClassDumpRuntime). |
| 6 | + |
| 7 | +### Usage |
| 8 | + |
| 9 | +`classdumpctl` is designed for 3 primary uses: |
| 10 | + |
| 11 | +- Inspecting a single class or protocol at a time |
| 12 | + - use `-c <class name>` or `-p <protocol name>` |
| 13 | + - the output will be colorized by default (see `-m`) |
| 14 | + - you may need to specify `-i <path>` with the path to the library or framework containing the class or protocol if it's not already loaded |
| 15 | +- Dumping a single library or framework |
| 16 | + - use `-i <path>` to specify the path to the binary |
| 17 | + - use `-o <path>` to specify a directory to put the headers in |
| 18 | +- Dumping the entire `dyld_shared_cache` |
| 19 | + - use `-a` |
| 20 | + - use `-o <path>` to specify a directory to put the headers in |
| 21 | + - uses concurrency to process all images in the shared cache quickly (see `-j`) |
| 22 | + |
| 23 | +It can also do more. See the full options listing below: |
| 24 | + |
| 25 | +``` |
| 26 | +Usage: classdumpctl [options] |
| 27 | +Options: |
| 28 | + -a, --dyld_shared_cache Interact in the dyld_shared_cache |
| 29 | + by default, dump all classes in the cache |
| 30 | + -l, --list List all classes in the specified image |
| 31 | + if specified with -a/--dyld_shared_cache |
| 32 | + lists all images in the dyld_shared_cache |
| 33 | + -o <p>, --output=<p> Use path as the output directory |
| 34 | + if specified with -a/--dyld_shared_cache |
| 35 | + the file structure of the cache is written to |
| 36 | + the specified directory, otherwise all classes found |
| 37 | + are written to this directory at the top level |
| 38 | + -m <m>, --color=<m> Set color settings, one of the below |
| 39 | + default: color output only if output is to a TTY |
| 40 | + never: no output is colored |
| 41 | + always: output to TTYs, pipes, and files are colored |
| 42 | + -i <p>, --image=<p> Reference the mach-o image at path |
| 43 | + by default, dump all classes in this image |
| 44 | + otherwise may specify --class or --protocol |
| 45 | + -c <s>, --class=<s> Dump class to stdout (unless -o is specified) |
| 46 | + -p <s>, --protocol=<s> Dump protocol to stdout (unless -o is specified) |
| 47 | + -j <N>, --jobs=<N> Allow N jobs at once |
| 48 | + only applicable when specified with -a/--dyld_shared_cache |
| 49 | + (defaults to number of processing core available) |
| 50 | +``` |
0 commit comments