From 3caa0043ec27f58f7dee6df181bc517b7674bf80 Mon Sep 17 00:00:00 2001
From: Larry Safran <lsafran@google.com>
Date: Wed, 26 Jun 2024 13:13:28 -0700
Subject: [PATCH] Add --address_type to interop and xds test descriptions
 (#36830)

This documents the changes the the test server classes in https://github.com/grpc/grpc-java/pull/11231

Closes #36830

COPYBARA_INTEGRATE_REVIEW=https://github.com/grpc/grpc/pull/36830 from larry-safran:dualstack_test_doc 986e9dd3fa4e90eb1a0bc550a0aadc886e5d327b
PiperOrigin-RevId: 647054757
---
 doc/interop-test-descriptions.md | 6 ++++++
 doc/xds-test-descriptions.md     | 6 ++++++
 2 files changed, 12 insertions(+)

diff --git a/doc/interop-test-descriptions.md b/doc/interop-test-descriptions.md
index fd3a195e166..2ae7ffb6b10 100755
--- a/doc/interop-test-descriptions.md
+++ b/doc/interop-test-descriptions.md
@@ -1287,6 +1287,12 @@ Servers should accept these arguments:
 
     * Whether to use a plaintext or encrypted connection
 
+Servers that want to be used for dual stack testing must accept this argument:
+
+* --address_type=IPV4|IPV6|IPV4_IPV6
+    
+    * What type of addresses to listen on. Default IPV4_IPV6
+
 Servers must support TLS with ALPN. They should use
 [server1.pem](https://github.com/grpc/grpc/blob/master/src/core/tsi/test_creds/server1.pem)
 for their certificate.
diff --git a/doc/xds-test-descriptions.md b/doc/xds-test-descriptions.md
index 8bd482ab01a..be2b3ff0eb6 100644
--- a/doc/xds-test-descriptions.md
+++ b/doc/xds-test-descriptions.md
@@ -17,6 +17,12 @@ Server should accept these arguments:
     *   When set to true it uses XdsServerCredentials with the test server for security test cases.
         In case of secure mode, port and maintenance_port should be different.
 
+Servers that want to support dual stack testing (like Java) should also accept:
+
+*  --address_type=IPV4|IPV6|IPV4_IPV6
+    *   Type of IP address to bind to.  IPV4_IPV6 will use the wildcard address.
+        IPV4 and IPV6 will cause server to bind to one non-localhost and the localhost address of the appropriate type
+
 In addition, when handling requests, if the initial request metadata contains the `rpc-behavior` key, it should modify its handling of the request as follows:
 
  - If the value matches `sleep-<int>`, the server should wait the specified number of seconds before resuming behavior matching and RPC processing.