sync: SyncableService support for starting sync

chrome/browser/sync/glue/sync_start_util.h

+// Copyright 2013 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.
+//
+// Various utilities for kicking off sync initialization from data types or
+// other services.
+
+#ifndef CHROME_BROWSER_SYNC_GLUE_SYNC_START_UTIL_H_
+#define CHROME_BROWSER_SYNC_GLUE_SYNC_START_UTIL_H_
+
+#include "base/files/file_path.h"
+#include "sync/api/syncable_service.h"
+
+namespace sync_start_util {
+  // Creates a StartSyncFlare that a SyncableService can use to tell
+  // ProfileSyncService it needs sync to start ASAP.  Typically this would be
+  // given to the SyncableService via InjectStartSyncFlare.
+  //
+  // The flare is designed to be Run()able from any thread so that non-
+  // frontend types don't have to deal with posting tasks.
+  //
+  // |profile_path| is used to get a hold of the actual Profile* once the
+  // request to start sync is safely in UI Thread land.
+  syncer::StartSyncFlare GetFlareForSyncableService(
+      const base::FilePath& profile_path);
+};
+
+#endif  // CHROME_BROWSER_SYNC_GLUE_SYNC_START_UTIL_H_