Description

Objects that implement the Connection.Active interface represent an - attempt to connect to a network using the details provided by a Connection - object. The Connection.Active object tracks the life-cycle of the - connection attempt and if successful indicates whether the connected - network is the "default" or preferred network for access. NetworkManager - has the concept of connections, which can be thought of as settings, a - profile or a configuration that can be applied on a networking device. - Such settings-connections are exposed as D-Bus object and the - active-connection expresses this relationship between device and - settings-connection. At any time a settings-connection can only be - activated on one device and vice versa. However, during activation and - deactivation multiple active-connections can reference the same device or - settings-connection as they are waiting to be activated or to be - deactivated. +

+Objects that implement the Connection.Active interface represent an +attempt to connect to a network using the details provided by a Connection +object. The Connection.Active object tracks the life-cycle of the +connection attempt and if successful indicates whether the connected +network is the "default" or preferred network for access. NetworkManager +has the concept of connections, which can be thought of as settings, a +profile or a configuration that can be applied on a networking device. +Such settings-connections are exposed as D-Bus object and the +active-connection expresses this relationship between device and +settings-connection. At any time a settings-connection can only be +activated on one device and vice versa. However, during activation and +deactivation multiple active-connections can reference the same device or +settings-connection as they are waiting to be activated or to be +deactivated.

@@ -87,7 +88,8 @@ StateChanged (u state, u reason); -

Emitted when the state of the active connection has changed. +

+Emitted when the state of the active connection has changed.

@@ -97,11 +99,15 @@ StateChanged (u state, - + - +

`u state`:	(NMActiveConnectionState) The new state of the active connection.	+(NMActiveConnectionState) The new state of the active connection. +
`u reason`:	(NMActiveConnectionStateReason) Reason code describing the change to the new state.	+(NMActiveConnectionStateReason) Reason code describing the change to the new state. +

@@ -115,7 +121,8 @@ StateChanged (u state,

 Connection  readable   o

The path of the connection. +

+The path of the connection.

A specific object associated with the active connection. This property - reflects the specific object used during connection activation, and will - not change over the lifetime of the ActiveConnection once set. +

+A specific object associated with the active connection. This property +reflects the specific object used during connection activation, and will +not change over the lifetime of the ActiveConnection once set.

The ID of the connection, provided as a convenience so that clients do not - have to retrieve all connection details. +

+The ID of the connection, provided as a convenience so that clients do not +have to retrieve all connection details.

The UUID of the connection, provided as a convenience so that clients do - not have to retrieve all connection details. +

+The UUID of the connection, provided as a convenience so that clients do +not have to retrieve all connection details.

The type of the connection, provided as a convenience so that clients do - not have to retrieve all connection details. +

+The type of the connection, provided as a convenience so that clients do +not have to retrieve all connection details.

Array of object paths representing devices which are part of this active - connection. +

+Array of object paths representing devices which are part of this active +connection.

Whether this active connection is the default IPv4 connection, i.e. - whether it currently owns the default IPv4 route. +

+Whether this active connection is the default IPv4 connection, i.e. +whether it currently owns the default IPv4 route.

Object path of the Ip4Config object describing the configuration of the - connection. Only valid when the connection is in the - NM_ACTIVE_CONNECTION_STATE_ACTIVATED state. +

+Object path of the Ip4Config object describing the configuration of the +connection. Only valid when the connection is in the +NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

Object path of the Dhcp4Config object describing the DHCP options returned - by the DHCP server (assuming the connection used DHCP). Only valid when - the connection is in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED state. +

+Object path of the Dhcp4Config object describing the DHCP options returned +by the DHCP server (assuming the connection used DHCP). Only valid when +the connection is in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

Whether this active connection is the default IPv6 connection, i.e. - whether it currently owns the default IPv6 route. +

+Whether this active connection is the default IPv6 connection, i.e. +whether it currently owns the default IPv6 route.

Object path of the Ip6Config object describing the configuration of the - connection. Only valid when the connection is in the - NM_ACTIVE_CONNECTION_STATE_ACTIVATED state. +

+Object path of the Ip6Config object describing the configuration of the +connection. Only valid when the connection is in the +NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.

Object path of the Dhcp6Config object describing the DHCP options returned - by the DHCP server (assuming the connection used DHCP). Only valid when - the connection is in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED state. +

+Object path of the Dhcp6Config object describing the DHCP options returned +by the DHCP server (assuming the connection used DHCP). Only valid when +the connection is in the NM_ACTIVE_CONNECTION_STATE_ACTIVATED state.