bin/appmgr/realm.h

// Copyright 2016 The Fuchsia 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 GARNET_BIN_APPMGR_REALM_H_
#define GARNET_BIN_APPMGR_REALM_H_

#include <fs/synchronous-vfs.h>
#include <zx/channel.h>

#include <iosfwd>
#include <memory>
#include <string>
#include <unordered_map>

#include <component/cpp/fidl.h>
#include "garnet/bin/appmgr/application_controller_impl.h"
#include "garnet/bin/appmgr/application_environment_controller_impl.h"
#include "garnet/bin/appmgr/application_runner_holder.h"
#include "garnet/bin/appmgr/namespace.h"
#include "garnet/bin/appmgr/realm_hub_holder.h"
#include "lib/fidl/cpp/binding_set.h"
#include "lib/fxl/macros.h"
#include "lib/fxl/memory/ref_ptr.h"
#include "lib/fxl/strings/string_view.h"
#include "lib/svc/cpp/service_provider_bridge.h"

namespace component {

class Realm {
 public:
  Realm(Realm* parent, zx::channel host_directory, fidl::StringPtr label);
  ~Realm();

  Realm* parent() const { return parent_; }
  const std::string& label() const { return label_; }
  const std::string& koid() const { return koid_; }

  const fbl::RefPtr<fs::PseudoDir>& hub_dir() const { return hub_.root_dir(); }

  void CreateNestedJob(
      zx::channel host_directory,
      fidl::InterfaceRequest<ApplicationEnvironment> environment,
      fidl::InterfaceRequest<ApplicationEnvironmentController> controller,
      fidl::StringPtr label);

  void CreateApplication(
      ApplicationLaunchInfo launch_info,
      fidl::InterfaceRequest<ApplicationController> controller);

  // Removes the child realm from this realm and returns the owning
  // reference to the child's controller. The caller of this function typically
  // destroys the controller (and hence the environment) shortly after calling
  // this function.
  std::unique_ptr<ApplicationEnvironmentControllerImpl> ExtractChild(
      Realm* child);

  // Removes the application from this environment and returns the owning
  // reference to the application's controller. The caller of this function
  // typically destroys the controller (and hence the application) shortly after
  // calling this function.
  std::unique_ptr<ApplicationControllerImpl> ExtractApplication(
      ApplicationControllerImpl* controller);

  void AddBinding(fidl::InterfaceRequest<ApplicationEnvironment> environment);

  zx_status_t BindSvc(zx::channel channel);

 private:
  static uint32_t next_numbered_label_;

  ApplicationRunnerHolder* GetOrCreateRunner(const std::string& runner);

  void CreateApplicationWithProcess(
      ApplicationPackagePtr package, ApplicationLaunchInfo launch_info,
      fidl::InterfaceRequest<ApplicationController> controller,
      fxl::RefPtr<Namespace> ns);
  void CreateApplicationFromPackage(
      ApplicationPackagePtr package, ApplicationLaunchInfo launch_info,
      fidl::InterfaceRequest<ApplicationController> controller,
      fxl::RefPtr<Namespace> ns);

  zx::channel OpenRootInfoDir();

  Realm* const parent_;
  LoaderPtr loader_;
  std::string label_;
  std::string koid_;

  zx::job job_;
  zx::job job_for_child_;

  fxl::RefPtr<Namespace> default_namespace_;

  RealmHubHolder hub_;
  fs::SynchronousVfs info_vfs_;

  std::unordered_map<Realm*,
                     std::unique_ptr<ApplicationEnvironmentControllerImpl>>
      children_;

  std::unordered_map<ApplicationControllerImpl*,
                     std::unique_ptr<ApplicationControllerImpl>>
      applications_;

  std::unordered_map<std::string, std::unique_ptr<ApplicationRunnerHolder>>
      runners_;

  zx::channel svc_channel_client_;
  zx::channel svc_channel_server_;

  FXL_DISALLOW_COPY_AND_ASSIGN(Realm);
};

}  // namespace component

#endif  // GARNET_BIN_APPMGR_REALM_H_