blob: a53d40b4efde2606bef0da9dba1d965d639927e6 [file] [log] [blame]
// 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.
#include <memory>
#include <string>
#include <vector>
#include "base/callback_forward.h"
#include "build/build_config.h"
#include "content/common/content_export.h"
#include "services/service_manager/embedder/process_type.h"
namespace base {
class CommandLine;
namespace service_manager {
class BackgroundServiceManager;
class Identity;
} // namespace service_manager
namespace content {
class ContentBrowserClient;
class ContentGpuClient;
class ContentRendererClient;
class ContentUtilityClient;
class ZygoteForkDelegate;
struct MainFunctionParams;
class CONTENT_EXPORT ContentMainDelegate {
virtual ~ContentMainDelegate() {}
// Tells the embedder that the absolute basic startup has been done, i.e.
// it's now safe to create singletons and check the command line. Return true
// if the process should exit afterwards, and if so, |exit_code| should be
// set. This is the place for embedder to do the things that must happen at
// the start. Most of its startup code should be in the methods below.
virtual bool BasicStartupComplete(int* exit_code);
// This is where the embedder puts all of its startup code that needs to run
// before the sandbox is engaged.
virtual void PreSandboxStartup() {}
// This is where the embedder can add startup code to run after the sandbox
// has been initialized.
virtual void SandboxInitialized(const std::string& process_type) {}
// Asks the embedder to start a process. Return -1 for the default behavior.
virtual int RunProcess(
const std::string& process_type,
const MainFunctionParams& main_function_params);
// Called right before the process exits.
virtual void ProcessExiting(const std::string& process_type) {}
#if defined(OS_MACOSX)
// Returns true if the process registers with the system monitor, so that we
// can allocate an IO port for it before the sandbox is initialized. Embedders
// are called only for process types that content doesn't know about.
virtual bool ProcessRegistersWithSystemProcess(
const std::string& process_type);
// Used to determine if we should send the mach port to the parent process or
// not. The embedder usually sends it for all child processes, use this to
// override this behavior.
virtual bool ShouldSendMachPort(const std::string& process_type);
// Allows the embedder to override initializing the sandbox. This is needed
// because some processes might not want to enable it right away or might not
// want it at all.
virtual bool DelaySandboxInitialization(const std::string& process_type);
#elif defined(OS_LINUX)
// Tells the embedder that the zygote process is starting, and allows it to
// specify one or more zygote delegates if it wishes by storing them in
// |*delegates|.
virtual void ZygoteStarting(
std::vector<std::unique_ptr<ZygoteForkDelegate>>* delegates);
// Called every time the zygote process forks.
virtual void ZygoteForked() {}
#endif // defined(OS_LINUX)
// TODO(vadimt, yiyaoliu): Remove this function once is
// fixed.
// Returns whether or not profiler recording should be enabled.
virtual bool ShouldEnableProfilerRecording();
// Fatal errors during initialization are reported by this function, so that
// the embedder can implement graceful exit by displaying some message and
// returning initialization error code. Default behavior is CHECK(false).
virtual int TerminateForFatalInitializationError();
// Overrides the Service Manager process type to use for the currently running
// process.
virtual service_manager::ProcessType OverrideProcessType();
// Allows the content embedder to adjust arbitrary command line arguments for
// any service process started by the Service Manager.
virtual void AdjustServiceProcessCommandLine(
const service_manager::Identity& identity,
base::CommandLine* command_line);
// Allows the embedder to perform arbitrary initialization within the Service
// Manager process immediately before the Service Manager runs its main loop.
// |quit_closure| is a callback the embedder may retain and invoke at any time
// to cleanly terminate Service Manager execution.
virtual void OnServiceManagerInitialized(
const base::Closure& quit_closure,
service_manager::BackgroundServiceManager* service_manager);
friend class ContentClientInitializer;
// Called once per relevant process type to allow the embedder to customize
// content. If an embedder wants the default (empty) implementation, don't
// override this.
virtual ContentBrowserClient* CreateContentBrowserClient();
virtual ContentGpuClient* CreateContentGpuClient();
virtual ContentRendererClient* CreateContentRendererClient();
virtual ContentUtilityClient* CreateContentUtilityClient();
} // namespace content