summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTim Beale <timbeale@catalyst.net.nz>2019-01-30 15:10:45 +1300
committerAndrew Bartlett <abartlet@samba.org>2019-02-01 03:36:15 +0100
commitb4211f69233f954a3fa596f464276184d85d322b (patch)
tree7f7b764f69d36e451d5bec7265416e1ecf955930
parenta094e16fd58bec1d5938a25e941b15c180ec7a55 (diff)
downloadsamba-b4211f69233f954a3fa596f464276184d85d322b.tar.gz
selftest: Add dns_hub to selftest/target/README
Add a description explaining what dns_hub does and why we need it. Signed-off-by: Tim Beale <timbeale@catalyst.net.nz> Reviewed-by: Volker Lendecke <vl@samba.org> Reviewed-by: Andrew Bartlett <abartlet@samba.org>
-rw-r--r--selftest/target/README13
-rwxr-xr-xselftest/target/dns_hub.py2
2 files changed, 15 insertions, 0 deletions
diff --git a/selftest/target/README b/selftest/target/README
index 36b68d5dd24..69d70217bdf 100644
--- a/selftest/target/README
+++ b/selftest/target/README
@@ -41,6 +41,19 @@ Note that several of the testenvs also use local in their name, e.g.
'localvampiredc'. In particular, there's the 'localdc', which is the NetBIOS
name of the DC in the 'ad_dc_ntvfs' testenv.
+dns_hub
+-------
+dns_hub doesn't run a Samba/smbd server like the other testenvs do. It's there
+to solve the problem of how to do DNS more nicely in selftest. Running
+autobuild can start up a lot of different testenvs, and so we end up with
+different DCs running in different domains. Each test suite only wants to talk
+to a specific domain at a time. However, by default the tests all use a common
+client.conf - essentially the tests are simulating a single client that's
+pretending to be in several different domains. The problem is when the test
+wants to resolve a DNS host, which DC should it ask? Each DC only knows about its
+own realm. dns_hub.py acts as a proxy, so it works out the correct DC to forward
+the query to, based on the queried host's realm.
+
Vampire DC
----------
Vampire DC gets its name for historic reasons. It's one of the few testenvs
diff --git a/selftest/target/dns_hub.py b/selftest/target/dns_hub.py
index 97b7432294c..d2d1f39e752 100755
--- a/selftest/target/dns_hub.py
+++ b/selftest/target/dns_hub.py
@@ -16,6 +16,8 @@
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
+# Used by selftest to proxy DNS queries to the correct testenv DC.
+# See selftest/target/README for more details.
# Based on the EchoServer example from python docs
import threading