go-wireless

A way to interact with the Wireless interfaces on a Linux machine using WPA Supplicant.

Requirements

Requires a running wpa_supplicant with control interface at /var/run/wpa_supplicant (which is usually a symlink to /run/wpa_supplicant). This requires the config file to contain the line:

ctrl_interface=DIR=/run/wpa_supplicant GROUP=wheel

Or for the wpa_supplicant instance to be running with the -O /run/wpa_supplicant argument.

You will probably also need to be running as root unless you are in the specified group (wheel in the above example).

Usage

Examples of the usage can be found in the cmd directory as standalone commands.

Get a list of wifi cards attached:

ifaces := wireless.Interfaces()

From there you can use the client:

wc, err := wireless.NewClient("wlan0")
defer wc.Close()

Get a list of APs that are in range:

aps, err := wc.Scan()
fmt.Println(aps, err)
ap, ok := wireless.APs(aps).FindBySSID("CIA Predator Drone 237A")

Get a list of known networks (note: the password cannot be retrieved so are not populated):

nets, err := wc.Networks()
fmt.Println(nets, err)

Connect to networks:

net := NewNetwork("FBI Surveillance Van #4", "secretpass")
net, err := wc.Connect(net)

Disable networks:

nets, err:= wc.Networks()
net, err := net, ok := wireless.Networks(nets).FindBySSID("FBI Surveillance Van #4")
net.Disable(true)
net, err := wc.UpdateNetwork(net)

Subscribe to events:

sub := wc.Subscribe(wireless.EventConnected, wireless.EventAuthReject, wireless.EventDisconnected)

ev := <-sub.Next()
switch ev.Name {
 case wireless.EventConnected:
  fmt.Println(ev.Arguments)
 case wireless.EventAuthReject:
  fmt.Println(ev.Arguments)
 case wireless.EventDisconnected:
  fmt.Println(ev.Arguments)
}

Check the status of the connection:

st, err := wc.Status()
fmt.Printf("%+v\n", st)

API

There is an API that can be used with gin:

r := gin.Default()
api.SetupRoutes(r)
r.Serve(":8080")

Endpoints

• GET /interfaces
• GET /interfaces/:iface
• PUT /interfaces/:iface
• GET /interfaces/:iface/aps
• GET /interfaces/:iface/networks
• POST /interfaces/:iface/networks
• PUT /interfaces/:iface/networks/:id_or_idstr
• GET /interfaces/:iface/networks/:id_or_idstr
• DELETE /interfaces/:iface/networks/:id_or_idstr