Add an interface for Flash to clear its data.

ppapi/api/private/ppp_flash_clear_site_data.idl

+/* Copyright (c) 2012 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.
+ */
+
+/**
+ * This file contains the <code>PPP_Flash_ClearSiteData</code> interface.
+ */
+
+label Chrome {
+  M20 = 1.0
+};
+
+/**
+ * This interface allows the browser to request the plugin to clear site data.
+ */
+interface PPP_Flash_ClearSiteData {
+  /**
+   * This function allows the plugin to implement the "Clear site data" feature.
+   *
+   * @arg site String specifying which site to clear the data for. This will
+   * be null to clear data for all sites.
+   *
+   * @arg flags Currently always 0 in Chrome to clear all data. This may be
+   * extended in the future to clear only specific types of data.
+   *
+   * @arg max_age The maximum age in seconds to clear data for. This allows the
+   * plugin to implement "clear past hour" and "clear past data", etc.
+   *
+   * See also the NPP_ClearSiteData function in NPAPI.
+   * https://wiki.mozilla.org/NPAPI:ClearSiteData
+   */
+  void ClearSiteData(str_t site,

[Bernhard Bauer, 2012/04/05 10:01:38]

Should we return an error code here?

[brettw, 2012/04/05 14:47:23]

It seemed like Chrome didn't do anything with this value. Do you think it would
be useful?

[Bernhard Bauer, 2012/04/05 14:49:08]

It might be useful if we have UI to show errors in the Clear Browsing Data
dialog at some point.

[viettrungluu, 2012/04/05 17:22:24]

This function needs to specify where the Flash data to be cleared lives, given
that Flapper has no idea. Moreover, the location is actually under the profile
directory.[*]

[*] Who knows how Flapper handles multi-profile properly right now.

[Bernhard Bauer, 2012/04/05 18:49:37]

I thought all versions of Flash, including Flapper, have been storing their data
in the same location
(http://en.wikipedia.org/wiki/Local_Shared_Object#File_locations )?

+                     uint64_t flags,
+                     uint64_t max_age);
+};
+