src/developer/debug/zxdb/common/err.h

// Copyright 2018 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 SRC_DEVELOPER_DEBUG_ZXDB_COMMON_ERR_H_
#define SRC_DEVELOPER_DEBUG_ZXDB_COMMON_ERR_H_

#include <string>

namespace debug {
class Status;
}

namespace unwinder {
class Error;
}

namespace zxdb {

// Most errors are general but in some cases we need to programmatically know a particular error.
// These errors are listed here.
enum class ErrType {
  kNone,            // No error.
  kGeneral,         // Unspecified error type.
  kCanceled,        // The operation was explicitly canceled.
  kNoConnection,    // There is no connection to the debug agent.
  kCorruptMessage,  // Data was corrupted between us and the debug agent.
  kClientApi,       // An invalid client API call.
  kNotSupported,    // The system doesn't support the requested operation.
  kNotFound,        // For example, the processes to be attached to didn't exist.
  kAlreadyExists,   // For example, attaching to a process or job that's already attached.
  kNoResources,     // Ran out of something (like debug registers).
  kInput,           // Some problem getting input from the user (parse error, etc.).
  kOptimizedOut,    // Not available because of optimization in the debugged program.
  kUnsupported      // The answer is probably knowable but the debugger doesn't support it yet.
};

class Err {
 public:
  // Indicates no error.
  Err();

  // Indicates an error of the given type with an optional error message.
  Err(ErrType type, const std::string& msg = std::string());

  // Produces a "general" error with the given message.
  explicit Err(const std::string& msg);

  // Conversion from an error that comes from the agent. It could also indicate "success" which
  // will produce a "success" Err.
  explicit Err(const debug::Status& debug_status);

  [[gnu::format(printf, 2, 3)]] explicit Err(const char* fmt, ...);

  ~Err();

  // Returns a standard "optimized out" error.
  static Err OptimizedOut() { return Err(ErrType::kOptimizedOut, "optimized out"); }

  bool has_error() const { return type_ != ErrType::kNone; }
  bool ok() const { return type_ == ErrType::kNone; }

  ErrType type() const { return type_; }
  const std::string& msg() const { return msg_; }
  std::string ToString() const;

  // Equality operator is provided for tests.
  bool operator==(const Err& other) const;

 private:
  ErrType type_ = ErrType::kNone;
  std::string msg_;
};

std::string ErrTypeToString(ErrType type);

unwinder::Error ErrToUnwinderError(const Err& err);

}  // namespace zxdb

#endif  // SRC_DEVELOPER_DEBUG_ZXDB_COMMON_ERR_H_