Re: API changes for 802.1x and connections

[Dan Williams <dcbw redhat com>]

On Thu, 2008-03-20 at 15:58 -0400, Dan Williams wrote:
> 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.

One more note; the ActivateConnection() method should now return the
object path of the ActiveConnection object that was created as a result
of the method call, or an error of course.

Dan