Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Proposal: remove requirement for exact instruction count for disassemble response

オープン
#234 コメント 8 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
32/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
停滞
領域
api, devtools

調査の方向性

まず、issue で引用されている逆アセンブル要求の定義と instructionCount の仕様を確認し、次に VS Code の逆アセンブルビューが返されたアドレスをどのように解釈するかを確認します。利用可能な命令が少ない場合に期待されるレスポンスを定義し、アドレスのルールを明確にします。クライアントとデバッグアダプターの双方にとってプロトコル仕様が曖昧でなくなれば完了です。

索引モデルが issue の本文から書いたものです。

説明

under-discussion

The spec requires debug adapters to return exactly the number of instructions requested.

  /**
   * Number of instructions to disassemble starting at the specified location
   * and offset.
   * An adapter must return exactly this number of instructions - any
   * unavailable instructions should be replaced with an implementation-defined
   * 'invalid instruction' value.
   */
  instructionCount: number;

This presents an issue when there are not enough instructions available. The DA is then required to return an "implementation-defined" invalid instruction. It is unclear how those instructions will be used, and why they are even necessary to return. Scrolling through invalid instructions does not provide any additional information to users.

Also what the addresses should be for the invalid instructions is not defined in the spec so it is unclear how the editor can interpret them. For example, the VS Code implementation of a disassembly view will attempt to do a binary search using the addresses, which requires that the invalid instructions obey certain rules to implement this. This may also result in having to return negative addresses which also does not really make sense for an instruction.

Removing the requirement to return exactly the number of requested instructions would better define the expected disassembled instructions for both the client and server.

主要言語
HTML
スター
1.8k
フォーク
173
平均マージ
7日 7時間
マージ済み PR(30日)
2

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

microsoft/debug-adapter-protocol のほかの issue

microsoft/debug-adapter-protocol の issue をすべて見る

似ている issue

Backend & API Design の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。