Merge "Test: separate common methods to EthernetTetheringTestBase"
This commit is contained in:
Nucca Chen
File diff suppressed because it is too large
Load Diff
@@ -16,24 +16,85 @@
|
|||||||
|
|
||||||
package android.net;
|
package android.net;
|
||||||
|
|
||||||
|
import static android.Manifest.permission.CONNECTIVITY_USE_RESTRICTED_NETWORKS;
|
||||||
|
import static android.Manifest.permission.MANAGE_TEST_NETWORKS;
|
||||||
|
import static android.Manifest.permission.NETWORK_SETTINGS;
|
||||||
|
import static android.Manifest.permission.TETHER_PRIVILEGED;
|
||||||
|
import static android.content.pm.PackageManager.FEATURE_WIFI;
|
||||||
import static android.net.InetAddresses.parseNumericAddress;
|
import static android.net.InetAddresses.parseNumericAddress;
|
||||||
|
import static android.net.TetheringManager.CONNECTIVITY_SCOPE_GLOBAL;
|
||||||
|
import static android.net.TetheringManager.CONNECTIVITY_SCOPE_LOCAL;
|
||||||
|
import static android.net.TetheringManager.TETHERING_ETHERNET;
|
||||||
|
import static android.net.TetheringTester.isExpectedIcmpPacket;
|
||||||
|
import static android.net.TetheringTester.isExpectedTcpPacket;
|
||||||
|
import static android.net.TetheringTester.isExpectedUdpPacket;
|
||||||
|
import static android.system.OsConstants.IPPROTO_IP;
|
||||||
|
import static android.system.OsConstants.IPPROTO_IPV6;
|
||||||
|
import static android.system.OsConstants.IPPROTO_TCP;
|
||||||
|
import static android.system.OsConstants.IPPROTO_UDP;
|
||||||
|
|
||||||
|
import static com.android.net.module.util.HexDump.dumpHexString;
|
||||||
|
import static com.android.net.module.util.NetworkStackConstants.ETHER_TYPE_IPV4;
|
||||||
|
import static com.android.net.module.util.NetworkStackConstants.ETHER_TYPE_IPV6;
|
||||||
|
import static com.android.net.module.util.NetworkStackConstants.ICMPV6_ROUTER_ADVERTISEMENT;
|
||||||
|
import static com.android.net.module.util.NetworkStackConstants.TCPHDR_ACK;
|
||||||
|
import static com.android.net.module.util.NetworkStackConstants.TCPHDR_SYN;
|
||||||
|
import static com.android.testutils.TestNetworkTrackerKt.initTestNetwork;
|
||||||
|
import static com.android.testutils.TestPermissionUtil.runAsShell;
|
||||||
|
|
||||||
|
import static org.junit.Assert.assertEquals;
|
||||||
|
import static org.junit.Assert.assertFalse;
|
||||||
|
import static org.junit.Assert.assertNotNull;
|
||||||
|
import static org.junit.Assert.assertNull;
|
||||||
|
import static org.junit.Assert.assertTrue;
|
||||||
|
import static org.junit.Assert.fail;
|
||||||
|
import static org.junit.Assume.assumeFalse;
|
||||||
|
import static org.junit.Assume.assumeTrue;
|
||||||
|
|
||||||
import android.app.UiAutomation;
|
import android.app.UiAutomation;
|
||||||
import android.content.Context;
|
import android.content.Context;
|
||||||
import android.content.pm.PackageManager;
|
import android.content.pm.PackageManager;
|
||||||
|
import android.net.EthernetManager.TetheredInterfaceCallback;
|
||||||
|
import android.net.EthernetManager.TetheredInterfaceRequest;
|
||||||
|
import android.net.TetheringManager.StartTetheringCallback;
|
||||||
|
import android.net.TetheringManager.TetheringEventCallback;
|
||||||
|
import android.net.TetheringManager.TetheringRequest;
|
||||||
|
import android.net.TetheringTester.TetheredDevice;
|
||||||
import android.net.cts.util.CtsNetUtils;
|
import android.net.cts.util.CtsNetUtils;
|
||||||
import android.os.Handler;
|
import android.os.Handler;
|
||||||
import android.os.HandlerThread;
|
import android.os.HandlerThread;
|
||||||
|
import android.os.SystemClock;
|
||||||
|
import android.util.Log;
|
||||||
|
|
||||||
|
import androidx.annotation.NonNull;
|
||||||
|
import androidx.annotation.Nullable;
|
||||||
import androidx.test.platform.app.InstrumentationRegistry;
|
import androidx.test.platform.app.InstrumentationRegistry;
|
||||||
|
|
||||||
|
import com.android.modules.utils.build.SdkLevel;
|
||||||
|
import com.android.net.module.util.PacketBuilder;
|
||||||
|
import com.android.testutils.HandlerUtils;
|
||||||
import com.android.testutils.TapPacketReader;
|
import com.android.testutils.TapPacketReader;
|
||||||
import com.android.testutils.TestNetworkTracker;
|
import com.android.testutils.TestNetworkTracker;
|
||||||
|
|
||||||
|
import org.junit.After;
|
||||||
|
import org.junit.Before;
|
||||||
|
|
||||||
|
import java.io.FileDescriptor;
|
||||||
import java.net.Inet4Address;
|
import java.net.Inet4Address;
|
||||||
import java.net.Inet6Address;
|
import java.net.Inet6Address;
|
||||||
import java.net.InetAddress;
|
import java.net.InetAddress;
|
||||||
|
import java.net.NetworkInterface;
|
||||||
|
import java.net.SocketException;
|
||||||
import java.nio.ByteBuffer;
|
import java.nio.ByteBuffer;
|
||||||
|
import java.util.Arrays;
|
||||||
|
import java.util.Collection;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.Objects;
|
||||||
|
import java.util.Set;
|
||||||
|
import java.util.concurrent.CompletableFuture;
|
||||||
|
import java.util.concurrent.CountDownLatch;
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
import java.util.concurrent.TimeoutException;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* TODO: Common variables or methods shared between CtsEthernetTetheringTest and
|
* TODO: Common variables or methods shared between CtsEthernetTetheringTest and
|
||||||
@@ -46,8 +107,8 @@ public abstract class EthernetTetheringTestBase {
|
|||||||
// Used to check if any tethering interface is available. Choose 200ms to be request timeout
|
// Used to check if any tethering interface is available. Choose 200ms to be request timeout
|
||||||
// because the average interface requested time on cuttlefish@acloud is around 10ms.
|
// because the average interface requested time on cuttlefish@acloud is around 10ms.
|
||||||
// See TetheredInterfaceRequester.getInterface, isInterfaceForTetheringAvailable.
|
// See TetheredInterfaceRequester.getInterface, isInterfaceForTetheringAvailable.
|
||||||
protected static final int AVAILABLE_TETHER_IFACE_REQUEST_TIMEOUT_MS = 200;
|
private static final int AVAILABLE_TETHER_IFACE_REQUEST_TIMEOUT_MS = 200;
|
||||||
protected static final int TETHER_REACHABILITY_ATTEMPTS = 20;
|
private static final int TETHER_REACHABILITY_ATTEMPTS = 20;
|
||||||
protected static final long WAIT_RA_TIMEOUT_MS = 2000;
|
protected static final long WAIT_RA_TIMEOUT_MS = 2000;
|
||||||
|
|
||||||
// Address and NAT prefix definition.
|
// Address and NAT prefix definition.
|
||||||
@@ -72,9 +133,9 @@ public abstract class EthernetTetheringTestBase {
|
|||||||
protected static final byte TYPE_OF_SERVICE = 0;
|
protected static final byte TYPE_OF_SERVICE = 0;
|
||||||
|
|
||||||
// IPv6 header definition.
|
// IPv6 header definition.
|
||||||
protected static final short HOP_LIMIT = 0x40;
|
private static final short HOP_LIMIT = 0x40;
|
||||||
// version=6, traffic class=0x0, flowlabel=0x0;
|
// version=6, traffic class=0x0, flowlabel=0x0;
|
||||||
protected static final int VERSION_TRAFFICCLASS_FLOWLABEL = 0x60000000;
|
private static final int VERSION_TRAFFICCLASS_FLOWLABEL = 0x60000000;
|
||||||
|
|
||||||
// UDP and TCP header definition.
|
// UDP and TCP header definition.
|
||||||
// LOCAL_PORT is used by public port and private port. Assume port 9876 has not been used yet
|
// LOCAL_PORT is used by public port and private port. Assume port 9876 has not been used yet
|
||||||
@@ -82,34 +143,877 @@ public abstract class EthernetTetheringTestBase {
|
|||||||
// NAT port forwarding could be different between private port and public port.
|
// NAT port forwarding could be different between private port and public port.
|
||||||
protected static final short LOCAL_PORT = 9876;
|
protected static final short LOCAL_PORT = 9876;
|
||||||
protected static final short REMOTE_PORT = 433;
|
protected static final short REMOTE_PORT = 433;
|
||||||
protected static final short WINDOW = (short) 0x2000;
|
private static final short WINDOW = (short) 0x2000;
|
||||||
protected static final short URGENT_POINTER = 0;
|
private static final short URGENT_POINTER = 0;
|
||||||
|
|
||||||
// Payload definition.
|
// Payload definition.
|
||||||
protected static final ByteBuffer EMPTY_PAYLOAD = ByteBuffer.wrap(new byte[0]);
|
protected static final ByteBuffer EMPTY_PAYLOAD = ByteBuffer.wrap(new byte[0]);
|
||||||
protected static final ByteBuffer TEST_REACHABILITY_PAYLOAD =
|
private static final ByteBuffer TEST_REACHABILITY_PAYLOAD =
|
||||||
ByteBuffer.wrap(new byte[] { (byte) 0x55, (byte) 0xaa });
|
ByteBuffer.wrap(new byte[] { (byte) 0x55, (byte) 0xaa });
|
||||||
protected static final ByteBuffer RX_PAYLOAD =
|
protected static final ByteBuffer RX_PAYLOAD =
|
||||||
ByteBuffer.wrap(new byte[] { (byte) 0x12, (byte) 0x34 });
|
ByteBuffer.wrap(new byte[] { (byte) 0x12, (byte) 0x34 });
|
||||||
protected static final ByteBuffer TX_PAYLOAD =
|
protected static final ByteBuffer TX_PAYLOAD =
|
||||||
ByteBuffer.wrap(new byte[] { (byte) 0x56, (byte) 0x78 });
|
ByteBuffer.wrap(new byte[] { (byte) 0x56, (byte) 0x78 });
|
||||||
|
|
||||||
protected final Context mContext = InstrumentationRegistry.getInstrumentation().getContext();
|
private final Context mContext = InstrumentationRegistry.getInstrumentation().getContext();
|
||||||
protected final EthernetManager mEm = mContext.getSystemService(EthernetManager.class);
|
private final EthernetManager mEm = mContext.getSystemService(EthernetManager.class);
|
||||||
protected final TetheringManager mTm = mContext.getSystemService(TetheringManager.class);
|
private final TetheringManager mTm = mContext.getSystemService(TetheringManager.class);
|
||||||
protected final PackageManager mPackageManager = mContext.getPackageManager();
|
private final PackageManager mPackageManager = mContext.getPackageManager();
|
||||||
protected final CtsNetUtils mCtsNetUtils = new CtsNetUtils(mContext);
|
private final CtsNetUtils mCtsNetUtils = new CtsNetUtils(mContext);
|
||||||
protected final UiAutomation mUiAutomation =
|
private final UiAutomation mUiAutomation =
|
||||||
InstrumentationRegistry.getInstrumentation().getUiAutomation();
|
InstrumentationRegistry.getInstrumentation().getUiAutomation();
|
||||||
|
|
||||||
// Late initialization in setUp()
|
// Late initialization in setUp()
|
||||||
protected boolean mRunTests;
|
private boolean mRunTests;
|
||||||
protected HandlerThread mHandlerThread;
|
private HandlerThread mHandlerThread;
|
||||||
protected Handler mHandler;
|
private Handler mHandler;
|
||||||
|
private TetheredInterfaceRequester mTetheredInterfaceRequester;
|
||||||
|
|
||||||
// Late initialization in initTetheringTester().
|
// Late initialization in initTetheringTester().
|
||||||
protected TapPacketReader mUpstreamReader;
|
private TapPacketReader mUpstreamReader;
|
||||||
protected TestNetworkTracker mUpstreamTracker;
|
private TestNetworkTracker mUpstreamTracker;
|
||||||
protected TestNetworkInterface mDownstreamIface;
|
private TestNetworkInterface mDownstreamIface;
|
||||||
protected TapPacketReader mDownstreamReader;
|
private TapPacketReader mDownstreamReader;
|
||||||
|
private MyTetheringEventCallback mTetheringEventCallback;
|
||||||
|
|
||||||
|
@Before
|
||||||
|
public void setUp() throws Exception {
|
||||||
|
mHandlerThread = new HandlerThread(getClass().getSimpleName());
|
||||||
|
mHandlerThread.start();
|
||||||
|
mHandler = new Handler(mHandlerThread.getLooper());
|
||||||
|
|
||||||
|
mRunTests = runAsShell(NETWORK_SETTINGS, TETHER_PRIVILEGED, () ->
|
||||||
|
mTm.isTetheringSupported());
|
||||||
|
assumeTrue(mRunTests);
|
||||||
|
|
||||||
|
mTetheredInterfaceRequester = new TetheredInterfaceRequester(mHandler, mEm);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void maybeStopTapPacketReader(final TapPacketReader tapPacketReader)
|
||||||
|
throws Exception {
|
||||||
|
if (tapPacketReader != null) {
|
||||||
|
TapPacketReader reader = tapPacketReader;
|
||||||
|
mHandler.post(() -> reader.stop());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void maybeCloseTestInterface(final TestNetworkInterface testInterface)
|
||||||
|
throws Exception {
|
||||||
|
if (testInterface != null) {
|
||||||
|
testInterface.getFileDescriptor().close();
|
||||||
|
Log.d(TAG, "Deleted test interface " + testInterface.getInterfaceName());
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void maybeUnregisterTetheringEventCallback(final MyTetheringEventCallback callback)
|
||||||
|
throws Exception {
|
||||||
|
if (callback != null) {
|
||||||
|
callback.awaitInterfaceUntethered();
|
||||||
|
callback.unregister();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void cleanUp() throws Exception {
|
||||||
|
setPreferTestNetworks(false);
|
||||||
|
|
||||||
|
if (mUpstreamTracker != null) {
|
||||||
|
runAsShell(MANAGE_TEST_NETWORKS, () -> {
|
||||||
|
mUpstreamTracker.teardown();
|
||||||
|
mUpstreamTracker = null;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
if (mUpstreamReader != null) {
|
||||||
|
TapPacketReader reader = mUpstreamReader;
|
||||||
|
mHandler.post(() -> reader.stop());
|
||||||
|
mUpstreamReader = null;
|
||||||
|
}
|
||||||
|
|
||||||
|
maybeStopTapPacketReader(mDownstreamReader);
|
||||||
|
mDownstreamReader = null;
|
||||||
|
// To avoid flaky which caused by the next test started but the previous interface is not
|
||||||
|
// untracked from EthernetTracker yet. Just delete the test interface without explicitly
|
||||||
|
// calling TetheringManager#stopTethering could let EthernetTracker untrack the test
|
||||||
|
// interface from server mode before tethering stopped. Thus, awaitInterfaceUntethered
|
||||||
|
// could not only make sure tethering is stopped but also guarantee the test interface is
|
||||||
|
// untracked from EthernetTracker.
|
||||||
|
maybeCloseTestInterface(mDownstreamIface);
|
||||||
|
mDownstreamIface = null;
|
||||||
|
maybeUnregisterTetheringEventCallback(mTetheringEventCallback);
|
||||||
|
mTetheringEventCallback = null;
|
||||||
|
|
||||||
|
runAsShell(NETWORK_SETTINGS, () -> mTetheredInterfaceRequester.release());
|
||||||
|
setIncludeTestInterfaces(false);
|
||||||
|
}
|
||||||
|
|
||||||
|
@After
|
||||||
|
public void tearDown() throws Exception {
|
||||||
|
try {
|
||||||
|
if (mRunTests) cleanUp();
|
||||||
|
} finally {
|
||||||
|
mHandlerThread.quitSafely();
|
||||||
|
mUiAutomation.dropShellPermissionIdentity();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected boolean isInterfaceForTetheringAvailable() throws Exception {
|
||||||
|
// Before T, all ethernet interfaces could be used for server mode. Instead of
|
||||||
|
// waiting timeout, just checking whether the system currently has any
|
||||||
|
// ethernet interface is more reliable.
|
||||||
|
if (!SdkLevel.isAtLeastT()) {
|
||||||
|
return runAsShell(CONNECTIVITY_USE_RESTRICTED_NETWORKS, () -> mEm.isAvailable());
|
||||||
|
}
|
||||||
|
|
||||||
|
// If previous test case doesn't release tethering interface successfully, the other tests
|
||||||
|
// after that test may be skipped as unexcepted.
|
||||||
|
// TODO: figure out a better way to check default tethering interface existenion.
|
||||||
|
final TetheredInterfaceRequester requester = new TetheredInterfaceRequester(mHandler, mEm);
|
||||||
|
try {
|
||||||
|
// Use short timeout (200ms) for requesting an existing interface, if any, because
|
||||||
|
// it should reurn faster than requesting a new tethering interface. Using default
|
||||||
|
// timeout (5000ms, TIMEOUT_MS) may make that total testing time is over 1 minute
|
||||||
|
// test module timeout on internal testing.
|
||||||
|
// TODO: if this becomes flaky, consider using default timeout (5000ms) and moving
|
||||||
|
// this check into #setUpOnce.
|
||||||
|
return requester.getInterface(AVAILABLE_TETHER_IFACE_REQUEST_TIMEOUT_MS) != null;
|
||||||
|
} catch (TimeoutException e) {
|
||||||
|
return false;
|
||||||
|
} finally {
|
||||||
|
runAsShell(NETWORK_SETTINGS, () -> {
|
||||||
|
requester.release();
|
||||||
|
});
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void setIncludeTestInterfaces(boolean include) {
|
||||||
|
runAsShell(NETWORK_SETTINGS, () -> {
|
||||||
|
mEm.setIncludeTestInterfaces(include);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void setPreferTestNetworks(boolean prefer) {
|
||||||
|
runAsShell(NETWORK_SETTINGS, () -> {
|
||||||
|
mTm.setPreferTestNetworks(prefer);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
protected String getTetheredInterface() throws Exception {
|
||||||
|
return mTetheredInterfaceRequester.getInterface();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected CompletableFuture<String> requestTetheredInterface() throws Exception {
|
||||||
|
return mTetheredInterfaceRequester.requestInterface();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected static void waitForRouterAdvertisement(TapPacketReader reader, String iface,
|
||||||
|
long timeoutMs) {
|
||||||
|
final long deadline = SystemClock.uptimeMillis() + timeoutMs;
|
||||||
|
do {
|
||||||
|
byte[] pkt = reader.popPacket(timeoutMs);
|
||||||
|
if (isExpectedIcmpPacket(pkt, true /* hasEth */, false /* isIpv4 */,
|
||||||
|
ICMPV6_ROUTER_ADVERTISEMENT)) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
|
||||||
|
timeoutMs = deadline - SystemClock.uptimeMillis();
|
||||||
|
} while (timeoutMs > 0);
|
||||||
|
fail("Did not receive router advertisement on " + iface + " after "
|
||||||
|
+ timeoutMs + "ms idle");
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
protected static final class MyTetheringEventCallback implements TetheringEventCallback {
|
||||||
|
private final TetheringManager mTm;
|
||||||
|
private final CountDownLatch mTetheringStartedLatch = new CountDownLatch(1);
|
||||||
|
private final CountDownLatch mTetheringStoppedLatch = new CountDownLatch(1);
|
||||||
|
private final CountDownLatch mLocalOnlyStartedLatch = new CountDownLatch(1);
|
||||||
|
private final CountDownLatch mLocalOnlyStoppedLatch = new CountDownLatch(1);
|
||||||
|
private final CountDownLatch mClientConnectedLatch = new CountDownLatch(1);
|
||||||
|
private final CountDownLatch mUpstreamLatch = new CountDownLatch(1);
|
||||||
|
private final CountDownLatch mCallbackRegisteredLatch = new CountDownLatch(1);
|
||||||
|
private final TetheringInterface mIface;
|
||||||
|
private final Network mExpectedUpstream;
|
||||||
|
|
||||||
|
private boolean mAcceptAnyUpstream = false;
|
||||||
|
|
||||||
|
private volatile boolean mInterfaceWasTethered = false;
|
||||||
|
private volatile boolean mInterfaceWasLocalOnly = false;
|
||||||
|
private volatile boolean mUnregistered = false;
|
||||||
|
private volatile Collection<TetheredClient> mClients = null;
|
||||||
|
private volatile Network mUpstream = null;
|
||||||
|
|
||||||
|
MyTetheringEventCallback(TetheringManager tm, String iface) {
|
||||||
|
this(tm, iface, null);
|
||||||
|
mAcceptAnyUpstream = true;
|
||||||
|
}
|
||||||
|
|
||||||
|
MyTetheringEventCallback(TetheringManager tm, String iface, Network expectedUpstream) {
|
||||||
|
mTm = tm;
|
||||||
|
mIface = new TetheringInterface(TETHERING_ETHERNET, iface);
|
||||||
|
mExpectedUpstream = expectedUpstream;
|
||||||
|
}
|
||||||
|
|
||||||
|
public void unregister() {
|
||||||
|
mTm.unregisterTetheringEventCallback(this);
|
||||||
|
mUnregistered = true;
|
||||||
|
}
|
||||||
|
@Override
|
||||||
|
public void onTetheredInterfacesChanged(List<String> interfaces) {
|
||||||
|
fail("Should only call callback that takes a Set<TetheringInterface>");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onTetheredInterfacesChanged(Set<TetheringInterface> interfaces) {
|
||||||
|
// Ignore stale callbacks registered by previous test cases.
|
||||||
|
if (mUnregistered) return;
|
||||||
|
|
||||||
|
if (!mInterfaceWasTethered && interfaces.contains(mIface)) {
|
||||||
|
// This interface is being tethered for the first time.
|
||||||
|
Log.d(TAG, "Tethering started: " + interfaces);
|
||||||
|
mInterfaceWasTethered = true;
|
||||||
|
mTetheringStartedLatch.countDown();
|
||||||
|
} else if (mInterfaceWasTethered && !interfaces.contains(mIface)) {
|
||||||
|
Log.d(TAG, "Tethering stopped: " + interfaces);
|
||||||
|
mTetheringStoppedLatch.countDown();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onLocalOnlyInterfacesChanged(List<String> interfaces) {
|
||||||
|
fail("Should only call callback that takes a Set<TetheringInterface>");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onLocalOnlyInterfacesChanged(Set<TetheringInterface> interfaces) {
|
||||||
|
// Ignore stale callbacks registered by previous test cases.
|
||||||
|
if (mUnregistered) return;
|
||||||
|
|
||||||
|
if (!mInterfaceWasLocalOnly && interfaces.contains(mIface)) {
|
||||||
|
// This interface is being put into local-only mode for the first time.
|
||||||
|
Log.d(TAG, "Local-only started: " + interfaces);
|
||||||
|
mInterfaceWasLocalOnly = true;
|
||||||
|
mLocalOnlyStartedLatch.countDown();
|
||||||
|
} else if (mInterfaceWasLocalOnly && !interfaces.contains(mIface)) {
|
||||||
|
Log.d(TAG, "Local-only stopped: " + interfaces);
|
||||||
|
mLocalOnlyStoppedLatch.countDown();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void awaitInterfaceTethered() throws Exception {
|
||||||
|
assertTrue("Ethernet not tethered after " + TIMEOUT_MS + "ms",
|
||||||
|
mTetheringStartedLatch.await(TIMEOUT_MS, TimeUnit.MILLISECONDS));
|
||||||
|
}
|
||||||
|
|
||||||
|
public void awaitInterfaceLocalOnly() throws Exception {
|
||||||
|
assertTrue("Ethernet not local-only after " + TIMEOUT_MS + "ms",
|
||||||
|
mLocalOnlyStartedLatch.await(TIMEOUT_MS, TimeUnit.MILLISECONDS));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Used to check if the callback has registered. When the callback is registered,
|
||||||
|
// onSupportedTetheringTypes is celled in onCallbackStarted(). After
|
||||||
|
// onSupportedTetheringTypes called, drop the permission for registering callback.
|
||||||
|
// See MyTetheringEventCallback#register, TetheringManager#onCallbackStarted.
|
||||||
|
@Override
|
||||||
|
public void onSupportedTetheringTypes(Set<Integer> supportedTypes) {
|
||||||
|
// Used to check callback registered.
|
||||||
|
mCallbackRegisteredLatch.countDown();
|
||||||
|
}
|
||||||
|
|
||||||
|
public void awaitCallbackRegistered() throws Exception {
|
||||||
|
if (!mCallbackRegisteredLatch.await(TIMEOUT_MS, TimeUnit.MILLISECONDS)) {
|
||||||
|
fail("Did not receive callback registered signal after " + TIMEOUT_MS + "ms");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public void awaitInterfaceUntethered() throws Exception {
|
||||||
|
// Don't block teardown if the interface was never tethered.
|
||||||
|
// This is racy because the interface might become tethered right after this check, but
|
||||||
|
// that can only happen in tearDown if startTethering timed out, which likely means
|
||||||
|
// the test has already failed.
|
||||||
|
if (!mInterfaceWasTethered && !mInterfaceWasLocalOnly) return;
|
||||||
|
|
||||||
|
if (mInterfaceWasTethered) {
|
||||||
|
assertTrue(mIface + " not untethered after " + TIMEOUT_MS + "ms",
|
||||||
|
mTetheringStoppedLatch.await(TIMEOUT_MS, TimeUnit.MILLISECONDS));
|
||||||
|
} else if (mInterfaceWasLocalOnly) {
|
||||||
|
assertTrue(mIface + " not untethered after " + TIMEOUT_MS + "ms",
|
||||||
|
mLocalOnlyStoppedLatch.await(TIMEOUT_MS, TimeUnit.MILLISECONDS));
|
||||||
|
} else {
|
||||||
|
fail(mIface + " cannot be both tethered and local-only. Update this test class.");
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onError(String ifName, int error) {
|
||||||
|
// Ignore stale callbacks registered by previous test cases.
|
||||||
|
if (mUnregistered) return;
|
||||||
|
|
||||||
|
fail("TetheringEventCallback got error:" + error + " on iface " + ifName);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onClientsChanged(Collection<TetheredClient> clients) {
|
||||||
|
// Ignore stale callbacks registered by previous test cases.
|
||||||
|
if (mUnregistered) return;
|
||||||
|
|
||||||
|
Log.d(TAG, "Got clients changed: " + clients);
|
||||||
|
mClients = clients;
|
||||||
|
if (clients.size() > 0) {
|
||||||
|
mClientConnectedLatch.countDown();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public Collection<TetheredClient> awaitClientConnected() throws Exception {
|
||||||
|
assertTrue("Did not receive client connected callback after " + TIMEOUT_MS + "ms",
|
||||||
|
mClientConnectedLatch.await(TIMEOUT_MS, TimeUnit.MILLISECONDS));
|
||||||
|
return mClients;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onUpstreamChanged(Network network) {
|
||||||
|
// Ignore stale callbacks registered by previous test cases.
|
||||||
|
if (mUnregistered) return;
|
||||||
|
|
||||||
|
Log.d(TAG, "Got upstream changed: " + network);
|
||||||
|
mUpstream = network;
|
||||||
|
if (mAcceptAnyUpstream || Objects.equals(mUpstream, mExpectedUpstream)) {
|
||||||
|
mUpstreamLatch.countDown();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
public Network awaitUpstreamChanged(boolean throwTimeoutException) throws Exception {
|
||||||
|
if (!mUpstreamLatch.await(TIMEOUT_MS, TimeUnit.MILLISECONDS)) {
|
||||||
|
final String errorMessage = "Did not receive upstream "
|
||||||
|
+ (mAcceptAnyUpstream ? "any" : mExpectedUpstream)
|
||||||
|
+ " callback after " + TIMEOUT_MS + "ms";
|
||||||
|
|
||||||
|
if (throwTimeoutException) {
|
||||||
|
throw new TimeoutException(errorMessage);
|
||||||
|
} else {
|
||||||
|
fail(errorMessage);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return mUpstream;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected MyTetheringEventCallback enableEthernetTethering(String iface,
|
||||||
|
TetheringRequest request, Network expectedUpstream) throws Exception {
|
||||||
|
// Enable ethernet tethering with null expectedUpstream means the test accept any upstream
|
||||||
|
// after etherent tethering started.
|
||||||
|
final MyTetheringEventCallback callback;
|
||||||
|
if (expectedUpstream != null) {
|
||||||
|
callback = new MyTetheringEventCallback(mTm, iface, expectedUpstream);
|
||||||
|
} else {
|
||||||
|
callback = new MyTetheringEventCallback(mTm, iface);
|
||||||
|
}
|
||||||
|
runAsShell(NETWORK_SETTINGS, () -> {
|
||||||
|
mTm.registerTetheringEventCallback(mHandler::post, callback);
|
||||||
|
// Need to hold the shell permission until callback is registered. This helps to avoid
|
||||||
|
// the test become flaky.
|
||||||
|
callback.awaitCallbackRegistered();
|
||||||
|
});
|
||||||
|
final CountDownLatch tetheringStartedLatch = new CountDownLatch(1);
|
||||||
|
StartTetheringCallback startTetheringCallback = new StartTetheringCallback() {
|
||||||
|
@Override
|
||||||
|
public void onTetheringStarted() {
|
||||||
|
Log.d(TAG, "Ethernet tethering started");
|
||||||
|
tetheringStartedLatch.countDown();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onTetheringFailed(int resultCode) {
|
||||||
|
fail("Unexpectedly got onTetheringFailed");
|
||||||
|
}
|
||||||
|
};
|
||||||
|
Log.d(TAG, "Starting Ethernet tethering");
|
||||||
|
runAsShell(TETHER_PRIVILEGED, () -> {
|
||||||
|
mTm.startTethering(request, mHandler::post /* executor */, startTetheringCallback);
|
||||||
|
// Binder call is an async call. Need to hold the shell permission until tethering
|
||||||
|
// started. This helps to avoid the test become flaky.
|
||||||
|
if (!tetheringStartedLatch.await(TIMEOUT_MS, TimeUnit.MILLISECONDS)) {
|
||||||
|
fail("Did not receive tethering started callback after " + TIMEOUT_MS + "ms");
|
||||||
|
}
|
||||||
|
});
|
||||||
|
|
||||||
|
final int connectivityType = request.getConnectivityScope();
|
||||||
|
switch (connectivityType) {
|
||||||
|
case CONNECTIVITY_SCOPE_GLOBAL:
|
||||||
|
callback.awaitInterfaceTethered();
|
||||||
|
break;
|
||||||
|
case CONNECTIVITY_SCOPE_LOCAL:
|
||||||
|
callback.awaitInterfaceLocalOnly();
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
fail("Unexpected connectivity type requested: " + connectivityType);
|
||||||
|
}
|
||||||
|
|
||||||
|
return callback;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected MyTetheringEventCallback enableEthernetTethering(String iface,
|
||||||
|
Network expectedUpstream) throws Exception {
|
||||||
|
return enableEthernetTethering(iface,
|
||||||
|
new TetheringRequest.Builder(TETHERING_ETHERNET)
|
||||||
|
.setShouldShowEntitlementUi(false).build(), expectedUpstream);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected int getMTU(TestNetworkInterface iface) throws SocketException {
|
||||||
|
NetworkInterface nif = NetworkInterface.getByName(iface.getInterfaceName());
|
||||||
|
assertNotNull("Can't get NetworkInterface object for " + iface.getInterfaceName(), nif);
|
||||||
|
return nif.getMTU();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected TapPacketReader makePacketReader(final TestNetworkInterface iface) throws Exception {
|
||||||
|
FileDescriptor fd = iface.getFileDescriptor().getFileDescriptor();
|
||||||
|
return makePacketReader(fd, getMTU(iface));
|
||||||
|
}
|
||||||
|
|
||||||
|
protected TapPacketReader makePacketReader(FileDescriptor fd, int mtu) {
|
||||||
|
final TapPacketReader reader = new TapPacketReader(mHandler, fd, mtu);
|
||||||
|
mHandler.post(() -> reader.start());
|
||||||
|
HandlerUtils.waitForIdle(mHandler, TIMEOUT_MS);
|
||||||
|
return reader;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected static final class TetheredInterfaceRequester implements TetheredInterfaceCallback {
|
||||||
|
private final Handler mHandler;
|
||||||
|
private final EthernetManager mEm;
|
||||||
|
|
||||||
|
private TetheredInterfaceRequest mRequest;
|
||||||
|
private final CompletableFuture<String> mFuture = new CompletableFuture<>();
|
||||||
|
|
||||||
|
TetheredInterfaceRequester(Handler handler, EthernetManager em) {
|
||||||
|
mHandler = handler;
|
||||||
|
mEm = em;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onAvailable(String iface) {
|
||||||
|
Log.d(TAG, "Ethernet interface available: " + iface);
|
||||||
|
mFuture.complete(iface);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Override
|
||||||
|
public void onUnavailable() {
|
||||||
|
mFuture.completeExceptionally(new IllegalStateException("onUnavailable received"));
|
||||||
|
}
|
||||||
|
|
||||||
|
public CompletableFuture<String> requestInterface() {
|
||||||
|
assertNull("BUG: more than one tethered interface request", mRequest);
|
||||||
|
Log.d(TAG, "Requesting tethered interface");
|
||||||
|
mRequest = runAsShell(NETWORK_SETTINGS, () ->
|
||||||
|
mEm.requestTetheredInterface(mHandler::post, this));
|
||||||
|
return mFuture;
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getInterface(int timeout) throws Exception {
|
||||||
|
return requestInterface().get(timeout, TimeUnit.MILLISECONDS);
|
||||||
|
}
|
||||||
|
|
||||||
|
public String getInterface() throws Exception {
|
||||||
|
return getInterface(TIMEOUT_MS);
|
||||||
|
}
|
||||||
|
|
||||||
|
public void release() {
|
||||||
|
if (mRequest != null) {
|
||||||
|
mFuture.obtrudeException(new IllegalStateException("Request already released"));
|
||||||
|
mRequest.release();
|
||||||
|
mRequest = null;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected TestNetworkInterface createTestInterface() throws Exception {
|
||||||
|
TestNetworkManager tnm = runAsShell(MANAGE_TEST_NETWORKS, () ->
|
||||||
|
mContext.getSystemService(TestNetworkManager.class));
|
||||||
|
TestNetworkInterface iface = runAsShell(MANAGE_TEST_NETWORKS, () ->
|
||||||
|
tnm.createTapInterface());
|
||||||
|
Log.d(TAG, "Created test interface " + iface.getInterfaceName());
|
||||||
|
return iface;
|
||||||
|
}
|
||||||
|
|
||||||
|
protected TestNetworkTracker createTestUpstream(final List<LinkAddress> addresses,
|
||||||
|
final List<InetAddress> dnses) throws Exception {
|
||||||
|
setPreferTestNetworks(true);
|
||||||
|
|
||||||
|
final LinkProperties lp = new LinkProperties();
|
||||||
|
lp.setLinkAddresses(addresses);
|
||||||
|
lp.setDnsServers(dnses);
|
||||||
|
lp.setNat64Prefix(TEST_NAT64PREFIX);
|
||||||
|
|
||||||
|
return runAsShell(MANAGE_TEST_NETWORKS, () -> initTestNetwork(mContext, lp, TIMEOUT_MS));
|
||||||
|
}
|
||||||
|
|
||||||
|
private short getEthType(@NonNull final InetAddress srcIp, @NonNull final InetAddress dstIp) {
|
||||||
|
return isAddressIpv4(srcIp, dstIp) ? (short) ETHER_TYPE_IPV4 : (short) ETHER_TYPE_IPV6;
|
||||||
|
}
|
||||||
|
|
||||||
|
private int getIpProto(@NonNull final InetAddress srcIp, @NonNull final InetAddress dstIp) {
|
||||||
|
return isAddressIpv4(srcIp, dstIp) ? IPPROTO_IP : IPPROTO_IPV6;
|
||||||
|
}
|
||||||
|
|
||||||
|
@NonNull
|
||||||
|
protected ByteBuffer buildUdpPacket(
|
||||||
|
@Nullable final MacAddress srcMac, @Nullable final MacAddress dstMac,
|
||||||
|
@NonNull final InetAddress srcIp, @NonNull final InetAddress dstIp,
|
||||||
|
short srcPort, short dstPort, @Nullable final ByteBuffer payload)
|
||||||
|
throws Exception {
|
||||||
|
final int ipProto = getIpProto(srcIp, dstIp);
|
||||||
|
final boolean hasEther = (srcMac != null && dstMac != null);
|
||||||
|
final int payloadLen = (payload == null) ? 0 : payload.limit();
|
||||||
|
final ByteBuffer buffer = PacketBuilder.allocate(hasEther, ipProto, IPPROTO_UDP,
|
||||||
|
payloadLen);
|
||||||
|
final PacketBuilder packetBuilder = new PacketBuilder(buffer);
|
||||||
|
|
||||||
|
// [1] Ethernet header
|
||||||
|
if (hasEther) {
|
||||||
|
packetBuilder.writeL2Header(srcMac, dstMac, getEthType(srcIp, dstIp));
|
||||||
|
}
|
||||||
|
|
||||||
|
// [2] IP header
|
||||||
|
if (ipProto == IPPROTO_IP) {
|
||||||
|
packetBuilder.writeIpv4Header(TYPE_OF_SERVICE, ID, FLAGS_AND_FRAGMENT_OFFSET,
|
||||||
|
TIME_TO_LIVE, (byte) IPPROTO_UDP, (Inet4Address) srcIp, (Inet4Address) dstIp);
|
||||||
|
} else {
|
||||||
|
packetBuilder.writeIpv6Header(VERSION_TRAFFICCLASS_FLOWLABEL, (byte) IPPROTO_UDP,
|
||||||
|
HOP_LIMIT, (Inet6Address) srcIp, (Inet6Address) dstIp);
|
||||||
|
}
|
||||||
|
|
||||||
|
// [3] UDP header
|
||||||
|
packetBuilder.writeUdpHeader(srcPort, dstPort);
|
||||||
|
|
||||||
|
// [4] Payload
|
||||||
|
if (payload != null) {
|
||||||
|
buffer.put(payload);
|
||||||
|
// in case data might be reused by caller, restore the position and
|
||||||
|
// limit of bytebuffer.
|
||||||
|
payload.clear();
|
||||||
|
}
|
||||||
|
|
||||||
|
return packetBuilder.finalizePacket();
|
||||||
|
}
|
||||||
|
|
||||||
|
@NonNull
|
||||||
|
protected ByteBuffer buildUdpPacket(@NonNull final InetAddress srcIp,
|
||||||
|
@NonNull final InetAddress dstIp, short srcPort, short dstPort,
|
||||||
|
@Nullable final ByteBuffer payload) throws Exception {
|
||||||
|
return buildUdpPacket(null /* srcMac */, null /* dstMac */, srcIp, dstIp, srcPort,
|
||||||
|
dstPort, payload);
|
||||||
|
}
|
||||||
|
|
||||||
|
private boolean isAddressIpv4(@NonNull final InetAddress srcIp,
|
||||||
|
@NonNull final InetAddress dstIp) {
|
||||||
|
if (srcIp instanceof Inet4Address && dstIp instanceof Inet4Address) return true;
|
||||||
|
if (srcIp instanceof Inet6Address && dstIp instanceof Inet6Address) return false;
|
||||||
|
|
||||||
|
fail("Unsupported conditions: srcIp " + srcIp + ", dstIp " + dstIp);
|
||||||
|
return false; // unreachable
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void sendDownloadPacketUdp(@NonNull final InetAddress srcIp,
|
||||||
|
@NonNull final InetAddress dstIp, @NonNull final TetheringTester tester,
|
||||||
|
boolean is6To4) throws Exception {
|
||||||
|
if (is6To4) {
|
||||||
|
assertFalse("CLAT download test must sends IPv6 packet", isAddressIpv4(srcIp, dstIp));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Expected received UDP packet IP protocol. While testing CLAT (is6To4 = true), the packet
|
||||||
|
// on downstream must be IPv4. Otherwise, the IP protocol of test packet is the same on
|
||||||
|
// both downstream and upstream.
|
||||||
|
final boolean isIpv4 = is6To4 ? true : isAddressIpv4(srcIp, dstIp);
|
||||||
|
|
||||||
|
final ByteBuffer testPacket = buildUdpPacket(srcIp, dstIp, REMOTE_PORT /* srcPort */,
|
||||||
|
LOCAL_PORT /* dstPort */, RX_PAYLOAD);
|
||||||
|
tester.verifyDownload(testPacket, p -> {
|
||||||
|
Log.d(TAG, "Packet in downstream: " + dumpHexString(p));
|
||||||
|
return isExpectedUdpPacket(p, true /* hasEther */, isIpv4, RX_PAYLOAD);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void sendUploadPacketUdp(@NonNull final MacAddress srcMac,
|
||||||
|
@NonNull final MacAddress dstMac, @NonNull final InetAddress srcIp,
|
||||||
|
@NonNull final InetAddress dstIp, @NonNull final TetheringTester tester,
|
||||||
|
boolean is4To6) throws Exception {
|
||||||
|
if (is4To6) {
|
||||||
|
assertTrue("CLAT upload test must sends IPv4 packet", isAddressIpv4(srcIp, dstIp));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Expected received UDP packet IP protocol. While testing CLAT (is4To6 = true), the packet
|
||||||
|
// on upstream must be IPv6. Otherwise, the IP protocol of test packet is the same on
|
||||||
|
// both downstream and upstream.
|
||||||
|
final boolean isIpv4 = is4To6 ? false : isAddressIpv4(srcIp, dstIp);
|
||||||
|
|
||||||
|
final ByteBuffer testPacket = buildUdpPacket(srcMac, dstMac, srcIp, dstIp,
|
||||||
|
LOCAL_PORT /* srcPort */, REMOTE_PORT /* dstPort */, TX_PAYLOAD);
|
||||||
|
tester.verifyUpload(testPacket, p -> {
|
||||||
|
Log.d(TAG, "Packet in upstream: " + dumpHexString(p));
|
||||||
|
return isExpectedUdpPacket(p, false /* hasEther */, isIpv4, TX_PAYLOAD);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@NonNull
|
||||||
|
private ByteBuffer buildTcpPacket(
|
||||||
|
@Nullable final MacAddress srcMac, @Nullable final MacAddress dstMac,
|
||||||
|
@NonNull final InetAddress srcIp, @NonNull final InetAddress dstIp,
|
||||||
|
short srcPort, short dstPort, final short seq, final short ack,
|
||||||
|
final byte tcpFlags, @NonNull final ByteBuffer payload) throws Exception {
|
||||||
|
final int ipProto = getIpProto(srcIp, dstIp);
|
||||||
|
final boolean hasEther = (srcMac != null && dstMac != null);
|
||||||
|
final ByteBuffer buffer = PacketBuilder.allocate(hasEther, ipProto, IPPROTO_TCP,
|
||||||
|
payload.limit());
|
||||||
|
final PacketBuilder packetBuilder = new PacketBuilder(buffer);
|
||||||
|
|
||||||
|
// [1] Ethernet header
|
||||||
|
if (hasEther) {
|
||||||
|
packetBuilder.writeL2Header(srcMac, dstMac, getEthType(srcIp, dstIp));
|
||||||
|
}
|
||||||
|
|
||||||
|
// [2] IP header
|
||||||
|
if (ipProto == IPPROTO_IP) {
|
||||||
|
packetBuilder.writeIpv4Header(TYPE_OF_SERVICE, ID, FLAGS_AND_FRAGMENT_OFFSET,
|
||||||
|
TIME_TO_LIVE, (byte) IPPROTO_TCP, (Inet4Address) srcIp, (Inet4Address) dstIp);
|
||||||
|
} else {
|
||||||
|
packetBuilder.writeIpv6Header(VERSION_TRAFFICCLASS_FLOWLABEL, (byte) IPPROTO_TCP,
|
||||||
|
HOP_LIMIT, (Inet6Address) srcIp, (Inet6Address) dstIp);
|
||||||
|
}
|
||||||
|
|
||||||
|
// [3] TCP header
|
||||||
|
packetBuilder.writeTcpHeader(srcPort, dstPort, seq, ack, tcpFlags, WINDOW, URGENT_POINTER);
|
||||||
|
|
||||||
|
// [4] Payload
|
||||||
|
buffer.put(payload);
|
||||||
|
// in case data might be reused by caller, restore the position and
|
||||||
|
// limit of bytebuffer.
|
||||||
|
payload.clear();
|
||||||
|
|
||||||
|
return packetBuilder.finalizePacket();
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void sendDownloadPacketTcp(@NonNull final InetAddress srcIp,
|
||||||
|
@NonNull final InetAddress dstIp, short seq, short ack, byte tcpFlags,
|
||||||
|
@NonNull final ByteBuffer payload, @NonNull final TetheringTester tester,
|
||||||
|
boolean is6To4) throws Exception {
|
||||||
|
if (is6To4) {
|
||||||
|
assertFalse("CLAT download test must sends IPv6 packet", isAddressIpv4(srcIp, dstIp));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Expected received TCP packet IP protocol. While testing CLAT (is6To4 = true), the packet
|
||||||
|
// on downstream must be IPv4. Otherwise, the IP protocol of test packet is the same on
|
||||||
|
// both downstream and upstream.
|
||||||
|
final boolean isIpv4 = is6To4 ? true : isAddressIpv4(srcIp, dstIp);
|
||||||
|
|
||||||
|
final ByteBuffer testPacket = buildTcpPacket(null /* srcMac */, null /* dstMac */,
|
||||||
|
srcIp, dstIp, REMOTE_PORT /* srcPort */, LOCAL_PORT /* dstPort */, seq, ack,
|
||||||
|
tcpFlags, payload);
|
||||||
|
tester.verifyDownload(testPacket, p -> {
|
||||||
|
Log.d(TAG, "Packet in downstream: " + dumpHexString(p));
|
||||||
|
|
||||||
|
return isExpectedTcpPacket(p, true /* hasEther */, isIpv4, seq, payload);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void sendUploadPacketTcp(@NonNull final MacAddress srcMac,
|
||||||
|
@NonNull final MacAddress dstMac, @NonNull final InetAddress srcIp,
|
||||||
|
@NonNull final InetAddress dstIp, short seq, short ack, byte tcpFlags,
|
||||||
|
@NonNull final ByteBuffer payload, @NonNull final TetheringTester tester,
|
||||||
|
boolean is4To6) throws Exception {
|
||||||
|
if (is4To6) {
|
||||||
|
assertTrue("CLAT upload test must sends IPv4 packet", isAddressIpv4(srcIp, dstIp));
|
||||||
|
}
|
||||||
|
|
||||||
|
// Expected received TCP packet IP protocol. While testing CLAT (is4To6 = true), the packet
|
||||||
|
// on upstream must be IPv6. Otherwise, the IP protocol of test packet is the same on
|
||||||
|
// both downstream and upstream.
|
||||||
|
final boolean isIpv4 = is4To6 ? false : isAddressIpv4(srcIp, dstIp);
|
||||||
|
|
||||||
|
final ByteBuffer testPacket = buildTcpPacket(srcMac, dstMac, srcIp, dstIp,
|
||||||
|
LOCAL_PORT /* srcPort */, REMOTE_PORT /* dstPort */, seq, ack, tcpFlags,
|
||||||
|
payload);
|
||||||
|
tester.verifyUpload(testPacket, p -> {
|
||||||
|
Log.d(TAG, "Packet in upstream: " + dumpHexString(p));
|
||||||
|
|
||||||
|
return isExpectedTcpPacket(p, false /* hasEther */, isIpv4, seq, payload);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
protected void runTcpTest(
|
||||||
|
@NonNull final MacAddress uploadSrcMac, @NonNull final MacAddress uploadDstMac,
|
||||||
|
@NonNull final InetAddress uploadSrcIp, @NonNull final InetAddress uploadDstIp,
|
||||||
|
@NonNull final InetAddress downloadSrcIp, @NonNull final InetAddress downloadDstIp,
|
||||||
|
@NonNull final TetheringTester tester, boolean isClat) throws Exception {
|
||||||
|
// Three way handshake and data transfer.
|
||||||
|
//
|
||||||
|
// Server (base seq = 2000) Client (base seq = 1000)
|
||||||
|
// | |
|
||||||
|
// | [1] [SYN] SEQ = 1000 |
|
||||||
|
// |<---------------------------------------------------------| -
|
||||||
|
// | | ^
|
||||||
|
// | [2] [SYN + ACK] SEQ = 2000, ACK = 1000+1 | |
|
||||||
|
// |--------------------------------------------------------->| three way handshake
|
||||||
|
// | | |
|
||||||
|
// | [3] [ACK] SEQ = 1001, ACK = 2000+1 | v
|
||||||
|
// |<---------------------------------------------------------| -
|
||||||
|
// | | ^
|
||||||
|
// | [4] [ACK] SEQ = 1001, ACK = 2001, 2 byte payload | |
|
||||||
|
// |<---------------------------------------------------------| data transfer
|
||||||
|
// | | |
|
||||||
|
// | [5] [ACK] SEQ = 2001, ACK = 1001+2, 2 byte payload | v
|
||||||
|
// |--------------------------------------------------------->| -
|
||||||
|
// | |
|
||||||
|
//
|
||||||
|
|
||||||
|
// This test can only verify the packets are transferred end to end but TCP state.
|
||||||
|
// TODO: verify TCP state change via /proc/net/nf_conntrack or netlink conntrack event.
|
||||||
|
// [1] [UPLOAD] [SYN]: SEQ = 1000
|
||||||
|
sendUploadPacketTcp(uploadSrcMac, uploadDstMac, uploadSrcIp, uploadDstIp,
|
||||||
|
(short) 1000 /* seq */, (short) 0 /* ack */, TCPHDR_SYN, EMPTY_PAYLOAD,
|
||||||
|
tester, isClat /* is4To6 */);
|
||||||
|
|
||||||
|
// [2] [DONWLOAD] [SYN + ACK]: SEQ = 2000, ACK = 1001
|
||||||
|
sendDownloadPacketTcp(downloadSrcIp, downloadDstIp, (short) 2000 /* seq */,
|
||||||
|
(short) 1001 /* ack */, (byte) ((TCPHDR_SYN | TCPHDR_ACK) & 0xff), EMPTY_PAYLOAD,
|
||||||
|
tester, isClat /* is6To4 */);
|
||||||
|
|
||||||
|
// [3] [UPLOAD] [ACK]: SEQ = 1001, ACK = 2001
|
||||||
|
sendUploadPacketTcp(uploadSrcMac, uploadDstMac, uploadSrcIp, uploadDstIp,
|
||||||
|
(short) 1001 /* seq */, (short) 2001 /* ack */, TCPHDR_ACK, EMPTY_PAYLOAD, tester,
|
||||||
|
isClat /* is4To6 */);
|
||||||
|
|
||||||
|
// [4] [UPLOAD] [ACK]: SEQ = 1001, ACK = 2001, 2 byte payload
|
||||||
|
sendUploadPacketTcp(uploadSrcMac, uploadDstMac, uploadSrcIp, uploadDstIp,
|
||||||
|
(short) 1001 /* seq */, (short) 2001 /* ack */, TCPHDR_ACK, TX_PAYLOAD,
|
||||||
|
tester, isClat /* is4To6 */);
|
||||||
|
|
||||||
|
// [5] [DONWLOAD] [ACK]: SEQ = 2001, ACK = 1003, 2 byte payload
|
||||||
|
sendDownloadPacketTcp(downloadSrcIp, downloadDstIp, (short) 2001 /* seq */,
|
||||||
|
(short) 1003 /* ack */, TCPHDR_ACK, RX_PAYLOAD, tester, isClat /* is6To4 */);
|
||||||
|
|
||||||
|
// TODO: test BPF offload maps.
|
||||||
|
}
|
||||||
|
|
||||||
|
// TODO: remove ipv4 verification (is4To6 = false) once upstream connected notification race is
|
||||||
|
// fixed. See #runUdp4Test.
|
||||||
|
//
|
||||||
|
// This function sends a probe packet to downstream interface and exam the result from upstream
|
||||||
|
// interface to make sure ipv4 tethering is ready. Return the entire packet which received from
|
||||||
|
// upstream interface.
|
||||||
|
@NonNull
|
||||||
|
protected byte[] probeV4TetheringConnectivity(TetheringTester tester, TetheredDevice tethered,
|
||||||
|
boolean is4To6) throws Exception {
|
||||||
|
final ByteBuffer probePacket = buildUdpPacket(tethered.macAddr,
|
||||||
|
tethered.routerMacAddr, tethered.ipv4Addr /* srcIp */,
|
||||||
|
REMOTE_IP4_ADDR /* dstIp */, LOCAL_PORT /* srcPort */, REMOTE_PORT /* dstPort */,
|
||||||
|
TEST_REACHABILITY_PAYLOAD);
|
||||||
|
|
||||||
|
// Send a UDP packet from client and check the packet can be found on upstream interface.
|
||||||
|
for (int i = 0; i < TETHER_REACHABILITY_ATTEMPTS; i++) {
|
||||||
|
byte[] expectedPacket = tester.testUpload(probePacket, p -> {
|
||||||
|
Log.d(TAG, "Packet in upstream: " + dumpHexString(p));
|
||||||
|
// If is4To6 is true, the ipv4 probe packet would be translated to ipv6 by Clat and
|
||||||
|
// would see this translated ipv6 packet in upstream interface.
|
||||||
|
return isExpectedUdpPacket(p, false /* hasEther */, !is4To6 /* isIpv4 */,
|
||||||
|
TEST_REACHABILITY_PAYLOAD);
|
||||||
|
});
|
||||||
|
if (expectedPacket != null) return expectedPacket;
|
||||||
|
}
|
||||||
|
|
||||||
|
fail("Can't verify " + (is4To6 ? "ipv4 to ipv6" : "ipv4") + " tethering connectivity after "
|
||||||
|
+ TETHER_REACHABILITY_ATTEMPTS + " attempts");
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
|
||||||
|
// TODO: remove triggering upstream reselection once test network can replace selected upstream
|
||||||
|
// network in Tethering module.
|
||||||
|
private void maybeRetryTestedUpstreamChanged(final Network expectedUpstream,
|
||||||
|
final TimeoutException fallbackException) throws Exception {
|
||||||
|
// Fall back original exception because no way to reselect if there is no WIFI feature.
|
||||||
|
assertTrue(fallbackException.toString(), mPackageManager.hasSystemFeature(FEATURE_WIFI));
|
||||||
|
|
||||||
|
// Try to toggle wifi network, if any, to reselect upstream network via default network
|
||||||
|
// switching. Because test network has higher priority than internet network, this can
|
||||||
|
// help selecting test network to be upstream network for testing. This tries to avoid
|
||||||
|
// the flaky upstream selection under multinetwork environment. Internet and test network
|
||||||
|
// upstream changed event order is not guaranteed. Once tethering selects non-test
|
||||||
|
// upstream {wifi, ..}, test network won't be selected anymore. If too many test cases
|
||||||
|
// trigger the reselection, the total test time may over test suite 1 minmute timeout.
|
||||||
|
// Probably need to disable/restore all internet networks in a common place of test
|
||||||
|
// process. Currently, EthernetTetheringTest is part of CTS test which needs wifi network
|
||||||
|
// connection if device has wifi feature. CtsNetUtils#toggleWifi() checks wifi connection
|
||||||
|
// during the toggling process.
|
||||||
|
// See Tethering#chooseUpstreamType, CtsNetUtils#toggleWifi.
|
||||||
|
// TODO: toggle cellular network if the device has no WIFI feature.
|
||||||
|
Log.d(TAG, "Toggle WIFI to retry upstream selection");
|
||||||
|
mCtsNetUtils.toggleWifi();
|
||||||
|
|
||||||
|
// Wait for expected upstream.
|
||||||
|
final CompletableFuture<Network> future = new CompletableFuture<>();
|
||||||
|
final TetheringEventCallback callback = new TetheringEventCallback() {
|
||||||
|
@Override
|
||||||
|
public void onUpstreamChanged(Network network) {
|
||||||
|
Log.d(TAG, "Got upstream changed: " + network);
|
||||||
|
if (Objects.equals(expectedUpstream, network)) {
|
||||||
|
future.complete(network);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
};
|
||||||
|
try {
|
||||||
|
mTm.registerTetheringEventCallback(mHandler::post, callback);
|
||||||
|
assertEquals("onUpstreamChanged for unexpected network", expectedUpstream,
|
||||||
|
future.get(TIMEOUT_MS, TimeUnit.MILLISECONDS));
|
||||||
|
} catch (TimeoutException e) {
|
||||||
|
throw new AssertionError("Did not receive upstream " + expectedUpstream
|
||||||
|
+ " callback after " + TIMEOUT_MS + "ms");
|
||||||
|
} finally {
|
||||||
|
mTm.unregisterTetheringEventCallback(callback);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
protected TetheringTester initTetheringTester(List<LinkAddress> upstreamAddresses,
|
||||||
|
List<InetAddress> upstreamDnses) throws Exception {
|
||||||
|
assumeFalse(isInterfaceForTetheringAvailable());
|
||||||
|
|
||||||
|
// MyTetheringEventCallback currently only support await first available upstream. Tethering
|
||||||
|
// may select internet network as upstream if test network is not available and not be
|
||||||
|
// preferred yet. Create test upstream network before enable tethering.
|
||||||
|
mUpstreamTracker = createTestUpstream(upstreamAddresses, upstreamDnses);
|
||||||
|
|
||||||
|
mDownstreamIface = createTestInterface();
|
||||||
|
setIncludeTestInterfaces(true);
|
||||||
|
|
||||||
|
// Make sure EtherentTracker use "mDownstreamIface" as server mode interface.
|
||||||
|
assertEquals("TetheredInterfaceCallback for unexpected interface",
|
||||||
|
mDownstreamIface.getInterfaceName(), mTetheredInterfaceRequester.getInterface());
|
||||||
|
|
||||||
|
mTetheringEventCallback = enableEthernetTethering(mDownstreamIface.getInterfaceName(),
|
||||||
|
mUpstreamTracker.getNetwork());
|
||||||
|
|
||||||
|
try {
|
||||||
|
assertEquals("onUpstreamChanged for test network", mUpstreamTracker.getNetwork(),
|
||||||
|
mTetheringEventCallback.awaitUpstreamChanged(
|
||||||
|
true /* throwTimeoutException */));
|
||||||
|
} catch (TimeoutException e) {
|
||||||
|
// Due to race condition inside tethering module, test network may not be selected as
|
||||||
|
// tethering upstream. Force tethering retry upstream if possible. If it is not
|
||||||
|
// possible to retry, fail the test with the original timeout exception.
|
||||||
|
maybeRetryTestedUpstreamChanged(mUpstreamTracker.getNetwork(), e);
|
||||||
|
}
|
||||||
|
|
||||||
|
mDownstreamReader = makePacketReader(mDownstreamIface);
|
||||||
|
mUpstreamReader = makePacketReader(mUpstreamTracker.getTestIface());
|
||||||
|
|
||||||
|
final ConnectivityManager cm = mContext.getSystemService(ConnectivityManager.class);
|
||||||
|
// Currently tethering don't have API to tell when ipv6 tethering is available. Thus, make
|
||||||
|
// sure tethering already have ipv6 connectivity before testing.
|
||||||
|
if (cm.getLinkProperties(mUpstreamTracker.getNetwork()).hasGlobalIpv6Address()) {
|
||||||
|
waitForRouterAdvertisement(mDownstreamReader, mDownstreamIface.getInterfaceName(),
|
||||||
|
WAIT_RA_TIMEOUT_MS);
|
||||||
|
}
|
||||||
|
|
||||||
|
return new TetheringTester(mDownstreamReader, mUpstreamReader);
|
||||||
|
}
|
||||||
|
|
||||||
|
protected <T> List<T> toList(T... array) {
|
||||||
|
return Arrays.asList(array);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user