RFC643 日本語訳

Network Debugging Protocol                          Eric Mader
RFC: 643                                             July 1974
NIC #30873

デバッグプロトコルエリックマーダーRFCをネットワークでつないでください: 643 1974年7月のNIC#30873

     This document describes a proposed protocol  to  be  used  in  an
implementation   of   a   PDP-11   network  Bootstrap  service  and  a
cross-network  debugger.   The  protocol  is  designed  for  debugging
processes  running under an operating system which can perform some of
the "lower level" debugging  tasks,  such  as  planting  and  removing
breakpoints  and  single  stepping.  A subset of the protocol could be
used if such a capability does not exist (a  stand-alone  program  for
example).

このドキュメントは、PDP-11ネットワークBootstrapサービスと交差しているネットワークデバッガの実装に使用されるために提案されたプロトコルについて説明します。 プロトコルはタスクをデバッグしながら「下のレベル」のいくつかを実行できるオペレーティングシステムで実行されるデバッグ工程のために設計されています、区切り点と単一の踏むことを植えて、取り除くのなどように。 そのような能力が存在していないなら(例えば、スタンドアロンプログラム)、プロトコルの部分集合は使用されるかもしれません。

     The protocol is a level 2 protocol, which  bypasses  the  ARPANET
HOST-HOST  protocol.   (This  is  implemented  on  TENEX using special
privileged system calls which allow messages to be  sent  directly  to
and  received  directly  from the IMP).  Messages are sent between the
PDP-11 and the remote debugger on  one  link  (currently  377  octal).
Each  message from the remote debugger to the PDP-ll is a request that
the PDP-11 perform some action, and each message from  the  PDP-11  to
the remote debugger is either a reply to that request or an indication
that  a  process  has  stopped  running  (i.e.   has  trapped,  hit  a
breakpoint, etc).  The exact format of the messages is shown in Figure
1 below.

プロトコルは平らな2プロトコルです。(そのプロトコルはARPANET HOST-HOSTプロトコルを迂回させます)。 (これをTENEXで直接送られるべきメッセージに与える特別な特権があるシステムコールを使用することで実装して、直接IMPから受け取ります。) 1個のリンク(現在の377 8進)の上のPDP-11とリモートデバッガの間にメッセージを送ります。 各PDP-11からリモートデバッガまでのメッセージは、各リモートデバッガからPDP-llまでのメッセージがPDP-11が何らかの動作を実行するという要求であり、その要求に関する回答かプロセスが、稼働するのを止めたという指示(すなわち、捕らえて、区切り点などを打つ)のどちらかです。 メッセージの正確な書式は以下の図1に示されます。

     Each  command  consists  of  an  8-bit  op-code,  and  an   8-bit
process-id,  two  16-bit  arguments,  and  an optional string of 8-bit
bytes.  The op-code field from the PDP-11 should be the same  as  that
sent  by  the  remote  host  to  indicate successful completion of the
request or be the same as that set by the remote host with the 200 bit
set  to  indicate  failure to complete the request.  Op-codes from the
PDP-11 which have the 100 bit set are asynchronous indication  that  a
process  has stopped for a reason other than a request from the remote
host.  (See description of asynchronous replies  below).   An  op-code
from  the  PDP-11  with  both  the 100 and 200 bit set is meaningless.
Thus, the 8-bit op-code field sent by the PDP-11 can be thought of  as
a CAN'T Flag, an Asynchronous STOP Flag, and a 6-bit op-code.

各コマンドは8ビットの演算コード、8ビットのプロセスイド、2つの16ビットの議論、および8ビットのバイトの任意のストリングから成ります。 PDP-11からの演算コード分野は200ビットをもっているリモートホストでセットしたので要求の無事終了を示すか、または同じになるようにリモートホストによって送られたそれが要求を終了しないことを示すためにセットしたのと同じであるべきです。 100ビットを設定させるPDP-11からの演算コードはプロセスがリモートホストからの要求以外の理由をとどまって待ったという非同期な指示です。 (以下での非同期な回答の記述を見ます。) 100と200ビットが設定した両方があるPDP-11からの演算コードは無意味です。 したがって、aはFlag、Asynchronous STOP Flag、および6ビットの演算コードを考えることができないようにPDP-11によって送られた8ビットの演算コード野原は考えることができます。

     In the description that follows the commands will be given as

記述におけるコマンドが与えられているその尾行

   NAME (Process-ID, Argument 1, Argument 2, BYTE STRING)
with only as many of the fields present as are used.

分野の同じくらい多くだけがある(プロセスID、Argument1、Argument2、BYTE STRING)が使用されているように寄贈するNAME。

Op-Code 0 - NOP_______ _ _ ___

演算コード0--NOP_______ _ _ ___

     This command is intended to be used to determine if the PDP-11 is
operational.   It  has no effect on any process running in the PDP-11.
The response is NOP.

PDP-11が操作上であるかどうか決定するのにこのコマンドが使用されることを意図します。 それは、PDP-11へ駆け込みながら、どんなプロセスの上でも効き目がありません。 応答はNOPです。

Op-Code 1 - DEBUG (Process)_______ _ _ _____ _________

演算コード1--デバッグ(プロセス)_______ _ _ _____ _________

     This command requests the ability to  debug  the  given  process.
The PDP-11 should respond with

                                                    Page   2

このコマンドは与えられたプロセスをデバッグする能力を要求します。 PDP-11は2ページで応じるはずです。

                     DEBUGGING (process)

デバッグ(プロセス)

(op-code 1) if no other remote host is currently doing so, and

(演算コード1) そして他のどんなリモートホストも現在そうしていないなら。

                    CAN'T DEBUG (process)

デバッグできません。(プロセス)

(op-code 201) if another remote host  has  been  given  permission  to
debug the process, or the process doesn't exist.

(演算コード201) プロセスをデバッグする許可を別のリモートホストに与えたか、またはプロセスが存在していないなら。

Op-Code 2 - END DEBUG (Process)_______ _ _ ___ _____ _________

演算コード2--終わりのデバッグ(プロセス)_______ _ _ ___ _____ _________

     This command relinquishes the ability to debug  a  process.   The
PDP-11 should reply

このコマンドはプロセスをデバッグする能力を放棄します。 PDP-11は返答するはずです。

                     END DEBUG (Process)

終わりのデバッグ(プロセス)

(op-code 2) unless the remote host isn't  debugging  the  process,  in
which case it should respond

(演算コード2) リモートホストがプロセスをデバッグしている場合、その場合、それは応じるべきです。

                  CAN'T END DEBUG (Process)

デバッグを終わらせることができません。(プロセス)

(op-code 202).  If the process isn't running when  the  END  DEBUG  is
done, then the effect should be the same as

(演算コード202。) プロセスがいつを実行するかEND DEBUGがされる効果が同じであるべきであるその時でないなら

                      RESUME (PROCESS)
                    END DEBUG (PROCESS)

(プロセス)終わりのデバッグを再開してください。(プロセス)

Op-Code 3 - STOP (Process)_______ _ _ ____ _________

演算コード3--停止(プロセス)_______ _ _ ____ _________

     This command requests the PDP-11 to stop the given  process  from
running.  The PDP-11 should respond

このコマンドは、与えられたプロセスが稼働するのを止めるようPDP-11に要求します。 PDP-11は応じるはずです。

                      STOPPED (process)

止められます。(プロセス)

(op-code 3) unless the process isn't  being  debugged  by  the  remote
host.  In this case it should reply

(演算コード3) プロセスがリモートホストによってデバッグされている場合。 この場合、それは返答するべきです。

                    CAN'T STOP (process)

止まることができません。(プロセス)

  (op-code 203).

(演算コード203。)

Op-Code 4 - DEPOSIT (Process, Address, Count, Byte String)_______ _ _ _______ _________ ________ ______ ____ _______

演算コード4--(プロセス、アドレス、カウント、バイトストリング)を預けてください。_______ _ _ _______ _________ ________ ______ ____ _______

     This instructs the PDP-11 to deposit  the  Count  bytes  in  Byte
String  into  the  given process's address space beginning at Address.
The PDP-11 should reply

これは、Addressで始まる与えられた過程sのアドレス空間へのByte StringにCountバイトを預けるようPDP-11に命令します。 PDP-11は返答するはずです。

             DEPOSITED (Process, Address, Count)

預けられます。(プロセス、アドレス、カウント)

if successful or

またはうまくいく。

           CAN'T DEPOSIT (Process, Address, Count)

                                                    Page   3

3ページを預けることができません(プロセス、アドレスは重要です)。

if the deposit doesn't succeed, or the remote host isn't debugging the
process.

預金が成功しないか、またはリモートホストがプロセスをデバッグしていないなら。

Op-Code 5 - RESUME (Process)_______ _ _ ______ _________

演算コード5--履歴書(プロセス)_______ _ _ ______ _________

     This instructs the PDP-11 to allow the given  process  to  resume
running.  The PDP-11 should reply

これは、稼働するのを与えられたプロセスを再開させるようPDP-11に命令します。 PDP-11は返答するはずです。

                     RESUMED (Process)

再開されます。(プロセス)

before it starts the process (in case it traps right away), or

または以前プロセスが始めである、(すぐ捕らえるといけないので)。

                   CAN'T RESUME (Process)

再開できません。(プロセス)

if the process wasn't stopped, or the remote host isn't debugging  the
process.

プロセスが止められなかったか、またはリモートホストがプロセスをデバッグしていないなら。

Op-Code 6 - EXAMINE (Process, Address, Count)_______ _ _ _______ _________ ________ ______

演算コード6--(プロセス、アドレス、カウント)を調べてください。_______ _ _ _______ _________ ________ ______

     This instructs the PDP-11 to return Count bytes  from  the  given
process address space starting at Address.  The PDP-11 should reply

これは、Addressでバイトを与えられたプロセスアドレス空間始めからCountに返すようPDP-11に命令します。 PDP-11は返答するはずです。

       CONTENTS (Process, Address, Count, Byte String)

コンテンツ(プロセス、アドレス、カウント、バイトストリング)

if it can supply the bytes, or

またはバイトを供給できるなら。

           CAN'T EXAMINE (Process, Address, Count)

調べることができません。(プロセス、アドレス、カウント)

if all the bytes don't exist in the address space, or the remote  host
isn't debugging the process.

すべてのバイトがアドレス空間で存在するというわけではないか、またはリモートホストがプロセスをデバッグしていないなら。

Op-Code 7 - DEPOSIT STATE VECTOR (Process, Index, Byte Count,_______ _ _ _______ _____ ______ _________ ______ ____ ______
            Byte String)            ____ _______

演算コード7--預金州のベクトル(プロセス、インデックス、バイト・カウント、_______ _ _ _______ _____ ______ _________ ______ ____ ______バイトストリング)____ _______

     This instructs the PDP-11 to deposit the Byte Count bytes in Byte
String  into the state vector for the given process starting with byte
Index.  See Figure 2 for the format of the state vector.   The  PDP-11
should reply

これは、バイトIndexから始まって、与えられたプロセスのために州のベクトルへのByte StringにByte Countバイトを預けるようPDP-11に命令します。 州のベクトルの形式に関して図2を見てください。 PDP-11は返答するはずです。

     DEPOSITED STATE VECTOR (Process, Index, Byte Count)

預けられた州のベクトル(プロセス、インデックス、バイト・カウント)

unless the bytes won't all fit in the state vector or the remote  host
isn't debugging the process.  In this case the reply should be

バイトがすべて適合するなら、州のベクトルかリモートホストがプロセスをデバッグしていません。 この場合、回答はそうであるべきです。

  CAN'T DEPOSIT STATE VECTOR (Process, Index, Byte Count)

預金はベクトルを述べることができませんか?(プロセス、インデックス、バイト・カウント)

Op-Code 10 - BREAK (Process, Address, Proceed Count)_______ __ _ _____ _________ ________ _______ ______

演算コード10--壊れてください(プロセス、アドレスはカウントを続かせます)。_______ __ _ _____ _________ ________ _______ ______

     This instructs the PDP-11 to place a breakpoint at Address in the
given  process's address space, with a proceed count of Proceed Count.
The proceed count can be changed by issuing another BREAK with a
different count.  The PDP-11 should reply

                                                    Page   4

これは、当然のことの過程sのアドレス空間でAddressに区切り点をみなすようPDP-11に命令して、aで、Proceed Countのカウントを続かせてください。 カウントを続かせてください。異なったカウントで別のBREAKを発行することによって、変えることができます。 PDP-11、4パージュは返答するべきです。

           BROKE (Process, Address, Proceed Count)

壊れました。(プロセス、アドレスはカウントを続かせます)

if it was able to plant the breakpoint and

そして区切り点を植えることができた。

        CAN'T BREAK (Proceed, Address, Proceed Count)

壊れることができません。(続いてください、アドレス、カウントを続かせてください、)

if it was unable to plant the breakpoint because the breakpoint tables
for  the  process are full, or because the remote host isn't debugging
the process.  Note that the  PDP-11  must  keep  track  of  where  the
breakpoints are, the old contents of these locations etc.

プロセスのための区切り点テーブルが完全であるのでリモートホストがプロセスをデバッグしていないので区切り点を植えることができなかったなら。 PDP-11が区切り点があるところで動向をおさえなければならなくて、これらの古いコンテンツが位置のなどであることに注意してください。

Op-Code 11 - UNBREAK (Process, Address)_______ __ _ _______ _________ ________

演算コード11--UNBREAK(プロセス、アドレス)_______ __ _ _______ _________ ________

     This instructs the PDP-11 to remove the breakpoint  from  Address
in the process's address space and release all storage associated with
it.  The PDP-11 should reply

これは、すべてのストレージがそれに関連づけた過程sのアドレス空間とリリースでAddressから区切り点を取り除くようPDP-11に命令します。 PDP-11は返答するはずです。

                 UNBROKE (Process, Address)

UNBROKE(プロセス、アドレス)

when the breakpoint is removed, or

または区切り点を取り除くとき。

              CAN'T UNBREAK (Process, Address)

UNBREAKであることができる(プロセス、アドレス)

if the process doens't have a breakpoint at Address or the remote host
isn't debugging the process.

プロセスdoensがAddressに区切り点を持っていないか、そして、リモートホストがプロセスをデバッグしていません。

Op-Code 12 - SINGLE STEP (Process)_______ __ _ ______ ____ _________

演算コード12--シングルステップ(プロセス)_______ __ _ ______ ____ _________

     This instructs the PDP-11 to let the given  process  execute  one
instruction, using the Trace Trap feature.  The PDP-11 should reply

これは、Trace Trapの特徴を使用して、与えられたプロセスに1つの指示を実行させるようPDP-11に命令します。 PDP-11は返答するはずです。

                  SINGLE STEPPING (Process)

単一の踏むこと(プロセス)

before the process is started, or

または以前プロセスが始めである。

                 CAN'T SINGLE STEP (Process)

シングルステップであることができる(プロセス)

if the process is already running or the remote host  isn't  debugging
the process.

プロセスが既に稼働する予定であるか、そして、リモートホストがプロセスをデバッグしていません。

Op-Code 13 - PROCEED BPT (Process)_______ __ _ _______ ___ _________

演算コード13--BPT(プロセス)を続かせてください。_______ __ _ _______ ___ _________

     This instructs the PDP-11 to allow the process to proceed from  a
break point trap (BPT, see below).  The PDP-11 should reply

これは、ブレークポイント罠からプロセスを生じさせるようPDP-11に命令します(BPT、以下を見てください)。 PDP-11は返答するはずです。

                  PROCEEDING BPT (Process)

BPTを続かせます。(プロセス)

before allowing the process to proceed, or

またはプロセスが続くのを許容する前に。

                 CAN'T PROCEED BPT (Process)

BPTを続かせることができません。(プロセス)

if the process isn't stopped at a breakpoint or the remote host  isn't
debugging the process.

                                                    Page   5

プロセスが区切り点で止められないか、そして、リモートホストがプロセスをデバッグしていません。 5ページ

Op-Code 14 - CREATE PROCESS_______ __ _ ______ _______

演算コード14--プロセスを作成してください。_______ __ _ ______ _______

     This instructs the PDP-11 to  create  a  process  (with  its  own
virtual address space if the system will support such a feature).  The
PDP-11 should reply

これは、プロセスを作成するようPDP-11に命令します(システムがそうするなら、それ自身の仮想アドレス空間で、そのような特徴をサポートしてください)。 PDP-11は返答するはずです。

                  CREATED PROCESS (Process)

作成されたプロセス(プロセス)

if it could create a process, with the process-id in process.  If  the
process  creation  failed  or  the system cannot create processes, the
PDP-11 should reply

プロセスを作成できるなら、中にプロセスイドがある状態で、処理してください。 プロセス作成が失敗できなかったか、システムがプロセスを作成できないなら、PDP-11は返答するはずです。

                    CAN'T CREATE PROCESS.

プロセスを作成できません。

Once a remote host has created a process it is debugging it, that is a

リモートホストがいったんプロセスを作成すると、それをデバッグしていて、それはaです。

                       DEBUG (process)

デバッグ(プロセス)

need not be done.

する必要はありません。

Op-Code 15 - DESTROY PROCESS (Process)_______ __ _ _______ _______ _________

演算コード15--プロセス(プロセス)を破壊してください。_______ __ _ _______ _______ _________

     This instructs the PDP-11 to destroy the  given  process.   After
the  process  is destroyed the remote host cannot, of course, debug it
so there is no need to do an

これは、与えられたプロセスを破壊するようPDP-11に命令します。 プロセスによる破壊されて、リモートホストがそうすることができない、もちろん、デバッグがそれであるという後に、ことであるので、する必要は全くありません。

                    END DEBUG (Process).

デバッグ(プロセス)を終わらせてください。

The PDP-11 should reply

PDP-11は返答するはずです。

                 DESTROYED PROCESS (Process)

破壊されたプロセス(プロセス)

if the process has been destroyed.  If the system  doesn't  support  a
multi-process structure or the remote host isn't debugging the process
the PDP-11 should reply

プロセスが破壊されたなら。 システムが、マルチプロセスが構造であるとサポートしないか、またはリモートホストがプロセスをデバッグしていないなら、PDP-11は返答するはずです。

              CAN'T DESTROY PROCESS (Process).

プロセス(プロセス)を破壊できません。

                 Asynchronous Stop Replies                 ____________ ____ _______

非同期な停止回答____________ ____ _______

     These replies (op-code between 100 and 177 octal) are sent by the
PDP-11  wherever a process being debugged stops running for any reason
other than in response to the

に対応してこれらの回答(演算コード100〜177 8進)がPDP-11によってどこでも、デバッグされるプロセスがどんな理由でも稼働するのを止めるところに送られる。

                       STOP (Process)

停止(プロセス)

command.  Each of these replies includes the entire state  vector  for
the process.

                                                    Page   6

命令してください。 それぞれのこれらの回答はプロセスのための全体の州のベクトルを含んでいます。 6ページ

Op-Code 100 - TRAP (Process, Reason, 0, STATE VECTOR)_______ ___ _ ____ _________ _______ __ _____ _______

演算コード100--捕らえてください(処理してください、そして、理由、0はベクトルを述べます)。_______ ___ _ ____ _________ _______ __ _____ _______

     This informs the remote host that a  process  has  "trapped",  or
terminated abnormally.  The reason is a system error code, or could be
a trap vector address in the stand-alone case.

これは、プロセスが「捕らえる」か、または異常に終わったことをリモートホストに知らせます。 理由は、システム・エラーコードである、またはスタンドアロンの場合で罠ベクトルアドレスであるかもしれません。

Op-Code 101 - HALT (Process, 0,0, STATE VECTOR)_______ ___ _ ____ _________ ____ _____ _______

演算コード101--停止してください(処理してください、そして、0、0はベクトルを述べます)。_______ ___ _ ____ _________ ____ _____ _______

     This  informs  the  remote  host  that  the  given  process   has
terminated normally.

これは、通常、与えられたプロセスが終わったことをリモートホストに知らせます。

Op-Code 102 - BPT (Process, 0, 0, STATE VECTOR)_______ ___ _ ___ _________ __ __ _____ _______

演算コード102--BPT(処理してください、そして、0、0はベクトルを述べます)_______ ___ _ ___ _________ __ __ _____ _______

     This informs the remote host that the given  process  has  hit  a
breakpoint trap.

これは、与えられたプロセスが区切り点罠を打ったことをリモートホストに知らせます。

Op-Code 103 - TTRAP (Process, 0, 0, STATE VECTOR)_______ ___ _ _____ _________ __ __ _____ _______

演算コード103--TTRAP(処理してください、そして、0、0はベクトルを述べます)_______ ___ _ _____ _________ __ __ _____ _______

     This informs the remote host that the given  process  has  hit  a
trace trap, i.e.  has just executed one instruction in response to the

に対応してちょうど1つの指示を実行したところである、これが、与えられたプロセスですなわち、跡の罠を打つリモートホストに知らせる。

                    SINGLE STEP (Process)

シングルステップ(プロセス)

command.

                                                    Page   7

命令してください。 7ページ

                          Figure 1

図1

             FORMAT OF NETWORK DEBUGGER MESSAGES

ネットワークデバッガメッセージの形式

                    ----------------
                   | TYPE | HOST    |
                    ----------------
                   | LINK | STYPE   |
                    ----------------
                   | CMD  |  PID    |
                    ----------------
                   |    ARG1        |
                    ----------------
                   |    ARG2        |
                    ----------------

---------------- | タイプ| ホスト| ---------------- | リンク| STYPE| ---------------- | CMD| PID| ---------------- | ARG1| ---------------- | ARG2| ----------------

     TYPE -- The HOST-IMP/IMP-HOST message type, should
             always be zero.

TYPE--いつもHOST-IMP/IMP-HOSTメッセージタイプはゼロであるべきです。

     HOST -- The source host ID.

HOST--送信元ホストID。

     LINK -- The debugger link.

LINK--デバッガリンク。

    STYPE -- The message subtype, always zero.

STYPE--メッセージ「副-タイプ」、いつもゼロ。

      CMD -- The debugger command op-code, excess 100 for
             asynchronous reply's, excess 200 for "can't"
             reply's.

CMD--デバッガコマンド演算コード、非同期なリプライのもののための余分な100、“can't"リプライのもののための余分な200。

      PID -- Process ID of process being debugged.

PID--デバッグされるプロセスのIDを処理してください。

     ARG1 -- The first argument of the command.

ARG1--コマンドの最初の議論。

     ARG2 -- The second argument of the command.

ARG2--コマンドの2番目の議論。


                                                 Page 8

8ページ

                          Figure 2

図2

                  FORMAT OF STATE VECTORS

州のベクトルの形式

                      ------------
                     |    R0      |
                      ------------
                     |    R1      |
                      ------------
                     |    R2      |
                      ------------
                     |   ...      |
                      ------------
                     |    PC      |
                      ------------
                     |    PS      |
                      ------------

------------ | R0| ------------ | R1| ------------ | R2| ------------ | ... | ------------ | PC| ------------ | PS| ------------