blob: bb8f612c6723b69eb46e20db6c5049f64b59545b [file] [log] [blame]
// Copyright 2014 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.
#ifndef SERVICES_SERVICE_MANAGER_RUNNER_HOST_SERVICE_PROCESS_LAUNCHER_H_
#define SERVICES_SERVICE_MANAGER_RUNNER_HOST_SERVICE_PROCESS_LAUNCHER_H_
#include <memory>
#include <string>
#include "base/callback.h"
#include "base/files/file_path.h"
#include "base/macros.h"
#include "base/memory/weak_ptr.h"
#include "base/optional.h"
#include "base/process/process.h"
#include "base/synchronization/waitable_event.h"
#include "mojo/public/cpp/platform/platform_channel.h"
#include "mojo/public/cpp/system/invitation.h"
#include "services/service_manager/public/mojom/service_factory.mojom.h"
#include "services/service_manager/runner/host/service_process_launcher_delegate.h"
#include "services/service_manager/sandbox/sandbox_type.h"
namespace base {
class CommandLine;
}
namespace service_manager {
class Identity;
// This class represents a "child process host". Handles launching and
// connecting a platform-specific "pipe" to the child, and supports joining the
// child process. Currently runs a single service, loaded from a standalone
// service executable on the file system.
//
// This class is not thread-safe. It should be created/used/destroyed on a
// single thread.
//
// Note: Does not currently work on Windows before Vista.
class ServiceProcessLauncher {
public:
using ProcessReadyCallback = base::OnceCallback<void(base::ProcessId)>;
// |name| is just for debugging ease. We will spawn off a process so that it
// can be sandboxed if |start_sandboxed| is true. |service_path| is a path to
// the service executable we wish to start.
ServiceProcessLauncher(ServiceProcessLauncherDelegate* delegate,
const base::FilePath& service_path);
~ServiceProcessLauncher();
// |Start()|s the child process; calls |DidStart()| (on the thread on which
// |Start()| was called) when the child has been started (or failed to start).
mojom::ServicePtr Start(const Identity& target,
SandboxType sandbox_type,
ProcessReadyCallback callback);
// Waits for the child process to terminate.
void Join();
private:
void DidStart(ProcessReadyCallback callback);
void DoLaunch(std::unique_ptr<base::CommandLine> child_command_line);
ServiceProcessLauncherDelegate* delegate_ = nullptr;
SandboxType sandbox_type_ = SANDBOX_TYPE_NO_SANDBOX;
Identity target_;
base::FilePath service_path_;
base::Process child_process_;
// Used to initialize the Mojo IPC channel between parent and child.
base::Optional<mojo::PlatformChannel> channel_;
mojo::PlatformChannel::HandlePassingInfo handle_passing_info_;
mojo::OutgoingInvitation invitation_;
// Since Start() calls a method on another thread, we use an event to block
// the main thread if it tries to destruct |this| while launching the process.
base::WaitableEvent start_child_process_event_;
base::WeakPtrFactory<ServiceProcessLauncher> weak_factory_;
DISALLOW_COPY_AND_ASSIGN(ServiceProcessLauncher);
};
} // namespace service_manager
#endif // SERVICES_SERVICE_MANAGER_RUNNER_HOST_SERVICE_PROCESS_LAUNCHER_H_