blob: ce95b60dd2db6cf3e55a0400394187a8bf4ec2b6 [file] [log] [blame]
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08001/**
2 * Copyright (c) 2008, The Android Open Source Project
3 *
Danica Chang6fdd0c62010-08-11 14:54:43 -07004 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08007 *
Danica Chang6fdd0c62010-08-11 14:54:43 -07008 * http://www.apache.org/licenses/LICENSE-2.0
The Android Open Source Project9066cfe2009-03-03 19:31:44 -08009 *
Danica Chang6fdd0c62010-08-11 14:54:43 -070010 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080014 * limitations under the License.
15 */
16
17package android.net;
18
Robert Greenwalt9258c642014-03-26 16:47:06 -070019import android.app.PendingIntent;
Robert Greenwaltd192dad2010-09-14 09:18:02 -070020import android.net.LinkProperties;
Robert Greenwalt9258c642014-03-26 16:47:06 -070021import android.net.Network;
Robert Greenwalt7b816022014-04-18 15:25:25 -070022import android.net.NetworkCapabilities;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080023import android.net.NetworkInfo;
Sreeram Ramachandran8cd33ed2014-07-23 15:23:15 -070024import android.net.NetworkMisc;
Jeff Sharkeyf0ceede2011-08-02 17:22:34 -070025import android.net.NetworkQuotaInfo;
Robert Greenwalt9258c642014-03-26 16:47:06 -070026import android.net.NetworkRequest;
Jeff Sharkeyd2a45872011-05-28 20:56:34 -070027import android.net.NetworkState;
Jason Monk207900c2014-04-25 15:00:09 -040028import android.net.ProxyInfo;
Robert Greenwalt42acef32009-08-12 16:08:25 -070029import android.os.IBinder;
Robert Greenwalt665e1ae2012-08-21 19:27:00 -070030import android.os.Messenger;
Chia-chi Yehff3bdca2011-05-23 17:26:46 -070031import android.os.ParcelFileDescriptor;
Wink Savilleab9321d2013-06-29 21:10:57 -070032import android.os.ResultReceiver;
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080033
Chia-chi Yeh2e467642011-07-04 03:23:12 -070034import com.android.internal.net.LegacyVpnInfo;
Chia-chi Yeh04ba25c2011-06-15 17:07:27 -070035import com.android.internal.net.VpnConfig;
Wenchao Tongf5ea3402015-03-04 13:26:38 -080036import com.android.internal.net.VpnInfo;
Jeff Sharkey82f85212012-08-24 11:17:25 -070037import com.android.internal.net.VpnProfile;
Chia-chi Yeh04ba25c2011-06-15 17:07:27 -070038
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080039/**
40 * Interface that answers queries about, and allows changing, the
41 * state of network connectivity.
42 */
43/** {@hide} */
44interface IConnectivityManager
45{
Paul Jensen31a94f42015-02-13 14:18:39 -050046 Network getActiveNetwork();
Jeff Sharkey1b6519b2016-04-28 15:33:18 -060047 Network getActiveNetworkForUid(int uid, boolean ignoreBlocked);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080048 NetworkInfo getActiveNetworkInfo();
Jeff Sharkey1b6519b2016-04-28 15:33:18 -060049 NetworkInfo getActiveNetworkInfoForUid(int uid, boolean ignoreBlocked);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080050 NetworkInfo getNetworkInfo(int networkType);
Jeff Sharkey1b6519b2016-04-28 15:33:18 -060051 NetworkInfo getNetworkInfoForUid(in Network network, int uid, boolean ignoreBlocked);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080052 NetworkInfo[] getAllNetworkInfo();
Lorenzo Colittib57edc52014-08-22 17:10:50 -070053 Network getNetworkForType(int networkType);
Robert Greenwalt73b6cbae2014-06-23 11:40:00 -070054 Network[] getAllNetworks();
Lorenzo Colitti403aa262014-11-28 11:21:30 +090055 NetworkCapabilities[] getDefaultNetworkCapabilitiesForUser(int userId);
The Android Open Source Project9066cfe2009-03-03 19:31:44 -080056
Robert Greenwalt9b2886e2011-08-31 11:46:42 -070057 boolean isNetworkSupported(int networkType);
58
Robert Greenwaltd192dad2010-09-14 09:18:02 -070059 LinkProperties getActiveLinkProperties();
Robert Greenwalt9258c642014-03-26 16:47:06 -070060 LinkProperties getLinkPropertiesForType(int networkType);
61 LinkProperties getLinkProperties(in Network network);
62
63 NetworkCapabilities getNetworkCapabilities(in Network network);
Robert Greenwaltd192dad2010-09-14 09:18:02 -070064
Jeff Sharkeyd2a45872011-05-28 20:56:34 -070065 NetworkState[] getAllNetworkState();
66
Jeff Sharkeyf0ceede2011-08-02 17:22:34 -070067 NetworkQuotaInfo getActiveNetworkQuotaInfo();
Jeff Sharkey9f7cbf02012-04-12 18:34:54 -070068 boolean isActiveNetworkMetered();
Jeff Sharkeyf0ceede2011-08-02 17:22:34 -070069
Sreeram Ramachandran03666c72014-07-19 23:21:46 -070070 boolean requestRouteToHostAddress(int networkType, in byte[] hostAddress);
Robert Greenwalt585ac0f2010-08-27 09:24:29 -070071
Tetsutoki Shiozawa335d2ed2016-03-16 23:30:57 +090072 int tether(String iface, String callerPkg);
Robert Greenwaltd0e18ff2010-01-26 11:40:34 -080073
Tetsutoki Shiozawa335d2ed2016-03-16 23:30:57 +090074 int untether(String iface, String callerPkg);
Robert Greenwalt5a735062010-03-02 17:25:02 -080075
76 int getLastTetherError(String iface);
Robert Greenwaltd0e18ff2010-01-26 11:40:34 -080077
Udam Saini0e94c362017-06-07 12:06:28 -070078 boolean isTetheringSupported(String callerPkg);
Robert Greenwalt2a091d72010-02-11 18:18:40 -080079
Tetsutoki Shiozawa335d2ed2016-03-16 23:30:57 +090080 void startTethering(int type, in ResultReceiver receiver, boolean showProvisioningUi,
81 String callerPkg);
Jeremy Klein36c7aa02016-01-22 14:11:45 -080082
Tetsutoki Shiozawa335d2ed2016-03-16 23:30:57 +090083 void stopTethering(int type, String callerPkg);
Jeremy Klein36c7aa02016-01-22 14:11:45 -080084
Robert Greenwaltd0e18ff2010-01-26 11:40:34 -080085 String[] getTetherableIfaces();
86
87 String[] getTetheredIfaces();
Robert Greenwalt2a091d72010-02-11 18:18:40 -080088
Robert Greenwalt5a735062010-03-02 17:25:02 -080089 String[] getTetheringErroredIfaces();
90
Robert Greenwalt9c7e2c22014-06-23 14:53:42 -070091 String[] getTetheredDhcpRanges();
92
Robert Greenwalt2a091d72010-02-11 18:18:40 -080093 String[] getTetherableUsbRegexs();
94
95 String[] getTetherableWifiRegexs();
Robert Greenwalt14f2ef42010-06-15 12:19:37 -070096
Danica Chang6fdd0c62010-08-11 14:54:43 -070097 String[] getTetherableBluetoothRegexs();
98
Tetsutoki Shiozawa335d2ed2016-03-16 23:30:57 +090099 int setUsbTethering(boolean enable, String callerPkg);
Mike Lockwood6c2260b2011-07-19 13:04:47 -0700100
Robert Greenwaltd7085fc2010-09-08 15:24:47 -0700101 void reportInetCondition(int networkType, int percentage);
Robert Greenwalt434203a2010-10-11 16:00:27 -0700102
Paul Jensenbfd17b72015-04-07 12:43:13 -0400103 void reportNetworkConnectivity(in Network network, boolean hasConnectivity);
Robert Greenwalt9258c642014-03-26 16:47:06 -0700104
Jason Monk207900c2014-04-25 15:00:09 -0400105 ProxyInfo getGlobalProxy();
Robert Greenwalt434203a2010-10-11 16:00:27 -0700106
Jason Monk207900c2014-04-25 15:00:09 -0400107 void setGlobalProxy(in ProxyInfo p);
Robert Greenwalt434203a2010-10-11 16:00:27 -0700108
Paul Jensencee9b512015-05-06 07:32:40 -0400109 ProxyInfo getProxyForNetwork(in Network nework);
Robert Greenwaltd55a6b42011-03-25 13:09:25 -0700110
Robin Lee3b3dd942015-05-12 18:14:58 +0100111 boolean prepareVpn(String oldPackage, String newPackage, int userId);
Chia-chi Yehff3bdca2011-05-23 17:26:46 -0700112
Robin Lee3b3dd942015-05-12 18:14:58 +0100113 void setVpnPackageAuthorization(String packageName, int userId, boolean authorized);
Jeff Davidson05542602014-08-11 14:07:27 -0700114
Chia-chi Yeh04ba25c2011-06-15 17:07:27 -0700115 ParcelFileDescriptor establishVpn(in VpnConfig config);
Chia-chi Yeh77fd4852011-07-02 17:15:00 -0700116
Robin Lee3b3dd942015-05-12 18:14:58 +0100117 VpnConfig getVpnConfig(int userId);
Chad Brubakerbf6ff2c2013-07-16 18:59:12 -0700118
Jeff Sharkey82f85212012-08-24 11:17:25 -0700119 void startLegacyVpn(in VpnProfile profile);
Chia-chi Yeh2e467642011-07-04 03:23:12 -0700120
Robin Lee3eed5ec2015-07-07 12:28:13 -0700121 LegacyVpnInfo getLegacyVpnInfo(int userId);
Jeff Sharkey69ddab42012-08-25 00:05:46 -0700122
Wenchao Tongf5ea3402015-03-04 13:26:38 -0800123 VpnInfo[] getAllVpnInfo();
124
Jeff Sharkey69ddab42012-08-25 00:05:46 -0700125 boolean updateLockdownVpn();
Charles He36738632017-05-15 17:07:18 +0100126 boolean isAlwaysOnVpnPackageSupported(int userId, String packageName);
Robin Leedc679712016-05-03 13:23:03 +0100127 boolean setAlwaysOnVpnPackage(int userId, String packageName, boolean lockdown);
Robin Lee244ce8e2016-01-05 18:03:46 +0000128 String getAlwaysOnVpnPackage(int userId);
Irfan Sheriffda6da092012-08-16 12:49:23 -0700129
Wink Saville948282b2013-08-29 08:55:16 -0700130 int checkMobileProvisioning(int suggestedTimeOutMs);
Robert Greenwalte182bfe2013-07-16 12:06:09 -0700131
132 String getMobileProvisioningUrl();
Wink Saville42d4f082013-07-20 20:31:59 -0700133
Paul Jensen89e0f092014-09-15 15:59:36 -0400134 void setProvisioningNotificationVisible(boolean visible, int networkType, in String action);
Yuhao Zheng5cd1a0e2013-09-09 17:00:04 -0700135
136 void setAirplaneMode(boolean enable);
Robert Greenwalte049c232014-04-11 15:53:27 -0700137
Robert Greenwalta67be032014-05-16 15:49:14 -0700138 void registerNetworkFactory(in Messenger messenger, in String name);
139
fengludb571472015-04-21 17:12:05 -0700140 boolean requestBandwidthUpdate(in Network network);
fenglub15e72b2015-03-20 11:29:56 -0700141
Robert Greenwalta67be032014-05-16 15:49:14 -0700142 void unregisterNetworkFactory(in Messenger messenger);
Robert Greenwalt7b816022014-04-18 15:25:25 -0700143
Paul Jensen31a94f42015-02-13 14:18:39 -0500144 int registerNetworkAgent(in Messenger messenger, in NetworkInfo ni, in LinkProperties lp,
Sreeram Ramachandran8cd33ed2014-07-23 15:23:15 -0700145 in NetworkCapabilities nc, int score, in NetworkMisc misc);
Robert Greenwalt9258c642014-03-26 16:47:06 -0700146
147 NetworkRequest requestNetwork(in NetworkCapabilities networkCapabilities,
Robert Greenwaltb90b20b2014-06-02 15:32:02 -0700148 in Messenger messenger, int timeoutSec, in IBinder binder, int legacy);
Robert Greenwalt9258c642014-03-26 16:47:06 -0700149
150 NetworkRequest pendingRequestForNetwork(in NetworkCapabilities networkCapabilities,
151 in PendingIntent operation);
152
Jeremy Joslin46e3ac82014-11-05 10:32:09 -0800153 void releasePendingNetworkRequest(in PendingIntent operation);
154
Robert Greenwalt9258c642014-03-26 16:47:06 -0700155 NetworkRequest listenForNetwork(in NetworkCapabilities networkCapabilities,
156 in Messenger messenger, in IBinder binder);
157
158 void pendingListenForNetwork(in NetworkCapabilities networkCapabilities,
159 in PendingIntent operation);
160
161 void releaseNetworkRequest(in NetworkRequest networkRequest);
Robert Greenwalt71bf33a2014-05-15 18:07:26 -0700162
Lorenzo Colittie03c3c72015-04-03 16:38:52 +0900163 void setAcceptUnvalidated(in Network network, boolean accept, boolean always);
Lorenzo Colitti165c51c2016-09-19 01:00:19 +0900164 void setAvoidUnvalidated(in Network network);
Lorenzo Colitti4734cdb2017-04-27 14:30:21 +0900165 void startCaptivePortalApp(in Network network);
Lorenzo Colittie03c3c72015-04-03 16:38:52 +0900166
Lorenzo Colitti46aa9c02017-01-24 18:08:41 +0900167 int getMultipathPreference(in Network Network);
168
Robert Greenwalt71bf33a2014-05-15 18:07:26 -0700169 int getRestoreDefaultNetworkDelay(int networkType);
Sreeram Ramachandranf4e0c0c2014-07-27 14:18:26 -0700170
171 boolean addVpnAddress(String address, int prefixLength);
172 boolean removeVpnAddress(String address, int prefixLength);
Sreeram Ramachandranc2c0bea2014-11-11 16:09:21 -0800173 boolean setUnderlyingNetworksForVpn(in Network[] networks);
Stuart Scottf1fb3972015-04-02 18:00:02 -0700174
175 void factoryReset();
Lorenzo Colitti8bf977d2015-06-15 14:29:22 +0900176
177 void startNattKeepalive(in Network network, int intervalSeconds, in Messenger messenger,
178 in IBinder binder, String srcAddr, int srcPort, String dstAddr);
179
180 void stopKeepalive(in Network network, int slot);
Udam Sainib7c24872016-01-04 12:16:14 -0800181
182 String getCaptivePortalServerUrl();
Ricky Wai44dcbde2018-01-23 04:09:45 +0000183
184 byte[] getNetworkWatchlistConfigHash();
The Android Open Source Project9066cfe2009-03-03 19:31:44 -0800185}