doc: Fix race conditions in technology handling
authorMarcel Holtmann <marcel@holtmann.org>
Fri, 9 Dec 2011 11:37:27 +0000 (13:37 +0200)
committerMarcel Holtmann <marcel@holtmann.org>
Fri, 9 Dec 2011 11:37:27 +0000 (13:37 +0200)
doc/manager-api.txt

index 02fd89d..0edfad9 100644 (file)
@@ -22,23 +22,10 @@ Methods             dict GetProperties()
                        Possible Errors: [service].Error.InvalidArguments
                                         [service].Error.InvalidProperty
 
-               void RequestScan(string type)
+               array{object,dict} GetTechnologies()
 
-                       Request to trigger a scan for the specified
-                       technology. The empty string "" triggers scanning
-                       on all technologies.
-
-                       Possible Errors: [service].Error.InvalidArguments
-
-               void EnableTechnology(string type)
-
-                       Enable specified type of technologies.
-
-                       Possible Errors: [service].Error.InvalidArguments
-
-               void DisableTechnology(string type)
-
-                       Disable specified type of technologies.
+                       Returns a list of tuples with technology object
+                       path and dictionary of technology properties.
 
                        Possible Errors: [service].Error.InvalidArguments
 
@@ -154,7 +141,21 @@ Methods            dict GetProperties()
 
                        Possible Errors: [service].Error.InvalidArguments
 
-Signals                PropertyChanged(string name, variant value)
+Signals                TechnologyAdded(object path, dict properties)
+
+                       Signal that is sent when a new technology is added.
+
+                       It contains the object path of the technology and
+                       also its properties.
+
+               TechnologyRemoved(object path)
+
+                       Signal that is sent when a modem has been removed.
+
+                       The object path is no longer accessible after this
+                       signal and only emitted for reference.
+
+               PropertyChanged(string name, variant value)
 
                        This signal indicates a changed value of the given
                        property.
@@ -169,26 +170,6 @@ Properties string State [readonly]
                        the value "connected". This can only be seen if
                        previously no connection was present.
 
-               array{string} AvailableTechnologies [readonly]
-
-                       The list of available technologies. The strings
-                       are the same as the ones from the service types.
-
-               array{string} EnabledTechnologies [readonly]
-
-                       The list of enabled technologies. The strings
-                       are the same as the ones from the service types.
-
-               array{string} ConnectedTechnologies [readonly]
-
-                       The list of connected technologies. The strings
-                       are the same as the ones from the service type.
-
-               string DefaultTechnology [readonly]
-
-                       The current connected technology which holds the
-                       default route.
-
                boolean OfflineMode [readwrite]
 
                        The offline mode indicates the global setting for
@@ -202,10 +183,6 @@ Properties string State [readonly]
                        the limited usage of WiFi or Bluetooth devices might
                        be allowed in some situations.
 
-               array{object} Technologies [readonly]
-
-                       List of technology object paths.
-
                array{object} Services [readonly]
 
                        List of service object paths. The list is sorted