1 /* 2 * Copyright (C) 2011 The Android Open Source Project 3 * 4 * 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 7 * 8 * http://www.apache.org/licenses/LICENSE-2.0 9 * 10 * 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 14 * limitations under the License. 15 */ 16 17 package android.net; 18 19 import android.net.DataUsageRequest; 20 import android.net.INetworkStatsSession; 21 import android.net.Network; 22 import android.net.NetworkState; 23 import android.net.NetworkStats; 24 import android.net.NetworkStatsHistory; 25 import android.net.NetworkTemplate; 26 import android.os.IBinder; 27 import android.os.Messenger; 28 import com.android.internal.net.VpnInfo; 29 30 /** {@hide} */ 31 interface INetworkStatsService { 32 33 /** Start a statistics query session. */ 34 @UnsupportedAppUsage openSession()35 INetworkStatsSession openSession(); 36 37 /** Start a statistics query session. If calling package is profile or device owner then it is 38 * granted automatic access if apiLevel is NetworkStatsManager.API_LEVEL_DPC_ALLOWED. If 39 * apiLevel is at least NetworkStatsManager.API_LEVEL_REQUIRES_PACKAGE_USAGE_STATS then 40 * PACKAGE_USAGE_STATS permission is always checked. If PACKAGE_USAGE_STATS is not granted 41 * READ_NETWORK_USAGE_STATS is checked for. 42 */ 43 @UnsupportedAppUsage openSessionForUsageStats(int flags, String callingPackage)44 INetworkStatsSession openSessionForUsageStats(int flags, String callingPackage); 45 46 /** Return data layer snapshot of UID network usage. */ 47 @UnsupportedAppUsage getDataLayerSnapshotForUid(int uid)48 NetworkStats getDataLayerSnapshotForUid(int uid); 49 50 /** Get a detailed snapshot of stats since boot for all UIDs. 51 * 52 * <p>Results will not always be limited to stats on requiredIfaces when specified: stats for 53 * interfaces stacked on the specified interfaces, or for interfaces on which the specified 54 * interfaces are stacked on, will also be included. 55 * @param requiredIfaces Interface names to get data for, or {@link NetworkStats#INTERFACES_ALL}. 56 */ getDetailedUidStats(in String[] requiredIfaces)57 NetworkStats getDetailedUidStats(in String[] requiredIfaces); 58 59 /** Return set of any ifaces associated with mobile networks since boot. */ 60 @UnsupportedAppUsage getMobileIfaces()61 String[] getMobileIfaces(); 62 63 /** Increment data layer count of operations performed for UID and tag. */ incrementOperationCount(int uid, int tag, int operationCount)64 void incrementOperationCount(int uid, int tag, int operationCount); 65 66 /** Force update of ifaces. */ forceUpdateIfaces( in Network[] defaultNetworks, in VpnInfo[] vpnArray, in NetworkState[] networkStates, in String activeIface)67 void forceUpdateIfaces( 68 in Network[] defaultNetworks, 69 in VpnInfo[] vpnArray, 70 in NetworkState[] networkStates, 71 in String activeIface); 72 /** Force update of statistics. */ 73 @UnsupportedAppUsage forceUpdate()74 void forceUpdate(); 75 76 /** Registers a callback on data usage. */ registerUsageCallback(String callingPackage, in DataUsageRequest request, in Messenger messenger, in IBinder binder)77 DataUsageRequest registerUsageCallback(String callingPackage, 78 in DataUsageRequest request, in Messenger messenger, in IBinder binder); 79 80 /** Unregisters a callback on data usage. */ unregisterUsageRequest(in DataUsageRequest request)81 void unregisterUsageRequest(in DataUsageRequest request); 82 83 /** Get the uid stats information since boot */ getUidStats(int uid, int type)84 long getUidStats(int uid, int type); 85 86 /** Get the iface stats information since boot */ getIfaceStats(String iface, int type)87 long getIfaceStats(String iface, int type); 88 89 /** Get the total network stats information since boot */ getTotalStats(int type)90 long getTotalStats(int type); 91 92 } 93