Skip to content

Commit 42949b5

Browse files
committed
docs: add CLI examples to ipsw dsc disass cmd
1 parent bd849ac commit 42949b5

File tree

2 files changed

+31
-10
lines changed

2 files changed

+31
-10
lines changed

www/docs/cli/ipsw/dyld/disass.md

+30-10
Original file line numberDiff line numberDiff line change
@@ -14,19 +14,39 @@ Disassemble at symbol/vaddr
1414
ipsw dyld disass <DSC> [flags]
1515
```
1616

17+
### Examples
18+
19+
```bash
20+
# Disassemble all images in dyld_shared_cache
21+
❯ ipsw dsc disass DSC
22+
# Disassemble a few dylibs in dyld_shared_cache (NOTE: multiple -i flags OR comma separated dylibs)
23+
❯ ipsw dsc disass DSC --image libsystem_kernel.dylib --image libsystem_platform.dylib,libsystem_pthread.dylib
24+
# Disassemble a symbol in dyld_shared_cache (NOTE: supply --symbol-image 'libsystem_malloc.dylib' for faster lookup)
25+
❯ ipsw dsc disass DSC --symbol _malloc
26+
# Disassemble a function at a virtual address in dyld_shared_cache
27+
❯ ipsw dsc disass DSC --vaddr 0x1b19d6940
28+
# Disassemble a function at a virtual address in dyld_shared_cache and output as JSON
29+
❯ ipsw dsc disass DSC --vaddr 0x1b19d6940 --json
30+
# Disassemble a function at a virtual address in dyld_shared_cache and demangle symbol names
31+
❯ ipsw dsc disass DSC --vaddr 0x1b19d6940 --demangle
32+
# Disassemble a function at a virtual address in dyld_shared_cache and do NOT markup analysis (Faster)
33+
❯ ipsw dsc disass DSC --vaddr 0x1b19d6940 --quiet
34+
```
35+
1736
### Options
1837

1938
```
20-
--cache string Path to .a2s addr to sym cache file (speeds up analysis)
21-
-c, --count uint Number of instructions to disassemble
22-
-d, --demangle Demangle symbol names
23-
-h, --help help for disass
24-
-i, --image string dylib image to search
25-
--input string Input function JSON file
26-
-j, --json Output as JSON
27-
-q, --quiet Do NOT markup analysis (Faster)
28-
-s, --symbol string Function to disassemble
29-
-a, --vaddr uint Virtual address to start disassembling
39+
--cache string Path to .a2s addr to sym cache file (speeds up analysis)
40+
-c, --count uint Number of instructions to disassemble
41+
-d, --demangle Demangle symbol names
42+
-h, --help help for disass
43+
-i, --image strings Dylib(s) to disassemble
44+
--input string Input function JSON file
45+
-j, --json Output as JSON
46+
-q, --quiet Do NOT markup analysis (Faster)
47+
-s, --symbol string Function to disassemble
48+
--symbol-image string Dylib to search for symbol (speeds up symbol lookup)
49+
-a, --vaddr uint Virtual address to start disassembling
3050
```
3151

3252
### Options inherited from parent commands

www/docs/cli/ipsw/macho/disass.md

+1
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,7 @@ ipsw macho disass <MACHO> [flags]
2323
-c, --count uint Number of instructions to disassemble
2424
-d, --demangle Demangle symbol names
2525
-t, --fileset-entry string Which fileset entry to analyze
26+
--force Continue to disassemble even if there are analysis errors
2627
-h, --help help for disass
2728
-j, --json Output as JSON
2829
-o, --off uint File offset to start disassembling

0 commit comments

Comments
 (0)