summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/service-api.txt31
1 files changed, 29 insertions, 2 deletions
diff --git a/doc/service-api.txt b/doc/service-api.txt
index e488d7af..149e9d73 100644
--- a/doc/service-api.txt
+++ b/doc/service-api.txt
@@ -271,13 +271,40 @@ Properties string State [readonly]
indicates connections to a foreign provider when
traveling abroad.
- array{string} Nameservers [readwrite]
+ array{string} Nameservers [readonly]
+
+ The list of currently active nameservers for this
+ service. If the server is not in READY, LOGIN or
+ ONLINE state than this list will be empty.
+
+ Global nameservers are automatically added to this
+ list. The array represents a sorted list of the
+ current nameservers. The first one has the highest
+ priority and is used by default.
+
+ When using DHCP this array represents the nameservers
+ provided by the network. In case of manual settings,
+ the ones from Nameservers.Configuration are used.
+
+ array{string} Nameservers.Configuration [readwrite]
The list of manually configured domain name
servers. Some 3G networks don't provide correct
name servers and this allows for an override.
- array{string} Domains [readwrite]
+ This array is sorted by priority and the first
+ entry in the list represents the nameserver with
+ the highest priority.
+
+ When using manual configuration and no global
+ nameservers are configured, then it is useful
+ to configure this setting.
+
+ array{string} Domains [readonly]
+
+ The list of currently used search domains.
+
+ array{string} Domains.Configuration [readwrite]
The list of manually configured search domains.