Skip to content

Commit 49b393c

Browse files
committed
[README] Add Usage section
1 parent 1d287ae commit 49b393c

File tree

1 file changed

+46
-1
lines changed

1 file changed

+46
-1
lines changed

README.md

Lines changed: 46 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,49 @@
22

33
`classdumpctl` is a command line tool to dump Objective-C class and protocol headers.
44

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

Comments
 (0)