3
0
mirror of https://git.kernel.org/pub/scm/network/wireless/iwd.git synced 2025-06-07 13:47:23 +02:00
iwd/doc/network-api.txt
James Prestwood f209e00dde doc: add note about timeouts to Network.Connect()
Since netconfig is now part of the Connect() call from a DBus
perspective add a note indicating that this method has the potential
to take a very long time if there are issues with DHCP.
2025-06-05 10:02:28 -05:00

64 lines
1.9 KiB
Plaintext

Network hierarchy
=================
Service net.connman.iwd
Interface net.connman.iwd.Network
Object path /net/connman/iwd/{phy0,phy1,...}/{1,2,...}/Xxx
Methods void Connect()
Connect to the network. Request the device implied by
the object path to connect to specified network.
Connecting to WEP networks is not supported.
Note: When [General].EnableNetworkConfiguration is set
to true a call to Connect() has the potential to take
a significant amount of time. Specifically if DHCP is
either slow, or is unable to complete. The timeout for
DHCP is roughly 30 seconds per BSS.
Possible errors: net.connman.iwd.Aborted
net.connman.iwd.Busy
net.connman.iwd.Failed
net.connman.iwd.NoAgent
net.connman.iwd.NotSupported
net.connman.iwd.Timeout
net.connman.iwd.InProgress
net.connman.iwd.NotConfigured
Properties string Name [readonly]
Network SSID
boolean Connected [readonly]
Reflects whether the network is currently connected
or actively being connected to. This is meant for
the application to show a check-box or some other
means to notify the user which network is currently
selected. Refer to net.connman.iwd.Station
documentation for more details if you need to know
the actual state of the connection (i.e connecting,
connected, etc)
object Device [readonly]
The object path of the station the network belongs to.
string Type [readonly]
Contains the type of the network. Possible
types are "open", "wep", "psk", or "8021x" (EAP)
object KnownNetwork [readonly, optional]
Contains the path of the KnownNetwork object
corresponding to this Network. If the network
is not provisioned or has not been connected to
before, the property is omitted.
array(object) ExtendedServiceSet [readonly]
Contains a list of paths of each individual
BasicServiceSet object.