.SH SYNOPSIS
.BI "iwspy " interface
.br
-.BI "iwspy " interface " [+] " IPADDR " | hw " HWADDR " [...]"
+.BI "iwspy " interface " [+] " DNSNAME " | " IPADDR " | " HWADDR " [...]"
.br
.BI "iwspy " interface " off"
.\"
.PP
This information is updated each time a new packet is received, so
each address of the list add some overhead in the driver.
+.PP
+Note the this functionality work only for node part of the current
+wireless cells.
.\"
.\" PARAMETER part
.\"
.SH PARAMETERS
You may set any number of addresses up to 8.
.TP
-.B IPADDR
-Set an IP address. As the hardware work with hardware addresses,
+.BR DNSNAME " | " IPADDR
+Set an IP address, or in some cases a DNS name (using the name
+resolver). As the hardware work with hardware addresses,
.B iwspy
-will translate this address through
+will translate this IP address through
.IR ARP .
In some case, this address might not be in the ARP cache and
.B iwspy
will fail. In those case,
.IR ping (8)
-this address and retry.
+this name/address and retry.
.TP
-.B hw HWADDR
+.B HWADDR
Set a hardware (MAC) address (this address is not translated & checked
-like the IP one).
+like the IP one). The address must contain a colon
+.RB ( : )
+to be recognised as a hardware address.
.TP
.B +
Add the new set of addresses at the end of the current list instead of
should use this option to avoid conflicts.
.TP
.B off
-Remove the current list of addresses and disable the functionality
+Remove the current list of addresses and disable the spy functionality
.\"
.\" FILES part
.\"
.SH SEE ALSO
.BR iwconfig (8),
.BR ifconfig (8),
+.BR iwlist (8).
.BR iwpriv (8).