15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Instances of NaCl modules spun up within the plugin as a subprocess. 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// This may represent the "main" nacl module, or it may represent helpers 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// that perform various tasks within the plugin, for example, 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// a NaCl module for a compiler could be loaded to translate LLVM bitcode 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// into native code. 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_NACL_SUBPROCESS_H_ 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_NACL_SUBPROCESS_H_ 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <stdarg.h> 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "native_client/src/include/nacl_macros.h" 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "native_client/src/include/portability.h" 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 19ca12bfac764ba476d6cd062bf1dde12cc64c3f40Ben Murdoch#include "ppapi/native_client/src/trusted/plugin/service_runtime.h" 20ca12bfac764ba476d6cd062bf1dde12cc64c3f40Ben Murdoch#include "ppapi/native_client/src/trusted/plugin/srpc_client.h" 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace plugin { 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class Plugin; 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class ServiceRuntime; 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class SrpcParams; 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// A class representing an instance of a NaCl module, loaded by the plugin. 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class NaClSubprocess { 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 321320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci NaClSubprocess(const std::string& description, 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ServiceRuntime* service_runtime, 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SrpcClient* srpc_client) 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) : description_(description), 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) service_runtime_(service_runtime), 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) srpc_client_(srpc_client) { 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) virtual ~NaClSubprocess(); 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ServiceRuntime* service_runtime() const { return service_runtime_.get(); } 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void set_service_runtime(ServiceRuntime* service_runtime) { 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) service_runtime_.reset(service_runtime); 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) } 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The socket used for communicating w/ the NaCl module. 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SrpcClient* srpc_client() const { return srpc_client_.get(); } 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A basic description of the subprocess. 501320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci std::string description() const { return description_; } 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // A detailed description of the subprocess that may contain addresses. 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Only use for debugging, but do not expose this to untrusted webapps. 541320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci std::string detailed_description() const; 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Start up interfaces. 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) bool StartSrpcServices(); 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Invoke an Srpc Method. |out_params| must be allocated and cleaned up 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // outside of this function, but it will be initialized by this function, and 615821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // on success any out-params (if any) will be placed in |out_params|. 625821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Input types must be listed in |input_signature|, with the actual 635821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // arguments passed in as var-args. Returns |true| on success. 641320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci bool InvokeSrpcMethod(const std::string& method_name, 651320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci const std::string& input_signature, 665821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SrpcParams* out_params, 675821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ...); 685821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 695821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Fully shut down the subprocess. 705821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) void Shutdown(); 715821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 725821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 735821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) NACL_DISALLOW_COPY_AND_ASSIGN(NaClSubprocess); 745821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 751320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci bool VInvokeSrpcMethod(const std::string& method_name, 761320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci const std::string& signature, 775821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) SrpcParams* params, 785821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) va_list vl); 795821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 801320f92c476a1ad9d19dba2a48c72b75566198e9Primiano Tucci std::string description_; 815821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 825821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // The service runtime representing the NaCl module instance. 835821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) nacl::scoped_ptr<ServiceRuntime> service_runtime_; 845821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) // Ownership of srpc_client taken from the service runtime. 855821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) nacl::scoped_ptr<SrpcClient> srpc_client_; 865821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 875821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 885821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace plugin 895821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 905821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // NATIVE_CLIENT_SRC_TRUSTED_PLUGIN_NACL_SUBPROCESS_H_ 91