Allow PNaCl NMF to set translator optimization options for experimentation.

ppapi/native_client/src/trusted/plugin/manifest.h

 /*
  * 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.
  */
 
 // Manifest interface class.
 
 #ifndef NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_MANIFEST_H_
 #define NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_MANIFEST_H_
 
 #include <map>
 #include <set>
 #include <string>
 
 #include "native_client/src/include/nacl_macros.h"
 #include "native_client/src/include/nacl_string.h"
 #include "third_party/jsoncpp/source/include/json/value.h"
 
 namespace pp {
 class URLUtil_Dev;
 }  // namespace pp
 
 namespace plugin {
 
 class ErrorInfo;
+class PnaclOptions;
 
 class Manifest {
  public:
   Manifest() { }
   virtual ~Manifest() { }
 
   // A convention in the interfaces below regarding permit_extension_url:
   // Some manifests (e.g., the pnacl coordinator manifest) need to access
   // resources from an extension origin distinct from the plugin's origin
   // (e.g., the pnacl coordinator needs to load llc, ld, and some libraries).
   // This out-parameter is true if this manifest lookup confers access to
   // a resource in the extension origin.
 
   // Gets the full program URL for the current sandbox ISA from the
-  // manifest file. Sets |pnacl_translate| to |true| if the program is
-  // requires pnacl translation.
+  // manifest file.  Fills in |pnacl_options| if the program requires
+  // PNaCl translation.
   virtual bool GetProgramURL(nacl::string* full_url,
-                             nacl::string* cache_identity,
-                             ErrorInfo* error_info,
-                             bool* pnacl_translate) const = 0;
+                             PnaclOptions* pnacl_options,
+                             ErrorInfo* error_info) const = 0;
 
   // Resolves a URL relative to the manifest base URL
   virtual bool ResolveURL(const nacl::string& relative_url,
                           nacl::string* full_url,
                           ErrorInfo* error_info) const = 0;
 
   // Gets the file names from the "files" section of the manifest.  No
   // checking that the keys' values are proper ISA dictionaries -- it
   // is assumed that other consistency checks take care of that, and
   // that the keys are appropriate for use with ResolveKey.
   virtual bool GetFileKeys(std::set<nacl::string>* keys) const = 0;
 
   // Resolves a key from the "files" section to a fully resolved URL,
   // i.e., relative URL values are fully expanded relative to the
-  // manifest's URL (via ResolveURL).  |pnacl_translate| tells
-  // the caller whether the resolution requires a pnacl translation step.
+  // manifest's URL (via ResolveURL).  Fills in |pnacl_options| if
+  // the resolved key requires a pnacl translation step to obtain
+  // the final requested resource.
   // If there was an error, details are reported via error_info.
   virtual bool ResolveKey(const nacl::string& key,
                           nacl::string* full_url,
-                          nacl::string* cache_identity,
-                          ErrorInfo* error_info,
-                          bool* pnacl_translate) const = 0;
+                          PnaclOptions* pnacl_options,
+                          ErrorInfo* error_info) const = 0;
 
  protected:
   NACL_DISALLOW_COPY_AND_ASSIGN(Manifest);
 };
 
 
 }  // namespace plugin
 
 #endif  // NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_MANIFEST_H_