// 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.kernel;

using fuchsia.mem;
using zx;

/// Protocol for retrieving kcounter information.
@discoverable
@for_deprecated_c_bindings
protocol Counter {
    /// Retrives a VMO containining summarized kcounter data. The vmo returned
    /// in `buffer` is in "inspect-vmo" format, documented elsewhere.
    GetInspectVmo() -> (resource struct {
        status zx.status;
        buffer fuchsia.mem.Buffer;
    });

    /// Request that the previously-returned VMO buffer's data be updated. The
    /// data may not be updated if it was already recently updated (updates are
    /// limited to an unspecified rate, but approximately every few seconds).
    UpdateInspectVmo() -> (struct {
        status zx.status;
    });
};