Merge "New systemapi to mark a wifi network as metered." into mm-wireless-dev am: 3d4acbf5fb

am: 5c55babd64

* commit '5c55babd64d0ba3bbed77739587594e22bfa3b52':
  New systemapi to mark a wifi network as metered.

api/system-current.txt

@@ -26682,6 +26682,7 @@ package android.net.wifi {
     method public boolean reconnect();
     method public boolean removeNetwork(int);
     method public boolean saveConfiguration();
+    method public boolean setMetered(int, boolean);
     method public void setTdlsEnabled(java.net.InetAddress, boolean);
     method public void setTdlsEnabledWithMacAddress(java.lang.String, boolean);
     method public boolean setWifiApConfiguration(android.net.wifi.WifiConfiguration);

wifi/java/android/net/wifi/WifiManager.java

@@ -891,6 +891,24 @@ public class WifiManager {
         }
     }
 
+    /**
+     * Sets whether or not the given network is metered from a network policy
+     * point of view. A network should be classified as metered when the user is
+     * sensitive to heavy data usage on that connection due to monetary costs,
+     * data limitations or battery/performance issues. A typical example would
+     * be a wifi connection where the user was being charged for usage.
+     * @param netId the integer that identifies the network configuration
+     * to the supplicant.
+     * @param isMetered True to mark the network as metered.
+     * @return {@code true} if the operation succeeded.
+     * @hide
+     */
+    @SystemApi
+    public boolean setMetered(int netId, boolean isMetered) {
+        // TODO(jjoslin): Implement
+        return false;
+    }
+
     /**
      * Remove the specified network from the list of configured networks.
      * This may result in the asynchronous delivery of state change