// Copyright 2020 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.fs;

using fuchsia.io;

/// Administration functionality for filesystems.
@discoverable
protocol Admin {
    /// Shuts down the filesystem. Once the filesystem recieves the shutdown request, it will
    /// complete any active requests before terminating, but will not respond to new requests. This
    /// call blocks until all open connections to the filesystem are terminated and any underlying
    /// block devices or other owned channels are released, then it responds to this request and
    /// closes this channel.
    Shutdown() -> ();

    /// Opens the given handle to the root directory of the filesystem.
    /// If the open fails, the handle will be closed with an epitaph indicating
    /// what went wrong.
    GetRoot(resource struct {
        dir server_end:fuchsia.io.Directory;
    });
};