guest_log.h

Go to the documentation of this file.

// Copyright 2026 The Symbian SDK Authors.
// Licensed under the Apache License, Version 2.0.
 
#ifndef SYMBIAN_AGENT_GUEST_LOG_H_
#define SYMBIAN_AGENT_GUEST_LOG_H_
 
#include <array>
#include <cstddef>
#include <cstdint>
 
#include "absl/status/statusor.h"
#include "absl/time/clock.h"
#include "absl/time/time.h"
 
namespace symbian::agent {
 
enum class AgentLogCode : std::uint8_t {
  kAuthenticated = 1,
  kStatusRead = 2,
  kRejectedFrame = 3,
  kSessionClosed = 4,
};
 
enum class AgentLogSeverity : std::uint8_t {
  kDebug = 1,
  kInfo = 2,
  kWarning = 3,
};
 
struct AgentLogRecord {
  std::uint64_t sequence = 0;
  AgentLogCode code = AgentLogCode::kAuthenticated;
  AgentLogSeverity severity = AgentLogSeverity::kInfo;
  std::uint64_t elapsed_microseconds = 0;
};
 
struct AgentLogPage {
  std::array<AgentLogRecord, 8> records{};
  std::uint8_t count = 0;
  std::uint64_t next_cursor = 0;
  bool gap = false;
};
 
class AgentLogRing {
 public:
  static constexpr std::size_t kCapacity = 32;
 
  void Append(AgentLogCode code);
 
  absl::StatusOr<AgentLogPage> ReadAfter(std::uint64_t cursor,
                                         std::uint8_t limit) const;
 
 private:
  std::array<AgentLogRecord, kCapacity> records_{};
  absl::Time started_ = absl::Now();
  std::uint64_t last_elapsed_microseconds_ = 0;
  std::uint64_t next_sequence_ = 1;
};
 
}  // namespace symbian::agent
 
#endif  // SYMBIAN_AGENT_GUEST_LOG_H_