fOmey/README.md

## README.md

      
    Raw
  

              README.md
            
          
    WSL : nl80211 not found fix & 8814au drivers

Quick facts


Do not save kernel source to a /mnt/c path, compile from the linux user home directory.
Windows is case-insensitive, will cause random "file not found" compilation errors.
I'm using the Kali Windows store installation to do all these steps, this is especially important if you plan on using 8814au drivers (I don't believe they are compatible with Ubuntu)
Windows 10, latest windows updates & WSL.
The steps related to 8814au drivers can be modified as necessary.
For changes to take effect, WSL requires the "6 second rule" between restarts when modifying WSL related configuration files. Meaning if you issue a wsl --shutdown wait 6 seconds before issuing wsl.

Dependencies

sudo apt update && sudo apt upgrade
sudo apt install flex bison libssl-dev libelf-dev git dwarves bc make libncurses-dev python3

Change working directory to home

Make sure you're not inside a /mnt/c path.
cd ~

Pull kernel source & extract

Credit to kevin for this ingenius method, much faster than cloning github repo.
wget https://github.com/microsoft/WSL2-Linux-Kernel/archive/refs/tags/linux-msft-wsl-$(uname -r | cut -d- -f 1).tar.gz
tar -xvf linux-msft-wsl-$(uname -r | cut -d- -f 1).tar.gz

Change directory into kernel source

What would we do without auto-complete..
cd WSL{TAB}

Use current kernel config as template

cat /proc/config.gz | gunzip > .config

Configure kernel

make menuconfig

Enable the following in kernel config (*), exit & save

I opted to integrate into the kernel (*), you can also choose to compile as modules (M) this will require more setting up later (auto starting at boot)

Networking support

Wireless (*)

cfg80211 (*)


Compile kernel, modules_install needed for DKMS

make modules -j $(expr $(nproc) - 1)
sudo make modules_install

Build kernel bzImage

make -j $(expr $(nproc) - 1)


Move kernel image to %UserProfile%

Replace USERNAME with your own (duh)
mv arch/x86/boot/bzImage /mnt/c/Users/USERNAME

Some useful tools & 8814au drivers

sudo apt install usbip usbutils iw wireshark realtek-rtl8814au-dkms

Enable systemd, needed for module autostart & other useful services

sudo nano /etc/wsl.conf

Contents:
[boot]
systemd = true

Auto start kernel module on WSL startup

If you decided to configure cfg80211 as a module, you want to also create a autostart conf for it also
echo "8814au" | sudo tee -a /etc/modules-load.d/8814au.conf

Shut down WSL on host machine

wsl --shutdown

Create .wslconfig in %UserProfile%

Replace USERNAME with your own (duh)
Contents:
# Settings apply across all Linux distros running on WSL 2
[wsl2]

# Specify a custom Linux kernel to use with your installed distros. The default kernel used can be found at https://github.com/microsoft/WSL2-Linux-Kernel
kernel=C:\\Users\\USERNAME\\bzImage

Restart WSL on host machine

wsl

Verify kernel module is loaded

lsmod

Output:
Module                  Size  Used by
8814au               2682880  0

Attach Wireless USB (8814au)

Either on host with
usbipd wsl attach -b <BUSID>

or on VM
sudo usbip attach -r <HOSTIP/172.20.32.1> -b <BUSID>

Verify 8814au attached & more importantly driver is being used

lsusb -t

Output:
/:  Bus 02.Port 1: Dev 1, Class=root_hub, Driver=vhci_hcd/8p, 5000M
/:  Bus 01.Port 1: Dev 1, Class=root_hub, Driver=vhci_hcd/8p, 480M
    |__ Port 1: Dev 2, If 0, Class=Vendor Specific Class, Driver=rtl8814au, 480M

Auto attach USB on startup & set monitor mode on wlan0

sudo nano ~/wsl.sh

Contents:
#!/bin/sh

sudo usbip attach --remote 172.20.32.1 --busid=3-2

while true; do
    if [ -z $(sudo iw dev | grep -o wlan0) ]; then
        sleep 1  # network not yet up
    else
        break   # network up
    fi
done

sudo ip link set wlan0 down
sudo iw wlan0 set monitor control
sudo ip link set wlan0 up
Set permissions & enable in crontab

sudo chmod +x ~/wsl.sh
sudo crontab -e

May have to select editor if first time running crontab -e (obviously nano, unless you're a masochist).. contents:
# Edit this file to introduce tasks to be run by cron.
#
# Each task to run has to be defined through a single line
# indicating with different fields when the task will be run
# and what command to run for the task
#
# To define the time you can provide concrete values for
# minute (m), hour (h), day of month (dom), month (mon),
# and day of week (dow) or use '*' in these fields (for 'any').
#
# Notice that tasks will be started based on the cron's system
# daemon's notion of time and timezones.
#
# Output of the crontab jobs (including errors) is sent through
# email to the user the crontab file belongs to (unless redirected).
#
# For example, you can run a backup of all your user accounts
# at 5 a.m every week with:
# 0 5 * * 1 tar -zcf /var/backups/home.tgz /home/
#
# For more information see the manual pages of crontab(5) and cron(8)
#
# m h  dom mon dow   command

@reboot sh /home/ruckus/wsl.sh

Shutdown WSL on host machine

Shutdown & wait for USB chime, USB chime is used as an indication it's safe to reboot.
wsl --shutdown

Start WSL on host machine

At this stage kernel module should auto load, USB should auto attach & wireless interface should be set in monitor mode.
wsl

Test wireshark

Launch as sudo, otherwise you won't see network adapters
sudo wireshark

Refrences


WSL
WSL kernel source
Kevins excellent gist writeup