Rust Unsafe

Rust unsafe

Purpose

Guide agents through writing, reviewing, and reasoning about unsafe Rust: what operations require unsafe, how to write safe abstractions, audit patterns, common pitfalls, and when to reach for unsafe.

Triggers

• "When do I need to use unsafe in Rust?"
• "How do I write a safe abstraction over unsafe code?"
• "How do I audit an unsafe block?"
• "What are the rules for raw pointers in Rust?"
• "What does transmute do and when is it safe?"
• "How do I implement UnsafeCell correctly?"

Workflow

1. The five unsafe superpowers

unsafe grants exactly five capabilities not available in safe Rust:

1. Dereference raw pointers (*const T, *mut T)
2. Call unsafe functions (including extern "C" functions)
3. Access or modify mutable static variables
4. Implement unsafe traits (Send, Sync)
5. Access fields of unions

Everything else in Rust — including memory allocation, borrowing, closures — follows safe rules even inside unsafe blocks.

2. Raw pointers

// Creating raw pointers (safe — no dereference yet)
let x = 42u32;
let ptr: *const u32 = &x;
let mut_ptr: *mut u32 = &mut some_val as *mut u32;