LuLu Documentation

Technical Documentation: objective-see/LuLu

ℹ️ Provenance: Multi-Tier Ingestion · CodeWiki Reference

Overview (`README.md`) Copy Section

LuLu

简体中文 | 正體中文

LuLu is the free open-source macOS firewall:

Documentation:
Full details and usage instructions can be found here.

To Support:
❤  Love this product and want to support it? Please check out my patreon page.

Overview (`LuLu/Tests/README.md`) Copy Section

LuLu Passive Mode Improvements Tests

This directory contains tests for the passive mode FQDN rule creation improvements.

What's Tested Copy Chapter

🎯 Domain Name Prioritization Copy Section

• Prioritizes flow.URL.host over flow.remoteHostname over remoteEndpoint.hostname
• Ensures rules use domain names like github.com instead of IP addresses like 140.82.112.3

🎨 Smart Port Display Copy Section

• Hides common ports (80, 443) for cleaner UI display
• Shows uncommon ports (8080, 3000, etc.) to highlight important information
• Preserves full data internally for precise filtering

🔗 End-to-End Integration Copy Section

• Validates complete flow from network traffic to final rule display
• Tests real-world scenarios with complex URLs and various port configurations

Running Tests Copy Chapter

# Run the complete test suite
./run_passive_mode_tests.sh

Test Results Copy Chapter

✅ 9/9 tests pass covering all functionality

Before/After Examples Copy Section

Files Copy Chapter

• test_passive_mode_improvements.m - Comprehensive test suite
• run_passive_mode_tests.sh - Build and run script
• README.md - This file

--- METRICS ---

• Files Extracted: 2
• Estimated Token Budget: ~514 tokens
• Canonical Reference: https://codewiki.google/github.com/objective-see/LuLu