StationSniffer

Userspace process for sniffing and serving Unassociated Station Link Metrics Statistics

[[TOC]]

Building

You'll need a C++ compiler, libpcap, and libradiotap

apt install libpcap-dev

To build and install libradiotap:

git clone git@github.com:radiotap/radiotap-library.git;
cd radiotap-library;
mkdir -p build;
cd build;
cmake ..;
make && make install

Then, to build StationSniffer:

make

Running

StationSniffer will take the interface that it is fed and put it into promiscuous mode for the lifetime of the program. If you've got one in mind, use it. If you want to make one, see "Creating a virtual interface using iw"

Otherwise, run:

./station-sniffer <interface_name> <packet_wait_time (ms)>

Creating a virtual interface using iw

iw phy <your_phy> interface add <virtual_monitor_interface_name> type monitor

To find <your_phy>, run iw dev and pick one.

Fetching station statistics

StationSniffer has a Unix domain socket server thread running to serve clients. It's found at /tmp/uslm_socket

The client should connect to this (stream) socket and make requests there. Requests are made via a minimal binary protocol, the format of which can be found in messages.h

There is a reference client implementation in tools/test.py (Python) and tools/uds_client.c (C)

Contributing

See CONTRIBUTING.md for more details.

License

Distributed under the FreeBSD License. See LICENSE for more details.

Contact

t.polomik at cablelabs.com
tuckerpo at (buffalo.edu | fsf.org)