X-Git-Url: https://vcs.maemo.org/git/?a=blobdiff_plain;f=doc%2Fservice-api.txt;h=ab1aa340b6920f0aebb152b6883ffc67cf2b394e;hb=b5ecc8c4f4cf4a299af6a4408d2ee3f5924ed2b8;hp=25c4631c2c0cc47df9abcacb4c7aa6c939f18c09;hpb=bd91f83892ec91781654f8cc3402a0f50b3f7a10;p=connman

diff --git a/doc/service-api.txt b/doc/service-api.txt
index 25c4631..ab1aa34 100644
--- a/doc/service-api.txt
+++ b/doc/service-api.txt
@@ -12,6 +12,66 @@ Methods		dict GetProperties()
 
 			Possible Errors: [service].Error.InvalidArguments
 
+		void Connect()
+
+			Connect this service. It will attempt to connect
+			WiFi, WiMAX or Bluetooth services.
+
+			For Ethernet devices this method can only be used
+			if it has previously been disconnected. Otherwise
+			the plugging of a cable will trigger connecting
+			automatically. If no cable is plugged in this method
+			will fail.
+
+			Possible Errors: [service].Error.InvalidArguments
+
+		void Disconnect()
+
+			Disconnect this service. If the service is not
+			connected an error message will be generated.
+
+			On Ethernet devices this will disconnect the IP
+			details from the service. It will not magically
+			unplug the cable. When no cable is plugged in this
+			method will fail.
+
+			Possible Errors: [service].Error.InvalidArguments
+
+		void Remove()
+
+			A successfully connected service with Favorite=true
+			can be removed this way. If it is connected, it will
+			be automatically disconnected first.
+
+			This is similar to setting the Favorite property
+			to false, but that is currently not supported.
+
+			Calling this method on Ethernet devices will cause
+			an error message. It is not possible to remove these
+			kind of devices.
+
+			Possible Errors: [service].Error.InvalidArguments
+
+		void MoveBefore(object service)
+
+			If a service has been used before, this allows a
+			reorder of the favorite services.
+
+			The target service object must be part of this
+			profile. Moving between profiles is not supported.
+
+			Possible Errors: [service].Error.InvalidArguments
+
+		void MoveAfter(object service)
+
+			If a service has been used before, this allows a
+			reorder of the favorite services.
+
+			The target service object must be part of this
+			profile. Moving between profiles is not supported.
+
+			Possible Errors: [service].Error.InvalidArguments
+
 Signals		PropertyChanged(string name, variant value)
 
 			This signal indicates a changed value of the given
@@ -21,6 +81,9 @@ Properties	string State [readonly]
 
 			The service state information.
 
+			Valid states are "idle", "failure", "association",
+			"configuration" and "ready".
+
 		string Name [readonly]
 
 			The service name (for example "Wireless" etc.)
@@ -28,6 +91,9 @@ Properties	string State [readonly]
 			This name can be used for directly displaying it in
 			the application. It has pure informational purpose.
 
+			For Ethernet devices and hidden WiFi networks  it is
+			not guaranteed that this property is present.
+
 		string Type [readonly]
 
 			The service type (for example "ethernet", "wifi" etc.)
@@ -42,15 +108,42 @@ Properties	string State [readonly]
 			present and contains the mode of the network. The
 			possible values are "managed" or "adhoc".
 
+			This property might be only present for WiFi
+			services.
+
 		string Security [readonly]
 
 			If the service type is WiFi, then this property is
 			present and contains the security method or key
 			management setting.
 
-			Possible values are "none", "wep", "wpa" and "wpa2".
+			Possible values are "none", "wep", "wpa" and "rsn".
+
+			This property might be only present for WiFi
+			services.
+
+		string Passphrase [readwrite]
+
+			If the service type is WiFi, then this property
+			can be used to store a passphrase.
+
+			This property is still experimental and might be
+			removed in future version.
 
 		uint8 Strength [readonly]
 
 			Indicates the signal strength of the service. This
 			is a normalized value between 0 and 100.
+
+			This property will not be present for Ethernet
+			devices.
+
+		boolean Favorite [readonly]
+
+			Will be true if a cable is plugged in or the user
+			selected and successfully connected to this service.
+
+			Setting this property to true has no effect at all
+			and setting it to false is similar to the Remove()
+			method. So for now it will be considered a read
+			only property.