2 \page dbus %wpa_supplicant D-Bus API
4 This section documents the %wpa_supplicant D-Bus API. Every D-Bus
5 interface implemented by %wpa_supplicant is described here including
6 their methods, signals, and properties with arguments, returned
7 values, and possible errors.
17 \section dbus_main fi.w1.wpa_supplicant1
19 Interface implemented by the main %wpa_supplicant D-Bus object
20 registered in the bus with fi.w1.wpa_supplicant1 name.
22 \subsection dbus_main_methods Methods
26 <h3>CreateInterface ( a{sv} : args ) --> o : interface</h3>
27 <p>Registers a wireless interface in %wpa_supplicant.</p>
32 A dictionary with arguments used to add the interface to %wpa_supplicant. The dictionary may contain the following entries:
34 <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th>
35 <tr><td>Ifname</td><td>s</td><td>Name of the network interface to control, e.g., wlan0</td><td>Yes</td>
36 <tr><td>BridgeIfname</td><td>s</td><td>Name of the bridge interface to control, e.g., br0</td><td>No</td>
37 <tr><td>Driver</td><td>s</td><td>Driver name which the interface uses, e.g., nl80211</td><td>No</td>
38 <tr><td>ConfigFile</td><td>s</td><td>Configuration file path</td><td>No</td>
44 <dt>o : interface</dt>
45 <dd>A D-Bus path to object representing created interface</dd>
47 <h4>Possible errors</h4>
49 <dt>fi.w1.wpa_supplicant1.InterfaceExists</dt>
50 <dd>%wpa_supplicant already controls this interface.</dd>
51 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
52 <dd>Creating interface failed for an unknown reason.</dd>
53 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
54 <dd>Invalid entries were found in the passed argument.</dd>
59 <h3>RemoveInterface ( o : interface ) --> nothing</h3>
60 <p>Deregisters a wireless interface from %wpa_supplicant.</p>
63 <dt>o : interface</dt>
64 <dd>A D-Bus path to an object representing an interface to remove returned by CreateInterface</dd>
66 <h4>Possible errors</h4>
68 <dt>fi.w1.wpa_supplicant1.InterfaceUnknown</dt>
69 <dd>Object pointed by the path doesn't exist or doesn't represent an interface.</dd>
70 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
71 <dd>Removing interface failed for an unknown reason.</dd>
76 <h3>GetInterface ( s : ifname ) --> o : interface</h3>
77 <p>Returns a D-Bus path to an object related to an interface which %wpa_supplicant already controls.</p>
81 <dd>Name of the network interface, e.g., wlan0</dd>
85 <dt>o : interface</dt>
86 <dd>A D-Bus path to an object representing an interface</dd>
88 <h4>Possible errors</h4>
90 <dt>fi.w1.wpa_supplicant1.InterfaceUnknown</dt>
91 <dd>An interface with the passed name in not controlled by %wpa_supplicant.</dd>
92 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
93 <dd>Getting an interface object path failed for an unknown reason.</dd>
98 \subsection dbus_main_properties Properties
102 <h3>DebugLevel - s - (read/write)</h3>
103 <p>Global %wpa_supplicant debugging level. Possible values are
104 "msgdump" (verbose debugging), "debug" (debugging),
105 "info" (informative), "warning" (warnings), and "error" (errors).</p>
109 <h3>DebugTimestamp - b - (read/write)</h3>
110 <p>Global %wpa_supplicant debugging parameter. Determines if timestamps are shown in debug logs.</p>
114 <h3>DebugShowKeys - b - (read/write)</h3>
115 <p>Global %wpa_supplicant debugging parameter. Determines if secrets are shown in debug logs.</p>
119 <h3>Interfaces - ao - (read)</h3>
120 <p>An array with paths to D-Bus objects representing controlled interfaces each.</p>
124 <h3>EapMethods - as - (read)</h3>
125 <p>An array with supported EAP methods names.</p>
129 <h3>Capabilities - as - (read)</h3>
130 <p>An array with supported capabilities (e.g., "ap", "ibss-rsn", "p2p", "interworking").</p>
134 \subsection dbus_main_signals Signals
138 <h3>InterfaceAdded ( o : interface, a{sv} : properties )</h3>
139 <p>A new interface was added to %wpa_supplicant.</p>
142 <dt>o : interface</dt>
143 <dd>A D-Bus path to an object representing the added interface</dd>
146 <dt>a{sv} : properties</dt>
147 <dd>A dictionary containing properties of added interface.</dd>
152 <h3>InterfaceRemoved ( o : interface )</h3>
153 <p>An interface was removed from %wpa_supplicant.</p>
156 <dt>o : interface</dt>
157 <dd>A D-Bus path to an object representing the removed interface</dd>
162 <h3>PropertiesChanged ( a{sv} : properties )</h3>
163 <p>Some properties have changed.</p>
166 <dt>a{sv} : properties</dt>
167 <dd>A dictionary with pairs of properties names which have changed and theirs new values. Possible dictionary keys are: "DebugParams"</dd>
173 \section dbus_interface fi.w1.wpa_supplicant1.Interface
175 Interface implemented by objects related to network interface added to
176 %wpa_supplicant, i.e., returned by
177 fi.w1.wpa_supplicant1.CreateInterface.
179 \subsection dbus_interface_methods Methods
183 <h3>Scan ( a{sv} : args ) --> nothing</h3>
184 <p>Triggers a scan.</p>
187 <dt>a{sv} : args</dt>
189 A dictionary with arguments describing scan type:
191 <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th>
192 <tr><td>Type</td><td>s</td><td>Type of the scan. Possible values: "active", "passive"</td><td>Yes</td>
193 <tr><td>SSIDs</td><td>aay</td><td>Array of SSIDs to scan for (applies only if scan type is active)</td><td>No</td>
194 <tr><td>IEs</td><td>aay</td><td>Information elements to used in active scan (applies only if scan type is active)</td><td>No</td>
195 <tr><td>Channels</td><td>a(uu)</td><td>Array of frequencies to scan in form of (center, width) in MHz.</td><td>No</td>
196 <tr><td>AllowRoam</td><td>b</td><td>TRUE (or absent) to allow a roaming decision based on the results of this scan, FALSE to prevent a roaming decision.</td><td>No</td>
200 <h4>Possible errors</h4>
202 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
203 <dd>Invalid entries were found in the passed argument.</dd>
208 <h3>Disconnect ( ) --> nothing</h3>
209 <p>Disassociates the interface from current network.</p>
210 <h4>Possible errors</h4>
212 <dt>fi.w1.wpa_supplicant1.NotConnected</dt>
213 <dd>Interface is not connected to any network.</dd>
218 <h3>AddNetwork ( a{sv} : args ) --> o : network</h3>
219 <p>Adds a new network to the interface.</p>
222 <dt>a{sv} : args</dt>
223 <dd>A dictionary with network configuration. Dictionary entries are equivalent to entries in the "network" block in %wpa_supplicant configuration file. Entry values should be appropriate type to the entry, e.g., an entry with key "frequency" should have value type int.</dd>
228 <dd>A D-Bus path to an object representing a configured network</dd>
230 <h4>Possible errors</h4>
232 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
233 <dd>Invalid entries were found in the passed argument.</dd>
234 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
235 <dd>Adding network failed for an unknown reason.</dd>
240 <h3>RemoveNetwork ( o : network ) --> nothing</h3>
241 <p>Removes a configured network from the interface.</p>
245 <dd>A D-Bus path to an object representing a configured network returned by fi.w1.wpa_supplicant1.Interface.AddNetwork</dd>
247 <h4>Possible errors</h4>
249 <dt>fi.w1.wpa_supplicant1.NetworkUnknown</dt>
250 <dd>A passed path doesn't point to any network object.</dd>
251 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
252 <dd>A passed path doesn't point to any network object.</dd>
253 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
254 <dd>Removing network failed for an unknown reason.</dd>
259 <h3>RemoveAllNetworks ( ) --> nothing</h3>
260 <p>Remove all configured networks from the interface.</p>
264 <h3>SelectNetwork ( o : network ) --> nothing</h3>
265 <p>Attempt association with a configured network.</p>
269 <dd>A D-Bus path to an object representing a configured network returned by fi.w1.wpa_supplicant1.Interface.AddNetwork</dd>
271 <h4>Possible errors</h4>
273 <dt>fi.w1.wpa_supplicant1.NetworkUnknown</dt>
274 <dd>A passed path doesn't point to any network object.</dd>
275 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
276 <dd>A passed path doesn't point to any network object.</dd>
281 <h3>Reassociate ( ) --> nothing</h3>
282 <p>Attempt reassociation.</p>
283 <h4>Possible errors</h4>
285 <dt>fi.w1.wpa_supplicant1.InterfaceDisabled</dt>
286 <dd>The interface is disabled.</dd>
291 <h3>Reattach ( ) --> nothing</h3>
292 <p>Attempt reassociation back to the current BSS.</p>
293 <h4>Possible errors</h4>
295 <dt>fi.w1.wpa_supplicant1.NotConnected</dt>
296 <dd>Interface is not connected to any network.</dd>
301 <h3>AddBlob ( s : name, ay : data ) --> nothing</h3>
302 <p>Adds a blob to the interface.</p>
306 <dd>A name of a blob</dd>
310 <h4>Possible errors</h4>
312 <dt>fi.w1.wpa_supplicant1.BlobExists</dt>
313 <dd>A blob with the specified name already exists.</dd>
318 <h3>RemoveBlob ( s : name ) --> nothing</h3>
319 <p>Removes the blob from the interface.</p>
323 <dd>A name of the blob to remove</dd>
325 <h4>Possible errors</h4>
327 <dt>fi.w1.wpa_supplicant1.BlobUnknown</dt>
328 <dd>A blob with the specified name doesn't exist.</dd>
333 <h3>GetBlob ( s : name ) --> ay : data</h3>
334 <p>Returns the blob data of a previously added blob.</p>
338 <dd>A name of the blob</dd>
345 <h4>Possible errors</h4>
347 <dt>fi.w1.wpa_supplicant1.BlobUnknown</dt>
348 <dd>A blob with the specified name doesn't exist.</dd>
352 <h3>AutoScan ( s : arg ) --> nothing</h3>
353 <p>Set autoscan parameters for the interface.</p>
357 <dd>Autoscan parameter line or empty to unset autoscan.</dd>
359 <h4>Possible errors</h4>
361 <dt>fi.w1.wpa_supplicant1.NoMemory</dt>
362 <dd>Needed memory was not possible to get allocated.</dd>
363 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
364 <dd>Invalid entries were found in the passed argument.</dd>
368 <h3>TDLSDiscover ( s : peer_address ) --> nothing</h3>
369 <p>Initiate a TDLS discovery for a peer.</p>
372 <dt>s : peer_address</dt>
373 <dd>MAC address for the peer to perform TDLS discovery.</dd>
375 <h4>Possible errors</h4>
377 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
378 <dd>The "peer_address" argument is not a properly formatted MAC.</dd>
379 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
380 <dd>Initiating the TDLS operation failed for an unknown reason.</dd>
384 <h3>TDLSSetup ( s : peer_address ) --> nothing</h3>
385 <p>Setup a TDLS session for a peer.</p>
388 <dt>s : peer_address</dt>
389 <dd>MAC address for the peer to perform TDLS setup.</dd>
391 <h4>Possible errors</h4>
393 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
394 <dd>The "peer_address" argument is not a properly formatted MAC.</dd>
395 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
396 <dd>Initiating the TDLS operation failed for an unknown reason.</dd>
400 <h3>TDLSStatus ( s : peer_address ) --> s</h3>
401 <p>Return TDLS status with respect to a peer.</p>
404 <dt>s : peer_address</dt>
405 <dd>MAC address for the peer for which status is requested.</dd>
410 <dd>Current status of the TDLS link with the selected peer.</dd>
412 <h4>Possible errors</h4>
414 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
415 <dd>The "peer_address" argument is not a properly formatted MAC.</dd>
419 <h3>TDLSTeardown ( s : peer_address ) --> nothing</h3>
420 <p>Tear down a TDLS session with a peer.</p>
423 <dt>s : peer_address</dt>
424 <dd>MAC address for the peer to tear down TDLS connectivity with.</dd>
426 <h4>Possible errors</h4>
428 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
429 <dd>The "peer_address" argument is not a properly formatted MAC.</dd>
430 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
431 <dd>Initiating the TDLS operation failed for an unknown reason.</dd>
435 <h3>EAPLogoff ( ) --> nothing</h3>
436 <p>IEEE 802.1X EAPOL state machine logoff.</p>
439 <h3>EAPLogon ( ) --> nothing</h3>
440 <p>IEEE 802.1X EAPOL state machine logon.</p>
444 <h3>NetworkReply ( o : network, s : field, s : value ) --> nothing</h3>
445 <p>Provide parameter requested by NetworkRequest().</p>
449 <dd>A D-Bus path to an object representing the network (copied from NetworkRequest()).</dd>
451 <dd>Requested information (copied from NetworkRequest()).</dd>
453 <dd>The requested information (e.g., password for EAP authentication).</dd>
455 <h4>Possible errors</h4>
457 <dt>fi.w1.wpa_supplicant1.NetworkUnknown</dt>
458 <dd>A passed path doesn't point to any network object.</dd>
459 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
460 <dd>A passed path doesn't point to any network object.</dd>
461 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
462 <dd>IEEE 802.1X support was not included in the build.</dd>
467 <h3>SetPKCS11EngineAndModulePath ( s : pkcs11_engine_path, s : pkcs11_module_path ) --> nothing</h3>
468 <p>Set PKCS #11 engine and module path.</p>
471 <dt>s : pkcs11_engine_path</dt>
472 <dd>PKCS #11 engine path.</dd>
473 <dt>s : pkcs11_module_path</dt>
474 <dd>PKCS #11 module path.</dd>
476 <h4>Possible errors</h4>
478 <dt>org.freedesktop.DBus.Error.Failed.InvalidArgs</dt>
479 <dd>Invalid PKCS #11 engine or module path.</dd>
480 <dt>org.freedesktop.DBus.Error.Failed</dt>
481 <dd>Reinit of the EAPOL state machine with the new PKCS #11 engine and module path failed.</dd>
485 <h3>SignalPoll ( ) --> a{sv} : properties</h3>
486 <p>Fetch signal properties for the current connection.</p>
489 <dt>a{sv} : properties</dt>
492 <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th>
493 <tr><td>linkspeed</td><td>i</td><td>Link speed (Mbps)</td><td>No</td>
494 <tr><td>noise</td><td>i</td><td>Noise (dBm)</td><td>No</td>
495 <tr><td>width</td><td>s</td><td>Channel width</td><td>No</td>
496 <tr><td>frequency</td><td>u</td><td>Frequency (MHz)</td><td>No</td>
497 <tr><td>rssi</td><td>i</td><td>RSSI (dBm)</td><td>No</td>
498 <tr><td>avg-rssi</td><td>i</td><td>Average RSSI (dBm)</td><td>No</td>
499 <tr><td>center-frq1</td><td>i</td><td>VHT segment 1 frequency (MHz)</td><td>No</td>
500 <tr><td>center-frq2</td><td>i</td><td>VHT segment 2 frequency (MHz)</td><td>No</td>
506 <h3>FlushBSS ( u : age ) --> nothing</h3>
507 <p>Flush BSS entries from the cache.</p>
511 <dd>Maximum age in seconds for BSS entries to keep in cache (0 = remove all entries).</dd>
516 <h3>SubscribeProbeReq ( ) --> nothing</h3>
517 <p>Subscribe to receive Probe Request events. This is needed in addition to registering a signal handler for the ProbeRequest signal to avoid flooding D-Bus with all Probe Request indications when no application is interested in them.</p>
518 <h4>Possible errors</h4>
520 <dt>fi.w1.wpa_supplicant1.SubscriptionInUse</dt>
521 <dd>Another application is already subscribed.</dd>
522 <dt>fi.w1.wpa_supplicant1.NoMemory</dt>
523 <dd>Needed memory was not possible to get allocated.</dd>
528 <h3>UnsubscribeProbeReq ( ) --> nothing</h3>
529 <p>Unsubscribe from receiving Probe Request events.</p>
530 <h4>Possible errors</h4>
532 <dt>fi.w1.wpa_supplicant1.NoSubscription</dt>
533 <dd>No subscription in place.</dd>
534 <dt>fi.w1.wpa_supplicant1.SubscriptionNotYou</dt>
535 <dd>Subscription in place, but for another process.</dd>
540 \subsection dbus_interface_properties Properties
544 <h3>Capabilities - a{sv} - (read)</h3>
545 <p>Capabilities of the interface. Dictionary contains following entries:</p>
547 <tr><th>Key</th><th>Value type</th><th>Description</th>
548 <tr><td>Pairwise</td><td>as</td><td>Possible array elements: "ccmp", "tkip", "none"</td>
549 <tr><td>Group</td><td>as</td><td>Possible array elements: "ccmp", "tkip", "wep104", "wep40"</td>
550 <tr><td>KeyMgmt</td><td>as</td><td>Possible array elements: "wpa-psk", "wpa-ft-psk", "wpa-psk-sha256", "wpa-eap", "wpa-ft-eap", "wpa-eap-sha256", "ieee8021x", "wpa-none", "wps", "none"</td>
551 <tr><td>Protocol</td><td>as</td><td>Possible array elements: "rsn", "wpa"</td>
552 <tr><td>AuthAlg</td><td>as</td><td>Possible array elements: "open", "shared", "leap"</td>
553 <tr><td>Scan</td><td>as</td><td>Possible array elements: "active", "passive", "ssid"</td>
554 <tr><td>Modes</td><td>as</td><td>Possible array elements: "infrastructure", "ad-hoc", "ap"</td>
559 <h3>State - s - (read)</h3>
560 <p>A state of the interface. Possible values are: return "disconnected", "inactive", "scanning", "authenticating", "associating", "associated", "4way_handshake", "group_handshake", "completed","unknown".</p>
564 <h3>Scanning - b - (read)</h3>
565 <p>Determines if the interface is already scanning or not</p>
569 <h3>ApScan - u - (read/write)</h3>
570 <p>Identical to ap_scan entry in %wpa_supplicant configuration file. Possible values are 0, 1 or 2.</p>
574 <h3>BSSExpireAge - u - (read/write)</h3>
575 <p>Identical to bss_expiration_age entry in %wpa_supplicant configuration file.</p>
579 <h3>BSSExpireCount - u - (read/write)</h3>
580 <p>Identical to bss_expiration_scan_count entry in %wpa_supplicant configuration file.</p>
584 <h3>Country - s - (read/write)</h3>
585 <p>Identical to country entry in %wpa_supplicant configuration file.</p>
589 <h3>Ifname - s - (read)</h3>
590 <p>Name of network interface controlled by the interface, e.g., wlan0.</p>
594 <h3>BridgeIfname - s - (read)</h3>
595 <p>Name of bridge network interface controlled by the interface, e.g., br0.</p>
599 <h3>Driver - s - (read)</h3>
600 <p>Name of driver used by the interface, e.g., nl80211.</p>
604 <h3>CurrentBSS - o - (read)</h3>
605 <p>Path to D-Bus object representing BSS which %wpa_supplicant is associated with, or "/" if is not associated at all.</p>
609 <h3>CurrentNetwork - o - (read)</h3>
610 <p>Path to D-Bus object representing configured network which %wpa_supplicant uses at the moment, or "/" if doesn't use any.</p>
614 <h3>Blobs - as - (read)</h3>
615 <p>List of blobs names added to the Interface.</p>
619 <h3>BSSs - ao - (read)</h3>
620 <p>List of D-Bus objects paths representing BSSs known to the interface, i.e., scan results.</p>
624 <h3>Networks - ao - (read)</h3>
625 <p>List of D-Bus objects paths representing configured networks.</p>
629 <h3>FastReauth - b - (read/write)</h3>
630 <p>Identical to fast_reauth entry in %wpa_supplicant configuration file.</p>
634 <h3>ScanInterval - i - (read/write)</h3>
635 <p>Time (in seconds) between scans for a suitable AP. Must be >= 0.</p>
639 <h3>PKCS11EnginePath - s - (read)</h3>
640 <p>PKCS #11 engine path.</p>
644 <h3>PKCS11ModulePath - s - (read)</h3>
645 <p>PKCS #11 module path.</p>
649 \subsection dbus_interface_signals Signals
653 <h3>ScanDone ( b : success )</h3>
654 <p>Scanning finished. </p>
658 <dd>Determines if scanning was successful. If so, results are available.</dd>
663 <h3>BSSAdded ( o : BSS, a{sv} : properties )</h3>
664 <p>Interface became aware of a new BSS.</p>
668 <dd>A D-Bus path to an object representing the new BSS.</dd>
671 <dt>a{sv} : properties</dt>
672 <dd>A dictionary containing properties of added BSS.</dd>
677 <h3>BSSRemoved ( o : BSS )</h3>
678 <p>BSS disappeared.</p>
682 <dd>A D-Bus path to an object representing the BSS.</dd>
687 <h3>BlobAdded ( s : blobName )</h3>
688 <p>A new blob has been added to the interface.</p>
691 <dt>s : blobName</dt>
692 <dd>A name of the added blob.</dd>
697 <h3>BlobRemoved ( s : blobName )</h3>
698 <p>A blob has been removed from the interface.</p>
701 <dt>s : blobName</dt>
702 <dd>A name of the removed blob.</dd>
707 <h3>NetworkAdded ( o : network, a{sv} : properties )</h3>
708 <p>A new network has been added to the interface.</p>
712 <dd>A D-Bus path to an object representing the added network.</dd>
715 <dt>a{sv} : properties</dt>
716 <dd>A dictionary containing properties of added network.</dd>
721 <h3>NetworkRemoved ( o : network )</h3>
722 <p>The network has been removed from the interface.</p>
726 <dd>A D-Bus path to an object representing the removed network.</dd>
731 <h3>NetworkSelected ( o : network )</h3>
732 <p>The network has been selected.</p>
736 <dd>A D-Bus path to an object representing the selected network.</dd>
741 <h3>StaAuthorized ( s : mac )</h3>
742 <p>A new station has been authorized to the interface.</p>
746 <dd>A mac address which has been authorized.</dd>
751 <h3>StaDeauthorized ( s : mac )</h3>
752 <p>A station has been deauthorized to the interface.</p>
756 <dd>A mac address which has been deauthorized.</dd>
761 <h3>PropertiesChanged ( a{sv} : properties )</h3>
762 <p>Some properties have changed.</p>
765 <dt>a{sv} : properties</dt>
766 <dd>A dictionary with pairs of properties names which have changed and theirs new values. Possible dictionary keys are: "ApScan", "Scanning", "State", "CurrentBSS", "CurrentNetwork"</dd>
771 <h3>Certification ( a{sv} : parameters )</h3>
772 <p>Information about server TLS certificates.</p>
775 <dt>a{sv} : parameters</dt>
776 <dd>A dictionary with pairs of field names and their values. Possible dictionary keys are: "depth", "subject", "cert_hash", "cert".</dd>
781 <h3>EAP ( s : status, s : parameter )</h3>
782 <p>Information about EAP peer status.</p>
786 <dd>Operation, e.g., "started", "accept proposed method", "remote certificate verification", "eap parameter needed", "completion".</dd>
787 <dt>s : parameter</dt>
788 <dd>Information about the operation, e.g., EAP method name, "success".</dd>
793 <h3>NetworkRequest ( o : network, s : field, s : txt )</h3>
794 <p>Request for network parameter. NetworkResponse() is used to provide the requested parameter.</p>
798 <dd>D-Bus path to an object representing the network.</dd>
800 <dd>Requested information, e.g., "PASSWORD".</dd>
802 <dd>Human readable information about the requested information.</dd>
807 <h3>ProbeRequest ( a{sv} : args )</h3>
808 <p>Information about a received Probe Request frame. This signal is delivered only to a single application that has subscribed to received the events with SubscribeProbeReq().</p>
811 <dt>a{sv} : args</dt>
812 <dd>A dictionary with pairs of field names and their values. Possible dictionary keys are: "addr", "dst", "bssid", "ies", "signal".</dd>
818 \section dbus_wps fi.w1.wpa_supplicant1.Interface.WPS
820 Interface implemented by objects related to network interface added to
821 %wpa_supplicant, i.e., returned by fi.w1.wpa_supplicant1.CreateInterface.
823 \subsection dbus_wps_methods Methods
827 <h3>Start ( a{sv} : args ) --> a{sv} : output</h3>
828 <p>Starts WPS configuration.</p>
831 <dt>a{sv} : args</dt>
833 A dictionary with arguments used to start WPS configuration. The dictionary may contain the following entries:
835 <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th>
836 <tr><td>Role</td><td>s</td><td>The device's role. Possible values are "enrollee" and "registrar".</td><td>Yes</td>
837 <tr><td>Type</td><td>s</td><td>WPS authentication type. Applies only for enrollee role. Possible values are "pin" and "pbc".</td><td>Yes, for enrollee role; otherwise no</td>
838 <tr><td>Pin</td><td>s</td><td>WPS Pin.</td><td>Yes, for registrar role; otherwise optional</td>
839 <tr><td>Bssid</td><td>ay</td><td></td><td>No</td>
845 <dt>a{sv} : output</dt>
848 <tr><th>Key</th><th>Value type</th><th>Description</th><th>Required</th>
849 <tr><td>Pin</td><td>s</td><td>Newly generated PIN, if not specified for enrollee role and pin authentication type.</td><td>No</td>
853 <h4>Possible errors</h4>
855 <dt>fi.w1.wpa_supplicant1.UnknownError</dt>
856 <dd>Starting WPS configuration failed for an unknown reason.</dd>
857 <dt>fi.w1.wpa_supplicant1.InvalidArgs</dt>
858 <dd>Invalid entries were found in the passed argument.</dd>
863 \subsection dbus_wps_properties Properties
867 <h3>ProcessCredentials - b - (read/write)</h3>
868 <p>Determines if the interface will process the credentials (credentials_processed configuration file parameter).</p>
872 \subsection dbus_wps_signals Signals
876 <h3>Event ( s : name, a{sv} : args )</h3>
877 <p>WPS event occurred.</p>
881 <dd>Event type. Possible values are: "success, "fail" and "m2d"</dd>
882 <dt>a{sv} : args</dt>
884 Event arguments. Empty for success event, one entry ( "msg" : i ) for fail event and following entries for m2d event:
886 <tr><th>config_methods</th><th>Value type</th>
887 <tr><td>manufacturer</td><td>q</td>
888 <tr><td>model_name</td><td>ay</td>
889 <tr><td>model_number</td><td>ay</td>
890 <tr><td>serial_number</td><td>ay</td>
891 <tr><td>dev_name</td><td>ay</td>
892 <tr><td>primary_dev_type</td><td>ay</td>
893 <tr><td>config_error</td><td>q</td>
894 <tr><td>dev_password_id</td><td>q</td>
901 <h3>Credentials ( a{sv} : credentials )</h3>
902 <p>WPS credentials. Dictionary contains:</p>
904 <tr><th>Key</th><th>Value type</th><th>Description</th>
905 <tr><td>BSSID</td><td>ay</td><td></td>
906 <tr><td>SSID</td><td>s</td><td></td>
907 <tr><td>AuthType</td><td>as</td><td>Possible array elements: "open", "shared", "wpa-psk", "wpa-eap", "wpa2-eap", "wpa2-psk"</td>
908 <tr><td>EncrType</td><td>as</td><td>Possible array elements: "none", "wep", "tkip", "aes"</td>
909 <tr><td>Key</td><td>ay</td><td>Key data</td>
910 <tr><td>KeyIndex</td><td>u</td><td>Key index</td>
915 <h3>PropertiesChanged ( a{sv} : properties )</h3>
916 <p>Some properties have changed.</p>
919 <dt>a{sv} : properties</dt>
920 <dd>A dictionary with pairs of properties names which have changed and theirs new values. Possible dictionary keys are: "ProcessCredentials"</dd>
926 \section dbus_bss fi.w1.wpa_supplicant1.BSS
928 Interface implemented by objects representing a scanned BSSs, i.e.,
931 \subsection dbus_bss_properties Properties
935 <h3>BSSID - ay - (read)</h3>
936 <p>BSSID of the BSS.</p>
939 <h3>SSID - ay - (read)</h3>
940 <p>SSID of the BSS.</p>
943 <h3>WPA - a{sv} - (read)</h3>
944 <p>WPA information of the BSS. Empty dictionary indicates no WPA support. Dictionary entries are:</p>
946 <tr><td>KeyMgmt</td><td>as</td><td>Key management suite. Possible array elements: "wpa-psk", "wpa-eap", "wpa-none"</td>
947 <tr><td>Pairwise</td><td>as</td><td>Pairwise cipher suites. Possible array elements: "ccmp", "tkip"</td>
948 <tr><td>Group</td><td>s</td><td>Group cipher suite. Possible values are: "ccmp", "tkip", "wep104", "wep40"</td>
952 <h3>RSN - a{sv} - (read)</h3>
953 <p>RSN information of the BSS. Empty dictionary indicates no RSN support. Dictionary entries are:</p>
955 <tr><td>KeyMgmt</td><td>as</td><td>Key management suite. Possible array elements: "wpa-psk", "wpa-eap", "wpa-ft-psk", "wpa-ft-eap", "wpa-psk-sha256", "wpa-eap-sha256",</td>
956 <tr><td>Pairwise</td><td>as</td><td>Pairwise cipher suites. Possible array elements: "ccmp", "tkip"</td>
957 <tr><td>Group</td><td>s</td><td>Group cipher suite. Possible values are: "ccmp", "tkip", "wep104", "wep40"</td>
958 <tr><td>MgmtGroup</td><td>s</td><td>Mangement frames cipher suite. Possible values are: "aes128cmac"</td>
962 <h3>IEs - ay - (read)</h3>
963 <p>All IEs of the BSS as a chain of TLVs</p>
966 <h3>Privacy - b - (read)</h3>
967 <p>Indicates if BSS supports privacy.</p>
970 <h3>Mode - s - (read)</h3>
971 <p>Describes mode of the BSS. Possible values are: "ad-hoc" and "infrastructure".</p>
974 <h3>Frequency - q - (read)</h3>
975 <p>Frequency of the BSS in MHz.</p>
978 <h3>Rates - au - (read)</h3>
979 <p>Descending ordered array of rates supported by the BSS in bits per second.</p>
982 <h3>Signal - n - (read)</h3>
983 <p>Signal strength of the BSS.</p>
987 \subsection dbus_bss_signals Signals
991 <h3>PropertiesChanged ( a{sv} : properties )</h3>
992 <p>Some properties have changed.</p>
995 <dt>a{sv} : properties</dt>
996 <dd>A dictionary with pairs of properties names which have changed and theirs new values.</dd>
1002 \section dbus_network fi.w1.wpa_supplicant1.Network
1004 Interface implemented by objects representing configured networks,
1005 i.e., returned by fi.w1.wpa_supplicant1.Interface.AddNetwork.
1007 \subsection dbus_network_properties Properties
1011 <h3>Enabled - b - (read/write)</h3>
1012 <p>Determines if the configured network is enabled or not.</p>
1016 <h3>Properties - a{sv} - (read/write)</h3>
1017 <p>Properties of the configured network. Dictionary contains entries from "network" block of %wpa_supplicant configuration file. All values are string type, e.g., frequency is "2437", not 2437.
1021 \subsection dbus_network_signals Signals
1025 <h3>PropertiesChanged ( a{sv} : properties )</h3>
1026 <p>Some properties have changed.</p>
1029 <dt>a{sv} : properties</dt>
1030 <dd>A dictionary with pairs of properties names which have changed and theirs new values. Possible dictionary keys are: "Enabled"</dd>