9462a3c9f0
Application can specify static ipv4 server and client address to setup
tethering and this is one shot configuration. Tethering service would
not save the configuration and the configuration would be reset when
tethering stop or start failure.
When startTethering callback fired, it just mean tethering is requested
successful. Therefore, callers may call startTethering again if
startTethering successful but do not receive following tethering active
notification for a while. Tethering service never actually does anything
synchronously when startTethering is called:
-startProvisioningIfNeeded just posts a message to the handler thread.
-enableTetheringInternal doesn't do anything synchronously, it just
asks the downstreams to get their interfaces ready and waits for
callbacks.
If tethering is already enabled with a different request,
tethering would be disabled and re-enabled.
Bug: 141256482
Test: -build, flash, boot
-atest TetheringTests
-atest CtsTetheringTest
Change-Id: I2b2dd965a673e6f1626738d41b5d443f0f9fbd0e
Merged-In: I0399917e7cefa1547d617e688225544c4fc1a231
(cherry picked from commit 5d6723e24e21154bef3967585a8adc069e007f49)
128 lines
9.2 KiB
Text
128 lines
9.2 KiB
Text
// Signature format: 2.0
|
|
package android.net {
|
|
|
|
public final class TetheredClient implements android.os.Parcelable {
|
|
ctor public TetheredClient(@NonNull android.net.MacAddress, @NonNull java.util.Collection<android.net.TetheredClient.AddressInfo>, int);
|
|
method public int describeContents();
|
|
method @NonNull public java.util.List<android.net.TetheredClient.AddressInfo> getAddresses();
|
|
method @NonNull public android.net.MacAddress getMacAddress();
|
|
method public int getTetheringType();
|
|
method public void writeToParcel(@NonNull android.os.Parcel, int);
|
|
field @NonNull public static final android.os.Parcelable.Creator<android.net.TetheredClient> CREATOR;
|
|
}
|
|
|
|
public static final class TetheredClient.AddressInfo implements android.os.Parcelable {
|
|
method public int describeContents();
|
|
method @NonNull public android.net.LinkAddress getAddress();
|
|
method @Nullable public String getHostname();
|
|
method public void writeToParcel(@NonNull android.os.Parcel, int);
|
|
field @NonNull public static final android.os.Parcelable.Creator<android.net.TetheredClient.AddressInfo> CREATOR;
|
|
}
|
|
|
|
public final class TetheringConstants {
|
|
field public static final String EXTRA_ADD_TETHER_TYPE = "extraAddTetherType";
|
|
field public static final String EXTRA_PROVISION_CALLBACK = "extraProvisionCallback";
|
|
field public static final String EXTRA_REM_TETHER_TYPE = "extraRemTetherType";
|
|
field public static final String EXTRA_RUN_PROVISION = "extraRunProvision";
|
|
field public static final String EXTRA_SET_ALARM = "extraSetAlarm";
|
|
}
|
|
|
|
public class TetheringManager {
|
|
ctor public TetheringManager(@NonNull android.content.Context, @NonNull java.util.function.Supplier<android.os.IBinder>);
|
|
method public int getLastTetherError(@NonNull String);
|
|
method @NonNull public String[] getTetherableBluetoothRegexs();
|
|
method @NonNull public String[] getTetherableIfaces();
|
|
method @NonNull public String[] getTetherableUsbRegexs();
|
|
method @NonNull public String[] getTetherableWifiRegexs();
|
|
method @NonNull public String[] getTetheredIfaces();
|
|
method @NonNull public String[] getTetheringErroredIfaces();
|
|
method public boolean isTetheringSupported();
|
|
method public boolean isTetheringSupported(@NonNull String);
|
|
method @RequiresPermission(android.Manifest.permission.ACCESS_NETWORK_STATE) public void registerTetheringEventCallback(@NonNull java.util.concurrent.Executor, @NonNull android.net.TetheringManager.TetheringEventCallback);
|
|
method @RequiresPermission(anyOf={android.Manifest.permission.TETHER_PRIVILEGED, android.Manifest.permission.WRITE_SETTINGS}) public void requestLatestTetheringEntitlementResult(int, boolean, @NonNull java.util.concurrent.Executor, @NonNull android.net.TetheringManager.OnTetheringEntitlementResultListener);
|
|
method public void requestLatestTetheringEntitlementResult(int, @NonNull android.os.ResultReceiver, boolean);
|
|
method @Deprecated public int setUsbTethering(boolean);
|
|
method @RequiresPermission(anyOf={android.Manifest.permission.TETHER_PRIVILEGED, android.Manifest.permission.WRITE_SETTINGS}) public void startTethering(@NonNull android.net.TetheringManager.TetheringRequest, @NonNull java.util.concurrent.Executor, @NonNull android.net.TetheringManager.StartTetheringCallback);
|
|
method @RequiresPermission(anyOf={android.Manifest.permission.TETHER_PRIVILEGED, android.Manifest.permission.WRITE_SETTINGS}) public void startTethering(int, @NonNull java.util.concurrent.Executor, @NonNull android.net.TetheringManager.StartTetheringCallback);
|
|
method @RequiresPermission(anyOf={android.Manifest.permission.TETHER_PRIVILEGED, android.Manifest.permission.WRITE_SETTINGS}) public void stopAllTethering();
|
|
method @RequiresPermission(anyOf={android.Manifest.permission.TETHER_PRIVILEGED, android.Manifest.permission.WRITE_SETTINGS}) public void stopTethering(int);
|
|
method @Deprecated public int tether(@NonNull String);
|
|
method @RequiresPermission(anyOf={android.Manifest.permission.TETHER_PRIVILEGED, android.Manifest.permission.ACCESS_NETWORK_STATE}) public void unregisterTetheringEventCallback(@NonNull android.net.TetheringManager.TetheringEventCallback);
|
|
method @Deprecated public int untether(@NonNull String);
|
|
field public static final String ACTION_TETHER_STATE_CHANGED = "android.net.conn.TETHER_STATE_CHANGED";
|
|
field public static final String EXTRA_ACTIVE_LOCAL_ONLY = "android.net.extra.ACTIVE_LOCAL_ONLY";
|
|
field public static final String EXTRA_ACTIVE_TETHER = "tetherArray";
|
|
field public static final String EXTRA_AVAILABLE_TETHER = "availableArray";
|
|
field public static final String EXTRA_ERRORED_TETHER = "erroredArray";
|
|
field public static final int TETHERING_BLUETOOTH = 2; // 0x2
|
|
field public static final int TETHERING_ETHERNET = 5; // 0x5
|
|
field public static final int TETHERING_INVALID = -1; // 0xffffffff
|
|
field public static final int TETHERING_NCM = 4; // 0x4
|
|
field public static final int TETHERING_USB = 1; // 0x1
|
|
field public static final int TETHERING_WIFI = 0; // 0x0
|
|
field public static final int TETHERING_WIFI_P2P = 3; // 0x3
|
|
field public static final int TETHER_ERROR_DHCPSERVER_ERROR = 12; // 0xc
|
|
field public static final int TETHER_ERROR_DISABLE_NAT_ERROR = 9; // 0x9
|
|
field public static final int TETHER_ERROR_ENABLE_NAT_ERROR = 8; // 0x8
|
|
field public static final int TETHER_ERROR_ENTITLEMENT_UNKNOWN = 13; // 0xd
|
|
field public static final int TETHER_ERROR_IFACE_CFG_ERROR = 10; // 0xa
|
|
field public static final int TETHER_ERROR_MASTER_ERROR = 5; // 0x5
|
|
field public static final int TETHER_ERROR_NO_ACCESS_TETHERING_PERMISSION = 15; // 0xf
|
|
field public static final int TETHER_ERROR_NO_CHANGE_TETHERING_PERMISSION = 14; // 0xe
|
|
field public static final int TETHER_ERROR_NO_ERROR = 0; // 0x0
|
|
field public static final int TETHER_ERROR_PROVISION_FAILED = 11; // 0xb
|
|
field public static final int TETHER_ERROR_SERVICE_UNAVAIL = 2; // 0x2
|
|
field public static final int TETHER_ERROR_TETHER_IFACE_ERROR = 6; // 0x6
|
|
field public static final int TETHER_ERROR_UNAVAIL_IFACE = 4; // 0x4
|
|
field public static final int TETHER_ERROR_UNKNOWN_IFACE = 1; // 0x1
|
|
field public static final int TETHER_ERROR_UNSUPPORTED = 3; // 0x3
|
|
field public static final int TETHER_ERROR_UNTETHER_IFACE_ERROR = 7; // 0x7
|
|
field public static final int TETHER_HARDWARE_OFFLOAD_FAILED = 2; // 0x2
|
|
field public static final int TETHER_HARDWARE_OFFLOAD_STARTED = 1; // 0x1
|
|
field public static final int TETHER_HARDWARE_OFFLOAD_STOPPED = 0; // 0x0
|
|
}
|
|
|
|
public static interface TetheringManager.OnTetheringEntitlementResultListener {
|
|
method public void onTetheringEntitlementResult(int);
|
|
}
|
|
|
|
public abstract static class TetheringManager.StartTetheringCallback {
|
|
ctor public TetheringManager.StartTetheringCallback();
|
|
method public void onTetheringFailed(int);
|
|
method public void onTetheringStarted();
|
|
}
|
|
|
|
public abstract static class TetheringManager.TetheringEventCallback {
|
|
ctor public TetheringManager.TetheringEventCallback();
|
|
method public void onClientsChanged(@NonNull java.util.Collection<android.net.TetheredClient>);
|
|
method public void onError(@NonNull String, int);
|
|
method public void onOffloadStatusChanged(int);
|
|
method @Deprecated public void onTetherableInterfaceRegexpsChanged(@NonNull android.net.TetheringManager.TetheringInterfaceRegexps);
|
|
method public void onTetherableInterfacesChanged(@NonNull java.util.List<java.lang.String>);
|
|
method public void onTetheredInterfacesChanged(@NonNull java.util.List<java.lang.String>);
|
|
method public void onTetheringSupported(boolean);
|
|
method public void onUpstreamChanged(@Nullable android.net.Network);
|
|
}
|
|
|
|
@Deprecated public static class TetheringManager.TetheringInterfaceRegexps {
|
|
ctor @Deprecated public TetheringManager.TetheringInterfaceRegexps(@NonNull String[], @NonNull String[], @NonNull String[]);
|
|
method @Deprecated @NonNull public java.util.List<java.lang.String> getTetherableBluetoothRegexs();
|
|
method @Deprecated @NonNull public java.util.List<java.lang.String> getTetherableUsbRegexs();
|
|
method @Deprecated @NonNull public java.util.List<java.lang.String> getTetherableWifiRegexs();
|
|
}
|
|
|
|
public static class TetheringManager.TetheringRequest {
|
|
}
|
|
|
|
public static class TetheringManager.TetheringRequest.Builder {
|
|
ctor public TetheringManager.TetheringRequest.Builder(int);
|
|
method @NonNull public android.net.TetheringManager.TetheringRequest build();
|
|
method @Nullable public android.net.LinkAddress getClientStaticIpv4Address();
|
|
method @Nullable public android.net.LinkAddress getLocalIpv4Address();
|
|
method @NonNull @RequiresPermission(android.Manifest.permission.TETHER_PRIVILEGED) public android.net.TetheringManager.TetheringRequest.Builder setExemptFromEntitlementCheck(boolean);
|
|
method @NonNull @RequiresPermission(android.Manifest.permission.TETHER_PRIVILEGED) public android.net.TetheringManager.TetheringRequest.Builder setSilentProvisioning(boolean);
|
|
method @NonNull @RequiresPermission(android.Manifest.permission.TETHER_PRIVILEGED) public android.net.TetheringManager.TetheringRequest.Builder setStaticIpv4Addresses(@NonNull android.net.LinkAddress, @NonNull android.net.LinkAddress);
|
|
}
|
|
|
|
}
|
|
|