HyperOS-Directory-Traversal-Analysis/
│
├── 📁 .github/                     # GitHub community and CI/CD workflows
│   ├── 📁 ISSUE_TEMPLATE/          # Bug and feature request templates
│   │   ├── 📄 config.yml           # Issue template configuration and links
│   │   ├── 📄 hata-raporu.yml      # Bug report form (YAML Forms)
│   │   └── 📄 ozellik-istegi.yml   # Feature request form (YAML Forms)
│   ├── 📁 workflows/
│   │   ├── 📄 rust.yml             # Rust CI — Build, test and lint pipeline
│   │   ├── 📄 pages.yml            # GitHub Pages automatic publishing
│   │   ├── 📄 security.yml         # Security scan (cargo-audit, CodeQL)
│   │   └── 📄 docs.yml             # Documentation lint and link check
│   ├── 📄 dependabot.yml           # Automatic dependency updates
│   ├── 📄 FUNDING.yml              # GitHub Sponsors configuration
│   ├── 📄 mlc_config.json          # Markdown link checker settings
│   ├── 📄 PULL_REQUEST_TEMPLATE.md
│   └── 📄 SECURITY.md              # Security policy
│
├── 📁 assets/                      # Logo and image files
│   └── 🖼️ isu-logo.png             # İstinye University logo
│
│
├── 📁 docs/                        # Technical documentation
│   ├── 📄 zafiyet-analizi.md       # Vulnerability analysis and CVSS scoring
│   ├── 📄 mimari-analiz.md         # HyperOS AVCodec architecture diagram
│   ├── 📄 cozum-onerileri.md       # Mitigation recommendations and C++ patches
│   └── 📄 README.md                # Documentation guide index
│
├── 📁 research_results/            # Assignment research results
│   ├── 📄 Cevaplarım.md            # Answers to 10 advanced questions
│   ├── 📄 SORULAR.md               # Assignment questions
│   ├── 📄 yorum.md                 # Personal analysis and commentary
│   ├── 📄 simple.md                # Simple explanations (50 steps)
│   ├── 🌐 infographic.html         # Visual vulnerability guide
│   └── 📄 README.md                # Research results index
│
├── 📁 poc_python/                  # Python analysis tools (Reference)
│   ├── 📄 exploit.py               # CVE-2025-2844 Directory Traversal PoC
│   └── 📄 requirements.txt
│
├── 📁 poc_rust/                    # Rust UAF simulation (Main PoC)
│   ├── 📁 src/
│   │   └── 📄 main.rs              # Unsafe Rust UAF simulation logic
│   └── 📄 Cargo.toml
│
├── 🌐 simulation.html              # Interactive web simulation panel (5 scenes)
├── 📄 README.md                    # This file
├── 📄 CODE_OF_CONDUCT.md           # Community code of conduct
├── 📄 CONTRIBUTING.md              # Contribution guide
├── 📄 TODO.md                      # Task tracking list
└── ⚖️  LICENSE                      # MIT License

[Main Thread]    processFrameAsync() → Worker thread started
                      ↓
                release() called → Memory FREED ⚠️
                      ↓
[Worker Thread] Continues to access freed memory → UAF 💥

# Clone the project
git clone https://github.com/kkaanozturk/HyperOS-Directory-Traversal-Analysis.git
cd HyperOS-Directory-Traversal-Analysis/poc_rust

# Compile in release mode
cargo build --release

# Windows
.\target\release\cve_2025_21082_uaf_poc.exe --mode vulnerable --verbose

# Linux / macOS
./target/release/cve_2025_21082_uaf_poc --mode vulnerable --verbose

🔬 CVE-2025-21082: HyperOS AVCodec UAF PoC
Mode: vulnerable

⚠️  Running vulnerable scenario...
CodecContext allocated in Arc<Mutex<T>>
🧵 Starting worker thread...
🗑️  Main thread releasing codec context (UAF trigger)...
Memory corrupted to simulate UAF
🔄 Worker thread accessing codec context...
🚨 UAF detected! Magic number corrupted: 0xFEEDFACE
💥 UAF vulnerability triggered on frame 0!

🚨 Vulnerable scenario completed - UAF demonstrated!
⚠️  In a real exploit, this could lead to RCE

# Windows
.\target\release\cve_2025_21082_uaf_poc.exe --mode patched --verbose

# Linux / macOS
./target/release/cve_2025_21082_uaf_poc --mode patched --verbose

🔬 CVE-2025-21082: HyperOS AVCodec UAF PoC
Mode: patched

✅ Running patched scenario...
CodecContext allocated safely in Arc<Mutex<T>>
🧵 Starting worker thread...
⏳ Waiting for worker thread to complete (patch applied)...
🔄 Worker thread processing frames safely...
✅ Frame 0 processed successfully
✅ Frame 1 processed successfully
✅ Frame 2 processed successfully
✅ Frame 3 processed successfully
✅ Frame 4 processed successfully
✅ Worker thread completed safely
🗑️  Safely releasing codec context...

✅ Patched scenario completed - No UAF occurred!
🛡️  Proper synchronization prevents the vulnerability

# In the project root directory
py -m http.server 8000

# Open in your browser: http://localhost:8000/simulation.html

cd poc_python
py -m pip install -r requirements.txt
py exploit.py -u http://hedef:5000 -f etc/shadow

class AVCodecContext {
    void processFrameAsync() {
        worker_thread_ = std::thread([this]() {
            buffer_->processFrame(); // Worker thread is running
        });
        // ❌ No join() — race condition!
    }

    void release() {
        delete buffer_; // ❌ Memory freed while worker is still running
        buffer_ = nullptr;
    }
};

class AVCodecContext {
    void release() {
        shutdown_requested_ = true;
        worker_cv_.notify_all();

        if (worker_thread_.joinable()) {
            worker_thread_.join(); // ✅ Wait until thread completes
        }

        delete buffer_; // ✅ Safe cleanup
    }
};

unsafe fn process_frame(&mut self) -> bool {
    // If magic number is corrupted, UAF has occurred
    if self.magic != 0xDEADBEEF {
        println!("🚨 UAF detected! Magic: 0x{:08X}", self.magic);
        return false;
    }
    self.frame_counter += 1;
    true
}