src/developer/debug/zxdb/console/commands/verb_down.cc

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

#include "src/developer/debug/zxdb/console/commands/verb_down.h"

#include "src/developer/debug/zxdb/client/frame.h"
#include "src/developer/debug/zxdb/client/process.h"
#include "src/developer/debug/zxdb/client/target.h"
#include "src/developer/debug/zxdb/client/thread.h"
#include "src/developer/debug/zxdb/console/command.h"
#include "src/developer/debug/zxdb/console/command_utils.h"
#include "src/developer/debug/zxdb/console/console.h"
#include "src/developer/debug/zxdb/console/format_frame.h"
#include "src/developer/debug/zxdb/console/output_buffer.h"
#include "src/developer/debug/zxdb/console/verbs.h"

namespace zxdb {

namespace {

const char kDownShortHelp[] = "down: Move down the stack";
const char kDownHelp[] =
    R"(down

  Switch the active frame to the one below (forward in time from) the current.

Examples

  down
      Move one frame down the stack

  t 1 down
      Move down the stack on thread 1
)";

Err RunVerbDown(ConsoleContext* context, const Command& cmd) {
  if (Err err = AssertStoppedThreadWithFrameCommand(context, cmd, "down"); err.has_error())
    return err;

  auto id = context->GetActiveFrameIdForThread(cmd.thread());
  if (id < 0)
    return Err("Cannot find current frame.");

  if (id == 0)
    return Err("At bottom of stack.");

  if (cmd.thread()->GetStack().size() == 0)
    return Err("No stack frames.");

  id -= 1;

  context->SetActiveFrameIdForThread(cmd.thread(), id);
  OutputFrameInfoForChange(cmd.thread()->GetStack()[id], id);
  return Err();
}

}  // namespace

VerbRecord GetDownVerbRecord() {
  return VerbRecord(&RunVerbDown, {"down"}, kDownShortHelp, kDownHelp, CommandGroup::kGeneral);
}

// Shows the given frame for when it changes. This encapsulates the formatting options.
void OutputFrameInfoForChange(const Frame* frame, int id) {
  FormatFrameOptions opts;
  opts.loc.func.name.elide_templates = true;
  opts.loc.func.name.bold_last = true;
  opts.loc.func.params = FormatFunctionNameOptions::kElideParams;

  // Allow eliding of unnecessary path information.
  opts.loc.target_symbols = frame->GetThread()->GetProcess()->GetTarget()->GetSymbols();

  opts.variable.verbosity = ConsoleFormatOptions::Verbosity::kMinimal;
  opts.variable.pointer_expand_depth = 1;
  opts.variable.max_depth = 4;

  Console::get()->Output(FormatFrame(frame, opts, id));
}

}  // namespace zxdb