NetworkUtils.java revision 0900f3657664d9046e6723825fd32b244eef2b6c
19066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/* 29066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Copyright (C) 2008 The Android Open Source Project 39066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 49066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Licensed under the Apache License, Version 2.0 (the "License"); 59066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * you may not use this file except in compliance with the License. 69066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * You may obtain a copy of the License at 79066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 89066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * http://www.apache.org/licenses/LICENSE-2.0 99066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Unless required by applicable law or agreed to in writing, software 119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * distributed under the License is distributed on an "AS IS" BASIS, 129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * See the License for the specific language governing permissions and 149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * limitations under the License. 159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpackage android.net; 189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.net.InetAddress; 209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectimport java.net.UnknownHostException; 219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project/** 239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Native methods for managing network interfaces. 249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * 259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * {@hide} 269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Projectpublic class NetworkUtils { 280900f3657664d9046e6723825fd32b244eef2b6cMike Lockwood /** Bring the named network interface up. */ 290900f3657664d9046e6723825fd32b244eef2b6cMike Lockwood public native static int enableInterface(String interfaceName); 300900f3657664d9046e6723825fd32b244eef2b6cMike Lockwood 319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Bring the named network interface down. */ 329066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static int disableInterface(String interfaceName); 339066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 349066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Add a route to the specified host via the named interface. */ 359066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static int addHostRoute(String interfaceName, int hostaddr); 369066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 379066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Add a default route for the named interface. */ 389066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static int setDefaultRoute(String interfaceName, int gwayAddr); 399066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 409066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Return the gateway address for the default route for the named interface. */ 419066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static int getDefaultRoute(String interfaceName); 429066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 439066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Remove host routes that uses the named interface. */ 449066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static int removeHostRoutes(String interfaceName); 459066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 469066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Remove the default route for the named interface. */ 479066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static int removeDefaultRoute(String interfaceName); 489066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 499066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** Reset any sockets that are connected via the named interface. */ 509066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static int resetConnections(String interfaceName); 519066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 529066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 539066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Start the DHCP client daemon, in order to have it request addresses 549066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * for the named interface, and then configure the interface with those 559066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * addresses. This call blocks until it obtains a result (either success 569066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * or failure) from the daemon. 579066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param interfaceName the name of the interface to configure 589066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ipInfo if the request succeeds, this object is filled in with 599066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * the IP address information. 609066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} for success, {@code false} for failure 619066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 629066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static boolean runDhcp(String interfaceName, DhcpInfo ipInfo); 639066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 649066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 659066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Shut down the DHCP client daemon. 669066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param interfaceName the name of the interface for which the daemon 679066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * should be stopped 689066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} for success, {@code false} for failure 699066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 709066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static boolean stopDhcp(String interfaceName); 719066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 729066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 739066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Release the current DHCP lease. 749066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param interfaceName the name of the interface for which the lease should 759066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * be released 769066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} for success, {@code false} for failure 779066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 789066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static boolean releaseDhcpLease(String interfaceName); 799066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 809066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 819066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Return the last DHCP-related error message that was recorded. 829066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * <p/>NOTE: This string is not localized, but currently it is only 839066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * used in logging. 849066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the most recent error message, if any 859066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 869066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public native static String getDhcpError(); 879066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 889066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 899066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * When static IP configuration has been specified, configure the network 909066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * interface according to the values supplied. 919066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param interfaceName the name of the interface to configure 929066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param ipInfo the IP address, default gateway, and DNS server addresses 939066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * with which to configure the interface. 949066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return {@code true} for success, {@code false} for failure 959066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 969066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static boolean configureInterface(String interfaceName, DhcpInfo ipInfo) { 979066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return configureNative(interfaceName, 989066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ipInfo.ipAddress, 999066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ipInfo.netmask, 1009066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ipInfo.gateway, 1019066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ipInfo.dns1, 1029066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project ipInfo.dns2); 1039066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1049066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1059066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project private native static boolean configureNative( 1069066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project String interfaceName, int ipAddress, int netmask, int gateway, int dns1, int dns2); 1079066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project 1089066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project /** 1099066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * Look up a host name and return the result as an int. Works if the argument 1109066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * is an IP address in dot notation. Obviously, this can only be used for IPv4 1119066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * addresses. 1129066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @param hostname the name of the host (or the IP address) 1139066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project * @return the IP address as an {@code int} in network byte order 1149066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project */ 1159066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project public static int lookupHost(String hostname) { 1169066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project InetAddress inetAddress; 1179066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project try { 1189066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project inetAddress = InetAddress.getByName(hostname); 1199066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } catch (UnknownHostException e) { 1209066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return -1; 1219066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1229066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project byte[] addrBytes; 1239066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project int addr; 1249066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project addrBytes = inetAddress.getAddress(); 1259066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project addr = ((addrBytes[3] & 0xff) << 24) 1269066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | ((addrBytes[2] & 0xff) << 16) 1279066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | ((addrBytes[1] & 0xff) << 8) 1289066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project | (addrBytes[0] & 0xff); 1299066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project return addr; 1309066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project } 1319066cfe9886ac131c34d59ed0e2d287b0e3c0087The Android Open Source Project} 132