Send connman mailing list submissions to
        [email protected]

To subscribe or unsubscribe via email, send a message with subject or
body 'help' to
        [email protected]

You can reach the person managing the list at
        [email protected]

When replying, please edit your Subject line so it is more specific
than "Re: Contents of connman digest..."

Today's Topics:

   1. [PATCH 3/3] doc: Document VPN connection SetProperties D-Bus method
      (Jussi Laakkonen)


----------------------------------------------------------------------

Date: Tue, 10 Dec 2019 16:08:12 +0200
From: Jussi Laakkonen <[email protected]>
Subject: [PATCH 3/3] doc: Document VPN connection SetProperties D-Bus
        method
To: [email protected]
Message-ID: <[email protected]>

Include documentation for the SetProperties in VPN connection API.

Add error PermissionDenied for SetProperty and ClearProperty into VPN
connection API. Add missing NotSupported error for SetProperty into VPN
connection API.
---
 doc/vpn-connection-api.txt | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)

diff --git a/doc/vpn-connection-api.txt b/doc/vpn-connection-api.txt
index 1fd3be26..cddde744 100644
--- a/doc/vpn-connection-api.txt
+++ b/doc/vpn-connection-api.txt
@@ -12,6 +12,31 @@ Methods              dict GetProperties()  [experimental]
 
                        Possible Errors: [connection].Error.InvalidArguments
 
+               void SetProperties(dict) [experimental]
+
+                       Change values of all properties defined in the dict.
+                       Only properties that are listed as read-write are
+                       changeable. See the properties section for available
+                       properties. On every successful property value change
+                       a PropertyChanged signal will be emitted. Clearing a
+                       property can be done by supplying an empty property
+                       value: an empty array for UserRoutes property or an
+                       empty string for any other property. In case there
+                       are errors with the properties, InvalidProperty or
+                       PermissionDenied error is sent. InvalidProperty is
+                       sent when there is at least one invalid property, in
+                       this case there can be also properties that cannot be
+                       changed (immutable properties). In case there are
+                       only immutable properties PermissionDenied error is
+                       returned. The properties that are invalid or
+                       immutable are reported back at the end of the error
+                       message as a comma separated property name list.
+
+                       Possible Errors: [connection].Error.InvalidArguments
+                                        [connection].Error.InvalidProperty
+                                        [connection].Error.PermissionDenied
+                                        [connection].Error.NotSupported
+
                void SetProperty(string name, variant value) [experimental]
 
                        Changes the value of the specified property. Only
@@ -21,6 +46,8 @@ Methods               dict GetProperties()  [experimental]
 
                        Possible Errors: [connection].Error.InvalidArguments
                                         [connection].Error.InvalidProperty
+                                        [connection].Error.PermissionDenied
+                                        [connection].Error.NotSupported
 
                void ClearProperty(string name) [experimental]
 
@@ -28,6 +55,7 @@ Methods               dict GetProperties()  [experimental]
 
                        Possible Errors: [connection].Error.InvalidArguments
                                         [connection].Error.InvalidProperty
+                                        [connection].Error.PermissionDenied
 
                void Connect() [experimental]
 
-- 
2.20.1

------------------------------

Subject: Digest Footer

_______________________________________________
connman mailing list -- [email protected]
To unsubscribe send an email to [email protected]


------------------------------

End of connman Digest, Vol 50, Issue 5
**************************************

Reply via email to