Re: API changes for 802.1x and connections

[Dan Williams <dcbw redhat com>]

On Wed, 2008-03-19 at 17:03 -0400, Dan Williams wrote: 
> Hi,
> 
> Three API changes in the past few days...
> 
> 1) Split 802.1x options out of wireless-security to facilitate wired
> 802.1x.  There is now a new '802-1x' NMSetting which contains all of the
> options from wireless-security that were specific to 802.1x.  The
> setting description will be up on
> NetworkManagerConfigurationSpecification shortly.
> 
> 1a) Since old-school LEAP isn't 802.1x-based, it is still contained
> within the wireless-security NMSetting.  There are new 'leap-username'
> and 'leap-password' properties of NMSettingWirelessSecurity.  But
> connections that use Dynamic WEP or WPA[2] Enterprise with EAP-LEAP as
> the EAP method use the split out 802.1x setting.
> 
> 2) The ActivateDevice method on the main NetworkManager object has been
> renamed to ActivateConnection, and its arguments have been re-arranged
> so that the serivce_name and connection_path come before the
> device_path.  I might convert the arguments here to a dict in the
> future.  I may also add a DeactivateConnection method on the main NM
> object that takes the service_name + connection_path, and remove the
> Deactivate method of the device objects for consistency.
> 
> 3) The GetActiveConnections method on the main NM object now returns a
> list of dicts instead of a list of custom structures.

I've actually revised the interface yet again to be more consistent and
object-oriented.

There is now an "ActiveConnections" property on
the /org/freedesktop/NetworkManager::org.freedesktop.NetworkManager
object::interface that replaces the GetActiveConnections() call.  This
property is a list of object paths (signature 'ao') of ActiveConnection
objects.

There is a new ActiveConnection object with the D-Bus interface
org.freedesktop.NetworkManager.Connection.Active, which has a number of
properties itself:

ServiceName  (s)
Connection   (o)
SpecificObject (o)
SharedServiceName (s)
SharedConnection (o)
Devices (ao)

You'll get PropertyChanged signals on both the NetworkManager and
ActiveConnection objects when their properties change.

The Deactivate method on the Device object has been removed, the
functionality is now provided by a DeactivateConnection() method
on /org/freedesktop/NetworkManager::org.freedesktop.NetworkManager that
takes the path of the active connection you wish to deactivate.

Dan