Add INSTALL.md with dependency installation instructions for Fedora and Debian

Co-authored-by: Cursor <cursoragent@cursor.com>

INSTALL.md

@@ -0,0 +1,187 @@
+# Installation Guide
+
+This guide covers installing dependencies and building `fiwi_monitor` on different Linux distributions.
+
+## Prerequisites
+
+The `fiwi_monitor` tool requires:
+- **Build tools**: GCC compiler, autotools (autoconf, automake, libtool)
+- **Development libraries**: libpcap, libnl3 (for WiFi monitor mode)
+- **Package configuration**: pkg-config
+
+## Fedora / RHEL / CentOS
+
+### Install Dependencies
+
+```bash
+sudo dnf install -y \
+    gcc \
+    autoconf \
+    automake \
+    libtool \
+    libpcap-devel \
+    libnl3-devel \
+    pkg-config
+```
+
+### Build
+
+```bash
+# Generate configure script
+./autogen.sh
+
+# Configure build
+./configure
+
+# Build
+make
+
+# Install (optional, system-wide)
+sudo make install
+```
+
+## Debian / Ubuntu / Raspberry Pi OS
+
+### Install Dependencies
+
+```bash
+sudo apt-get update
+sudo apt-get install -y \
+    build-essential \
+    autoconf \
+    automake \
+    libtool \
+    libpcap-dev \
+    libnl-genl-3-dev \
+    libnl-3-dev \
+    pkg-config
+```
+
+### Build
+
+```bash
+# Generate configure script
+./autogen.sh
+
+# Configure build
+./configure
+
+# Build
+make
+
+# Install (optional, system-wide)
+sudo make install
+```
+
+## Verification
+
+After installation, verify the libraries are available:
+
+```bash
+# Check libpcap
+pkg-config --exists libpcap && echo "libpcap: OK" || echo "libpcap: MISSING"
+
+# Check libnl-genl-3.0
+pkg-config --exists libnl-genl-3.0 && echo "libnl-genl-3.0: OK" || echo "libnl-genl-3.0: MISSING"
+
+# Check libnl-3.0
+pkg-config --exists libnl-3.0 && echo "libnl-3.0: OK" || echo "libnl-3.0: MISSING"
+```
+
+## Troubleshooting
+
+### Package Not Found (Fedora)
+
+If `libnl3-devel` is not found, try:
+```bash
+# Search for available packages
+dnf search libnl
+
+# May need to enable additional repositories
+sudo dnf install epel-release
+```
+
+### Package Not Found (Debian/Ubuntu)
+
+If packages are not found:
+```bash
+# Update package lists
+sudo apt-get update
+
+# Search for packages
+apt-cache search libnl
+apt-cache search libpcap
+```
+
+### Configure Fails
+
+If `./configure` fails with "Package requirements not met":
+
+1. **Verify packages are installed:**
+   ```bash
+   # Fedora
+   rpm -qa | grep libnl
+   rpm -qa | grep libpcap
+   
+   # Debian/Ubuntu
+   dpkg -l | grep libnl
+   dpkg -l | grep libpcap
+   ```
+
+2. **Check pkg-config can find them:**
+   ```bash
+   pkg-config --modversion libpcap
+   pkg-config --modversion libnl-genl-3.0
+   pkg-config --modversion libnl-3.0
+   ```
+
+3. **If pkg-config can't find them, check PKG_CONFIG_PATH:**
+   ```bash
+   # Common locations
+   export PKG_CONFIG_PATH=/usr/lib/pkgconfig:/usr/lib64/pkgconfig
+   ./configure
+   ```
+
+### Build Errors
+
+If you get compilation errors:
+
+1. **Missing headers:**
+   ```bash
+   # Fedora - install kernel headers if needed
+   sudo dnf install kernel-devel
+   
+   # Debian/Ubuntu
+   sudo apt-get install linux-headers-$(uname -r)
+   ```
+
+2. **Linker errors:**
+   - Ensure development packages (with `-devel` or `-dev` suffix) are installed
+   - Not just runtime libraries
+
+## Quick Start
+
+Once built, run the monitor tool:
+
+```bash
+# Run as root (required for monitor mode)
+sudo ./src/wireless_monitor wlan0 11
+
+# Or after installation
+sudo wireless_monitor wlan0 11
+```
+
+## Package Names Reference
+
+| Component | Fedora/RHEL | Debian/Ubuntu |
+|-----------|-------------|---------------|
+| C Compiler | `gcc` | `build-essential` |
+| Autoconf | `autoconf` | `autoconf` |
+| Automake | `automake` | `automake` |
+| Libtool | `libtool` | `libtool` |
+| libpcap | `libpcap-devel` | `libpcap-dev` |
+| libnl-genl-3 | `libnl3-devel` | `libnl-genl-3-dev` |
+| libnl-3 | `libnl3-devel` | `libnl-3-dev` |
+| pkg-config | `pkg-config` | `pkg-config` |
+
+Note: On Fedora, `libnl3-devel` provides both `libnl-3.0` and `libnl-genl-3.0` pkg-config files.