nmap / nmap/npcap

New command-line option for Npcap/wlanhelper

Open
#163 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
C
Stars
3.6k
Forks
592
PR merge metrics
No merged PRs in 30d

Description

Wlanhelper is a very useful tool for retrieving information about WLAN adapters in a windows machine. There is no option, however, to list all available WLAN adapters with their capabilities. One (feature) suggestion would be to define a new option like L for this purpose. This option is very useful especially when the user has many different WLAN adapter installed and want to check the capabilities of each adapter (very similar to to my last post in nmap/npcap#79 that I called wlanhelper on each individual adapter and it was painful). This feature is very easy to impediment. In fact I have added it into the wlanHelper code and I can send a pull request if you are interested. The output looks like the following:

1. Wi-Fi Adapter
        Name: Wi-Fi 2
        GUID: 99a33870-708e-4cdd-ae8a-0654af1a6f31
        Description: 1x1 11bgn Wireless LAN PCI Express Half Mini Card Adapter
        State: "connected"
        Channel: 1
        Freq: 1
        Operation Modes: Extensible Station, Extensible AP, WFD_device, WFD_owner, WFD_client, Monitor
        Operation Mode: "Extensible Station (ExtSTA)"
        Supported modu: ht, hrdsss, erp, unknown or any, unknown or any, unknown or any
        Modulation: unknown or any
2. Wi-Fi Adapter
        Name: Wi-Fi 3
        GUID: e47bf137-2c3f-45e6-a47d-b5bdfb3eda9e
        Description: ASUS USB-AC51 USB Wireless adapter nmap/nmap#2
        State: "disconnected"
        Channel: 1
        Freq: 1
        Operation Modes: Extensible Station, Extensible AP, WFD_device, WFD_owner, WFD_client, Monitor
        Operation Mode: "Extensible Station (ExtSTA)"
        Supported modu: hrdsss, ofdm, erp, ht
        Modulation: ofdm
3. Wi-Fi Adapter
        Name: Wi-Fi 4
        GUID: 8752bd72-1b38-4c4d-8ee4-d93e5fdac546
        Description: NETGEAR A6100 WiFi Adapter
        State: "disconnected"
        Channel: 1
        Freq: 1
        Operation Modes: Extensible Station, WFD_device, WFD_owner, WFD_client
        Operation Mode: "Extensible Station (ExtSTA)"
        Supported modu: ht, erp, hrdsss, vht, ht, ofdm
        Modulation: hrdsss
4. Wi-Fi Adapter
        Name: Wi-Fi 5
        GUID: e0c38e96-84cb-494c-8f08-20847f467371
        Description: Edimax AC1200 MU-MIMO WiFi USB 3.0 Adapter
        State: "disconnected"
        Channel: 1
        Freq: 1
        Operation Modes: Extensible Station, WFD_device, WFD_owner, WFD_client
        Operation Mode: "Extensible Station (ExtSTA)"
        Supported modu: ht, erp, hrdsss, vht, ht, ofdm
        Modulation: hrdsss
5. Wi-Fi Adapter
        Name: Wi-Fi 8
        GUID: 33466e84-772a-4fd5-8a2e-0ddbc397f03d
        Description: Linksys WUSB6100M
        State: "disconnected"
        Channel: 0
        Freq: 4294967295
        Operation Modes: Extensible Station, Extensible AP, WFD_device, WFD_owner, WFD_client, Monitor
        Operation Mode: "Extensible Station (ExtSTA)"
        Supported modu: hrdsss, ofdm, erp, ht, vht
        Modulation: ihv (-1)
6. Wi-Fi Adapter
        Name: Wi-Fi 7
        GUID: e83321be-778c-433d-b77f-abb009ba1bd5
        Description: TP-LINK Wireless USB Adapter
        State: "disconnected"
        Channel: 1
        Freq: 1
        Operation Modes: Extensible Station, Extensible AP, WFD_device, WFD_owner, WFD_client, Monitor
        Operation Mode: "Extensible Station (ExtSTA)"
        Supported modu: hrdsss, ofdm, erp, ht
        Modulation: ofdm
7. Wi-Fi Adapter
        Name: Wi-Fi 6
        GUID: e7ab7fb2-53d2-4e38-994d-1492afaf2504
        Description: D-Link DWA-171 Wireless AC Dual Band Adapter
        State: "disconnected"
        Channel: 1
        Freq: 1
        Operation Modes: Extensible Station, WFD_device, WFD_owner, WFD_client
        Operation Mode: "Extensible Station (ExtSTA)"
        Supported modu: ht, erp, hrdsss, vht, ht, ofdm
        Modulation: hrdsss
  1. The output is more user-friendly. The title for each entry starts with Wi-Fi adapter indicating that we are only listing the WLAN adapter not BT or Ethernet or etc.

  2. Then we list different capabilities and information for that adapter like its name, GUID, and so in.

  3. I do not know why did you use names like master and managed for listing the operating mode. Why not using access point, station, extensible station and so on. In fact for listing the operation mode, you use the actual term like Extensible Station (ExtSTA).

https://github.com/nmap/npcap/blob/1329082e00a57846823f20c1b4edcdb3ae9b2701/packetWin7/WlanHelper/WlanHelper/Tool.cpp#L673

  1. Supported operation modes now include Wi-Fi direct too.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read packetWin7/WlanHelper/WlanHelper/Tool.cpp around line 673 and inspect the existing wlanhelper option handling. Add the proposed option for listing all WLAN adapters and their capabilities, using the requested adapter-focused output; done means multiple available adapters are reported with their names, GUIDs, states, modes, and capabilities.

Written by the indexing model from the issue text.

Assessment

Tech stack
c
Domain
cli, networking
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.