Add support for the ExperimentalSwReporterEngine field trial.

chrome/browser/safe_browsing/srt_fetcher_win.h

 // Copyright 2015 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef CHROME_BROWSER_SAFE_BROWSING_SRT_FETCHER_WIN_H_
 #define CHROME_BROWSER_SAFE_BROWSING_SRT_FETCHER_WIN_H_
 
 #include <limits.h>
 
+#include <queue>
 #include <string>
 
 #include "base/callback_forward.h"
 #include "base/command_line.h"
 #include "base/memory/ref_counted.h"
 #include "base/version.h"
 
 namespace base {
 class FilePath;
 class TaskRunner;
@@ skipping 21 matching lines @@
 const int kDaysBetweenSuccessfulSwReporterRuns = 7;
 const int kDaysBetweenSwReporterRunsForPendingPrompt = 1;
 
 // To test SRT Fetches.
 const int kSRTFetcherID = 47;
 
 // Parameters used to invoke the sw_reporter component.
 struct SwReporterInvocation {
   base::CommandLine command_line;
 
+  // Experimental versions of the reporter will write metrics to registry keys
+  // ending in |suffix|. Those metrics should be copied to UMA histograms also
+  // ending in |suffix|. For the canonical version, |suffix| will be empty.
+  std::string suffix;
+
+  // The experimental sw_reporter never triggers the prompt, just reports
+  // results through UMA.
+  bool is_experimental;
+
   SwReporterInvocation();
   explicit SwReporterInvocation(const base::FilePath& exe_path);
   explicit SwReporterInvocation(const base::CommandLine& command_line);
 
   bool operator==(const SwReporterInvocation& other) const;
 };
 
 // Tries to run the sw_reporter component, and then schedule the next try. If
 // called multiple times, then multiple sequences of trying to run will happen,
 // yet only one reporter will run per specified period (either
 // |kDaysBetweenSuccessfulSwReporterRuns| or
 // |kDaysBetweenSwReporterRunsForPendingPrompt|) will actually happen.
 // |invocation| is the details of the SwReporter to execute, and |version| is
 // its version. The task runners are provided to allow tests to provide their
 // own.
 void RunSwReporter(const SwReporterInvocation& invocation,
                    const base::Version& version,
                    scoped_refptr<base::TaskRunner> main_thread_task_runner,
                    scoped_refptr<base::TaskRunner> blocking_task_runner);
 
+// Try to run multiple invocations of the sw_reporter component, with different
+// combinations of command line args. Each set of invocations is treated as a
+// normal scheduled launch of the sw_reporter for the purposes of retries, as
+// described in |RunSwReporter|.
+//
+// |invocations| is a list of sw_reporter configurations which will be launched
+// in order. Once one has been executed, the reporter is considered to have
+// "run" - the remainder will also be executed as part of this run, but then
+// the reporter will not be run again for the specified period. If none of the
+// invocations in the queue execute, another queue can be tried by calling this
+// function again.
+//
+// See |RunSwReporter| for the meaning of the remaining parameters.
+void RunSwReporters(const std::queue<SwReporterInvocation>& invocations,
+                    const base::Version& version,
+                    scoped_refptr<base::TaskRunner> main_thread_task_runner,
+                    scoped_refptr<base::TaskRunner> blocking_task_runner);
+
 // Returns true iff Local State is successfully accessed and indicates the most
 // recent Reporter run terminated with an exit code indicating the presence of
 // UwS.
 bool ReporterFoundUws();
 
 // Returns true iff a valid registry key for the SRT Cleaner exists, and that
 // key is nonempty.
 // TODO(tmartino): Consider changing to check whether the user has recently
 // run the cleaner, rather than checking if they've run it at all.
 bool UserHasRunCleaner();
 
 // Test mocks for launching the reporter and showing the prompt
 typedef base::Callback<int(const SwReporterInvocation& invocation)>
     ReporterLauncher;
 typedef base::Callback<void(Browser*, const std::string&)> PromptTrigger;
 void SetReporterLauncherForTesting(const ReporterLauncher& reporter_launcher);
 void SetPromptTriggerForTesting(const PromptTrigger& prompt_trigger);
 
 // Callbacks to let the tests know when the reporter is ready to launch.
 typedef base::Callback<void(void)> LaunchReadyNotifier;
 void SetLaunchReadyNotifierForTesting(const LaunchReadyNotifier& notifier);
 typedef base::Callback<void(void)> ReporterDoneNotifier;
 void SetReporterDoneNotifierForTesting(const ReporterDoneNotifier& notifier);
 
 }  // namespace safe_browsing
 
 #endif  // CHROME_BROWSER_SAFE_BROWSING_SRT_FETCHER_WIN_H_