Help My Wifi Go

vimanuelt

Here is an updated script, maintained by Fred Finster, to help with troubleshooting Wifi issues.

#!/bin/sh
# helpmywifigo.sh – Diagnostic tool to collect network hardware and config info on GhostBSD
# Version: 1.5 – with extended diagnostics, fix mode, and full Wi-Fi driver detection

VERSION="1.5"

echo "=== GhostBSD Network Diagnostic Script – Version $VERSION ==="

# Mode flags
FIX_MODE=0
BRIEF_MODE=0

# Parse arguments
for arg in "$@"; do
  case "$arg" in
    --brief|-b) BRIEF_MODE=1 ;;
    --fix) FIX_MODE=1 ;;
  esac
done

if [ "$FIX_MODE" -eq 1 ]; then
  echo "Running in FIX mode: the script will attempt automatic remediation."
fi

# Detect sudo availability
if command -v sudo >/dev/null 2>&1; then
  SUDO=sudo
else
  echo "[WARN] 'sudo' not found – falling back to unprivileged mode."
  SUDO=""
fi

check_command() {
  if ! command -v "$1" >/dev/null 2>&1; then
    echo "[ERROR] Command not found: $1"
    return 1
  fi
  return 0
}

run_section() {
  echo
  echo "=== $1 ==="
}

run_command() {
  CMD="$1"
  DESC="$2"
  if eval "$CMD"; then
    echo "[OK] $DESC"
  else
    echo "[FAIL] $DESC – command failed: $CMD"
  fi
}

# Check required commands
REQUIRED_COMMANDS="uname pciconf usbconfig kldstat ifconfig netstat route date getent"
MISSING=0
for cmd in $REQUIRED_COMMANDS; do
  check_command "$cmd" || MISSING=1
done

if [ "$MISSING" -eq 1 ]; then
  echo "Aborting: Missing required commands. Please install missing tools or run on a supported system."
  exit 1
fi

run_section "Timestamp"
run_command "date" "System Date and Time"

run_section "Operating System Info"
run_command "uname -a" "uname"

if [ "$BRIEF_MODE" -ne 1 ]; then
  run_section "PCI Devices (verbose)"
  run_command "$SUDO pciconf -lv" "pciconf"

  run_section "USB Devices"
  run_command "$SUDO usbconfig list && $SUDO usbconfig dump_device_desc" "usbconfig"
fi

run_section "Loaded Kernel Modules"
run_command "$SUDO kldstat" "kldstat"

run_section "All Network Interfaces"
run_command "ifconfig -a" "ifconfig -a"

run_section "Interfaces with IP Addresses"
for iface in $(ifconfig -l); do
  ADDR=$(ifconfig "$iface" | awk '/inet / || /inet6 / {print $2; exit}')
  if [ -n "$ADDR" ]; then
    echo "Interface: $iface – IP: $ADDR"
  fi
done

run_section "Wireless Status (if available)"
for iface in $(ifconfig -l); do
  if ifconfig "$iface" 2>/dev/null | grep -q 'ssid'; then
    echo
    echo "--- Wi-Fi Interface: $iface ---"
    run_command "ifconfig "$iface"" "Interface Status: $iface"
    run_command "$SUDO ifconfig "$iface" list scan 2>/dev/null" "Nearby Wi-Fi Networks for $iface"
  fi
done

run_section "Routing Table"
run_command "$SUDO netstat -rn" "netstat -rn"

run_section "Default Route"
run_command "$SUDO route -n get default" "route -n get default"

run_section "DNS Resolution Test"
run_command "getent hosts www.freebsd.org" "DNS Resolution using getent"

run_section "DNS Resolver Configuration (/etc/resolv.conf)"
if [ -f /etc/resolv.conf ]; then
  cat /etc/resolv.conf
else
  echo "[WARN] /etc/resolv.conf not found"
fi

run_section "Filtered dmesg Output (Wireless/USB Related)"
run_command "$SUDO dmesg | grep -Ei 'rtw|wlan|usb|wifi|80211'" "Filtered dmesg"

if [ "$(id -u)" -eq 0 ] && [ -f /var/log/messages ]; then
  run_section "System Log (/var/log/messages – last 50 lines)"
  tail -n 50 /var/log/messages
fi

run_section "Realtek-Related Packages"
if command -v pkg >/dev/null 2>&1; then
  pkg info -x rtwn || echo "[INFO] No rtwn-related packages found."
else
  echo "[WARN] 'pkg' command not found. Skipping package list."
fi

run_section "Helpful Resources"
echo "GhostBSD Networking Forum:"
echo "  https://forums.ghostbsd.org/viewtopic.php?f=64&t=16"
echo
echo "RealTek RTL8188CE (PCI):"
echo "  https://forums.ghostbsd.org/viewtopic.php?f=64&t=570"
echo
echo "Edimax EW-7811un (USB):"
echo "  https://forums.ghostbsd.org/viewtopic.php?f=64&t=526"
echo
echo "Script completed. Version $VERSION. Review the output above or in the saved file."


###############################################################################
# EXTENDED AUTOMATED FIXES
###############################################################################
if [ "$FIX_MODE" -eq 1 ]; then
  echo
  echo "=== Attempting Fixes ==="

  # Load common Wi-Fi drivers
  echo "[INFO] Loading all common Wi-Fi drivers (if not already loaded)..."
  DRIVERS="if_iwm if_iwn if_ral if_bwn if_bwi if_urtwn if_rtwn_usb if_ath if_wpi if_rsu"
  for mod in $DRIVERS; do
    if ! kldstat | grep -q "$mod"; then
      echo "[FIX] Loading $mod..."
      $SUDO kldload "$mod" 2>/dev/null && echo "[OK] Loaded $mod" || echo "[SKIP] $mod not applicable"
    fi
  done

  # Load wlan module
  if ! kldstat | grep -q "wlan"; then
    echo "[FIX] Loading wlan module..."
    $SUDO kldload wlan || echo "[FAIL] Could not load wlan"
  fi

  # Create wlan0 from likely devices
  if ! ifconfig | grep -q "^wlan0"; then
    for dev in $(ifconfig -l); do
      if echo "$dev" | grep -Eq 'rtwn[0-9]*|urtwn[0-9]*|iwm[0-9]*|iwn[0-9]*|ath[0-9]*|ral[0-9]*|rsu[0-9]*|bwn[0-9]*|bwi[0-9]*|wpi[0-9]*'; then
        echo "[FIX] Creating wlan0 from $dev..."
        $SUDO ifconfig wlan0 create wlandev "$dev" && echo "[OK] Created wlan0 from $dev" && break
      fi
    done
  fi

  # Attempt DHCP renewal if no default route
  if ! route -n get default >/dev/null 2>&1; then
    echo "[FIX] No default route detected. Attempting DHCP renewal..."
    for iface in $(ifconfig -l); do
      if ifconfig "$iface" | grep -q "status: active"; then
        echo "[FIX] Running dhclient on $iface..."
        $SUDO dhclient "$iface" || echo "[FAIL] dhclient failed on $iface"
      fi
    done
  fi

  # DNS test and regeneration
  if ! getent hosts freebsd.org >/dev/null 2>&1; then
    if [ -s /etc/resolv.conf ]; then
      echo "[WARN] /etc/resolv.conf exists but DNS resolution is failing."
    else
      echo "[FIX] Resolv.conf missing or empty. Regenerating via dhclient..."
      for iface in $(ifconfig -l); do
        $SUDO dhclient "$iface" || echo "[FAIL] dhclient failed on $iface for resolv.conf"
      done
    fi
  fi

  # Vendor ID detection (basic output from pciconf)
  echo
  echo "=== Detected Wireless-Related PCI Devices ==="
  pciconf -lv | awk '
    BEGIN { RS="\n\n"; FS="\n" }
    /network/i {
      print "------------------------------"
      for (i = 1; i <= NF; i++) print $i
    }'

  echo "[DONE] Fixes and driver loading completed."
fi

vimanuelt

helpmywifigo – Network Diagnostic and Repair Tool for GhostBSD

Version: 1.5
License: BSD-2-Clause
Maintainer: Fred Finster

Overview

helpmywifigo is a shell-based tool designed for GhostBSD and FreeBSD systems. It gathers network-related system information and attempts automatic repairs to common wireless and networking issues. This script supports both diagnostics and automatic remediation through a command-line switch.

Features

Diagnostic Capabilities

Verifies presence of essential kernel modules
Displays PCI and USB device information
Lists all network interfaces and their IP addresses
Checks for default route and validates DNS resolution
Displays filtered system logs and relevant kernel messages
Lists installed Realtek-related packages
Offers structured and labeled output for easier reading
Supports HTML formatting for sharing reports

Automatic Fix Mode

When invoked with the --fix option, the script will attempt to:

Load common wireless drivers:
- if_iwm, if_iwn, if_ath, if_ral, if_bwn, if_bwi, if_wpi, if_rtwn_usb, if_urtwn, if_rsu
Load the wlan module if not already loaded
Create a wlan0 interface from any detected wireless interface
Run dhclient on active interfaces if no default route is set
Regenerate /etc/resolv.conf if it is missing or DNS is failing
Output matching pciconf blocks for detected network devices

Usage

Run diagnostics

chmod +x helpmywifigo_v1.5_extended.sh
./helpmywifigo.sh > my_network_info.txt

Attempt automatic repairs

./helpmywifigo.sh --fix > fixlog.txt

Run in brief mode

./helpmywifigo.sh --brief > my_network_info.txt

Requirements

GhostBSD or FreeBSD (13.x or 14.x)
Installed tools:
- uname, pciconf, usbconfig, kldstat, ifconfig, netstat, route, getent, dmesg, pkg
Optional but recommended: sudo

Output

Default output is to stdout. Redirect to a file for easier review.
Fix mode outputs results inline and attempts kernel module and network recovery steps.
PCI matching and filtered logs assist in forum-based support.

Caveats

The script is invasive when run with --fix and modifies the live system state.
It does not persist changes across reboots (no edits to rc.conf or loader files).
It is suitable for recovery and first-pass troubleshooting, not long-term configuration.

wb7odyfred

Thank You, Vic Thatcher for modifying this tool helpmywifigo.sh and improving this tool to help new users gather information about their wifi interface to "feedback" to others helping them setup a wifi interface to internet connection.
One has to edit 3 files:

/etc/wpa_supplicant.conf
/etc/rc.conf
/boot/loader.conf

and use 2 tools:

wpa_supplicant -i  wlan0  -c  /etc/wpa_supplicant.conf
killall dhclient
dhclient  wlan0

Thank you again, Vic for these modifications and improvements!