doc/network-lowlevel-api.txt

Network hierarchy
=================

Service		org.chromium.flimflam
Interface	org.chromium.flimflam.Network
Object path	[variable prefix]/{network0,network1,...}

Methods		dict GetProperties()

			Returns properties for the network object. See
			the properties section for available properties.

			Possible Errors: [service].Error.InvalidArguments

Signals		PropertyChanged(string name, variant value)

			This signal indicates a changed value of the given
			property.

Properties	string Address [readonly]

			The address of the network.

		boolean Connected [readonly]

			Whether or not the network is currently connected.

		object Device [readonly]

			The object path for the associated device.

		uint16 Frequency [readonly]

			The operating frequency in MHz of the network.

		string Name [readonly]

			The pretty/long version of the network name. For
			example in case of WiFi this will be a UTF-8
			valid version of the SSID.

			This property might not be available for every
			network. For example hidden WiFi networks will
			not include it.

		uint8 Strength [readonly]

			The signal strength of the network. This is a
			normalized value between 0 and 100 with higher
			values for stronger (better) signal.

		string WiFi.AuthMode [readonly]

			(WiFi only) The negotiated authentication method
			used to setup a connection.  There are too many
			possible values to enumerate here.  The complete
			set depends on the capabilities of the associated
			WiFi supplicant.

		uint16 WiFi.Channel [readonly]

			(WiFi only) The IEEE channel number of the
			network.  This value is for informational purposes
			only; the Frequency property should always be
			used when describing a network because channel
			numbers are ambiguous.

		string WiFi.Mode [readonly]

			(WiFi only) The mode of the network.  Possible
			values are "managed" or "adhoc".

		string WiFi.Passphrase [readonly]

			(WiFi only) If a passhrase is required, then this
			property is present and contains the passphrase
			in clear text.

			For systems using PolicyKit, the access to this value
			will be protected by the security policy.

		string WiFi.PhyMode [readonly]

			(WiFi only) The negotiated operating mode for
			the channel.  Possible values include "802.11a",
			"802.11b", "802.11g", "802.11n".  This value is
			for informational purposes only.

		string WiFi.Security [readonly]

			(WiFi only) The security method or key management
			setting.  Possible values are "none", "wep",
			"wpa", "rsn", and "802_1x".

		array{byte} WiFi.SSID [readonly]

			(WiFi only) The binary SSID value.

		string WiFi.EAP.Identity [readonly]
		string WiFi.EAP.EAP [readonly]
		string WiFi.EAP.InnerEAP [readonly]
		string WiFi.EAP.AnonymousIdentity [readonly]
		string WiFi.EAP.ClientCert [readonly]
		string WiFi.EAP.CertID [readonly]
		string WiFi.EAP.PrivateKey [readonly]
		string WiFi.EAP.PrivateKeyPassword [readonly]
		string WiFi.EAP.KeyID [readonly]
		string WiFi.EAP.CACert [readonly]
		string WiFi.EAP.CACertID [readonly]
		string WiFi.EAP.PIN [readonly]
		string WiFi.EAP.Password [readonly]
		string WiFi.EAP.KeyMgmt [readonly]

		       (WiFi only) Properties used in 802.1x authentication.
		       See the description of the equivalent property for
		       the Service object in service-api.txt.