• Home
  • History
  • Annotate
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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