document DNS roaming setting

cvmfs · Sep 27, 2018 · 5443a0e · 5443a0e
1 parent 0218e65
commit 5443a0e
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 0 deletions.
diff --git a/apx-parameters.rst b/apx-parameters.rst
@@ -32,6 +32,7 @@ CVMFS_DEBUGLOG                  If set, run CernVM-FS in debug mode and write a
 CVMFS_DEFAULT_DOMAIN            The default domain will be automatically appended to repository names when given without a domain.
 CVMFS_DNS_RETRIES               Number of retries when resolving proxy names
 CVMFS_DNS_TIMEOUT               Timeout in seconds when resolving proxy names
+CVMFS_DNS_ROAMING               If true, watch /etc/resolv.conf for nameserver changes
 CVMFS_EXTERNAL_FALLBACK_PROXY   List of HTTP proxies similar to ``CVMFS_EXTERNAL_HTTP_PROXY``. The fallback proxies are added to the end of the normal proxies, and disable DIRECT connections.
 CVMFS_EXTERNAL_HTTP_PROXY       Chain of HTTP proxy groups to be used when CernVM-FS is accessing external data
 CVMFS_EXTERNAL_TIMEOUT          Timeout in seconds for HTTP requests to an external-data server with a proxy server

diff --git a/cpt-configure.rst b/cpt-configure.rst
@@ -423,6 +423,14 @@ milliseconds precision randomly in the interval
 :math:`[1, \text{\$CVMFS\_BACKOFF\_INIT}\cdot 1000]`. With every retry,
 the backoff is then doubled.
 
+DNS Nameserver Changes
+~~~~~~~~~~~~~~~~~~~~~~
+
+CernVM-FS can watch /etc/resolv.conf and automatically follow changes to the
+DNS servers. This behavior is controlled by the ``CVMFS_DNS_ROAMING`` client
+configuration. It is by default turned on on macOS and turned off on Linux.
+
+
 .. _sct_cache:
 
 Cache Settings