| b.liu | e958203 | 2025-04-17 19:18:16 +0800 | [diff] [blame^] | 1 | .\" Jean II - HPLB - 96 |
| 2 | .\" iwspy.8 |
| 3 | .\" |
| 4 | .TH IWSPY 8 "31 October 1996" "net-tools" "Linux Programmer's Manual" |
| 5 | .\" |
| 6 | .\" NAME part |
| 7 | .\" |
| 8 | .SH NAME |
| 9 | iwspy \- Get wireless statistics from specific nodes |
| 10 | .\" |
| 11 | .\" SYNOPSIS part |
| 12 | .\" |
| 13 | .SH SYNOPSIS |
| 14 | .BI "iwspy " interface |
| 15 | .br |
| 16 | .BI "iwspy " interface " [+] " DNSNAME " | " IPADDR " | " HWADDR " [...]" |
| 17 | .br |
| 18 | .BI "iwspy " interface " off" |
| 19 | .\" |
| 20 | .\" DESCRIPTION part |
| 21 | .\" |
| 22 | .SH DESCRIPTION |
| 23 | .B Iwspy |
| 24 | is used to set a list of addresses in a wireless network interface and |
| 25 | to read back quality of link information for each of those. This |
| 26 | information is the same as the one available in |
| 27 | .I /proc/net/wireless |
| 28 | : quality of the link, signal strength and noise level. |
| 29 | .PP |
| 30 | This information is updated each time a new packet is received, so |
| 31 | each address of the list add some overhead in the driver. |
| 32 | .PP |
| 33 | Note the this functionality work only for node part of the current |
| 34 | wireless cells. |
| 35 | .\" |
| 36 | .\" PARAMETER part |
| 37 | .\" |
| 38 | .SH PARAMETERS |
| 39 | You may set any number of addresses up to 8. |
| 40 | .TP |
| 41 | .BR DNSNAME " | " IPADDR |
| 42 | Set an IP address, or in some cases a DNS name (using the name |
| 43 | resolver). As the hardware work with hardware addresses, |
| 44 | .B iwspy |
| 45 | will translate this IP address through |
| 46 | .IR ARP . |
| 47 | In some case, this address might not be in the ARP cache and |
| 48 | .B iwspy |
| 49 | will fail. In those case, |
| 50 | .IR ping (8) |
| 51 | this name/address and retry. |
| 52 | .TP |
| 53 | .B HWADDR |
| 54 | Set a hardware (MAC) address (this address is not translated & checked |
| 55 | like the IP one). The address must contain a colon |
| 56 | .RB ( : ) |
| 57 | to be recognised as a hardware address. |
| 58 | .TP |
| 59 | .B + |
| 60 | Add the new set of addresses at the end of the current list instead of |
| 61 | replacing it. The address list is unique for each device, so each user |
| 62 | should use this option to avoid conflicts. |
| 63 | .TP |
| 64 | .B off |
| 65 | Remove the current list of addresses and disable the spy functionality |
| 66 | .\" |
| 67 | .\" FILES part |
| 68 | .\" |
| 69 | .SH FILES |
| 70 | .I /proc/net/wireless |
| 71 | .\" |
| 72 | .\" SEE ALSO part |
| 73 | .\" |
| 74 | .SH SEE ALSO |
| 75 | .BR iwconfig (8), |
| 76 | .BR ifconfig (8), |
| 77 | .BR iwlist (8). |
| 78 | .BR iwpriv (8). |
| 79 | |