blob: 361afa2dd3d59f3edfb9eaf511d94ff893168874 [file] [log] [blame]
// Copyright (c) 2011 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.
#pragma once
#include <string>
#include "build/build_config.h"
#include "content/common/content_export.h"
struct MainFunctionParams;
class ZygoteForkDelegate;
namespace content {
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 that content doesn't know about.
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_POSIX)
// Tells the embedder that the zygote process is starting, and allows it to
// specify a zygote delegate if it wishes.
virtual ZygoteForkDelegate* ZygoteStarting();
// Called every time the zygote process forks.
virtual void ZygoteForked();
#endif // OS_MACOSX
} // namespace content