1 /* 2 * Copyright (C) 2009 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.LinkAddress; 20 import android.net.RouteInfo; 21 22 /** 23 * Callback class for receiving events from an INetworkManagementService 24 * 25 * @hide 26 */ 27 interface INetworkManagementEventObserver { 28 /** 29 * Interface configuration status has changed. 30 * 31 * @param iface The interface. 32 * @param up True if the interface has been enabled. 33 */ 34 void interfaceStatusChanged(String iface, boolean up); 35 36 /** 37 * Interface physical-layer link state has changed. For Ethernet, 38 * this method is invoked when the cable is plugged in or unplugged. 39 * 40 * @param iface The interface. 41 * @param up True if the physical link-layer connection signal is valid. 42 */ 43 void interfaceLinkStateChanged(String iface, boolean up); 44 45 /** 46 * An interface has been added to the system 47 * 48 * @param iface The interface. 49 */ 50 void interfaceAdded(String iface); 51 52 /** 53 * An interface has been removed from the system 54 * 55 * @param iface The interface. 56 */ 57 void interfaceRemoved(String iface); 58 59 60 /** 61 * An interface address has been added or updated. 62 * 63 * @param iface The interface. 64 * @param address The address. 65 */ 66 void addressUpdated(String iface, in LinkAddress address); 67 68 /** 69 * An interface address has been removed. 70 * 71 * @param iface The interface. 72 * @param address The address. 73 */ 74 void addressRemoved(String iface, in LinkAddress address); 75 76 /** 77 * A networking quota limit has been reached. The quota might not 78 * be specific to an interface. 79 * 80 * @param limitName The name of the limit that triggered. 81 * @param iface The interface on which the limit was detected. 82 */ 83 void limitReached(String limitName, String iface); 84 85 /** 86 * Interface data activity status is changed. 87 * 88 * @param iface The interface. 89 * @param active True if the interface is actively transmitting data, false if it is idle. 90 * @param tsNanos Elapsed realtime in nanos when the state of the network interface changed. 91 */ 92 void interfaceClassDataActivityChanged(String label, boolean active, long tsNanos); 93 94 /** 95 * Information about available DNS servers has been received. 96 * 97 * @param iface The interface on which the information was received. 98 * @param lifetime The time in seconds for which the DNS servers may be used. 99 * @param servers The IP addresses of the DNS servers. 100 */ 101 void interfaceDnsServerInfo(String iface, long lifetime, in String[] servers); 102 103 /** 104 * A route has been added or updated. 105 */ 106 void routeUpdated(in RouteInfo route); 107 108 /** 109 * A route has been removed. 110 */ 111 void routeRemoved(in RouteInfo route); 112 } 113