cashew: support "usage requests allowed OTA only" policy

src/service.h

Index: src/service.h
diff --git a/src/service.h b/src/service.h
index c1d78576939f7c53163ec055bf6f4bdfa97749d0..d49d0ebfd3dccdca70e612b283db4f691d3e6644 100644
--- a/src/service.h
+++ b/src/service.h
@@ -70,6 +70,9 @@ class Service : public org::chromium::flimflam::Service_proxy,
     // NOTE: for now, should always be kTypeCellular
     virtual Type GetType() const;
 
+    // convert type string to Type enum value
+    static Type TypeFromString(const std::string& type);
+
     // get Device object for this service
     // this can return NULL if we don't yet have Device info
     virtual Device* GetDevice() const;
@@ -77,6 +80,9 @@ class Service : public org::chromium::flimflam::Service_proxy,
     // get data plan info, formatted for D-Bus
     virtual DBusDataPlanList GetDBusDataPlans() const;
 
+    // do we think that we're the default service at this time?
+    virtual bool IsDefaultService() const;
+
     // Flimflam Service D-Bus Proxy methods
 
     // receive incoming PropertyChanged D-Bus signal from Flimflam service
@@ -95,6 +101,18 @@ class Service : public org::chromium::flimflam::Service_proxy,
                                    bool successful,
                                    const Value *parsed_usage_update);
 
+    // Service Manager methods
+
+    // we've received an update from our parent about whether or not we're the
+    // default service
+    virtual void OnDefaultServiceUpdate(bool is_default_service);
+
+    // we've received an update from our parent that Flimflam has come online
+    virtual void OnFlimflamOnline();
+
+    // we've received an update from our parent that Flimflam has gone offline
+    virtual void OnFlimflamOffline();
+
   private:
     // back pointer to our parent ServiceManager
     ServiceManager * const parent_;
@@ -135,12 +153,12 @@ class Service : public org::chromium::flimflam::Service_proxy,
     // carrier policy
     Policy *policy_;
 
+    // do we think that we're the default service?
+    bool is_default_service_;
+
     // convert state string to State enum value
     State StateFromString(const std::string& state) const;
 
-    // convert type string to Type enum value
-    Type TypeFromString(const std::string& type) const;
-
     // we've received updated Device info from Flimflam
     void OnDeviceUpdate(const DBus::Path& device_path);
 
@@ -196,6 +214,34 @@ class Service : public org::chromium::flimflam::Service_proxy,
     // usage API request returned an error result
     void OnCrosUsageErrorResult(const std::string& status);
 
+    // do we think that we're connected at this time?
+    bool IsConnected() const;
+
+    // we've just become connected
+    void OnConnected();
+
+    // we've just become disconnected
+    // NOTE: this means we've entered a state other than kStateReady, not
+    // that we're necessarily in kStateDisconnect
+    void OnDisconnected();
+
+    // are we currently sending periodic usage API requests?
+    bool IsSendingUsageRequests() const;
+
+    // based on our best current knowledge and our policy, should we be
+    // sending periodic usage API requests?
+    bool ShouldSendUsageRequests() const;
+
+    // stop sending periodic usage API requests
+    void StopSendingUsageRequests();
+
+    // start sending periodic usage API requests
+    void StartSendingUsageRequests();
+
+    // something has changed, so reevaluate whether or not we should be sending
+    // periodic usage API requests and adjust our behavior if necessary
+    void ReconsiderSendingUsageRequests();
+
     DISALLOW_COPY_AND_ASSIGN(Service);
 };