name: aircrack-ng
category: wireless
description: WiFi network security assessment tool for cracking WEP/WPA/WPA2 keys.
keywords:
  - wifi
  - wireless
  - wep
  - wpa
  - wpa2
  - crack
  - handshake
  - password

parameters:
  capture_file:
    type: string
    required: true
    description: Path to capture file (.cap/.pcap)

  wordlist:
    type: string
    flag: "-w"
    description: Wordlist for dictionary attack

  bssid:
    type: string
    flag: "-b"
    description: Target BSSID (MAC address)

  essid:
    type: string
    flag: "-e"
    description: Target ESSID (network name)

  key_type:
    type: enum
    flag: "-a"
    options:
      - value: "1"
        description: "WEP"
      - value: "2"
        description: "WPA/WPA2"
    description: Force attack mode

  threads:
    type: integer
    flag: "-p"
    description: Number of CPU threads

  quiet:
    type: boolean
    flag: "-q"
    description: Quiet mode

  show_ascii:
    type: boolean
    flag: "-l"
    description: Write key to file

requires_root: false
timeout: 0
interactive: true

examples:
  - "aircrack-ng -w wordlist.txt capture.cap"
  - "aircrack-ng -w wordlist.txt -b AA:BB:CC:DD:EE:FF capture.cap"
  - "aircrack-ng -a 2 -w rockyou.txt handshake.cap"
  - "aircrack-ng -e TargetNetwork -w passwords.txt capture.cap"

notes: |
  Capture requirements:
  - WEP: Need enough IVs (40,000+)
  - WPA/WPA2: Need 4-way handshake

  Capture with airodump-ng:
  airodump-ng -c [channel] --bssid [MAC] -w [file] wlan0mon

  Wordlists:
  - /usr/share/wordlists/rockyou.txt
  - Custom wordlists for target

  Performance:
  - Use -p for multi-threading
  - GPU cracking with hashcat is faster

  After capture:
  1. Check handshake with aircrack-ng file.cap
  2. Run dictionary attack
  3. Consider hashcat for speed