ConnectivityService.java revision b8f16340b531809aa08cb73c55ddadd5f94de080
1/*
2 * Copyright (C) 2008 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
17package com.android.server;
18
19import android.app.Notification;
20import android.app.NotificationManager;
21import android.content.ContentResolver;
22import android.content.Context;
23import android.content.Intent;
24import android.content.pm.PackageManager;
25import android.net.ConnectivityManager;
26import android.net.IConnectivityManager;
27import android.net.MobileDataStateTracker;
28import android.net.NetworkInfo;
29import android.net.NetworkStateTracker;
30import android.net.wifi.WifiStateTracker;
31import android.os.Binder;
32import android.os.Handler;
33import android.os.IBinder;
34import android.os.Looper;
35import android.os.Message;
36import android.os.RemoteException;
37import android.os.ServiceManager;
38import android.os.SystemProperties;
39import android.provider.Settings;
40import android.text.TextUtils;
41import android.util.EventLog;
42import android.util.Log;
43
44import com.android.internal.telephony.Phone;
45
46import java.io.FileDescriptor;
47import java.io.PrintWriter;
48import java.util.ArrayList;
49import java.util.List;
50
51/**
52 * @hide
53 */
54public class ConnectivityService extends IConnectivityManager.Stub {
55
56    private static final boolean DBG = true;
57    private static final String TAG = "ConnectivityService";
58
59    // Event log tags (must be in sync with event-log-tags)
60    private static final int EVENTLOG_CONNECTIVITY_STATE_CHANGED = 50020;
61
62    // how long to wait before switching back to a radio's default network
63    private static final int RESTORE_DEFAULT_NETWORK_DELAY = 1 * 60 * 1000;
64    // system property that can override the above value
65    private static final String NETWORK_RESTORE_DELAY_PROP_NAME =
66            "android.telephony.apn-restore";
67
68    /**
69     * Sometimes we want to refer to the individual network state
70     * trackers separately, and sometimes we just want to treat them
71     * abstractly.
72     */
73    private NetworkStateTracker mNetTrackers[];
74
75    /**
76     * A per Net list of the PID's that requested access to the net
77     * used both as a refcount and for per-PID DNS selection
78     */
79    private List mNetRequestersPids[];
80
81    private WifiWatchdogService mWifiWatchdogService;
82
83    // priority order of the nettrackers
84    // (excluding dynamically set mNetworkPreference)
85    // TODO - move mNetworkTypePreference into this
86    private int[] mPriorityList;
87
88    private Context mContext;
89    private int mNetworkPreference;
90    private int mActiveDefaultNetwork = -1;
91
92    private int mNumDnsEntries;
93
94    private boolean mTestMode;
95    private static ConnectivityService sServiceInstance;
96
97    private Handler mHandler;
98
99    // list of DeathRecipients used to make sure features are turned off when
100    // a process dies
101    private List mFeatureUsers;
102
103    private boolean mSystemReady;
104    private ArrayList<Intent> mDeferredBroadcasts;
105
106    private class NetworkAttributes {
107        /**
108         * Class for holding settings read from resources.
109         */
110        public String mName;
111        public int mType;
112        public int mRadio;
113        public int mPriority;
114        public NetworkAttributes(String init) {
115            String fragments[] = init.split(",");
116            mName = fragments[0].toLowerCase();
117            if (fragments[1].toLowerCase().equals("wifi")) {
118                mRadio = ConnectivityManager.TYPE_WIFI;
119            } else {
120                mRadio = ConnectivityManager.TYPE_MOBILE;
121            }
122            if (mName.equals("default")) {
123                mType = mRadio;
124            } else if (mName.equals("mms")) {
125                mType = ConnectivityManager.TYPE_MOBILE_MMS;
126            } else if (mName.equals("supl")) {
127                mType = ConnectivityManager.TYPE_MOBILE_SUPL;
128            } else if (mName.equals("dun")) {
129                mType = ConnectivityManager.TYPE_MOBILE_DUN;
130            } else if (mName.equals("hipri")) {
131                mType = ConnectivityManager.TYPE_MOBILE_HIPRI;
132            }
133            mPriority = Integer.parseInt(fragments[2]);
134        }
135        public boolean isDefault() {
136            return (mType == mRadio);
137        }
138    }
139    NetworkAttributes[] mNetAttributes;
140
141    private class RadioAttributes {
142        public String mName;
143        public int mPriority;
144        public int mSimultaneity;
145        public int mType;
146        public RadioAttributes(String init) {
147            String fragments[] = init.split(",");
148            mName = fragments[0].toLowerCase();
149            mPriority = Integer.parseInt(fragments[1]);
150            mSimultaneity = Integer.parseInt(fragments[2]);
151            if (mName.equals("wifi")) {
152                mType = ConnectivityManager.TYPE_WIFI;
153            } else {
154                mType = ConnectivityManager.TYPE_MOBILE;
155            }
156        }
157    }
158    RadioAttributes[] mRadioAttributes;
159
160    private static class ConnectivityThread extends Thread {
161        private Context mContext;
162
163        private ConnectivityThread(Context context) {
164            super("ConnectivityThread");
165            mContext = context;
166        }
167
168        @Override
169        public void run() {
170            Looper.prepare();
171            synchronized (this) {
172                sServiceInstance = new ConnectivityService(mContext);
173                notifyAll();
174            }
175            Looper.loop();
176        }
177
178        public static ConnectivityService getServiceInstance(Context context) {
179            ConnectivityThread thread = new ConnectivityThread(context);
180            thread.start();
181
182            synchronized (thread) {
183                while (sServiceInstance == null) {
184                    try {
185                        // Wait until sServiceInstance has been initialized.
186                        thread.wait();
187                    } catch (InterruptedException ignore) {
188                        Log.e(TAG,
189                            "Unexpected InterruptedException while waiting"+
190                            " for ConnectivityService thread");
191                    }
192                }
193            }
194
195            return sServiceInstance;
196        }
197    }
198
199    public static ConnectivityService getInstance(Context context) {
200        return ConnectivityThread.getServiceInstance(context);
201    }
202
203    private ConnectivityService(Context context) {
204        if (DBG) Log.v(TAG, "ConnectivityService starting up");
205        mContext = context;
206        mNetTrackers = new NetworkStateTracker[
207                ConnectivityManager.MAX_NETWORK_TYPE+1];
208        mHandler = new MyHandler();
209
210        mNetworkPreference = getPersistedNetworkPreference();
211
212        // Load device network attributes from resources
213        mNetAttributes = new NetworkAttributes[
214                ConnectivityManager.MAX_NETWORK_TYPE+1];
215        mRadioAttributes = new RadioAttributes[
216                ConnectivityManager.MAX_RADIO_TYPE+1];
217        String[] naStrings = context.getResources().getStringArray(
218                com.android.internal.R.array.networkAttributes);
219        // TODO - what if the setting has gaps/unknown types?
220        for (String a : naStrings) {
221            NetworkAttributes n = new NetworkAttributes(a);
222            mNetAttributes[n.mType] = n;
223        }
224        String[] raStrings = context.getResources().getStringArray(
225                com.android.internal.R.array.radioAttributes);
226        for (String a : raStrings) {
227            RadioAttributes r = new RadioAttributes(a);
228            mRadioAttributes[r.mType] = r;
229        }
230
231        // high priority first
232        mPriorityList = new int[naStrings.length];
233        {
234            int priority = 0; //lowest
235            int nextPos = naStrings.length-1;
236            while (nextPos>-1) {
237                for (int i = 0; i < mNetAttributes.length; i++) {
238                    if(mNetAttributes[i].mPriority == priority) {
239                        mPriorityList[nextPos--] = i;
240                    }
241                }
242                priority++;
243            }
244        }
245
246        mNetRequestersPids =
247                new ArrayList[ConnectivityManager.MAX_NETWORK_TYPE+1];
248        for (int i=0; i<=ConnectivityManager.MAX_NETWORK_TYPE; i++) {
249            mNetRequestersPids[i] = new ArrayList();
250        }
251
252        mFeatureUsers = new ArrayList();
253
254        /*
255         * Create the network state trackers for Wi-Fi and mobile
256         * data. Maybe this could be done with a factory class,
257         * but it's not clear that it's worth it, given that
258         * the number of different network types is not going
259         * to change very often.
260         */
261        if (DBG) Log.v(TAG, "Starting Wifi Service.");
262        WifiStateTracker wst = new WifiStateTracker(context, mHandler);
263        WifiService wifiService = new WifiService(context, wst);
264        ServiceManager.addService(Context.WIFI_SERVICE, wifiService);
265        mNetTrackers[ConnectivityManager.TYPE_WIFI] = wst;
266
267        mNetTrackers[ConnectivityManager.TYPE_MOBILE] =
268                new MobileDataStateTracker(context, mHandler,
269                ConnectivityManager.TYPE_MOBILE, Phone.APN_TYPE_DEFAULT,
270                "MOBILE");
271
272        mNetTrackers[ConnectivityManager.TYPE_MOBILE_MMS] =
273                new MobileDataStateTracker(context, mHandler,
274                ConnectivityManager.TYPE_MOBILE_MMS, Phone.APN_TYPE_MMS,
275                "MOBILE_MMS");
276
277        mNetTrackers[ConnectivityManager.TYPE_MOBILE_SUPL] =
278                new MobileDataStateTracker(context, mHandler,
279                ConnectivityManager.TYPE_MOBILE_SUPL, Phone.APN_TYPE_SUPL,
280                "MOBILE_SUPL");
281
282        mNetTrackers[ConnectivityManager.TYPE_MOBILE_DUN] =
283                new MobileDataStateTracker(context, mHandler,
284                ConnectivityManager.TYPE_MOBILE_DUN, Phone.APN_TYPE_DUN,
285                "MOBILE_DUN");
286
287        mNetTrackers[ConnectivityManager.TYPE_MOBILE_HIPRI] =
288                new MobileDataStateTracker(context, mHandler,
289                ConnectivityManager.TYPE_MOBILE_HIPRI, Phone.APN_TYPE_HIPRI,
290                "MOBILE_HIPRI");
291
292        mNumDnsEntries = 0;
293
294        mTestMode = SystemProperties.get("cm.test.mode").equals("true")
295                && SystemProperties.get("ro.build.type").equals("eng");
296
297        for (NetworkStateTracker t : mNetTrackers)
298            t.startMonitoring();
299
300        // Constructing this starts it too
301        mWifiWatchdogService = new WifiWatchdogService(context, wst);
302    }
303
304    /**
305     * Sets the preferred network.
306     * @param preference the new preference
307     */
308    public synchronized void setNetworkPreference(int preference) {
309        enforceChangePermission();
310        if (ConnectivityManager.isNetworkTypeValid(preference) &&
311                mNetAttributes[preference].isDefault()) {
312            if (mNetworkPreference != preference) {
313                persistNetworkPreference(preference);
314                mNetworkPreference = preference;
315                enforcePreference();
316            }
317        }
318    }
319
320    public int getNetworkPreference() {
321        enforceAccessPermission();
322        return mNetworkPreference;
323    }
324
325    private void persistNetworkPreference(int networkPreference) {
326        final ContentResolver cr = mContext.getContentResolver();
327        Settings.Secure.putInt(cr, Settings.Secure.NETWORK_PREFERENCE,
328                networkPreference);
329    }
330
331    private int getPersistedNetworkPreference() {
332        final ContentResolver cr = mContext.getContentResolver();
333
334        final int networkPrefSetting = Settings.Secure
335                .getInt(cr, Settings.Secure.NETWORK_PREFERENCE, -1);
336        if (networkPrefSetting != -1) {
337            return networkPrefSetting;
338        }
339
340        return ConnectivityManager.DEFAULT_NETWORK_PREFERENCE;
341    }
342
343    /**
344     * Make the state of network connectivity conform to the preference settings
345     * In this method, we only tear down a non-preferred network. Establishing
346     * a connection to the preferred network is taken care of when we handle
347     * the disconnect event from the non-preferred network
348     * (see {@link #handleDisconnect(NetworkInfo)}).
349     */
350    private void enforcePreference() {
351        if (mNetTrackers[mNetworkPreference].getNetworkInfo().isConnected())
352            return;
353
354        if (!mNetTrackers[mNetworkPreference].isAvailable())
355            return;
356
357        for (int t=0; t <= ConnectivityManager.MAX_RADIO_TYPE; t++) {
358            if (t != mNetworkPreference &&
359                    mNetTrackers[t].getNetworkInfo().isConnected()) {
360                if (DBG) {
361                    Log.d(TAG, "tearing down " +
362                            mNetTrackers[t].getNetworkInfo() +
363                            " in enforcePreference");
364                }
365                teardown(mNetTrackers[t]);
366            }
367        }
368    }
369
370    private boolean teardown(NetworkStateTracker netTracker) {
371        if (netTracker.teardown()) {
372            netTracker.setTeardownRequested(true);
373            return true;
374        } else {
375            return false;
376        }
377    }
378
379    /**
380     * Return NetworkInfo for the active (i.e., connected) network interface.
381     * It is assumed that at most one network is active at a time. If more
382     * than one is active, it is indeterminate which will be returned.
383     * @return the info for the active network, or {@code null} if none is
384     * active
385     */
386    public NetworkInfo getActiveNetworkInfo() {
387        enforceAccessPermission();
388        for (int type=0; type <= ConnectivityManager.MAX_NETWORK_TYPE; type++) {
389            if (!mNetAttributes[type].isDefault()) {
390                continue;
391            }
392            NetworkStateTracker t = mNetTrackers[type];
393            NetworkInfo info = t.getNetworkInfo();
394            if (info.isConnected()) {
395                if (DBG && type != mActiveDefaultNetwork) Log.e(TAG,
396                        "connected default network is not " +
397                        "mActiveDefaultNetwork!");
398                return info;
399            }
400        }
401        return null;
402    }
403
404    public NetworkInfo getNetworkInfo(int networkType) {
405        enforceAccessPermission();
406        if (ConnectivityManager.isNetworkTypeValid(networkType)) {
407            NetworkStateTracker t = mNetTrackers[networkType];
408            if (t != null)
409                return t.getNetworkInfo();
410        }
411        return null;
412    }
413
414    public NetworkInfo[] getAllNetworkInfo() {
415        enforceAccessPermission();
416        NetworkInfo[] result = new NetworkInfo[mNetTrackers.length];
417        int i = 0;
418        for (NetworkStateTracker t : mNetTrackers) {
419            result[i++] = t.getNetworkInfo();
420        }
421        return result;
422    }
423
424    public boolean setRadios(boolean turnOn) {
425        boolean result = true;
426        enforceChangePermission();
427        for (NetworkStateTracker t : mNetTrackers) {
428            result = t.setRadio(turnOn) && result;
429        }
430        return result;
431    }
432
433    public boolean setRadio(int netType, boolean turnOn) {
434        enforceChangePermission();
435        if (!ConnectivityManager.isNetworkTypeValid(netType)) {
436            return false;
437        }
438        NetworkStateTracker tracker = mNetTrackers[netType];
439        return tracker != null && tracker.setRadio(turnOn);
440    }
441
442    /**
443     * Used to notice when the calling process dies so we can self-expire
444     *
445     * Also used to know if the process has cleaned up after itself when
446     * our auto-expire timer goes off.  The timer has a link to an object.
447     *
448     */
449    private class FeatureUser implements IBinder.DeathRecipient {
450        int mNetworkType;
451        String mFeature;
452        IBinder mBinder;
453        int mPid;
454        int mUid;
455
456        FeatureUser(int type, String feature, IBinder binder) {
457            super();
458            mNetworkType = type;
459            mFeature = feature;
460            mBinder = binder;
461            mPid = getCallingPid();
462            mUid = getCallingUid();
463
464            try {
465                mBinder.linkToDeath(this, 0);
466            } catch (RemoteException e) {
467                binderDied();
468            }
469        }
470
471        void unlinkDeathRecipient() {
472            mBinder.unlinkToDeath(this, 0);
473        }
474
475        public void binderDied() {
476            Log.d(TAG, "ConnectivityService FeatureUser binderDied(" +
477                    mNetworkType + ", " + mFeature + ", " + mBinder);
478            stopUsingNetworkFeature(this, false);
479        }
480
481        public void expire() {
482            Log.d(TAG, "ConnectivityService FeatureUser expire(" +
483                    mNetworkType + ", " + mFeature + ", " + mBinder);
484            stopUsingNetworkFeature(this, false);
485        }
486    }
487
488    // javadoc from interface
489    public int startUsingNetworkFeature(int networkType, String feature,
490            IBinder binder) {
491        if (DBG) {
492            Log.d(TAG, "startUsingNetworkFeature for net " + networkType +
493                    ": " + feature);
494        }
495        enforceChangePermission();
496        if (!ConnectivityManager.isNetworkTypeValid(networkType)) {
497            return Phone.APN_REQUEST_FAILED;
498        }
499
500        FeatureUser f = new FeatureUser(networkType, feature, binder);
501
502        // TODO - move this into the MobileDataStateTracker
503        int usedNetworkType = networkType;
504        if(networkType == ConnectivityManager.TYPE_MOBILE) {
505            if (TextUtils.equals(feature, Phone.FEATURE_ENABLE_MMS)) {
506                usedNetworkType = ConnectivityManager.TYPE_MOBILE_MMS;
507            } else if (TextUtils.equals(feature, Phone.FEATURE_ENABLE_SUPL)) {
508                usedNetworkType = ConnectivityManager.TYPE_MOBILE_SUPL;
509            } else if (TextUtils.equals(feature, Phone.FEATURE_ENABLE_DUN)) {
510                usedNetworkType = ConnectivityManager.TYPE_MOBILE_DUN;
511            } else if (TextUtils.equals(feature, Phone.FEATURE_ENABLE_HIPRI)) {
512                usedNetworkType = ConnectivityManager.TYPE_MOBILE_HIPRI;
513            }
514        }
515        NetworkStateTracker network = mNetTrackers[usedNetworkType];
516        if (network != null) {
517            if (usedNetworkType != networkType) {
518                Integer currentPid = new Integer(getCallingPid());
519
520                NetworkStateTracker radio = mNetTrackers[networkType];
521                NetworkInfo ni = network.getNetworkInfo();
522
523                if (ni.isAvailable() == false) {
524                    if (DBG) Log.d(TAG, "special network not available");
525                    return Phone.APN_TYPE_NOT_AVAILABLE;
526                }
527
528                synchronized(this) {
529                    mFeatureUsers.add(f);
530                    if (!mNetRequestersPids[usedNetworkType].contains(currentPid)) {
531                        // this gets used for per-pid dns when connected
532                        mNetRequestersPids[usedNetworkType].add(currentPid);
533                    }
534                }
535                mHandler.sendMessageDelayed(mHandler.obtainMessage(
536                        NetworkStateTracker.EVENT_RESTORE_DEFAULT_NETWORK,
537                        f), getRestoreDefaultNetworkDelay());
538
539
540                if ((ni.isConnectedOrConnecting() == true) &&
541                        !network.isTeardownRequested()) {
542                    if (ni.isConnected() == true) {
543                        // add the pid-specific dns
544                        handleDnsConfigurationChange();
545                        if (DBG) Log.d(TAG, "special network already active");
546                        return Phone.APN_ALREADY_ACTIVE;
547                    }
548                    if (DBG) Log.d(TAG, "special network already connecting");
549                    return Phone.APN_REQUEST_STARTED;
550                }
551
552                // check if the radio in play can make another contact
553                // assume if cannot for now
554
555                if (DBG) Log.d(TAG, "reconnecting to special network");
556                network.reconnect();
557                return Phone.APN_REQUEST_STARTED;
558            } else {
559                synchronized(this) {
560                    mFeatureUsers.add(f);
561                }
562                mHandler.sendMessageDelayed(mHandler.obtainMessage(
563                        NetworkStateTracker.EVENT_RESTORE_DEFAULT_NETWORK,
564                        f), getRestoreDefaultNetworkDelay());
565
566                return network.startUsingNetworkFeature(feature,
567                        getCallingPid(), getCallingUid());
568            }
569        }
570        return Phone.APN_TYPE_NOT_AVAILABLE;
571    }
572
573    // javadoc from interface
574    public int stopUsingNetworkFeature(int networkType, String feature) {
575        enforceChangePermission();
576
577        int pid = getCallingPid();
578        int uid = getCallingUid();
579
580        FeatureUser u = null;
581        boolean found = false;
582
583        synchronized(this) {
584            for (int i = 0; i < mFeatureUsers.size() ; i++) {
585                u = (FeatureUser)mFeatureUsers.get(i);
586                if (uid == u.mUid && pid == u.mPid &&
587                        networkType == u.mNetworkType &&
588                        TextUtils.equals(feature, u.mFeature)) {
589                    found = true;
590                    break;
591                }
592            }
593        }
594        if (found && u != null) {
595            // stop regardless of how many other time this proc had called start
596            return stopUsingNetworkFeature(u, true);
597        } else {
598            // none found!
599            return 1;
600        }
601    }
602
603    private int stopUsingNetworkFeature(FeatureUser u, boolean ignoreDups) {
604        int networkType = u.mNetworkType;
605        String feature = u.mFeature;
606        int pid = u.mPid;
607        int uid = u.mUid;
608
609        NetworkStateTracker tracker = null;
610        boolean callTeardown = false;  // used to carry our decision outside of sync block
611
612        if (DBG) {
613            Log.d(TAG, "stopUsingNetworkFeature for net " + networkType +
614                    ": " + feature);
615        }
616
617        if (!ConnectivityManager.isNetworkTypeValid(networkType)) {
618            return -1;
619        }
620
621        // need to link the mFeatureUsers list with the mNetRequestersPids state in this
622        // sync block
623        synchronized(this) {
624            // check if this process still has an outstanding start request
625            if (!mFeatureUsers.contains(u)) {
626                return 1;
627            }
628            u.unlinkDeathRecipient();
629            mFeatureUsers.remove(mFeatureUsers.indexOf(u));
630            // If we care about duplicate requests, check for that here.
631            //
632            // This is done to support the extension of a request - the app
633            // can request we start the network feature again and renew the
634            // auto-shutoff delay.  Normal "stop" calls from the app though
635            // do not pay attention to duplicate requests - in effect the
636            // API does not refcount and a single stop will counter multiple starts.
637            if (ignoreDups == false) {
638                for (int i = 0; i < mFeatureUsers.size() ; i++) {
639                    FeatureUser x = (FeatureUser)mFeatureUsers.get(i);
640                    if (x.mUid == u.mUid && x.mPid == u.mPid &&
641                            x.mNetworkType == u.mNetworkType &&
642                            TextUtils.equals(x.mFeature, u.mFeature)) {
643                        return 1;
644                    }
645                }
646            }
647
648            // TODO - move to MobileDataStateTracker
649            int usedNetworkType = networkType;
650            if (networkType == ConnectivityManager.TYPE_MOBILE) {
651                if (TextUtils.equals(feature, Phone.FEATURE_ENABLE_MMS)) {
652                    usedNetworkType = ConnectivityManager.TYPE_MOBILE_MMS;
653                } else if (TextUtils.equals(feature, Phone.FEATURE_ENABLE_SUPL)) {
654                    usedNetworkType = ConnectivityManager.TYPE_MOBILE_SUPL;
655                } else if (TextUtils.equals(feature, Phone.FEATURE_ENABLE_DUN)) {
656                    usedNetworkType = ConnectivityManager.TYPE_MOBILE_DUN;
657                } else if (TextUtils.equals(feature, Phone.FEATURE_ENABLE_HIPRI)) {
658                    usedNetworkType = ConnectivityManager.TYPE_MOBILE_HIPRI;
659                }
660            }
661            tracker =  mNetTrackers[usedNetworkType];
662            if(usedNetworkType != networkType) {
663                Integer currentPid = new Integer(pid);
664                reassessPidDns(pid, true);
665                mNetRequestersPids[usedNetworkType].remove(currentPid);
666                if (mNetRequestersPids[usedNetworkType].size() != 0) {
667                    if (DBG) Log.d(TAG, "not tearing down special network - " +
668                           "others still using it");
669                    return 1;
670                }
671                callTeardown = true;
672            }
673        }
674
675        if (callTeardown) {
676            tracker.teardown();
677            return 1;
678        } else {
679            // do it the old fashioned way
680            return tracker.stopUsingNetworkFeature(feature, pid, uid);
681        }
682    }
683
684    /**
685     * Ensure that a network route exists to deliver traffic to the specified
686     * host via the specified network interface.
687     * @param networkType the type of the network over which traffic to the
688     * specified host is to be routed
689     * @param hostAddress the IP address of the host to which the route is
690     * desired
691     * @return {@code true} on success, {@code false} on failure
692     */
693    public boolean requestRouteToHost(int networkType, int hostAddress) {
694        enforceChangePermission();
695        if (!ConnectivityManager.isNetworkTypeValid(networkType)) {
696            return false;
697        }
698        NetworkStateTracker tracker = mNetTrackers[networkType];
699
700        if (!tracker.getNetworkInfo().isConnected() || tracker.isTeardownRequested()) {
701            if (DBG) {
702                Log.d(TAG, "requestRouteToHost on down network (" + networkType + " - dropped");
703            }
704            return false;
705        }
706        return tracker.requestRouteToHost(hostAddress);
707    }
708
709    /**
710     * @see ConnectivityManager#getBackgroundDataSetting()
711     */
712    public boolean getBackgroundDataSetting() {
713        return Settings.Secure.getInt(mContext.getContentResolver(),
714                Settings.Secure.BACKGROUND_DATA, 1) == 1;
715    }
716
717    /**
718     * @see ConnectivityManager#setBackgroundDataSetting(boolean)
719     */
720    public void setBackgroundDataSetting(boolean allowBackgroundDataUsage) {
721        mContext.enforceCallingOrSelfPermission(
722                android.Manifest.permission.CHANGE_BACKGROUND_DATA_SETTING,
723                "ConnectivityService");
724
725        if (getBackgroundDataSetting() == allowBackgroundDataUsage) return;
726
727        Settings.Secure.putInt(mContext.getContentResolver(),
728                Settings.Secure.BACKGROUND_DATA,
729                allowBackgroundDataUsage ? 1 : 0);
730
731        Intent broadcast = new Intent(
732                ConnectivityManager.ACTION_BACKGROUND_DATA_SETTING_CHANGED);
733        mContext.sendBroadcast(broadcast);
734    }
735
736    private int getNumConnectedNetworks() {
737        int numConnectedNets = 0;
738
739        for (NetworkStateTracker nt : mNetTrackers) {
740            if (nt.getNetworkInfo().isConnected() &&
741                    !nt.isTeardownRequested()) {
742                ++numConnectedNets;
743            }
744        }
745        return numConnectedNets;
746    }
747
748    private void enforceAccessPermission() {
749        mContext.enforceCallingOrSelfPermission(
750                android.Manifest.permission.ACCESS_NETWORK_STATE,
751                "ConnectivityService");
752    }
753
754    private void enforceChangePermission() {
755        mContext.enforceCallingOrSelfPermission(
756                android.Manifest.permission.CHANGE_NETWORK_STATE,
757                "ConnectivityService");
758    }
759
760    /**
761     * Handle a {@code DISCONNECTED} event. If this pertains to the non-active
762     * network, we ignore it. If it is for the active network, we send out a
763     * broadcast. But first, we check whether it might be possible to connect
764     * to a different network.
765     * @param info the {@code NetworkInfo} for the network
766     */
767    private void handleDisconnect(NetworkInfo info) {
768
769        int prevNetType = info.getType();
770
771        mNetTrackers[prevNetType].setTeardownRequested(false);
772        /*
773         * If the disconnected network is not the active one, then don't report
774         * this as a loss of connectivity. What probably happened is that we're
775         * getting the disconnect for a network that we explicitly disabled
776         * in accordance with network preference policies.
777         */
778        if (!mNetAttributes[prevNetType].isDefault()) {
779            List pids = mNetRequestersPids[prevNetType];
780            for (int i = 0; i<pids.size(); i++) {
781                Integer pid = (Integer)pids.get(i);
782                // will remove them because the net's no longer connected
783                // need to do this now as only now do we know the pids and
784                // can properly null things that are no longer referenced.
785                reassessPidDns(pid.intValue(), false);
786            }
787        }
788
789        Intent intent = new Intent(ConnectivityManager.CONNECTIVITY_ACTION);
790        intent.putExtra(ConnectivityManager.EXTRA_NETWORK_INFO, info);
791        if (info.isFailover()) {
792            intent.putExtra(ConnectivityManager.EXTRA_IS_FAILOVER, true);
793            info.setFailover(false);
794        }
795        if (info.getReason() != null) {
796            intent.putExtra(ConnectivityManager.EXTRA_REASON, info.getReason());
797        }
798        if (info.getExtraInfo() != null) {
799            intent.putExtra(ConnectivityManager.EXTRA_EXTRA_INFO,
800                    info.getExtraInfo());
801        }
802
803        /*
804         * If this is a default network, check if other defaults are available
805         * or active
806         */
807        NetworkStateTracker newNet = null;
808        if (mNetAttributes[prevNetType].isDefault()) {
809            if (mActiveDefaultNetwork == prevNetType) {
810                mActiveDefaultNetwork = -1;
811            }
812
813            int newType = -1;
814            int newPriority = -1;
815            for (int checkType=0; checkType <=
816                    ConnectivityManager.MAX_NETWORK_TYPE; checkType++) {
817                if (checkType == prevNetType) {
818                    continue;
819                }
820                if (mNetAttributes[checkType].isDefault()) {
821                    /* TODO - if we have multiple nets we could use
822                     * we may want to put more thought into which we choose
823                     */
824                    if (checkType == mNetworkPreference) {
825                        newType = checkType;
826                        break;
827                    }
828                    if (mRadioAttributes[mNetAttributes[checkType].mRadio].
829                            mPriority > newPriority) {
830                        newType = checkType;
831                        newPriority = mRadioAttributes[mNetAttributes[newType].
832                                mRadio].mPriority;
833                    }
834                }
835            }
836
837            if (newType != -1) {
838                newNet = mNetTrackers[newType];
839                /**
840                 * See if the other network is available to fail over to.
841                 * If is not available, we enable it anyway, so that it
842                 * will be able to connect when it does become available,
843                 * but we report a total loss of connectivity rather than
844                 * report that we are attempting to fail over.
845                 */
846                if (newNet.isAvailable()) {
847                    NetworkInfo switchTo = newNet.getNetworkInfo();
848                    switchTo.setFailover(true);
849                    if (!switchTo.isConnectedOrConnecting() ||
850                            newNet.isTeardownRequested()) {
851                        newNet.reconnect();
852                    }
853                    if (DBG) {
854                        if (switchTo.isConnected()) {
855                            Log.v(TAG, "Switching to already connected " +
856                                    switchTo.getTypeName());
857                        } else {
858                            Log.v(TAG, "Attempting to switch to " +
859                                    switchTo.getTypeName());
860                        }
861                    }
862                    intent.putExtra(ConnectivityManager.
863                            EXTRA_OTHER_NETWORK_INFO, switchTo);
864                } else {
865                    intent.putExtra(ConnectivityManager.EXTRA_NO_CONNECTIVITY,
866                            true);
867                    newNet.reconnect();
868                }
869            } else {
870                intent.putExtra(ConnectivityManager.EXTRA_NO_CONNECTIVITY,
871                        true);
872            }
873        }
874
875        // do this before we broadcast the change
876        handleConnectivityChange();
877
878        sendStickyBroadcast(intent);
879        /*
880         * If the failover network is already connected, then immediately send
881         * out a followup broadcast indicating successful failover
882         */
883        if (newNet != null && newNet.getNetworkInfo().isConnected())
884            sendConnectedBroadcast(newNet.getNetworkInfo());
885    }
886
887    private void sendConnectedBroadcast(NetworkInfo info) {
888        Intent intent = new Intent(ConnectivityManager.CONNECTIVITY_ACTION);
889        intent.putExtra(ConnectivityManager.EXTRA_NETWORK_INFO, info);
890        if (info.isFailover()) {
891            intent.putExtra(ConnectivityManager.EXTRA_IS_FAILOVER, true);
892            info.setFailover(false);
893        }
894        if (info.getReason() != null) {
895            intent.putExtra(ConnectivityManager.EXTRA_REASON, info.getReason());
896        }
897        if (info.getExtraInfo() != null) {
898            intent.putExtra(ConnectivityManager.EXTRA_EXTRA_INFO,
899                    info.getExtraInfo());
900        }
901        sendStickyBroadcast(intent);
902    }
903
904    /**
905     * Called when an attempt to fail over to another network has failed.
906     * @param info the {@link NetworkInfo} for the failed network
907     */
908    private void handleConnectionFailure(NetworkInfo info) {
909        mNetTrackers[info.getType()].setTeardownRequested(false);
910
911        String reason = info.getReason();
912        String extraInfo = info.getExtraInfo();
913
914        if (DBG) {
915            String reasonText;
916            if (reason == null) {
917                reasonText = ".";
918            } else {
919                reasonText = " (" + reason + ").";
920            }
921            Log.v(TAG, "Attempt to connect to " + info.getTypeName() +
922                    " failed" + reasonText);
923        }
924
925        Intent intent = new Intent(ConnectivityManager.CONNECTIVITY_ACTION);
926        intent.putExtra(ConnectivityManager.EXTRA_NETWORK_INFO, info);
927        if (getActiveNetworkInfo() == null) {
928            intent.putExtra(ConnectivityManager.EXTRA_NO_CONNECTIVITY, true);
929        }
930        if (reason != null) {
931            intent.putExtra(ConnectivityManager.EXTRA_REASON, reason);
932        }
933        if (extraInfo != null) {
934            intent.putExtra(ConnectivityManager.EXTRA_EXTRA_INFO, extraInfo);
935        }
936        if (info.isFailover()) {
937            intent.putExtra(ConnectivityManager.EXTRA_IS_FAILOVER, true);
938            info.setFailover(false);
939        }
940        sendStickyBroadcast(intent);
941    }
942
943    private void sendStickyBroadcast(Intent intent) {
944        synchronized(this) {
945            if (mSystemReady) {
946                mContext.sendStickyBroadcast(intent);
947            } else {
948                if (mDeferredBroadcasts == null) {
949                    mDeferredBroadcasts = new ArrayList<Intent>();
950                }
951                mDeferredBroadcasts.add(intent);
952            }
953        }
954    }
955
956    void systemReady() {
957        synchronized(this) {
958            mSystemReady = true;
959            if (mDeferredBroadcasts != null) {
960                int count = mDeferredBroadcasts.size();
961                for (int i = 0; i < count; i++) {
962                    mContext.sendStickyBroadcast(mDeferredBroadcasts.get(i));
963                }
964                mDeferredBroadcasts = null;
965            }
966        }
967    }
968
969    private void handleConnect(NetworkInfo info) {
970        int type = info.getType();
971
972        // snapshot isFailover, because sendConnectedBroadcast() resets it
973        boolean isFailover = info.isFailover();
974        NetworkStateTracker thisNet = mNetTrackers[type];
975
976        // if this is a default net and other default is running
977        // kill the one not preferred
978        if (mNetAttributes[type].isDefault()) {
979            if (mActiveDefaultNetwork != -1 && mActiveDefaultNetwork != type) {
980                if ((type != mNetworkPreference &&
981                        mNetAttributes[mActiveDefaultNetwork].mPriority >
982                        mNetAttributes[type].mPriority) ||
983                        mNetworkPreference == mActiveDefaultNetwork) {
984                        // don't accept this one
985                        if (DBG) Log.v(TAG, "Not broadcasting CONNECT_ACTION " +
986                                "to torn down network " + info.getTypeName());
987                        teardown(thisNet);
988                        return;
989                } else {
990                    // tear down the other
991                    NetworkStateTracker otherNet =
992                            mNetTrackers[mActiveDefaultNetwork];
993                    if (DBG) Log.v(TAG, "Policy requires " +
994                            otherNet.getNetworkInfo().getTypeName() +
995                            " teardown");
996                    if (!teardown(otherNet)) {
997                        Log.e(TAG, "Network declined teardown request");
998                        return;
999                    }
1000                    if (isFailover) {
1001                        otherNet.releaseWakeLock();
1002                    }
1003                }
1004            }
1005            mActiveDefaultNetwork = type;
1006        }
1007        thisNet.setTeardownRequested(false);
1008        thisNet.updateNetworkSettings();
1009        handleConnectivityChange();
1010        sendConnectedBroadcast(info);
1011    }
1012
1013    private void handleScanResultsAvailable(NetworkInfo info) {
1014        int networkType = info.getType();
1015        if (networkType != ConnectivityManager.TYPE_WIFI) {
1016            if (DBG) Log.v(TAG, "Got ScanResultsAvailable for " +
1017                    info.getTypeName() + " network. Don't know how to handle.");
1018        }
1019
1020        mNetTrackers[networkType].interpretScanResultsAvailable();
1021    }
1022
1023    private void handleNotificationChange(boolean visible, int id,
1024            Notification notification) {
1025        NotificationManager notificationManager = (NotificationManager) mContext
1026                .getSystemService(Context.NOTIFICATION_SERVICE);
1027
1028        if (visible) {
1029            notificationManager.notify(id, notification);
1030        } else {
1031            notificationManager.cancel(id);
1032        }
1033    }
1034
1035    /**
1036     * After any kind of change in the connectivity state of any network,
1037     * make sure that anything that depends on the connectivity state of
1038     * more than one network is set up correctly. We're mainly concerned
1039     * with making sure that the list of DNS servers is set up  according
1040     * to which networks are connected, and ensuring that the right routing
1041     * table entries exist.
1042     */
1043    private void handleConnectivityChange() {
1044        /*
1045         * If a non-default network is enabled, add the host routes that
1046         * will allow it's DNS servers to be accessed.  Only
1047         * If both mobile and wifi are enabled, add the host routes that
1048         * will allow MMS traffic to pass on the mobile network. But
1049         * remove the default route for the mobile network, so that there
1050         * will be only one default route, to ensure that all traffic
1051         * except MMS will travel via Wi-Fi.
1052         */
1053        handleDnsConfigurationChange();
1054
1055        for (int netType : mPriorityList) {
1056            if (mNetTrackers[netType].getNetworkInfo().isConnected()) {
1057                if (mNetAttributes[netType].isDefault()) {
1058                    mNetTrackers[netType].addDefaultRoute();
1059                } else {
1060                    mNetTrackers[netType].addPrivateDnsRoutes();
1061                }
1062            } else {
1063                if (mNetAttributes[netType].isDefault()) {
1064                    mNetTrackers[netType].removeDefaultRoute();
1065                } else {
1066                    mNetTrackers[netType].removePrivateDnsRoutes();
1067                }
1068            }
1069        }
1070    }
1071
1072    /**
1073     * Adjust the per-process dns entries (net.dns<x>.<pid>) based
1074     * on the highest priority active net which this process requested.
1075     * If there aren't any, clear it out
1076     */
1077    private void reassessPidDns(int myPid, boolean doBump)
1078    {
1079        if (DBG) Log.d(TAG, "reassessPidDns for pid " + myPid);
1080        for(int i : mPriorityList) {
1081            if (mNetAttributes[i].isDefault()) {
1082                continue;
1083            }
1084            NetworkStateTracker nt = mNetTrackers[i];
1085            if (nt.getNetworkInfo().isConnected() &&
1086                    !nt.isTeardownRequested()) {
1087                List pids = mNetRequestersPids[i];
1088                for (int j=0; j<pids.size(); j++) {
1089                    Integer pid = (Integer)pids.get(j);
1090                    if (pid.intValue() == myPid) {
1091                        String[] dnsList = nt.getNameServers();
1092                        writePidDns(dnsList, myPid);
1093                        if (doBump) {
1094                            bumpDns();
1095                        }
1096                        return;
1097                    }
1098                }
1099           }
1100        }
1101        // nothing found - delete
1102        for (int i = 1; ; i++) {
1103            String prop = "net.dns" + i + "." + myPid;
1104            if (SystemProperties.get(prop).length() == 0) {
1105                if (doBump) {
1106                    bumpDns();
1107                }
1108                return;
1109            }
1110            SystemProperties.set(prop, "");
1111        }
1112    }
1113
1114    private void writePidDns(String[] dnsList, int pid) {
1115        int j = 1;
1116        for (String dns : dnsList) {
1117            if (dns != null && !TextUtils.equals(dns, "0.0.0.0")) {
1118                SystemProperties.set("net.dns" + j++ + "." + pid, dns);
1119            }
1120        }
1121    }
1122
1123    private void bumpDns() {
1124        /*
1125         * Bump the property that tells the name resolver library to reread
1126         * the DNS server list from the properties.
1127         */
1128        String propVal = SystemProperties.get("net.dnschange");
1129        int n = 0;
1130        if (propVal.length() != 0) {
1131            try {
1132                n = Integer.parseInt(propVal);
1133            } catch (NumberFormatException e) {}
1134        }
1135        SystemProperties.set("net.dnschange", "" + (n+1));
1136    }
1137
1138    private void handleDnsConfigurationChange() {
1139        // add default net's dns entries
1140        for (int x = mPriorityList.length-1; x>= 0; x--) {
1141            int netType = mPriorityList[x];
1142            NetworkStateTracker nt = mNetTrackers[netType];
1143            if (nt != null && nt.getNetworkInfo().isConnected() &&
1144                    !nt.isTeardownRequested()) {
1145                String[] dnsList = nt.getNameServers();
1146                if (mNetAttributes[netType].isDefault()) {
1147                    int j = 1;
1148                    for (String dns : dnsList) {
1149                        if (dns != null && !TextUtils.equals(dns, "0.0.0.0")) {
1150                            if (DBG) {
1151                                Log.d(TAG, "adding dns " + dns + " for " +
1152                                        nt.getNetworkInfo().getTypeName());
1153                            }
1154                            SystemProperties.set("net.dns" + j++, dns);
1155                        }
1156                    }
1157                    for (int k=j ; k<mNumDnsEntries; k++) {
1158                        if (DBG) Log.d(TAG, "erasing net.dns" + k);
1159                        SystemProperties.set("net.dns" + k, "");
1160                    }
1161                    mNumDnsEntries = j;
1162                } else {
1163                    // set per-pid dns for attached secondary nets
1164                    List pids = mNetRequestersPids[netType];
1165                    for (int y=0; y< pids.size(); y++) {
1166                        Integer pid = (Integer)pids.get(y);
1167                        writePidDns(dnsList, pid.intValue());
1168                    }
1169                }
1170            }
1171        }
1172
1173        bumpDns();
1174    }
1175
1176    private int getRestoreDefaultNetworkDelay() {
1177        String restoreDefaultNetworkDelayStr = SystemProperties.get(
1178                NETWORK_RESTORE_DELAY_PROP_NAME);
1179        if(restoreDefaultNetworkDelayStr != null &&
1180                restoreDefaultNetworkDelayStr.length() != 0) {
1181            try {
1182                return Integer.valueOf(restoreDefaultNetworkDelayStr);
1183            } catch (NumberFormatException e) {
1184            }
1185        }
1186        return RESTORE_DEFAULT_NETWORK_DELAY;
1187    }
1188
1189    @Override
1190    protected void dump(FileDescriptor fd, PrintWriter pw, String[] args) {
1191        if (mContext.checkCallingOrSelfPermission(
1192                android.Manifest.permission.DUMP)
1193                != PackageManager.PERMISSION_GRANTED) {
1194            pw.println("Permission Denial: can't dump ConnectivityService " +
1195                    "from from pid=" + Binder.getCallingPid() + ", uid=" +
1196                    Binder.getCallingUid());
1197            return;
1198        }
1199        pw.println();
1200        for (NetworkStateTracker nst : mNetTrackers) {
1201            if (nst.getNetworkInfo().isConnected()) {
1202                pw.println("Active network: " + nst.getNetworkInfo().
1203                        getTypeName());
1204            }
1205            pw.println(nst.getNetworkInfo());
1206            pw.println(nst);
1207            pw.println();
1208        }
1209    }
1210
1211    // must be stateless - things change under us.
1212    private class MyHandler extends Handler {
1213        @Override
1214        public void handleMessage(Message msg) {
1215            NetworkInfo info;
1216            switch (msg.what) {
1217                case NetworkStateTracker.EVENT_STATE_CHANGED:
1218                    info = (NetworkInfo) msg.obj;
1219                    if (DBG) Log.d(TAG, "ConnectivityChange for " +
1220                            info.getTypeName() + ": " +
1221                            info.getState() + "/" + info.getDetailedState());
1222
1223                    // Connectivity state changed:
1224                    // [31-13] Reserved for future use
1225                    // [12-9] Network subtype (for mobile network, as defined
1226                    //         by TelephonyManager)
1227                    // [8-3] Detailed state ordinal (as defined by
1228                    //         NetworkInfo.DetailedState)
1229                    // [2-0] Network type (as defined by ConnectivityManager)
1230                    int eventLogParam = (info.getType() & 0x7) |
1231                            ((info.getDetailedState().ordinal() & 0x3f) << 3) |
1232                            (info.getSubtype() << 9);
1233                    EventLog.writeEvent(EVENTLOG_CONNECTIVITY_STATE_CHANGED,
1234                            eventLogParam);
1235
1236                    if (info.getDetailedState() ==
1237                            NetworkInfo.DetailedState.FAILED) {
1238                        handleConnectionFailure(info);
1239                    } else if (info.getState() ==
1240                            NetworkInfo.State.DISCONNECTED) {
1241                        handleDisconnect(info);
1242                    } else if (info.getState() == NetworkInfo.State.SUSPENDED) {
1243                        // TODO: need to think this over.
1244                        // the logic here is, handle SUSPENDED the same as
1245                        // DISCONNECTED. The only difference being we are
1246                        // broadcasting an intent with NetworkInfo that's
1247                        // suspended. This allows the applications an
1248                        // opportunity to handle DISCONNECTED and SUSPENDED
1249                        // differently, or not.
1250                        handleDisconnect(info);
1251                    } else if (info.getState() == NetworkInfo.State.CONNECTED) {
1252                        handleConnect(info);
1253                    }
1254                    break;
1255
1256                case NetworkStateTracker.EVENT_SCAN_RESULTS_AVAILABLE:
1257                    info = (NetworkInfo) msg.obj;
1258                    handleScanResultsAvailable(info);
1259                    break;
1260
1261                case NetworkStateTracker.EVENT_NOTIFICATION_CHANGED:
1262                    handleNotificationChange(msg.arg1 == 1, msg.arg2,
1263                            (Notification) msg.obj);
1264
1265                case NetworkStateTracker.EVENT_CONFIGURATION_CHANGED:
1266                    handleDnsConfigurationChange();
1267                    break;
1268
1269                case NetworkStateTracker.EVENT_ROAMING_CHANGED:
1270                    // fill me in
1271                    break;
1272
1273                case NetworkStateTracker.EVENT_NETWORK_SUBTYPE_CHANGED:
1274                    // fill me in
1275                    break;
1276                case NetworkStateTracker.EVENT_RESTORE_DEFAULT_NETWORK:
1277                    FeatureUser u = (FeatureUser)msg.obj;
1278                    u.expire();
1279                    break;
1280            }
1281        }
1282    }
1283}
1284