blob: e6e3761e1379d2cf3fb8a6ef92032f05e65489bc [file] [log] [blame]
// Copyright 2019 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.
library fuchsia.netemul.sandbox;
using fuchsia.netemul.environment;
using fuchsia.netemul.sync;
/// Every connection to `Sandbox` represents a self-contained
/// context where ManagedEnvironments can be created. The
/// NetworkContext and SyncManager instances offered by it are
/// the same that are exposed to any ManagedEnvironment created
/// by the Sandbox.
/// The lifetime of the created environments (and the context
/// services) is bound to the connection to the Sandbox service.
/// If the channel is closed, all the environments and the
/// components created within them will be terminated.
protocol Sandbox {
/// Creates a new empty environment `root_env` configured by `options`.
CreateEnvironment(request<fuchsia.netemul.environment.ManagedEnvironment> root_env, fuchsia.netemul.environment.EnvironmentOptions options);
/// Gets this sandbox's NetworkContext.
GetNetworkContext(request<> network_context);
/// Gets this sandbox's SyncManager.
GetSyncManager(request<fuchsia.netemul.sync.SyncManager> sync_manager);