summaryrefslogtreecommitdiffstats
path: root/usr.sbin/wpa/ndis_events/ndis_events.8
diff options
context:
space:
mode:
Diffstat (limited to 'usr.sbin/wpa/ndis_events/ndis_events.8')
-rw-r--r--usr.sbin/wpa/ndis_events/ndis_events.825
1 files changed, 16 insertions, 9 deletions
diff --git a/usr.sbin/wpa/ndis_events/ndis_events.8 b/usr.sbin/wpa/ndis_events/ndis_events.8
index 0c5a64a..8cbd0cc 100644
--- a/usr.sbin/wpa/ndis_events/ndis_events.8
+++ b/usr.sbin/wpa/ndis_events/ndis_events.8
@@ -51,7 +51,8 @@ utility listens for events generated by an
.Xr ndis 4
wireless network driver and relays them to
.Xr wpa_supplicant 8
-for possible processing. The three event types that can occur
+for possible processing.
+The three event types that can occur
are media connect and disconnect events, such as when a wireless
interface joins or leaves a network, and media-specific events.
In particular,
@@ -64,12 +65,14 @@ needs in order to properly associate with WPA2-capable access points.
The
.Nm
daemon works by listening for interface information events via
-a routing socket. When it detects an event that was generated by an
+a routing socket.
+When it detects an event that was generated by an
.Xr ndis 4
interface, it transmits it via UDP packet on the loopback interface,
where
.Xr wpa_supplicant 8
-is presumeably listening. The standard
+is presumeably listening.
+The standard
.Xr wpa_supplicant 8
distribution includes its own version of this utility for use with
.Tn Windows\[rg] .
@@ -92,31 +95,35 @@ The
daemon supports the following options:
.Bl -tag -width indent
.It Fl a
-Process all events. By default,
+Process all events.
+By default,
.Nm
will only process and forward media-specific events, which contain
PMKID candidate information, and not bother forwarding connect and
disconnect events, since
.Xr wpa_supplicant 8
-normally can determine the current link state on its own. In some
+normally can determine the current link state on its own.
+In some
cases, the additional connect and disconnect events only confuse it
and make the association and authentication process take longer.
.It Fl d
-Run in debug mode. This causes
+Run in debug mode.
+This causes
.Nm
to run in the foreground and generate any output to the standard
error instead of using the
.Xr syslog 3
facility.
.It Fl v
-Run in verbose mode. This causes
+Run in verbose mode.
+This causes
.Nm
to emit notifications when it receives events.
.El
.Sh SEE ALSO
.Xr ndis 4 ,
-.Xr ndisapi 9 ,
-.Xr wpa_supplicant 8
+.Xr wpa_supplicant 8 ,
+.Xr ndisapi 9
.Sh HISTORY
The
.Nm
OpenPOWER on IntegriCloud