RFC1592 日本語訳
1592 Simple Network Management Protocol Distributed Protocol InterfaceVersion 2.0. B. Wijnen, G. Carpenter, K. Curran, A. Sehgal, G.Waters. March 1994. (Format: TXT=135259 bytes) (Obsoletes RFC1228) (Status: EXPERIMENTAL)
プログラムでの自動翻訳です。
RFC一覧
英語原文
Network Working Group B. Wijnen
Request for Comments: 1592 G. Carpenter
Obsoletes: 1228 T.J. Watson Research Center, IBM Corp.
Category: Experimental K. Curran
A. Sehgal
G. Waters
Bell Northern Research, Ltd.
March 1994
Wijnenがコメントのために要求するワーキンググループB.をネットワークでつないでください: 1592年のG.大工は以下を時代遅れにします。 1228 T.J.ワトソン研究所、IBM社のカテゴリ: 実験的なK.カランA.Sehgal G.は1994年のLtd.行進のときにベル北研究に水をまきます。
Simple Network Management Protocol
Distributed Protocol Interface
Version 2.0
簡単なネットワーク管理プロトコル分配されたプロトコルインタフェースバージョン2.0
Status of this Memo
このMemoの状態
This memo defines an Experimental Protocol for the Internet community. This memo does not specify an Internet standard of any kind. Discussion and suggestions for improvement are requested. Distribution of this memo is unlimited.
このメモはインターネットコミュニティのためにExperimentalプロトコルを定義します。 このメモはどんな種類のインターネット標準も指定しません。 議論と改善提案は要求されています。 このメモの分配は無制限です。
Table of Contents
1. INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1 Motivation . . . . . . . . . . . . . . . . . . . . . . . . 3
1.2 Summary of Changes . . . . . . . . . . . . . . . . . . . . 4
2. THEORY OF OPERATION . . . . . . . . . . . . . . . . . . . . . 5
2.1 Connection Establishment and Termination . . . . . . . . . 5
2.2 Registration . . . . . . . . . . . . . . . . . . . . . . . 6
2.3 Normal Operation . . . . . . . . . . . . . . . . . . . . . 6
2.4 DPI Architecture . . . . . . . . . . . . . . . . . . . . . 6
3. SNMP DPI PROTOCOL . . . . . . . . . . . . . . . . . . . . . 10
3.1 Connection Establishment . . . . . . . . . . . . . . . . 10
3.1.1 SNMP PDU to GET the Agent's DPI port . . . . . . . . . 11
3.1.2 SNMP PDU Containing the RESPONSE to the GET . . . . . 13
3.2 SNMP DPI Packet Formats . . . . . . . . . . . . . . . . 15
3.2.1 DPI Packet Header . . . . . . . . . . . . . . . . . . 15
3.2.2 OPEN . . . . . . . . . . . . . . . . . . . . . . . . . 16
3.2.3 CLOSE . . . . . . . . . . . . . . . . . . . . . . . . 18
3.2.4 ARE_YOU_THERE . . . . . . . . . . . . . . . . . . . . 19
3.2.5 REGISTER . . . . . . . . . . . . . . . . . . . . . . . 20
3.2.6 UNREGISTER . . . . . . . . . . . . . . . . . . . . . . 22
3.2.7 GET . . . . . . . . . . . . . . . . . . . . . . . . . 23
3.2.8 GETNEXT . . . . . . . . . . . . . . . . . . . . . . . 24
3.2.9 GETBULK . . . . . . . . . . . . . . . . . . . . . . . 25
3.2.10 SET, COMMIT and UNDO . . . . . . . . . . . . . . . . 26
3.2.11 RESPONSE . . . . . . . . . . . . . . . . . . . . . . 29
3.2.12 TRAP . . . . . . . . . . . . . . . . . . . . . . . . 31
3.3 Constants and Values . . . . . . . . . . . . . . . . . . 33
目次1。 変化. . . . . . . . . . . . . . . . . . . . 4 2の序論. . . . . . . . . . . . . . . . . . . . . . . . 2 1.1動機. . . . . . . . . . . . . . . . . . . . . . . . 3 1.2概要。 動作理論. . . . . . . . . . . . . . . . . . . . . 5 2.1コネクション確立と終了. . . . . . . . . 5 2.2登録. . . . . . . . . . . . . . . . . . . . . . . 6 2.3通常操作. . . . . . . . . . . . . . . . . . . . . 6 2.4dpi構造. . . . . . . . . . . . . . . . . . . . . 6 3。 SNMP DPI PROTOCOL. . . . . . . . . . . . . . . . . . . . . 10 3.1Connection特権階級、.103.1、.1SNMP PDU、GET. . . . . 13 3.2SNMP DPI Packet Formats. . . . . . . . . . . . . . . . 15 3.2.1DPI Packet Header. . . . . . . . . . . . . . . . . . 15 3.2.2オープン. . . . . . . . . . . . . . . . . . . . . . . . . 16 3.2.3CLOSE. . . . . . . . . . . . . . . . . . . . . . . . 18 3.2へのGETエージェントのDPIポート. . . . . . . . . 11 3.1.2SNMP PDU Containing RESPONSE; 4 _あなたはそこの.193.2.5レジスタ. . . . . . . . . . . . . . . . . . . . . . . 20 3.2.6UNREGISTER. . . . . . . . . . . . . . . . . . . . . . 22 3.2.7が.233.2を得る_ですか?; 8 GETNEXT. . . . . . . . . . . . . . . . . . . . . . . 24 3.2.9GETBULK. . . . . . . . . . . . . . . . . . . . . . . 25 3.2.10は、.263.2.11応答. . . . . . . . . . . . . . . . . . . . . . 29 3.2.12罠を設定して、遂行して、元に戻します。 . . . . . . . . . . . . . . . . . . . . . . . . 31 3.3の定数と値. . . . . . . . . . . . . . . . . . 33
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 1] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[1ページ]RFC1592SNMP-dpi行進1994
3.3.1 Protocol Version and Release Values . . . . . . . . . 33
3.3.2 Packet Type Values . . . . . . . . . . . . . . . . . . 34
3.3.3 Variable Type Values . . . . . . . . . . . . . . . . . 35
3.3.4 Value Representation . . . . . . . . . . . . . . . . . 36
3.3.5 Character set selection . . . . . . . . . . . . . . . 36
3.3.6 Error Code Values for SNMP DPI RESPONSE packets . . . 37
3.3.7 UNREGISTER Reason Codes . . . . . . . . . . . . . . . 40
3.3.8 CLOSE Reason Codes . . . . . . . . . . . . . . . . . . 41
4. DPI 2.0 MIB DEFINITION . . . . . . . . . . . . . . . . . . 41
5. SUBAGENT CONSIDERATIONS . . . . . . . . . . . . . . . . . . 42
5.1 DPI API . . . . . . . . . . . . . . . . . . . . . . . . 43
5.2 Overview of Request Processing . . . . . . . . . . . . . 44
5.2.1 GET Processing . . . . . . . . . . . . . . . . . . . . 44
5.2.2 SET Processing . . . . . . . . . . . . . . . . . . . . 44
5.2.3 GETNEXT Processing . . . . . . . . . . . . . . . . . . 46
5.2.4 GETBULK Processing . . . . . . . . . . . . . . . . . . 47
5.2.5 OPEN Request . . . . . . . . . . . . . . . . . . . . . 48
5.2.6 CLOSE Request . . . . . . . . . . . . . . . . . . . . 49
5.2.7 REGISTER Request . . . . . . . . . . . . . . . . . . . 49
5.2.8 UNREGISTER Request . . . . . . . . . . . . . . . . . . 50
5.2.9 TRAP Request . . . . . . . . . . . . . . . . . . . . . 51
5.2.10 ARE_YOU_THERE request . . . . . . . . . . . . . . . . 51
5.2.11 How to query the DPI port. . . . . . . . . . . . . . 51
6. REFERENCES . . . . . . . . . . . . . . . . . . . . . . . . 51
7. SECURITY CONSIDERATIONS . . . . . . . . . . . . . . . . . . 52
8. AUTHORS' ADDRESSES . . . . . . . . . . . . . . . . . . . . 53
9. SAMPLE SOURCES FOR ANONYMOUS FTP . . . . . . . . . . . . . 54
3.3.1 プロトコルバージョンとRelease Values. . . . . . . . . 33 3.3.2Packet Type Values. . . . . . . . . . . . . . . . . . 34 3.3.3Variable Type Values. . . . . . . . . . . . . . . . . 35 3.3.4Value Representation. . . . . . . . . . . . . . . . . 36 3.3.5キャラクターは選択を設定します。SNMP DPI RESPONSEパケット. . . 37 3.3.7UNREGISTER Reason Codes. . . . . . . . . . . . . . . 40 3.3.8CLOSE Reason Codes. . . . . . . . . . . . . . . . . . 41 4のための.363.3.6Error Code Values。 dpi2.0MIB定義. . . . . . . . . . . . . . . . . . 41 5。 要求処理の副代理店問題. . . . . . . . . . . . . . . . . . 42 5.1dpi API.435.2概観、.445.2、.1、処理. . . . . . . . . . . . . . . . . . . . 44 5.2.2セット処理. . . . . . . . . . . . . . . . . . . . 44 5.2.3GETNEXT処理. . . . . . . . . . . . . . . . . . 46 5.2.4GETBULK処理を得てください…; _あなたはTHEREが要求する_です。. . . . . 47 5.2.5 オープンRequest. . . . . . . . . . . . . . . . . . . . . 48 5.2.6CLOSE Request. . . . . . . . . . . . . . . . . . . . 49 5.2.7REGISTER Request. . . . . . . . . . . . . . . . . . . 49 5.2.8UNREGISTER Request. . . . . . . . . . . . . . . . . . 50 5.2.9TRAP Request、.515.2、.10、.515.2 .11 DPIポートについて質問する方法。 . . . . . . . . . . . . . 51 6. 参照. . . . . . . . . . . . . . . . . . . . . . . . 51 7。 セキュリティ問題. . . . . . . . . . . . . . . . . . 52 8。 作者のアドレス. . . . . . . . . . . . . . . . . . . . 53 9。 アノニマスFTP. . . . . . . . . . . . . 54のためのサンプルソース
1. INTRODUCTION
1. 序論
This RFC describes version 2.0 of a protocol that International Business Machines Corporation (IBM) has been implementing in most of its SNMP agents to allow dynamic extension of supported MIBs. Bell Northern Research (BNR) has also implemented a version of this protocol in some of its SNMP agents for the same reason.
このRFCはIBM社(IBM)が支持されたMIBsのダイナミックな拡大を許すためにSNMPエージェントの大部分で実行しているプロトコルのバージョン2.0について説明します。 また、ベルの北Research(BNR)は何人かのSNMPエージェントで同じ理由からこのプロトコルのバージョンを実行しました。
The Simple Network Management Protocol (SNMP [1]) Distributed Protocol Interface (DPI) is an extension to SNMP agents that permits end-users to dynamically add, delete or replace management variables in the local Management Information Base without requiring recompilation of the SNMP agent. This is achieved by writing a so- called sub-agent that communicates with the agent via the SNMP-DPI.
Simple Network Managementプロトコル、(SNMP[1])の分配されたプロトコルInterface(DPI)はSNMPエージェントへのエンドユーザがダイナミックにSNMPエージェントを「再-編集」に要求しないで地方のManagement Information基地の中の管理変数を加えるか、削除するか、または置き換えることを許可する拡張子です。 これは、SNMP-DPIを通してエージェントとコミュニケートするそのように呼ばれたサブエージェントに書くことによって、達成されます。
For the author of a sub-agent, the SNMP-DPI eliminates the need to know the details of ASN.1 [2] or SNMP PDU (Protocol Data Unit) encoding/decoding [1, 3].
サブエージェントの作者に関しては、SNMP-DPIは、[1、3]をコード化するか、または解読しながら、ASN.1[2]の詳細を知る必要性かSNMP PDU(プロトコルData Unit)を排除します。
Versions 1.0 and 1.1 of this protocol have been in use within IBM
このプロトコルのバージョン1.0と1.1はIBMの中で使用中です。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 2] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[2ページ]RFC1592SNMP-dpi行進1994
since 1989 and is included in the SNMP agents for VM, MVS and OS/2. Version 1.2 of this protocol has been in use within BNR since 1992.
そして、1989、VM、MVS、およびOS/2のためのSNMPエージェントでは、含まれています。 1992年以来このプロトコルのバージョン1.2はBNRの中で使用中です。
1.1 MOTIVATION
1.1 動機
The Simple Network Management Protocol [1] defines a protocol that permits operations on a collection of variables. This set of variables is called the Management Information Base (MIB) and a core set of variables has previously been defined [4, 5]; however, the design of the MIB makes provision for extension of this core set. Thus, an enterprise or individual can define variables of their own which represent information of use to them. An example of a potentially interesting variable which is not in the core MIB would be CPU utilization (percent busy). Unfortunately, conventional SNMP agent implementations provide no means for an end-user to make available new variables.
Simple Network Managementプロトコル[1]は変数の収集のときに操作を可能にするプロトコルを定義します。 このセットの変数はManagement Information基地(MIB)と呼ばれます、そして、1人の巻き癖の変数は以前に、定義されました[4、5]。 しかしながら、MIBのデザインはこの巻き癖の拡大に備えます。 したがって、企業か個人がそれらの役に立つ情報を表すそれら自身の変数を定義できます。 コアMIBにない潜在的におもしろい変数に関する例はCPU使用率(パーセント忙しい)でしょう。 残念ながら、従来のSNMPエージェント実現はエンドユーザが利用可能な新しい変数を作る手段を全く提供しません。
Besides this, today there are many MIBs that people want to implement on a system. Without a capability for sub-agents, this requires all the MIBs to be implemented in one big monolithic agent, which is in many cases undesirable.
この他、今日、人々がシステムの上で実行したがっている多くのMIBsがあります。 サブエージェントのための能力がなければ、これは、すべてのMIBsが1人の大きい一枚岩的なエージェントで実行されるのを必要とします。(多くの場合、そのエージェントは、望ましくありません)。
The SNMP DPI addresses these issues by providing a light-weight mechanism by which a process can register the existence of a MIB variable or a MIB sub-tree with the SNMP agent. Requests for the variable(s) that are received by the SNMP agent are passed to the process acting as a sub-agent. The sub-agent then returns an appropriate answer to the SNMP agent. The SNMP agent eventually packages an SNMP response packet and sends the answer back to the remote network management station that initiated the request.
SNMP DPIは、過程がMIB変数かMIB下位木の存在をSNMPエージェントに示すことができる軽量のメカニズムを提供することによって、これらの問題を記述します。 SNMPエージェントによって受け取られる変数を求める要求はサブエージェントとして務める過程に合格されます。 そして、サブエージェントはSNMPエージェントの適切な答えを返します。 SNMPエージェントは、結局、SNMP応答パケットをパッケージして、要求を開始した遠く離れたネットワークマネージメントステーションに答えを送り返します。
Remote network management stations have no knowledge that the SNMP agent calls on other processes to obtain an answer. As far as they can tell, there is only one network management application (agent) running on the host.
遠く離れたネットワークマネージメントステーションには、SNMPエージェントが、他の過程が答えを得るよう呼びかけるという知識が全くありません。 彼らが判断できる限り、ホストで動く1つのネットワークマネージメント利用(エージェント)しかありません。
At the San Diego IETF (March 1992) a BOF was held on multiplexing SNMP agent's requirements. Both the SMUX [6] and DPI [7] protocols were discussed, as well as other unpublished approaches. There was also discussion regarding a need for a standard for multiplexing SNMP agents or sub-agent support. At the end of the BOF, however, there was not enough support for defining a standard. This was due, at least partially, to a few well known SNMP authors who stated that the proxy and party support for SNMPv2 (SMP at the time) would solve the problem.
サンディエゴIETF(1992年3月)では、SNMPエージェントの要件を多重送信するとき、BOFは持たれていました。 他の未発表のアプローチと同様にSMUX[6]とDPI[7]プロトコルの両方について議論しました。 マルチプレクシングSNMPエージェントかサブエージェントサポートの規格の必要性についての議論もありました。 しかしながら、BOFの端には、規格を定義する十分なサポートがありませんでした。 これは少なくとも部分的に当然でした、SNMPv2(当時SMP)のプロキシとパーティーサポートが問題を解決すると述べた数人の顔が広いSNMP作者に。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 3] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[3ページ]RFC1592SNMP-dpi行進1994
Nevertheless, questions continue to be raised about sub-agent support (both in SNMP and SNMP2 mail lists) in spite of both SNMPv2 [8] being on the standard's track and SMUX being changed to a historic RFC. Furthermore, within IBM and BNR we continue to see a substantial and expanding use of the DPI protocol. with positive results.
それにもかかわらず、質問は、規格の道の上にあるSNMPv2[8]と歴史的なRFCに変わるSMUXの両方にもかかわらず、サブエージェントサポート(SNMPとSNMP2メール・リストの)に関して上げられ続けています。 その上、IBMとBNRの中では、私たちはずっとDPIの実質的で拡張している使用を見ます。プロトコル肯定的な結果で。
Therefore, we believe that there is a place for a sub-agent protocol and we again offer this new version as an experimental protocol. We encourage people to try it and send us feedback. Depending on that feedback, we may decide to try to get onto the standards track at a later time.
したがって、私たちは、サブエージェントプロトコルのための場所があると信じています、そして、再び、実験プロトコルとしてこの新しいバージョンを申し出ます。 私たちは、人々がそれを試みて、フィードバックを私たちに送るよう奨励します。 そのフィードバックによって、私たちは、後で標準化過程に乗ろうとすると決めるかもしれません。
During discussions about sub-agent interfaces at the San Diego BOF it also became clear that we should reduce the focus on the API for the sub-agent programmers. This RFC, therefore, specifies only the protocol to distribute SNMP requests from the main SNMP agent to the sub-agents. Programmers can build one or more Programming APIs on top of that protocol as needed, and sample API code is available from the authors of this document.
また、サンディエゴBOFのサブエージェントインタフェースについての議論の間、私たちがサブエージェントのプログラマのためにAPIの上の焦点を減少させるべきであるのは明確になりました。 したがって、このRFCは、主なSNMPエージェントからサブエージェントまでのSNMP要求を広げるためにプロトコルだけを指定します。 より多くのProgramming APIが必要に応じてその上に議定書を作ります、そして、プログラマが1つを建てることができますか、またはサンプルAPIコードはこのドキュメントの作者から利用可能です。
1.2 SUMMARY OF CHANGES
1.2 変化の概要
The following changes have been made since the initial definition of SNMP-DPI [7]. Some of these resulted from comparing the SMUX [6] and DPI [7] protocols.
SNMP-DPI[7]の初期の定義以来以下の変更は行われています。 これらの或るものはSMUX[6]を比較して、DPI[7]プロトコルから生じました。
o Documentation changes to cleanup and be more specific in some
areas. Among other things, this includes:
o ドキュメンテーションはクリーンアップに変化します、そして、いくつかの領域では、より特定であってください。 特に、これは:
- Defining that integers are in network byte order
- Defining the character set used for strings
- Defining how DisplayStrings are handled.
- Including DPI20 MIB definition.
- それを定義して、DisplayStringsがどう扱われるかを定義して、ストリングに使用される文字の組を定義して、ネットワークバイトオーダーには整数があります。 - DPI20 MIB定義を含んでいます。
o Removal of the Programming API from the document.
o ドキュメントからのProgramming APIの取り外し。
o Addition of new DPI packet types:
o 新しいDPIパケットタイプの追加:
- SNMP_DPI_OPEN for a sub-agent to open a "connection" with
the DPI SNMP capable agent. The sub-agent must now
identify itself and optionally provide a "password" for the
connection.
- SNMP_DPI_CLOSE for the agent or sub-agent to close the
connection in a graceful way.
- SNMP_DPI_ARE_YOU_THERE for the sub-agent to verify that the
agent still knows about the sub-agent.
- SNMP_DPI_UNREGISTER for the agent or sub-agent to terminate
the registration of a MIB variable or MIB sub-tree.
- サブエージェントがDPI SNMP有能なエージェントとの「接続」を開くSNMP_DPI_オープン。 サブエージェントは、現在、それ自体を特定して、任意に「パスワード」を接続に提供しなければなりません。 - エージェントかサブエージェントが優雅な方法で接続を終えるSNMP_DPI_CLOSE。 - SNMP_DPI、___あなたは確かめるエージェントがサブエージェントに関してまだ知っているサブエージェントのためのTHEREですか? - エージェントかサブエージェントがMIB変数かMIB下位木の登録を終えるSNMP_DPI_UNREGISTER。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 4] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[4ページ]RFC1592SNMP-dpi行進1994
- SNMP_DPI_COMMIT which instructs the sub-agent to actually
commit a previous SNMP_DPI_SET request. This, together
with the UNDO, allows DPI sub-agents to be compliant with
SNMP in the sense that we can now handle the "as if
simultaneous" requirement.
- SNMP_DPI_UNDO which instructs the sub-agent to UNDO a SET
or COMMIT if such is needed.
- SNMP、_実際にDPI_SETが要求する前のSNMP_を遂行するようサブエージェントに命令するDPI_COMMIT。 これは、UNDOと共にDPIサブエージェントがSNMPと共に私たちが現在「まるで同時であるかのように」要件を扱うことができるという意味で言いなりになるのを許容します。 - SNMP、_そのようなものであるならUNDO a SETかCOMMITのサブエージェントを命令するDPI_UNDOが必要です。
o Changes to DPI packets:
o DPIパケットへの変化:
- Multiple varBinds can now be exchanged in one DPI packet
(for GET, GETNEXT, SET, TRAP). The sub-agent can specify
the maximum it wants to handle per packet.
- The packet headers now contain a packet-ID (similar to SNMP
request ID in SNMP PDU). This allows to match RESPONSE
packets to REQUESTS, which is important for UDP based
DPI-connections.
- The SNMP_DPI_REGISTER packet has new fields for time_out
and for requested priority.
- The SNMP_DPI_TRAP packet allows to specify an enterprise
OID. In addition, the generic and specific trap types are
now 4 octets, so that we can pass the types correctly.
- In general, the packets have a more consistent layout.
- 現在、1つのDPIパケット(GET、GETNEXT、SETのためのTRAP)で複数のvarBindsを交換できます。 サブエージェントはそれがパケット単位で扱いたがっている最大を指定できます。 - パケットのヘッダーは現在、パケットID(SNMP PDUのSNMP要求IDと同様の)を含みます。 これはマッチRESPONSEにREQUESTSへのパケットを許容します。(UDPのベースのDPI-接続に、REQUESTSは重要です)。 - SNMP_DPI_REGISTERパケットは、時間_の新しい分野を取り除いて、要求された優先権のためにそうします。 - TRAPパケットで企業OIDを指定するSNMP_DPI_。 さらに、現在、一般的で特定の罠タイプは、私たちが正しくタイプを通過できるための4つの八重奏です。 - 一般に、パケットには、より一貫したレイアウトがあります。
o The agent now sends a RESPONSE to a REGISTER request
o エージェントは現在、REGISTER要求にRESPONSEを送ります。
o Addition of SNMPv2 error codes and value types.
o SNMPv2エラーコードと値のタイプの追加。
2. THEORY OF OPERATION
2. 動作理論
2.1 CONNECTION ESTABLISHMENT AND TERMINATION
2.1 コネクション確立と終了
Communication between the SNMP Agent and its clients (sub-agents) takes place via a communication mechanism. The communication type can be either a logical stream connection (via TCP, for instance) or an unreliable datagram connection (UDP, for instance). It should be noted that other stream oriented transport communication mechanisms can also be used. For example, the VM SNMP agent allows DPI connections over IUCV (Inter-User Communications Vehicle) [9, 10]. Other than the connection establishment procedure, the protocol used is identical in these environments.
SNMPエージェントとそのクライアント(サブエージェント)とのコミュニケーションはコミュニケーションメカニズムで行われます。 コミュニケーションタイプは、論理的な流れの接続(例えばTCPを通して)か頼り無いデータグラム接続のどちらかであるかもしれません(例えば、UDP)。 また、輸送コミュニケーションメカニズムを使用できることに他の流れのそんなに指向していた状態で注意されるべきです。 例えば、VM SNMPエージェントはIUCV(相互User Communications Vehicle)[9、10]の上のDPI接続を許します。 コネクション確立手順を除いて、使用されるプロトコルはこれらの環境が同じです。
In Unix the number of processes is limited by the number of file- descriptors that can be opened. Since each TCP socket represents a file-descriptor, restricting SNMP-DPI protocol to TCP only connections would limit the number of sub-agents an agent could support. As a result, the some SNMP-DPI agents support both TCP and UDP socket type communication mechanisms for the SNMP-DPI protocol.
Unixでは、過程の数は開くことができるファイル記述子の数によって制限されます。 それぞれのTCPソケットがファイルディスクリプタを表すので、SNMP-DPIプロトコルをTCPに制限して、接続だけがエージェントが支持できたサブエージェントの数を制限するでしょう。 結果としてサポートする、SNMP-DPIエージェントの中にはSNMP-DPIプロトコルのためにTCPとUDPソケットタイプコミュニケーションメカニズムの両方をサポートする人もいます。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 5] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[5ページ]RFC1592SNMP-dpi行進1994
Please note that in the following portion of this text the SNMP-DPI agent is referred simply as the agent.
本稿の以下の部分では、SNMP-DPIエージェントが単にエージェントとして参照されます。
Once the transport connection has been set up, the sub-agent must also initialize the logical connection with the agent. To do so it issues an OPEN request to the agent in which the sub-agent uniquely identifies itself and passes some other parameters to the agent, such as, the maximum number of varBinds per interaction it is prepared to handle, and the timeout the agent should use when waiting for a response from the sub-agent.
一度、輸送接続はセットアップされたことがあります、また、サブエージェントがエージェントとの論理的な接続を初期化しなければなりません。 そうそれをするのはサブエージェントが、唯一それ自体を特定して、ある他のパラメタをエージェントに渡します、どれとしてあれほどか、そして、1それが扱うように準備される相互作用あたりのvarBindsの最大数、およびサブエージェントから応答を待つときエージェントが使用するべきであるタイムアウトでオープン要求をエージェントに出します。
When the sub-agent prepares to stop or cease operations, it first issues a CLOSE to shut down the logical connection with the agent, and then closes the transport connection.
サブエージェントが、操作を止まるか、またはやめるのを準備すると、それは、最初にエージェントとの論理的な接続を止めるためにCLOSEを発行して、輸送接続を終えます。
2.2 REGISTRATION
2.2 登録
A sub-agent supports a collection of MIB variables or object identifiers (object IDs) that constitute its MIB (sub)tree. Each of these object IDs consists of a group ID and an instance ID. The group ID is the root of the sub-agent's MIB tree that it supports and the point of registration to the agent's MIB tree. The instance ID is the piece of the Object Identifier that follows the group ID (registration point), so it is not an instance in the terms of the SNMP definition of an instance.
サブエージェントはMIB(潜水艦)木を構成するMIB変数かオブジェクト識別子(オブジェクトID)の収集をサポートします。 それぞれのこれらのオブジェクトIDはグループIDとインスタンスIDから成ります。 グループIDは、それがサポートするサブエージェントのMIB木の根とエージェントのMIB木への登録のポイントです。 インスタンスIDがグループID(登録ポイント)に従うObject Identifierの断片であるので、インスタンスのSNMP定義に関する諸条件でそれはインスタンスではありません。
Regardless of the transport mechanism used, after establishing a connection to the agent, the sub-agent registers a branch (group ID) to the Agent's MIB tree. With the registration request, the sub- agent passes some parameters, such as, requested priority and a timeout value for this specific sub-tree.
エージェントに取引関係を築いた後に使用された移送機構にかかわらず、サブエージェントはブランチ(グループID)をエージェントのMIB木に登録します。 登録要求、サブエージェントパスによるいくつかのそのようなパラメタがこの特定の下位木のために優先権とタイムアウト値を要求しました。
The agent sends back a response to indicate success or failure of the registration request.
エージェントは、登録要求の成否を示すために応答を返送します。
2.3 NORMAL OPERATION
2.3 通常の操作
Once the sub-agent has set up both the physical and logical connection to the agent, and once it has successfully registered the sub-tree(s) of the MIB(s) that it supports, it waits for requests from the SNMP agent or generates traps as required.
一度、サブエージェントがエージェントとの物理的で論理的な接続を両方に設定したことがあって、いったん首尾よくそれがサポートするMIB(s)の下位木を登録すると、それは、SNMPエージェントからの要求を待っているか、または必要に応じて罠を生成します。
2.4 DPI ARCHITECTURE
2.4 dpiアーキテクチャ
These are the requests that can be initiated by the SNMP agent:
これらはSNMPエージェントが開始できる要求です:
GET, GETNEXT, GETBULK, SET, COMMIT, UNDO, UNREGISTER, and CLOSE.
得てください、GETNEXT(用意ができているGETBULK)が公約する、アンドゥ、UNREGISTER、および閉鎖。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 6] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[6ページ]RFC1592SNMP-dpi行進1994
The first four of these correspond directly to SNMP requests that a network management station can make (By default a GETBULK request will be translated into multiple GETNEXT requests by the agent, but a sub-agent may request that the GETBULK be passed to it). The COMMIT, UNDO, UNREGISTER, ARE_YOU_THERE and CLOSE requests are specific SNMP-DPI requests. The sub-agent normally responds to a request with a RESPONSE packet. The CLOSE request is an exception for which the sub-agent only closes the physical connection.
これら最初の4つは直接ネットワークマネージメントステーションがすることができるSNMP要求に対応しています(デフォルトで、GETBULK要求がエージェントによる複数のGETNEXT要求に翻訳されるでしょうが、サブエージェントは、GETBULKがそれに渡されるよう要求するかもしれません)。 _COMMIT、UNDO、UNREGISTER、_あなたはTHEREです、そして、CLOSE要求は特定のSNMP-DPI要求です。 通常、サブエージェントはRESPONSEパケットで要求に応じます。 CLOSE要求はサブエージェントが物理接続を終えるだけである例外です。
These are the requests that can be initiated by a sub-agent:
これらはサブエージェントが開始できる要求です:
OPEN, REGISTER, TRAP, UNREGISTER, ARE_YOU_THERE and CLOSE.
開いてください、登録してください、罠、UNREGISTERは__そこのあなたであり、閉じます。
The agent responds to OPEN, REGISTER, UNREGISTER and ARE_YOU_THERE with a RESPONSE packet. The TRAP packet is just accepted and forwarded by the agent without returning any information to the sub- agent. The CLOSE packet is also just accepted by the agent upon which it closes the physical connection.
_エージェントはオープン、REGISTER、UNREGISTERに応じます、そして、_あなたはRESPONSEパケットがあるTHEREですか? どんな情報もサブエージェントに返さないで、TRAPパケットは、エージェントによってただ受け入れられて、進められます。 また、CLOSEパケットはそれが物理接続を終えるエージェントによってただ受け入れられます。
See Figure 1 for an overview of the DPI packet flow.
DPIパケット流動の概要に関して図1を見てください。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 7] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[7ページ]RFC1592SNMP-dpi行進1994
-------------------------------------------------------------------
-------------------------------------------------------------------
*---------------------------------*
| |
| SNMP Network |
| Management Station |
| |
|---------------------------------|
| SNMP Protocol |
*---------------------------------*
A | Get A
| | GetNext | GetResponse
Trap | | GetBulk |
| | Set |
| V |
*------------------------------* *-------------------*
| SNMP Protocol | | DPI Interface |
|------------------------------| Response | *--------------|
| | |<----------->| | |
| | | | | |
| SNMP Agent | | | | |
| | | Get,GetNext | | |
| | | (GetBulk) | | Client |
| | | Set,Commit | | |
| A *-----------+-> | Undo | | |
| | | Get/Set | |------------>| | or |
| Trap| | info | | | | |
| | | | SNMP | | | |
|-----+-----+-------* | | trap | | SNMP |
| | V | | DPI |<------------| | Sub-Agent |
| | | | | | |
| Statically Linked | | | | | |
| Instrumentation | | | | | |
| (like MIB II) | | | | | |
| | | | close | | |
| A | | | unregister | | |
|-------+-----------| | |<----------->| | |
| V | | | | | |
| | | | | | |
| | | | AreYouThere | | |
| TCP/IP layers | | | open | | |
| Kernel | | | register | | |
| | | |<------------| | |
*------------------------------* *-------------------*
*---------------------------------* | | | SNMPネットワーク| | 管理局| | | |---------------------------------| | SNMPプロトコル| *---------------------------------* A| Aを手に入れてください。| | GetNext| GetResponse罠| | GetBulk| | | セットします。| | V| *------------------------------* *-------------------* | SNMPプロトコル| | dpiインタフェース| |------------------------------| 応答| *--------------| | | | <、-、-、-、-、-、-、-、-、-、--、>|、|、|、|、|、|、|、|、|、| SNMPエージェント| | | | | | | | GetNext、得てください。| | | | | | (GetBulk) | | クライアント| | | | セットしてください、そして、公約してください。| | | | *-----------+->。| アンドゥ| | | | | | /を設定させてください。| |、-、-、-、-、-、-、-、-、-、-、--、>|、| または| | 罠| | インフォメーション| | | | | | | | | SNMP| | | | |-----+-----+-------* | | 罠| | SNMP| | | V| | dpi| <、-、-、-、-、-、-、-、-、-、-、--、|、| サブエージェント| | | | | | | | | 静的にリンクされます。| | | | | | | 計装| | | | | | | (MIB IIのような) | | | | | | | | | | 閉鎖| | | | A| | | 「非-レジスタ」| | | |-------+-----------| | | <、-、-、-、-、-、-、-、-、-、--、>|、|、|、| V| | | | | | | | | | | | | | | | | AreYouThere| | | | TCP/IP層| | | 戸外| | | | カーネル| | | レジスタ| | | | | | | <、-、-、-、-、-、-、-、-、-、-、--、|、|、| *------------------------------* *-------------------*
-------------------------------------------------------------------
Figure 1. SNMP DPI overview
------------------------------------------------------------------- 図1。 SNMP DPI概要
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 8] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[8ページ]RFC1592SNMP-dpi行進1994
Remarks for Figure 1:
図1のための所見:
o The SNMP agent communicates with the SNMP manager via the
standard SNMP protocol.
o The SNMP agent communicates with some statically linked-in
instrumentation (potentially for the MIB II), which in turn
talks to the TCP/IP layers and kernel (operating system) in an
implementation-dependent manner.
o An SNMP sub-agent, running as a separate process (potentially
on another machine), can set up a connection with the agent.
The sub-agent has an option to communicate with the SNMP agent
through UDP or TCP sockets, or even through other mechanisms.
o Once the connection is established, the sub-agent issues a DPI
OPEN and one or more REGISTER requests to register one or more
MIB sub-trees with the SNMP agent.
o The SNMP agent responds to DPI OPEN and REGISTER requests with
a RESPONSE packet, indicating success or failure.
o The SNMP agent will decode SNMP packets.
If such a packet contains a Get or GetNext request for an
object in a sub-tree registered by a sub-agent, it sends a
corresponding DPI packet to the sub-agent.
If the request is for a GetBulk, then the agent translates it
into multiple DPI GETNEXT packets and sends those to the
sub-agent. However, the sub-agent can request (in the REGISTER
packet) that a GETBULK be passed to the sub-agent.
If the request is for a Set, then the agent uses a 2-phase
commit scheme and sends the sub-agent a sequence of SET/COMMIT,
SET/UNDO or SET/COMMIT/UNDO DPI packets.
o The SNMP sub-agent sends responses back via a RESPONSE packet.
o The SNMP agent then encodes the reply into an SNMP packet and
sends it back to the requesting SNMP manager.
o If the sub-agent wants to report an important state change, it
sends a DPI TRAP packet to the SNMP agent which will encode it
into an SNMP trap packet and send it to the manager(s).
o If the sub-agent wants to stop operations, it sends a DPI
UNREGISTER and a DPI CLOSE packet to the agent. The agent
sends a response to an UNREGISTER request.
o There is no RESPONSE to a CLOSE, the agent just closes the DPI
connection. A CLOSE implies an UNREGISTER for all
registrations that exist for the DPI connection being CLOSED.
o An agent can send DPI UNREGISTER (if a higher priority
registration comes in or for other reasons) to the sub-agent,
the sub-agent then responds with a DPI RESPONSE packet.
o An agent can also (for whatever reason) send a DPI CLOSE to
indicate it is terminating the DPI connection.
o A sub-agent can send an ARE_YOU_THERE to verify that the
"connection" is still open. If so, the agent sends a RESPONSE
with no error, otherwise, it may send a RESPONSE with an error
o ○ SNMPエージェントが何らかの静的にリンクされた計装で交信する、(潜在的に、MIB II)、aとして別々の状態で稼働して、o An SNMPサブエージェントが処理してください、(潜在的にオンである、別のマシン)、エージェントとのセットアップされたa接続はそうすることができます。SNMPエージェントは標準のSNMPプロトコルでSNMPマネージャとコミュニケートします。どれが実装依存する方法で順番にTCP/IP層とカーネル(オペレーティングシステム)と話しますか? SNMPエージェントはRESPONSEパケットでDPI OPENとREGISTER要求に応じます、成否を示して。サブエージェントには、UDPかTCPソケットを通してSNMPエージェントと伝えるオプションがあるか、または他のメカニズムo Onceさえを通して、接続は確立されます、DPI OPENと1REGISTERが1つ以上のMIB下位木をSNMPエージェントに登録するよう要求するサブエージェント問題。○ ○ SNMPエージェントはSNMPパケットを解読するでしょう。 そのようなパケットがサブエージェントによって登録された下位木にオブジェクトを求めるGetかGetNext要求を含んでいるなら、それは対応するDPIパケットをサブエージェントに送ります。 要求がGetBulkのためのものであるなら、エージェントは、複数のDPI GETNEXTパケットにそれを翻訳して、サブエージェントにそれらを送ります。 しかしながら、サブエージェントは、GETBULKがサブエージェントに渡されるよう要求できます(REGISTERパケットで)。 要求がSetのためのものであるなら; ○ 次に、2フェーズが遂行するエージェント用途は、SET/COMMIT(SET/UNDOかSET/COMMIT/UNDO DPIパケット)の系列をサブエージェントに計画して、送って、SNMPサブエージェントはRESPONSEパケットを通して応答を返送します。○ SNMPエージェントは、次に、SNMPパケットに回答をコード化して、要求しているSNMPマネージャにそれを送り返します; ○ サブエージェントのIfは重要な州の変化を報告したがっていて、SNMPエージェントへのSNMP罠パケットにそれをコード化して、それをマネージャに送るDPI TRAPパケットを送ります。○ サブエージェントのIfは操作を止めたがっていて、それはDPI UNREGISTERとDPI CLOSEパケットをエージェントに送ります。 エージェントはUNREGISTER要求に応答を送ります。o ThereがCLOSEへのRESPONSEでない、エージェントはただDPI接続を終えます。 CLOSEはCLOSEDであるDPI接続のために存在するすべての登録証明書のためにUNREGISTERを含意します。o AnエージェントはDPI UNREGISTER(より高い優先権登録が理由か他の理由で来るなら)をサブエージェントに送ることができます、次に、サブエージェントがDPI RESPONSEパケットで応じます。また、o Anエージェントは、DPI接続を終えているのを示すためにDPI CLOSEを送ることができます(いかなる理由でも)。o Aサブエージェントが発信できる、__あなたは「接続」がまだ開いていることを確かめるTHEREですか? そうだとすれば、エージェントは誤りなしでRESPONSEを送ります。さもなければ、それは誤りと共にRESPONSEを送るかもしれません。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 9] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[9ページ]RFC1592SNMP-dpi行進1994
indication, or not react at all.
指示であるか否かに関係なく、全く反応してください。
3. SNMP DPI PROTOCOL
3. SNMP dpiプロトコル
This section describes the actual protocol used between the SNMP agent and sub-agents.
このセクションはSNMPエージェントとサブエージェントの間で使用される実際のプロトコルについて説明します。
3.1 CONNECTION ESTABLISHMENT
3.1 コネクション確立
In a TCP/IP environment, the SNMP agent listens on an arbitrary TCP/UDP port for a connection request from a sub-agent. It is important to realize that a well-known port is not used: every invocation of the SNMP agent will potentially result in a different TCP/UDP port being used.
TCP/IP環境で、SNMPエージェントはサブエージェントからの接続要求のために任意のTCP/UDPポートの上で聴きます。 ウェルノウンポートが使用されていないとわかるのは重要です: SNMPエージェントのあらゆる実施が潜在的に使用される異なったTCP/UDPポートをもたらすでしょう。
A sub-agent needs to determine this port number to establish a connection. The sub-agent learns the port number from the agent by sending it one conventional SNMP get-request PDU. The port numbers are maintained by the SNMP agent as the objects whose identifiers are:
サブエージェントは、取引関係を築くことをこのポートナンバーに決定する必要があります。 サブエージェントは、エージェントから1要求を得ている従来のSNMP PDUをそれに送ることによって、ポートナンバーを学びます。 ポートナンバーは識別子があるオブジェクトとしてSNMPエージェントによって維持されます:
1.3.6.1.4.1.2.2.1.1.0 dpiPort.0 (old DPI 1.x form)
1.3.6.1.4.1.2.2.1.1.1.0 dpiPortForTCP.0
1.3.6.1.4.1.2.2.1.1.2.0 dpiPortForUDP.0
1.3.6.1.4.1.2.2.1.1.0 dpiPort.0(古いDPI 1.xは形成します)1.3.6.1.4.1.2.2.1.1.1.0dpiPortForTCP.0 1.3.6.1.4.1.2.2.1.1.2.0dpiPortForUDP.0
These variables are registered under the IBM enterprise-specific tree. See 4, "DPI 2.0 MIB definition" for more information. The SNMP agent replies with a conventional SNMP response PDU that contains the port number to be used. This response is examined by the sub-agent and the port number is extracted. The sub-agent then establishes the connection to the specified port.
これらの変数はIBMの企業特有の木の下に示されます。 4、詳しい情報のための「DPI2.0MIB定義」を見てください。 SNMPエージェントは使用されるべきポートナンバーを含む従来のSNMP応答PDUと共に返答します。 この応答はサブエージェントによって調べられます、そして、ポートナンバーは抽出されます。 そして、サブエージェントは指定されたポートに接続を確立します。
On the surface, this procedure appears to mean that the sub-agent must be able to create and parse SNMP packets, but this is not the case. A DPI Application Programming Interface (API) normally provides a library routine, query_DPI_port(), which can be used to generate and parse the required SNMP packets. This very small routine (under 100 lines of C), does not greatly increase the size of any sub-agent.
表面では、この手順がサブエージェントがSNMPパケットを作成して、分析できなければならないことを意味するように見えますが、これはそうではありません。 通常、DPI Application Programming Interface(API)はライブラリ・ルーチン、必要なSNMPパケットを生成して、分析するのに使用できる質問_DPI_ポート()を提供します。 この非常に小さいルーチン、(下100は、C)に立ち並んでいて、どんなサブエージェントのサイズも大いに増強しません。
NOTE: Since this RFC does not define an API, the actual code of and interface to a query_DPI_port() type of function depends on the implementation.
以下に注意してください。 _このRFCが質問_DPIへのAPI、実際のコード、およびインタフェースを定義しないので、機能のポート()タイプは実装を当てにします。
For completeness, byte-by-byte descriptions of the packets to be generated by an SNMP DPI API routine query_DPI_port() are provided below. This is probably of little interest to most readers and reading the source of a query_DPI_port() function provides much of
完全性において、バイトごとのSNMP DPI APIの通常の質問_DPI_ポート()によって生成されるパケットの記述を以下に提供します。 これはたぶん質問_DPI_ポート()機能の源がたくさん提供するほとんどの読者と読書へのわずかの関心のものです。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 10] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[10ページ]RFC1592SNMP-dpi行進1994
the same information.
同じ情報。
3.1.1 SNMP PDU TO GET THE AGENT'S DPI PORT
3.1.1 エージェントのdpiポートを手に入れるSNMP PDU
As noted, before a TCP/UDP connection to the SNMP agent can be made, the sub-agent must learn which port that the agent is listening on. To do so, it can issue an SNMP GET for the variable dpiPortForTCP.0 (1.3.6.1.4.1.2.2.1.1.1.0) or variable dpiPortForUDP.0 (1.3.6.1.4.1.2.2.1.1.2.0).
注意されるように、SNMPエージェントとのTCP/UDP接続を作ることができる前にサブエージェントはエージェントが聴いているどのポートを学ばなければならないか。 そうするために、可変dpiPortForTCP.0のためにSNMP GETを発行できる、(1.3の.2の.1の.1の.1の.0か).6の可変.1の.4の.1の.2のdpiPortForUDP.0、(1.3 .6 .1 .4 .1 .2 .2 .1 .1 .2 .0)。
The SNMP PDU can be constructed as shown below. This PDU must be sent to UDP port 161 on the host where the agent runs (probably the same host where the sub-agent runs).
以下に示すようにSNMP PDUを組み立てることができます。 ホストの上のエージェントが走るUDPポート161(たぶんサブエージェントが走る同じホスト)にこのPDUを送らなければなりません。
The (SNMPv1) packet shown below is for the TCP port.
TCPポートには以下で見せられた(SNMPv1)パケットがあります。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 11] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[11ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 1 (Page 1 of 2). SNMP GET PDU for dpiPortForTCP.0 |
+---------------+----------------+--------------------------------+
| OFFSET | VALUE | FIELD |
+---------------+----------------+--------------------------------+
| 0 | 0x30 | ASN.1 header |
+---------------+----------------+--------------------------------+
| 1 | 37 + len | PDU_length, see formula below |
+---------------+----------------+--------------------------------+
| 2 | 0x02 0x01 0x00 | SNMP version: |
| | | (integer,length=1,value=0) |
+---------------+----------------+--------------------------------+
| 5 | 0x04 | community name (string) |
+---------------+----------------+--------------------------------+
| 6 | len | length of community name |
+---------------+----------------+--------------------------------+
| 7 | community name | varies |
+---------------+----------------+--------------------------------+
| 7 + len | 0xa0 0x1c | SNMP GET request: |
| | | request_type=0xa0,length=0x1c |
+---------------+----------------+--------------------------------+
| 7 + len + 2 | 0x02 0x01 0x01 | SNMP request ID: |
| | | integer,length=1,ID=1 |
+---------------+----------------+--------------------------------+
| 7 + len + 5 | 0x02 0x01 0x00 | SNMP error status: |
| | | integer,length=1,error=0 |
+---------------+----------------+--------------------------------+
| 7 + len + 8 | 0x02 0x01 0x00 | SNMP index: |
| | | integer,length=1,index=0 |
+---------------+----------------+--------------------------------+
| 7 + len + 11 | 0x30 0x11 | varBind list, length=0x11 |
+---------------+----------------+--------------------------------+
| 7 + len + 13 | 0x30 0x0f | varBind, length=0x0f |
+---------------+----------------+--------------------------------+
| 7 + len + 15 | 0x06 0x0b | Object ID, length=0x0b |
+---------------+----------------+--------------------------------+
+-----------------------------------------------------------------+ | テーブル1 (1/2ページ。) SNMPはdpiPortForTCP.0のためにPDUを手に入れます。| +---------------+----------------+--------------------------------+ | 相殺されます。| 値| 分野| +---------------+----------------+--------------------------------+ | 0 | 0×30| ASN.1ヘッダー| +---------------+----------------+--------------------------------+ | 1 | 37 + len| PDU_長さ、以下の公式を見てください。| +---------------+----------------+--------------------------------+ | 2 | 0×02 0×01 0×00| SNMPバージョン: | | | | (整数、長さ=1、値の=0) | +---------------+----------------+--------------------------------+ | 5 | 0×04| 共同体名(ストリング)| +---------------+----------------+--------------------------------+ | 6 | len| 共同体名の長さ| +---------------+----------------+--------------------------------+ | 7 | 共同体名| 異なります。| +---------------+----------------+--------------------------------+ | 7 + len| 0xa0 0x1c| SNMP GETは以下を要求します。 | | | | _タイプが0xa0と等しいよう要求してください、そして、長さは0x1cと等しいです。| +---------------+----------------+--------------------------------+ | 7+len+2| 0×02 0×01 0×01| SNMPはIDを要求します: | | | | 整数、長さ=1、ID=1| +---------------+----------------+--------------------------------+ | 7+len+5| 0×02 0×01 0×00| SNMPエラー状況: | | | | 1、整数、長さ=誤り=0| +---------------+----------------+--------------------------------+ | 7+len+8| 0×02 0×01 0×00| SNMPは索引をつけます: | | | | 整数、長さ=1は=0に索引をつけます。| +---------------+----------------+--------------------------------+ | 7+len+11| 0×30 0×11| varBindリスト、長さ=0×11| +---------------+----------------+--------------------------------+ | 7+len+13| 0×30 0x0f| varBind、長さ=0x0f| +---------------+----------------+--------------------------------+ | 7+len+15| 0×06 0x0b| オブジェクトID、長さ=の0x0b| +---------------+----------------+--------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 12] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[12ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 1 (Page 2 of 2). SNMP GET PDU for dpiPortForTCP.0 |
+---------------+----------------+--------------------------------+
| OFFSET | VALUE | FIELD |
+---------------+----------------+--------------------------------+
| 7 + len + 17 | 0x2b 0x06 0x01 | Object-ID: |
| | 0x04 0x01 0x02 | 1.3.6.1.4.1.2.2.1.1.1 |
| | 0x02 0x01 0x01 | Object-instance: 0 |
| | 0x01 0x00 | |
+---------------+----------------+--------------------------------+
| 7 + len + 28 | 0x05 0x00 | null value, length=0 |
+---------------+----------------+--------------------------------+
| NOTE: Formula to calculate "PDU_length": |
| |
| PDU_length = length of version field and string tag (4 bytes)|
| + length of community length field (1 byte) |
| + length of community name (depends...) |
| + length of SNMP GET request (32 bytes) |
| |
| = 37 + length of community name |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | テーブル1 (2/2ページ。) SNMPはdpiPortForTCP.0のためにPDUを手に入れます。| +---------------+----------------+--------------------------------+ | 相殺されます。| 値| 分野| +---------------+----------------+--------------------------------+ | 7+len+17| 0x2b0x06 0×01| オブジェクトID: | | | 0×04 0×01 0×02| 1.3.6.1.4.1.2.2.1.1.1 | | | 0×02 0×01 0×01| オブジェクトインスタンス: 0 | | | 0×01 0×00| | +---------------+----------------+--------------------------------+ | 7+len+28| 0×05 0×00| ヌル値、長さ=0| +---------------+----------------+--------------------------------+ | 以下に注意してください。 「PDU_長さ」について計算する公式: | | | | PDU_長さはバージョン分野とストリングタグ(4バイト)の長さと等しいです。| | + 共同体長さの分野(1バイト)の長さ| | + 共同体名(よる)の長さ | | + SNMP GET要求(32バイト)の長さ| | | | = 37 + 共同体名の長さ| +-----------------------------------------------------------------+
3.1.2 SNMP PDU CONTAINING THE RESPONSE TO THE GET
3.1.2 応答を含むSNMP PDU、得る。
Assuming that no errors occurred, the port is returned in the last few octets of the received packet. In the simple case, where the port number will be between 1024 and 16,385, the format of the packet is shown below.
誤りが全く発生しなかったと仮定して、容認されたパケットの最後のわずかな八重奏でポートを返します。 簡単な場合では、パケットの書式は以下に示されます。そこでは、ポートナンバーは、1024年から1万6385になるでしょう。
Note: In practice, the port number can be any positive number in the range from 1 through 65,535. A port number of 0 means that the agent does not have a dpiPort defined for the requested protocol. So the actual port value maybe in the last 1, 2 or 3 octets. The sample implementation code shows how to handle the response to cover all those cases, including error conditions.
以下に注意してください。 実際には、ポートナンバーは1〜6万5535の範囲のどんな正の数であるかもしれません。 0のポートナンバーは、エージェントが要求されたプロトコルのためにdpiPortを定義させないことを意味します。 それで、実際のポートは多分最後の1、2または3で八重奏を評価します。 サンプル実装コードは、エラー条件を含むそれらのすべてのケースをカバーするためにどのように応答を扱うかを示します。
Note: The (SNMPv1) packet shown below is for the TCP port.
以下に注意してください。 TCPポートには以下で見せられた(SNMPv1)パケットがあります。
+-----------------------------------------------------------------+
| Table 2 (Page 1 of 3). SNMP RESPONSE PDU for dpiPortForTCP.0 |
+---------------+----------------+--------------------------------+
| OFFSET | VALUE | FIELD |
+---------------+----------------+--------------------------------+
| 0 | 0x30 | ASN.1 header |
+---------------+----------------+--------------------------------+
| 1 | 39 + len | length, see formula below |
+---------------+----------------+--------------------------------+
+-----------------------------------------------------------------+ | テーブル2 (1/3ページ。) dpiPortForTCP.0のためのSNMP応答PDU| +---------------+----------------+--------------------------------+ | 相殺されます。| 値| 分野| +---------------+----------------+--------------------------------+ | 0 | 0×30| ASN.1ヘッダー| +---------------+----------------+--------------------------------+ | 1 | 39 + len| 長さ、以下の公式を見てください。| +---------------+----------------+--------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 13] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[13ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 2 (Page 2 of 3). SNMP RESPONSE PDU for dpiPortForTCP.0 |
+---------------+----------------+--------------------------------+
| OFFSET | VALUE | FIELD |
+---------------+----------------+--------------------------------+
| 2 | 0x02 0x01 0x00 | version |
| | | (integer,length=1,value=0) |
+---------------+----------------+--------------------------------+
| 5 | 0x04 | community name (string) |
+---------------+----------------+--------------------------------+
| 6 | len | length of community name |
+---------------+----------------+--------------------------------+
| 7 | community name | |
+---------------+----------------+--------------------------------+
| 7 + len | 0xa2 0x1e | SNMP RESPONSE: |
| | | request_type=0xa2,length=0x1e |
+---------------+----------------+--------------------------------+
| 7 + len + 2 | 0x02 0x01 0x01 | SNMP request ID: |
| | | integer,length=1,ID=1 |
+---------------+----------------+--------------------------------+
| 7 + len + 5 | 0x02 0x01 0x00 | SNMP error status: |
| | | integer,length=1,error=0 |
+---------------+----------------+--------------------------------+
| 7 + len + 8 | 0x02 0x01 0x00 | SNMP index: |
| | | integer,length=1,index=0 |
+---------------+----------------+--------------------------------+
| 7 + len + 11 | 0x30 0x13 | varBind list, length=0x13 |
+---------------+----------------+--------------------------------+
| 7 + len + 13 | 0x30 0x11 | varBind, length=0x11 |
+---------------+----------------+--------------------------------+
| 7 + len + 15 | 0x06 0x0b | Object ID, length=0x0b |
+---------------+----------------+--------------------------------+
| 7 + len + 17 | 0x2b 0x06 0x01 | Object-ID: |
| | 0x04 0x01 0x02 | 1.3.6.1.4.1.2.2.1.1.1 |
| | 0x02 0x01 0x01 | Object-instance: 0 |
| | 0x01 0x00 | |
+---------------+----------------+--------------------------------+
| 7 + len + 28 | 0x02 0x02 | integer, length=2 |
+---------------+----------------+--------------------------------+
| 7 + len + 30 | MSB LSB | port number (MSB, LSB) |
+---------------+----------------+--------------------------------+
+-----------------------------------------------------------------+ | テーブル2 (2/3ページ。) dpiPortForTCP.0のためのSNMP応答PDU| +---------------+----------------+--------------------------------+ | 相殺されます。| 値| 分野| +---------------+----------------+--------------------------------+ | 2 | 0×02 0×01 0×00| バージョン| | | | (整数、長さ=1、値の=0) | +---------------+----------------+--------------------------------+ | 5 | 0×04| 共同体名(ストリング)| +---------------+----------------+--------------------------------+ | 6 | len| 共同体名の長さ| +---------------+----------------+--------------------------------+ | 7 | 共同体名| | +---------------+----------------+--------------------------------+ | 7 + len| 0xa2 0x1e| SNMP応答: | | | | _タイプが0xa2と等しいよう要求してください、そして、長さは0x1eと等しいです。| +---------------+----------------+--------------------------------+ | 7+len+2| 0×02 0×01 0×01| SNMPはIDを要求します: | | | | 整数、長さ=1、ID=1| +---------------+----------------+--------------------------------+ | 7+len+5| 0×02 0×01 0×00| SNMPエラー状況: | | | | 1、整数、長さ=誤り=0| +---------------+----------------+--------------------------------+ | 7+len+8| 0×02 0×01 0×00| SNMPは索引をつけます: | | | | 整数、長さ=1は=0に索引をつけます。| +---------------+----------------+--------------------------------+ | 7+len+11| 0×30 0×13| varBindリスト、長さ=0×13| +---------------+----------------+--------------------------------+ | 7+len+13| 0×30 0×11| varBind、長さ=0×11| +---------------+----------------+--------------------------------+ | 7+len+15| 0×06 0x0b| オブジェクトID、長さ=の0x0b| +---------------+----------------+--------------------------------+ | 7+len+17| 0x2b0x06 0×01| オブジェクトID: | | | 0×04 0×01 0×02| 1.3.6.1.4.1.2.2.1.1.1 | | | 0×02 0×01 0×01| オブジェクトインスタンス: 0 | | | 0×01 0×00| | +---------------+----------------+--------------------------------+ | 7+len+28| 0×02 0×02| 整数、長さ=2| +---------------+----------------+--------------------------------+ | 7+len+30| MSB LSB| ポートナンバー(MSB、LSB)| +---------------+----------------+--------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 14] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[14ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 2 (Page 3 of 3). SNMP RESPONSE PDU for dpiPortForTCP.0 |
+---------------+----------------+--------------------------------+
| NOTE: Formula to calculate "PDU_length": |
| |
| PDU_length = length of version field and string tag (4 bytes)|
| + length of community length field (1 byte) |
| + length of community name (depends...) |
| + length of SNMP RESPONSE (34 bytes) |
| |
| = 39 + length of community name |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | テーブル2 (3/3ページ。) dpiPortForTCP.0のためのSNMP応答PDU| +---------------+----------------+--------------------------------+ | 以下に注意してください。 「PDU_長さ」について計算する公式: | | | | PDU_長さはバージョン分野とストリングタグ(4バイト)の長さと等しいです。| | + 共同体長さの分野(1バイト)の長さ| | + 共同体名(よる)の長さ | | + SNMP RESPONSE(34バイト)の長さ| | | | = 39 + 共同体名の長さ| +-----------------------------------------------------------------+
3.2 SNMP DPI PACKET FORMATS
3.2 SNMP dpiパケット・フォーマット
Each request to, or response from, the agent or sub-agent is constructed as a "packet" and is written to the stream.
各要求、応答、エージェントかサブエージェントが、「パケット」として組み立てられて、ストリームに書かれています。
Each packet is prefaced with the length of the data remaining in the packet. The length is stored in network byte order, the most significant byte (MSB) first, least significant byte (LSB) last. If we consider a stream connection (like TCP), the receiving side will read the packet by doing something similar to:
データの長さがパケットに残っていて、各パケットは前書きされます。 長さは最後にネットワークバイトオーダー、バイト(MSB)最も重要な1番目、最も重要でないバイト(LSB)で保存されます。 私たちが、ストリームが接続(TCPのような)であると考えると、受信側は、以下のことのために何か同様のことをすることによって、パケットを読むでしょう。
unsigned char len_bfr[2];
unsigned char *bfr;
int len;
未署名の炭のlen_bfr[2]。 未署名の炭*bfr。 int len。
read(fd,len_bfr,2);
len = len_bfr[0] * 256 + len_bfr[1];
bfr = malloc(len);
read(fd,bfr,len);
(fd、len_bfr、2)は読みます。 lenはlen_bfr[0]*256+len_bfr[1]と等しいです。 bfrはmalloc(len)と等しいです。 (fd、bfr、len)は読みます。
Note: The above example makes no provisions for error handling or a read returning less than the requested amount of data,and it is not intended to be used literally.
以下に注意してください。 上記の例は要求されたデータ量ほど戻らないエラー処理か読書に備えません、そして、文字通り使用されることを意図しません。
3.2.1 DPI PACKET HEADER
3.2.1 dpiパケットのヘッダー
The first part of every packet identifies the application protocol being used as well as some version information. The protocol major version is intended to indicate, in broad terms, what version of the protocol is used. The protocol minor version is intended to identify major incompatible versions of the protocol. The protocol release is intended to indicate incremental modifications to the protocol. The constants that are valid for these fields are defined in Table 15.
あらゆるパケットの最初の一部が何らかのバージョン情報と同様に使用されるアプリケーション・プロトコルを特定します。 プロトコルの主要なバージョンが、プロトコルのどんなバージョンが使用されているかを広義語で示すことを意図します。 プロトコルの小さい方のバージョンがプロトコルの主要な両立しないバージョンを特定することを意図します。 プロトコルリリースがプロトコルへの増加の変更を示すことを意図します。 これらの分野に、有効な定数はTable15で定義されます。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 15] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[15ページ]RFC1592SNMP-dpi行進1994
The next field, present in all packets, is the packet ID. It contains packet identification that can help an agent or sub-agent match responses with request. This is useful with UDP connections over which packets can be lost. The packet ID is a monotonically increasing unsigned 16-bit integer which wraps at its maximum value.
次のすべてのパケットに存在している分野はパケットIDです。 それはエージェントかサブエージェントが要求に応答に合っているのを助けることができるパケット識別を含んでいます。 パケットが失われる場合があるUDP接続において、これは役に立ちます。 パケットIDは16ビットの単調に増加する未署名の整数です。最大値におけるそれの機密。
The next field, present in all packets, is the packet type. It indicates what kind of packet we're dealing with (OPEN, REGISTER, GET, GETNEXT, GETBULK, SET, COMMIT, UNDO, TRAP, RESPONSE, UNREGISTER, or CLOSE). The permitted values for this field are defined in Table 16.
次のすべてのパケットに存在している分野はパケットタイプです。 それは、私たちがどういうパケットに対処しているかを(オープン、REGISTER、GET、GETNEXT、GETBULK、SET、COMMIT、UNDO、TRAP、RESPONSE、UNREGISTER、またはCLOSE)示します。 この分野への受入れられた値はTable16で定義されます。
+-----------------------------------------------------------------+
| Table 3. SNMP DPI packet header. Present in all packets. |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type |
+------------+----------------------------------------------------+
+-----------------------------------------------------------------+ | 3を見送ってください。 SNMP DPIパケットのヘッダー。 すべてのパケットでは、存在しています。 | +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプ| +------------+----------------------------------------------------+
From this point onwards, the contents of the packet are defined by the protocol being used. The remainder of this section describes:
このポイントから、前方へ、パケットの内容は使用されるプロトコルによって定義されます。 このセクションの残りは以下について説明します。
o Layout of packets for the SNMP DPI protocol, version 2.0.
o SNMP DPIプロトコルのためのパケットのレイアウト、バージョン2.0。
o Constants as defined with this version of the protocol.
o プロトコルのこのバージョンで定義される定数。
3.2.2 OPEN
3.2.2 戸外
In order for a sub-agent to communicate with a DPI capable SNMP agent, it must first send an SNMP DPI OPEN request to the agent to setup the "connection" with that agent.
DPI有能なSNMPエージェントと伝えるサブエージェントにとって整然とします、それは最初に、そのエージェントとの「接続」をセットアップするためにSNMP DPI OPEN要求をエージェントに送らなければなりません。
Such a packet contains the standard SNMP DPI header plus OPEN specific data. This data consists of:
そのようなパケットは標準のSNMP DPIヘッダーとオープンの特定のデータを含んでいます。 このデータは以下から成ります。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 16] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[16ページ]RFC1592SNMP-dpi行進1994
o a timeout value (in seconds).
This is a requested timeout value to be used for all requests
for objects for which there is no timeout value specified for
the sub-tree under which the object is registered. If you
specify a zero timeout value, then the agent will use its own
default timeout value. If you want a larger value than the
default value, then you can specify it here. However, the agent
may have a maximum value that you can never exceed. If you do
ask for a larger timeout than that maximum, the agent will set
it at the maximum it accepts.
o the maximum number of varBinds per DPI packet that the
sub-agent is prepared to handle.
o Selected character set to be used for the representation of the
OBJECT ID strings and DisplayStrings.
The choices are the native character set (0) or the ASCII
character set (1). See 3.3.5, "Character set selection"
for more information in character set selection.
An agent may choose to support only the native character set.
o null terminated sub-agent ID, which is a unique ASN.1 OBJECT
identifier, so in dotted ASN.1 notation. This string is
represented in the selected character set.
o null terminated sub-agent description, which is a DisplayString
describing the sub-agent. This string is represented in the
selected character set. This may be the null-string if there
is no description.
o optionally a password that the agent uses to validate the
sub-agent. It depends on the agent implementation if a
password is required. If no password is passed, the length
must be specified as zero.
o タイムアウト値(秒の)。 これはオブジェクトが登録されている下位木に指定されたタイムアウト値が全くないオブジェクトを求めるすべての要求に使用されるべき要求されたタイムアウト値です。 あなたがゼロを指定すると、次に、タイムアウト値、エージェントはそれ自身のデフォルトタイムアウト価値を使用するでしょう。 デフォルト値より大きい値が欲しいなら、あなたはここでそれを指定できます。 しかしながら、エージェントには、あなたが決して超えることができない最大値があるかもしれません。 あなたがその最大より大きいタイムアウトを求めると、エージェントは. ○ サブエージェントがDPIパケットあたりのvarBindsの最大数ですが、ハンドルOBJECT IDストリングの表現に使用されるべきo Selected文字集合とDisplayStringsに準備されて、それが受け入れる最大でそれを設定するでしょう。 選択は、ネイティブの文字集合(0)かASCII文字の組(1)です。 .5、詳しい情報のための「文字集合選択」がぴったりした選択を設定したのを3.3に確実にしてください。 エージェントは、ネイティブの文字集合だけをサポートするのを選ぶかもしれません。oヌルは点を打たされたASN.1記法でサブエージェントIDを終えました。(それは、ユニークなASN.1OBJECT識別子です)。 このストリングは選択された文字集合で表されます。oヌルはサブエージェント記述を終えました。(それは、サブエージェントについて説明するDisplayStringです)。 このストリングは選択された文字集合で表されます。 記述いいえ、oが任意にあれば、これはヌルストリングであるかもしれません。エージェントがサブエージェントを有効にするのに使用するパスワード。 パスワードが必要であるなら場合によりけりですエージェント実装で。 パスワードが全く通過されないなら、ゼロとして長さを指定しなければなりません。
The sub-agent must expect a response indicating success or failure. See Table 19 for the valid codes in a DPI RESPONSE to a DPI OPEN request.
サブエージェントは成否を示す応答を予想しなければなりません。 DPI OPEN要求へのDPI RESPONSEの有効なコードに関してTable19を見てください。
If the error_code in the RESPONSE is not SNMP_ERROR_DPI_noError, then the agent closes the connection.
RESPONSEの誤り_コードがSNMP_ERROR_DPI_noErrorでないなら、エージェントは接続を終えます。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 17] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[17ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 4. Layout SNMP DPI OPEN packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_OPEN |
+------------+----------------------------------------------------+
| 8 | requested overall timeout (seconds, MSB to LSB) |
+------------+----------------------------------------------------+
| 10 | max varBinds per DPI packet (MSB to LSB) |
+------------+----------------------------------------------------+
| 12 | Selected character set (0=Native, 1=ASCII) |
+------------+----------------------------------------------------+
| 13 | null terminated sub-agent ID (OID) |
+------------+----------------------------------------------------+
| 13+L1 | null terminated sub-agent Description |
+------------+----------------------------------------------------+
| 13+L2 | password length (zero if no password, MSB to LSB) |
+------------+----------------------------------------------------+
| 15+L2 | password (if any) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o L1 = strlen(sub-agent ID) + 1 |
| o L2 = L1 + strlen(sub-agent Description) + 1 |
| o OID and Description strings use selected character set |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 4を見送ってください。 レイアウトSNMP DPI OPENパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_オープンと等しいです。| +------------+----------------------------------------------------+ | 8 | 要求された総合的なタイムアウト(秒、LSBへのMSB)| +------------+----------------------------------------------------+ | 10 | DPIパケット(LSBへのMSB)あたりの最大varBinds| +------------+----------------------------------------------------+ | 12 | 選択された文字集合(1歳の0=ネイティブはASCIIと等しいです)| +------------+----------------------------------------------------+ | 13 | ヌル終えられたサブエージェントID(OID)| +------------+----------------------------------------------------+ | 13 + L1| ヌル終えられたサブエージェント記述| +------------+----------------------------------------------------+ | 13 + L2| パスワードの長さ、(パスワードがない、LSBへのMSBであるならゼロに合わせる、)| +------------+----------------------------------------------------+ | 15 + L2| (もしあれば)のパスワード| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o L1=は+ (サブエージェントID)1をstrlenします。| | o L2はL1+strlen(サブエージェント記述)+1と等しいです。| | o ストリングが使用するOIDと記述は文字集合を選択しました。| +-----------------------------------------------------------------+
3.2.3 CLOSE
3.2.3 近く
In order for a sub-agent to close the "connection" with the DPI capable SNMP agent, it must send an SNMP DPI CLOSE request to the agent. The agent will not send a response, but closes the physical connection and implicitly unregisters any sub-trees related to the connection.
サブエージェントがDPI有能なSNMPエージェントとの「接続」を閉じるように、それはSNMP DPI CLOSE要求をエージェントに送らなければなりません。 エージェントは、応答を送りませんが、それとなく物理接続を終えます。どんな下位木も接続に関連した「非-レジスタ」。
An agent may also send to the sub-agent an SNMP DPI CLOSE packet that contains the standard SNMP DPI header plus CLOSE specific data. This
また、エージェントは標準のSNMP DPIヘッダーとCLOSEの特定のデータを含むSNMP DPI CLOSEパケットをサブエージェントに送るかもしれません。 これ
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 18] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[18ページ]RFC1592SNMP-dpi行進1994
data consists of:
データは以下から成ります。
o a reason code for closing. See Table 21 for a list
of valid reason codes.
o 閉鎖のための理由コード。 正当な理由コードのリストに関してTable21を見てください。
+-----------------------------------------------------------------+
| Table 5. Layout SNMP DPI CLOSE packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_CLOSE |
+------------+----------------------------------------------------+
| 8 | reason code (1 octet) |
+------------+----------------------------------------------------+
+-----------------------------------------------------------------+ | 5を見送ってください。 レイアウトSNMP DPI CLOSEパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_CLOSEと等しいです。| +------------+----------------------------------------------------+ | 8 | 理由コード(1つの八重奏)| +------------+----------------------------------------------------+
3.2.4 ARE_YOU_THERE
3.2.4 _あなたはそこの_ですか?
An ARE_YOU_THERE packet allows a sub-agent to determine if it still has a DPI connection with the agent. This packet is necessary because a sub-agent passively awaits requests from an agent and normally will not detect problems with an agent connection in a timely manner. (In contrast, an agent becomes aware of any sub-agent connection problem in a timely manner because it sets a timeout when sending request).
_あなたはそれにエージェントとのa DPI接続がまだあるならサブエージェントがTHEREパケットで決定できる_ですか? このパケットは、サブエージェントが要求を受け身に待つのでエージェントから必要であり、通常、エージェント接続と共に問題を直ちに検出しないでしょう。 (要求を送るとき、直ちにタイムアウトを設定するので、対照的に、エージェントはどんなサブエージェント接続問題も意識するようになります。)
A sub-agent can send a SNMP DPI ARE_YOU_THERE packet to an agent which will then return a RESPONSE with a zero error code and a a zero error index if the connection is healthy. Otherwise, the agent may return a RESPONSE with an error indication. If the connection is broken, the sub-agent will see no response at all.
サブエージェントは_あなたにSNMP DPI AREに行かせることができます。_エージェントへの次に接続であるならエラーコードがなくてゼロがあるRESPONSEに誤りインデックスを返すTHEREパケットは健康です。 さもなければ、エージェントは誤り表示と共にRESPONSEを返すかもしれません。 接続が失意であるなら、サブエージェントは応答を全く見ないでしょう。
An ARE_YOU_THERE packet contains the standard SNMP DPI header with no additional data.
_はあなたです。_THEREパケットは追加データなしで標準のSNMP DPIヘッダーを含んでいます。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 19] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[19ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 6. Layout SNMP DPI ARE_YOU_THERE packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_ARE_YOU_THERE |
+------------+----------------------------------------------------+
+-----------------------------------------------------------------+ | 6を見送ってください。 レイアウトSNMP DPI ARE_、あなた、_THEREパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプ=SNMP_DPI_が_である、あなた、_THERE| +------------+----------------------------------------------------+
3.2.5 REGISTER
3.2.5 レジスタ
In order to register a branch in the MIB tree, an SNMP sub-agent sends an SNMP DPI REGISTER packet to the agent.
MIB木にブランチを登録するために、SNMPサブエージェントはSNMP DPI REGISTERパケットをエージェントに送ります。
Such a packet contains the standard SNMP DPI header plus REGISTER specific data. This data consists of:
そのようなパケットは標準のSNMP DPIヘッダーとREGISTERの特定のデータを含んでいます。 このデータは以下から成ります。
o a requested priority.
There are 2 special values, namely minus one (-1, requests best
available priority) and zero (0, requests next better priority
than the highest priority in use). Any other value requests a
specific priority or the next best priority if already in use).
The lower the number, the better the priority. An agent will
send requests to only the one sub-agent that has registered
with the best priority. The agent returns the actual priority
assigned in the RESPONSE packet in the error_index field.
o a requested timeout.
If a zero value is specified, then the agent uses the timeout
value specified in the DPI OPEN request.
If you want a shorter or longer timeout value for this specific
sub-tree, then you specify it here. The agent has a maximum
timeout it will allow in this field. The agent will use this
value (or its maximum) to await a response to requests for this
sub-tree.
o an indication as to whether the sub-agent wishes to handle MIB
view selection (SNMPv1 community string authentication)
in subsequent GET, GETNEXT or SET, COMMIT, UNDO requests. Not
all DPI capable agents need to support this feature, but they
must at least recognize this indication and give an appropriate
o 要求された優先。 2つの特別な値があります、すなわち、1(-1、要求は利用可能な優先権を負かす)とゼロを引いて(0、次の要求は使用中の最優先より優先権を改善します)。 既に使用中であるなら特定の優先か次が優先権を負かすといういかなる他の値の要求) 数が下位であれば下位であるほど、優先権は、より良いです。 エージェントは最も良い優先権とともに記名した1人のサブエージェントだけに要求を送るでしょう。 実際の優先権が誤り_におけるRESPONSEパケットで割り当てたエージェントリターンは分野○ 要求されたタイムアウトに索引をつけます。 ゼロであるなら、値は指定されて、次に、エージェントはDPI OPEN要求で指定されたタイムアウト値を使用します。 この特定の下位木のために、より短いか、より長いタイムアウト値が欲しいなら、あなたはここでそれを指定します。 エージェントには、それがこの分野に許容する最大のタイムアウトがあります。 エージェントは、この下位木を求める要求への応答を待つのに、この値(または、最大)を使用するでしょう。○ サブエージェントがMIBを扱いたがっているかどうかに関する指示はその後のGET、GETNEXTまたはSETで選択(SNMPv1共同体ストリング認証)を見ます、COMMIT、UNDO要求。 DPI有能なエージェントがこの特徴をサポートするために必要とするすべてではなく、彼らがこの指示を少なくとも認識しなければならない、付与、適切
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 20] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[20ページ]RFC1592SNMP-dpi行進1994
response if they do not support it.
o an indication as to whether the sub-agent wishes to handle the
GETBULK itself. If not, then the agent will translate a
GETBULK into multiple GETNEXT requests.
Not all DPI capable agents need to support this feature. They
may opt to always translate a GETBULK into multiple GETNEXT
requests. In this case the agent will send the appropriate
RESPONSE to indicate this.
o the group ID (sub-tree) to be registered (with trailing dot).
The group ID is represented in the selected character set as
specified in DPI OPEN packet.
サブエージェントがそうしたがっているかどうかに関して彼らが. ○ 指示をそれにサポートしないなら、応答はGETBULK自身を扱います。 そうでなければ、そして、エージェントは複数のGETNEXT要求にGETBULKを翻訳するでしょう。 すべてのDPI有能なエージェントが、この特徴をサポートする必要があるというわけではありません。 彼らは、いつも複数のGETNEXT要求にGETBULKを翻訳するために選ぶかもしれません。 この場合、エージェントはこれを示すRESPONSEを適切に送るでしょう。. ○ 登録されるべき(引きずっているドットで)グループID(下位木)。 グループIDはDPI OPENパケットの指定されるとしての選択された文字集合で表されます。
The agent will respond with an SNMP DPI RESPONSE packet indicating registration error or success. The packet ID of the response will be the same as that for the REGISTER request to which this is a response.
SNMP DPI RESPONSEパケットが登録誤りか成功を示していて、エージェントは応じるでしょう。 応答のパケットIDはこれが応答であるREGISTER要求のためのそれと同じになるでしょう。
The group ID will be the same as that specified in the REGISTER request. There will be no instance returned (e.g. NULL string for instance ID). The value will be an SNMP_TYPE_NULL value with a zero length.
グループIDはREGISTER要求で指定されたそれと同じになるでしょう。 返されたインスタンスが全くないでしょう(例えば、NULLは例えばIDを結びます)。 値はゼロ・レングスをもってSNMP_TYPE_NULL価値になるでしょう。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 21] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[21ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 7. Layout SNMP DPI REGISTER packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_REGISTER |
+------------+----------------------------------------------------+
| 8 | requested priority (MSB to LSB) |
+------------+----------------------------------------------------+
| 12 | timeout in seconds (MSB to LSB) |
+------------+----------------------------------------------------+
| 14 | view selection (0 = you (agent) do, 1 = I do) |
+------------+----------------------------------------------------+
| 15 | getbulk selection (0=use GetNext, 1=use GetBulk) |
+------------+----------------------------------------------------+
| 16 | null terminated group ID (with trailing dot) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o group ID string uses selected character set |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 7を見送ってください。 レイアウトSNMP DPI REGISTERパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_REGISTERと等しいです。| +------------+----------------------------------------------------+ | 8 | 要求された優先権(LSBへのMSB)| +------------+----------------------------------------------------+ | 12 | 秒(LSBへのMSB)のタイムアウト| +------------+----------------------------------------------------+ | 14 | 視点選択(あなた(エージェント)がする=、1=私がする0)| +------------+----------------------------------------------------+ | 15 | getbulk選択(0=はGetNextを使用して、1=使用はGetBulkです)| +------------+----------------------------------------------------+ | 16 | ヌル終えられたグループID(引きずっているドットがある)| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o グループIDストリング用途は文字集合を選択しました。| +-----------------------------------------------------------------+
3.2.6 UNREGISTER
3.2.6 UNREGISTER
In order to unregister a branch in the MIB tree, an SNMP sub-agent sends an SNMP DPI UNREGISTER packet to the agent.
MIB木の「非-レジスタ」aブランチ、SNMPサブエージェントはSNMP DPI UNREGISTERパケットをエージェントに送ります。
Such a packet contains the standard SNMP DPI header plus UNREGISTER specific data: a null terminated string (represented in the selected character set) representing the group ID in ASN.1 dotted notation and an indication as to the reason for the unregister (see table 14).
そのようなパケットは標準のSNMP DPIヘッダーとUNREGISTERの特定のデータを含んでいます: ASN.1のグループIDを表すヌル終えられたストリング(選択された文字集合では、表される)は「非-レジスタ」の理由に関して記法と指示に点を打たせました(テーブル14を見てください)。
The agent will respond with an SNMP DPI RESPONSE packet indicating error or success. The packet ID of the response will be the same as that for the UNREGISTER request to which this is a response.
SNMP DPI RESPONSEパケットが誤りか成功を示していて、エージェントは応じるでしょう。 応答のパケットIDはこれが応答であるUNREGISTER要求のためのそれと同じになるでしょう。
The group ID will be the same as that specified in the UNREGISTER request. There will be no instance returned (e.g. NULL string for
グループIDはUNREGISTER要求で指定されたそれと同じになるでしょう。 返されたインスタンスが全くない、(例えば、NULLストリング
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 22] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[22ページ]RFC1592SNMP-dpi行進1994
instance ID). The value will be an SNMP_TYPE_NULL value with a zero length.
インスタンスID) 値はゼロ・レングスをもってSNMP_TYPE_NULL価値になるでしょう。
+-----------------------------------------------------------------+
| Table 8. Layout SNMP DPI UNREGISTER packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_UNREGISTER |
+------------+----------------------------------------------------+
| 8 | reason code |
+------------+----------------------------------------------------+
| 9 | null terminated group ID (with trailing dot) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o group ID string uses selected character set |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 8を見送ってください。 レイアウトSNMP DPI UNREGISTERパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_UNREGISTERと等しいです。| +------------+----------------------------------------------------+ | 8 | 理由コード| +------------+----------------------------------------------------+ | 9 | ヌル終えられたグループID(引きずっているドットがある)| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o グループIDストリング用途は文字集合を選択しました。| +-----------------------------------------------------------------+
3.2.7 GET
3.2.7 得てください。
When the SNMP agent receives a PDU containing an SNMP GET request for a variable that resides in a sub-tree registered by a sub-agent, it passes an SNMP DPI GET packet to the sub-agent.
SNMPエージェントがサブエージェントによって登録された下位木である変数を求めるSNMP GET要求を含むPDUを受け取るとき、それはSNMP DPI GETパケットをサブエージェントに渡します。
Such a packet contains the standard SNMP DPI header plus GET specific data:
そのようなパケットは標準のSNMP DPIヘッダーとGETの特定のデータを含んでいます:
o the community name used in the SNMP PDU. The length is zero
unless view handling was selected by the sub-agent. The length
is also zero if the SNMP PDU was not in SNMPv1 format.
o per varBind two null terminated strings (in the selected
character set) representing the group and instance ID in ASN.1
dotted notation.
o SNMP PDUで使用される共同体名。 視点取り扱いがサブエージェントによって選択されなかったなら、長さはゼロです。 また、SNMPv1形式にSNMP PDUがなかったなら、長さはゼロです。varBind twoヌルあたりのoはグループを代表しながら、ストリング(選択された文字集合における)を終えました、そして、ASN.1のインスタンスIDは記法に点を打たせました。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 23] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[23ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 9. Layout SNMP DPI GET packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_GET |
+------------+----------------------------------------------------+
| 8 | community name length (MSB to LSB) |
+------------+----------------------------------------------------+
| 10 | community name (if any) |
+------------+----------------------------------------------------+
| 10+L1 | null terminated group ID (with trailing dot) |
+------------+----------------------------------------------------+
| 10+L2 | null terminated instance ID (no trailing dot) |
+------------+----------------------------------------------------+
| 10+L3 | optionally more varBinds (group/instance ID pairs) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o L1 = length of community name |
| o L2 = L1 + strlen(group ID) + 1 |
| o L3 = L2 + strlen(instance ID) + 1 |
| o group and instance ID strings use selected character set |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 9を見送ってください。 レイアウトSNMP DPI GETパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_GETと等しいです。| +------------+----------------------------------------------------+ | 8 | 共同体名前の長さ(LSBへのMSB)| +------------+----------------------------------------------------+ | 10 | 共同体名(もしあれば)| +------------+----------------------------------------------------+ | 10 + L1| ヌル終えられたグループID(引きずっているドットがある)| +------------+----------------------------------------------------+ | 10 + L2| ヌル終えられたインスタンスID(引きずっているドットがありません)| +------------+----------------------------------------------------+ | 10 + L3| 任意により多くのvarBinds(グループ/インスタンスID組)| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o L1は共同体名の長さと等しいです。| | o L2はL1+strlen(グループID)+1と等しいです。| | o L3はL2+strlen(インスタンスID)+1と等しいです。| | o ストリングが使用するグループとインスタンスIDは文字集合を選択しました。| +-----------------------------------------------------------------+
3.2.8 GETNEXT
3.2.8 GETNEXT
When the SNMP agent receives a PDU containing an SNMP GETNEXT request for a variable for which a sub-agent may be authoritative, it passes an SNMP DPI GETNEXT packet to the sub-agent.
SNMPエージェントがサブエージェントが正式であるかもしれない変数を求めるSNMP GETNEXT要求を含むPDUを受け取るとき、それはSNMP DPI GETNEXTパケットをサブエージェントに渡します。
Such a packet contains the standard SNMP DPI header plus GETNEXT specific data:
そのようなパケットは標準のSNMP DPIヘッダーとGETNEXTの特定のデータを含んでいます:
o the community name used in the SNMP PDU. The length is zero
unless view handling was selected by the sub-agent. The length
is also zero if the SNMP PDU was not in SNMPv1 format.
o per varBind two null terminated strings (in the selected
o SNMP PDUで使用される共同体名。 視点取り扱いがサブエージェントによって選択されなかったなら、長さはゼロです。 また、SNMPv1形式にSNMP PDUがなかったなら、長さはゼロです。varBind twoヌルあたりのoがストリングを終えた、(選択
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 24] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[24ページ]RFC1592SNMP-dpi行進1994
character set) representing the group and instance ID in ASN.1
dotted notation.
文字集合) ASN.1のグループとインスタンスIDを代表すると、記法は点を打たれました。
+-----------------------------------------------------------------+
| Table 10. Layout SNMP DPI GETNEXT packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_GETNEXT |
+------------+----------------------------------------------------+
| 8 | community name length (MSB to LSB) |
+------------+----------------------------------------------------+
| 10 | community name |
+------------+----------------------------------------------------+
| 10+L1 | null terminated group ID (with trailing dot) |
+------------+----------------------------------------------------+
| 10+L2 | null terminated instance ID (no trailing dot) |
+------------+----------------------------------------------------+
| 10+L3 | optionally more varBinds (group/instance ID pairs) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o L1 = length of community name |
| o L2 = L1 + strlen(group ID) + 1 |
| o L3 = L2 + strlen(instance ID) + 1 |
| o group and instance ID strings use selected character set |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 10を見送ってください。 レイアウトSNMP DPI GETNEXTパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_GETNEXTと等しいです。| +------------+----------------------------------------------------+ | 8 | 共同体名前の長さ(LSBへのMSB)| +------------+----------------------------------------------------+ | 10 | 共同体名| +------------+----------------------------------------------------+ | 10 + L1| ヌル終えられたグループID(引きずっているドットがある)| +------------+----------------------------------------------------+ | 10 + L2| ヌル終えられたインスタンスID(引きずっているドットがありません)| +------------+----------------------------------------------------+ | 10 + L3| 任意により多くのvarBinds(グループ/インスタンスID組)| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o L1は共同体名の長さと等しいです。| | o L2はL1+strlen(グループID)+1と等しいです。| | o L3はL2+strlen(インスタンスID)+1と等しいです。| | o ストリングが使用するグループとインスタンスIDは文字集合を選択しました。| +-----------------------------------------------------------------+
3.2.9 GETBULK
3.2.9 GETBULK
When the SNMP agent receives a PDU containing an SNMP GETBULK request that includes variables for which a sub-agent may be authoritative, it checks if the sub-agent wants to handle the GETBULK itself (as specified at registration time). If so, it sends an SNMP DPI GETBULK packet to the sub-agent.
SNMPエージェントがサブエージェントが正式であるかもしれない変数を含んでいるSNMP GETBULK要求を含むPDUを受け取るとき、それは、サブエージェントがGETBULK自身を扱いたがっているかどうか(登録時に指定されるように)チェックします。 そうだとすれば、それはSNMP DPI GETBULKパケットをサブエージェントに送ります。
Such a packet contains the standard SNMP DPI header plus GETBULK specific data:
そのようなパケットは標準のSNMP DPIヘッダーとGETBULKの特定のデータを含んでいます:
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 25] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[25ページ]RFC1592SNMP-dpi行進1994
o non-repeaters
o max repetitions
o per varBind two null terminated strings (in the selected
character set) representing the group and instance ID in ASN.1
dotted notation.
o varBind twoヌルあたりの非リピータo最大反復oはグループを代表しながら、ストリング(選択された文字集合における)を終えました、そして、ASN.1のインスタンスIDは記法に点を打たせました。
+-----------------------------------------------------------------+
| Table 11. Layout SNMP DPI GETBULK packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_GETBULK |
+------------+----------------------------------------------------+
| 8 | non-repeaters (4 octets, MSB to LSB) |
+------------+----------------------------------------------------+
| 12 | max-repetitions (4 octets, MSB to LSB) |
+------------+----------------------------------------------------+
| 16 | null terminated group ID (with trailing dot) |
+------------+----------------------------------------------------+
| 16+L1 | null terminated instance ID (no trailing dot) |
+------------+----------------------------------------------------+
| 16+L2 | optionally more varBinds (group/instance ID pairs) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o L1 = strlen(group ID) + 1 |
| o L2 = L1 + strlen(instance ID) + 1 |
| o group and instance ID strings use selected character set |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 11を見送ってください。 レイアウトSNMP DPI GETBULKパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_GETBULKと等しいです。| +------------+----------------------------------------------------+ | 8 | 非リピータ(4つの八重奏、LSBへのMSB)| +------------+----------------------------------------------------+ | 12 | 最大反復(4つの八重奏、LSBへのMSB)| +------------+----------------------------------------------------+ | 16 | ヌル終えられたグループID(引きずっているドットがある)| +------------+----------------------------------------------------+ | 16 + L1| ヌル終えられたインスタンスID(引きずっているドットがありません)| +------------+----------------------------------------------------+ | 16 + L2| 任意により多くのvarBinds(グループ/インスタンスID組)| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o L1=は+ (グループID)1をstrlenします。| | o L2はL1+strlen(インスタンスID)+1と等しいです。| | o ストリングが使用するグループとインスタンスIDは文字集合を選択しました。| +-----------------------------------------------------------------+
3.2.10 SET, COMMIT AND UNDO
3.2.10 セットしてください、そして、ANDアンドゥを遂行してください。
When the SNMP agent receives a PDU containing an SNMP SET request for a variable that is in a sub-tree registered by a sub-agent, it passes one of 3 sequences of SNMP DPI packets to the sub-agent:
SNMPエージェントがサブエージェントによって登録された下位木にはある変数を求めるSNMP SET要求を含むPDUを受け取るとき、SNMP DPIパケットの3つの系列の1つをサブエージェントに渡します:
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 26] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[26ページ]RFC1592SNMP-dpi行進1994
o SET, COMMIT
This is the normal sequence. The SET request is the first
phase. The sub-agent must verify that the SET request is valid
and that the resources needed are available. The COMMIT
request comes next. The sub-agent must now effectuate the SET
request.
o SET, UNDO
If an SNMP packet has a SET request for multiple varBinds that
reside in different sub-trees, then the agent first sends a SET
to all sub-agents. If any sub-agent returns an error on the
SET, then the agent sends UNDO to those sub-agents that
returned no error on the SET, meaning the SET is being
canceled.
o SET, COMMIT, UNDO
In the very rare circumstance where all sub-agents have
responded error-free to a SET and where one of them fails to
perform the COMMIT, then the agent sends an UNDO to all
involved sub-agents (also those who completed COMMIT).
Sub-agents should try, to the best of their ability, to never
let a commit fail and to undo an already committed set if asked
to do so.
o SET、COMMIT Thisは正常な系列です。 SET要求は第1段階です。 サブエージェントはSET要求が有効であり、必要であるリソースが利用可能であることを確かめなければなりません。 COMMIT要求は次に、来ます。 サブエージェントは現在SET要求. o SETを実現しなければなりません、UNDO If。SNMPパケットには、複数のvarBindsを求める異なった下位木で住みなさいといって、次に、エージェントが最初にすべてのサブエージェントにSETを送るというSET要求があります。 サブエージェントはいずれかであるならSET(エージェントがSETが取り消されていることを意味して、SETで誤りを全く返さなかったサブエージェントであるものへのUNDOを送るその時)における誤りにo SETを返します、COMMIT、UNDO In。すべてのサブエージェントがSETにエラーのない状態で応じて、彼らのひとりがCOMMITを実行しないで、次に、エージェントがUNDOをすべてに送る非常にまれな状況はサブエージェント(COMMITを完成した人も)にかかわりました。 サブエージェントは、aにやり損ないを決して遂行させないで、そうするように頼まれるなら、できる限り既に遂行されたセットを元に戻そうとするべきです。
Such packets contain the standard SNMP DPI header plus SET specific data:
そのようなパケットは標準のSNMP DPIヘッダーとSETの特定のデータを含んでいます:
o the community name used in the SNMP PDU. The length is zero
unless view handling was selected by the sub-agent. The length
is also zero if the SNMP PDU was not in SNMPv1 format.
o per varBind:
o SNMP PDUで使用される共同体名。 視点取り扱いがサブエージェントによって選択されなかったなら、長さはゼロです。 また、SNMP PDUがSNMPv1形式1varBindあたりのoになかったなら、長さはゼロです:
- two null terminated strings (in the selected character set)
representing the group and instance ID in ASN.1 dotted
notation.
- the type, value length and value to be set.
- 2ヌルはグループを代表しながら、ストリング(選択された文字集合における)を終えました、そして、ASN.1のインスタンスIDは記法に点を打たせました。 - タイプ、値の長さ、および設定されるべき値。
The permitted types for the type field are defined in Table 17.
タイプ分野のための受入れられたタイプはTable17で定義されます。
See 3.3.4, "Value Representation" for information on how the
value data is represented in the packet value field.
見る、3.3、.4、値のデータがパケット値の分野にどう表されるかの情報の「値の表現。」
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 27] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[27ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 12. Layout SNMP DPI SET, COMMIT, UNDO packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_SET/COMMIT/UNDO |
+------------+----------------------------------------------------+
| 8 | community name length (MSB to LSB) |
+------------+----------------------------------------------------+
| 10 | community name |
+------------+----------------------------------------------------+
| 10+L1 | null terminated group ID (with trailing dot) |
+------------+----------------------------------------------------+
| 10+L2 | null terminated instance ID (no trailing dot) |
+------------+----------------------------------------------------+
| 10+L3 | SNMP Variable Type Value |
+------------+----------------------------------------------------+
| 10+L3+1 | Length of value (2 octets, MSB to LSB) |
+------------+----------------------------------------------------+
| 10+L3+3 | Value |
+------------+----------------------------------------------------+
| 10+L4 | optionally more varBinds (sequences of group ID, |
| | instance ID, Type, Length and Value) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o L1 = length of community name |
| o L2 = L1 + strlen(group ID) + 1 |
| o L3 = L2 + strlen(instance ID) + 1 |
| o L4 = L3 + 3 + length of value |
| o group and instance ID strings use selected character set |
| o OID and DisplayString values use selected character set |
| o Integer values are in network byte order |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 12を見送ってください。 レイアウトSNMP DPI SET、COMMIT、UNDOパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_SET/COMMIT/UNDOと等しいです。| +------------+----------------------------------------------------+ | 8 | 共同体名前の長さ(LSBへのMSB)| +------------+----------------------------------------------------+ | 10 | 共同体名| +------------+----------------------------------------------------+ | 10 + L1| ヌル終えられたグループID(引きずっているドットがある)| +------------+----------------------------------------------------+ | 10 + L2| ヌル終えられたインスタンスID(引きずっているドットがありません)| +------------+----------------------------------------------------+ | 10 + L3| SNMPの可変タイプ価値| +------------+----------------------------------------------------+ | 10+L3+1| 価値(2つの八重奏、LSBへのMSB)の長さ| +------------+----------------------------------------------------+ | 10+L3+3| 値| +------------+----------------------------------------------------+ | 10 + L4| 任意により多くのvarBinds(グループIDの系列、| | | インスタンスID、Type、Length、およびValue)| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o L1は共同体名の長さと等しいです。| | o L2はL1+strlen(グループID)+1と等しいです。| | o L3はL2+strlen(インスタンスID)+1と等しいです。| | o L4は価値のL3+3+長さと等しいです。| | o ストリングが使用するグループとインスタンスIDは文字集合を選択しました。| | o OIDとDisplayString値は選択された文字集合を使用します。| | o ネットワークバイトオーダーには整数値があります。| +-----------------------------------------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 28] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[28ページ]RFC1592SNMP-dpi行進1994
3.2.11 RESPONSE
3.2.11 応答
An SNMP sub-agent must respond to a GET, GETNEXT, GETBULK, SET, COMMIT, UNDO or UNREGISTER request that it has received from the agent (unless it fails or has a bug ;-)). To do so, it sends an SNMP DPI RESPONSE packet to the agent.
SNMPサブエージェントはエージェントから受信したという(バグを失敗するか、または持っていない場合(^_-))GET、GETNEXT、GETBULK、SET、COMMIT、UNDOまたはUNREGISTER要求に応じなければなりません。 そうするために、それはSNMP DPI RESPONSEパケットをエージェントに送ります。
Such a packet contains the standard SNMP DPI header plus RESPONSE specific data:
そのようなパケットは標準のSNMP DPIヘッダーとRESPONSEの特定のデータを含んでいます:
o an error_code,
o an error_index,
o plus for a successful GET, GETNEXT, or GETBULK, the
name/type/length/value tuple(s) representing the returned
object(s). For each varBind this is described as:
o ○ 誤り_コード、誤り_インデックス、o、およびうまくいっているGET、GETNEXT、またはGETBULKのための返されたオブジェクトを表す名前/タイプ/長さ/値のtuple(s)。 各varBindに関しては、これは以下と説明されます。
- two null terminated strings (in the selected character set)
representing the group and instance ID in ASN.1 dotted
notation.
- the type, value length and value of the object that is
returned.
- 2ヌルはグループを代表しながら、ストリング(選択された文字集合における)を終えました、そして、ASN.1のインスタンスIDは記法に点を打たせました。 - 返されるオブジェクトのタイプ、値の長さ、および値。
The permitted types for the type field are defined in Table 17.
タイプ分野のための受入れられたタイプはTable17で定義されます。
See 3.3.4, "Value Representation" for information on how the
value data is represented in the packet value field.
見る、3.3、.4、値のデータがパケット値の分野にどう表されるかの情報の「値の表現。」
For an unsuccessful GET, GETNEXT or GETBULK, the sub-agent does not need to return any name/type/length/value tuple(s), because by definition, the varBind information is the same as in the request to which this is a response, and the agent still has that information.
失敗のGET、GETNEXTまたはGETBULKのために、サブエージェントはどんな名前/タイプ/長さ/値のtuple(s)も返す必要はありません、定義上、varBind情報がこれが応答である要求と同じであり、エージェントにはその情報がまだあるので。
The group ID and the packet ID must always be the same as the corresponding fields in request PDU which has prompted the RESPONSE.
グループIDとパケットIDはRESPONSEをうながした要求PDUの対応する分野といつも同じであるに違いありません。
If the response is to a SET, COMMIT or UNDO request, there is no need to return any varBind information, because by definition, the varBind information is the same as in the request to which this is a response, and the agent still has that information.
COMMITかUNDOが、SETに応答があるならどんなvarBind情報も返す必要は全くないよう要求します、定義上、varBind情報がこれが応答である要求と同じであり、エージェントにはその情報がまだあるので。
If the response is to a REGISTER or UNREGISTER, no variable (instance) is being returned, so the instance ID is the NULL string (one 0x00 byte). In the response to a REGISTER request indicating success, the error index contains the priority assigned by the agent.
REGISTERかUNREGISTERに応答があるなら、変数(インスタンス)が全く返されていないので、インスタンスIDはNULLストリング(1つ0×00バイト)です。 成功を示すREGISTER要求への応答では、誤りインデックスはエージェントによって割り当てられた優先権を含んでいます。
If the response is to an OPEN, ARE_YOU_THERE or CLOSE, no varBind data will be passed, so no group ID, instance ID or value data. The packet will only include the header, the error code and the error
応答がいいえ、__あなたがオープンに、THEREかCLOSEであり、varBindデータが全く通過されないで、したがって、グループIDということであるなら、インスタンスIDか値のデータです。 パケットはヘッダー、エラーコード、および誤りを含むだけでしょう。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 29] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[29ページ]RFC1592SNMP-dpi行進1994
index.
索引をつけてください。
+-----------------------------------------------------------------+
| Table 13. Layout SNMP DPI RESPONSE packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type = SNMP_DPI_RESPONSE |
+------------+----------------------------------------------------+
| 8 | error code (1 octet) |
+------------+----------------------------------------------------+
| 9 | error index (4 octets, MSB to LSB) |
+------------+----------------------------------------------------+
| 15 | null terminated group ID (with trailing dot) |
+------------+----------------------------------------------------+
| 15+L1 | null terminated instance ID (no trailing dot) |
+------------+----------------------------------------------------+
| 15+L2 | SNMP Variable Type Value |
+------------+----------------------------------------------------+
| 15+L2+1 | Length of value (MSB to LSB) |
+------------+----------------------------------------------------+
| 15+L2+3 | Value |
+------------+----------------------------------------------------+
| 15+L3 | optionally more varBinds (sequences of group ID, |
| | instance ID, Type, Length and Value) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o L1 = strlen(group ID) + 1 |
| o L2 = L1 + strlen(instance ID) + 1 |
| o L3 = L2 + 3 + length of value |
| o group and instance ID strings use selected character set |
| o OID and DisplayString values use selected character set |
| o Integer values are in network byte order |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 13を見送ってください。 レイアウトSNMP DPI RESPONSEパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプはSNMP_DPI_RESPONSEと等しいです。| +------------+----------------------------------------------------+ | 8 | エラーコード(1つの八重奏)| +------------+----------------------------------------------------+ | 9 | 誤りインデックス(4つの八重奏、LSBへのMSB)| +------------+----------------------------------------------------+ | 15 | ヌル終えられたグループID(引きずっているドットがある)| +------------+----------------------------------------------------+ | 15 + L1| ヌル終えられたインスタンスID(引きずっているドットがありません)| +------------+----------------------------------------------------+ | 15 + L2| SNMPの可変タイプ価値| +------------+----------------------------------------------------+ | 15+L2+1| 価値(LSBへのMSB)の長さ| +------------+----------------------------------------------------+ | 15+L2+3| 値| +------------+----------------------------------------------------+ | 15 + L3| 任意により多くのvarBinds(グループIDの系列、| | | インスタンスID、Type、Length、およびValue)| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o L1=は+ (グループID)1をstrlenします。| | o L2はL1+strlen(インスタンスID)+1と等しいです。| | o L3は価値のL2+3+長さと等しいです。| | o ストリングが使用するグループとインスタンスIDは文字集合を選択しました。| | o OIDとDisplayString値は選択された文字集合を使用します。| | o ネットワークバイトオーダーには整数値があります。| +-----------------------------------------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 30] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[30ページ]RFC1592SNMP-dpi行進1994
3.2.12 TRAP
3.2.12 罠
An SNMP sub-agent can request the agent to generate an SNMPv1 or SNMPv2 TRAP (depending on the trap destinations defined at the agent) by sending an SNMP DPI TRAP packet to the agent.
SNMPサブエージェントは、SNMP DPI TRAPパケットをエージェントに送ることによってSNMPv1かSNMPv2 TRAP(エージェントで定義された罠の目的地による)を生成するようエージェントに要求できます。
Such a packet contains the standard SNMP DPI header plus TRAP specific data:
そのようなパケットは標準のSNMP DPIヘッダーとTRAPの特定のデータを含んでいます:
o the generic and specific trap codes
o optionally a null terminated string (in the selected character
set) representing the enterprise ID in ASN.1 dotted notation.
This enterprise ID will be sent with the TRAP. If the null
string is passed, then the agent uses the sub-agent Identifier
(OID as passed with the DPI OPEN packet) as the Enterprise ID.
o optionally a set of one or more name/type/length/value tuples.
representing varBinds to be sent with the trap. Each varBind
consists of:
o ジェネリックの、そして、特定の罠は、ASN.1の点を打たされた記法で企業IDを表しながら、○ 任意に、ヌル終えられたストリング(選択された文字集合における)をコード化します。 TRAPと共にこの企業IDを送るでしょう。 ヌルストリングが渡されるなら、エージェントはエンタープライズIDとしてサブエージェントIdentifier(DPI OPENパケットで渡されるOID)を使用します。○ 任意に、1セットのものか以上が、tuples罠と共に送るためにvarBindsを表すと/タイプ/長さ/値を命名します。 各varBindは以下から成ります。
- two null terminated strings (in the selected character set)
representing the group and instance ID in ASN.1 dotted
notation.
- the type, value length and value of the object that is
returned.
- 2ヌルはグループを代表しながら、ストリング(選択された文字集合における)を終えました、そして、ASN.1のインスタンスIDは記法に点を打たせました。 - 返されるオブジェクトのタイプ、値の長さ、および値。
The permitted types for the type field are defined in Table 17.
タイプ分野のための受入れられたタイプはTable17で定義されます。
See 3.3.4, "Value Representation" for information on how the
value data is represented in the packet value field.
見る、3.3、.4、値のデータがパケット値の分野にどう表されるかの情報の「値の表現。」
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 31] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[31ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 14. Layout SNMP DPI TRAP packet |
+------------+----------------------------------------------------+
| OFFSET | FIELD |
+------------+----------------------------------------------------+
| 0 | packet length to follow (MSB to LSB) |
+------------+----------------------------------------------------+
| 2 | protocol major version |
+------------+----------------------------------------------------+
| 3 | protocol minor version |
+------------+----------------------------------------------------+
| 4 | protocol release |
+------------+----------------------------------------------------+
| 5 | packet id (MSB to LSB) |
+------------+----------------------------------------------------+
| 7 | packet type - SNMP_DPI_TRAP |
+------------+----------------------------------------------------+
| 8 | SNMP generic trap code |
+------------+----------------------------------------------------+
| 12 | SNMP specific trap code |
+------------+----------------------------------------------------+
| 14 | null terminated enterprise ID (no trailing dot) |
+------------+----------------------------------------------------+
| 14+L1 | null terminated group ID (with trailing dot) |
+------------+----------------------------------------------------+
| 14+L2 | null terminated instance ID (no trailing dot) |
+------------+----------------------------------------------------+
| 14+L3 | SNMP Variable Type Value |
+------------+----------------------------------------------------+
| 14+L3+1 | Length of value (MSB to LSB) |
+------------+----------------------------------------------------+
| 14+L3+3 | Value |
+------------+----------------------------------------------------+
| 14+L4 | optionally more varBinds (sequences of group ID, |
| | instance ID, Type, Length and Value) |
+------------+----------------------------------------------------+
| NOTE: |
| |
| o L1 = strlen(enterprise ID) + 1 |
| o L2 = L1 + strlen(group ID) + 1 |
| o L3 = L1 + L2 + strlen(instance ID) + 1 |
| o L4 = L1 + L2 + L3 + 3 + length of Value |
| o enterprise, group and instance ID strings use selected |
| character set |
| o OID and DisplayString values use selected character set |
| o Integer values are in network byte order |
+-----------------------------------------------------------------+
+-----------------------------------------------------------------+ | 14を見送ってください。 レイアウトSNMP DPI TRAPパケット| +------------+----------------------------------------------------+ | 相殺されます。| 分野| +------------+----------------------------------------------------+ | 0 | 続くパケット長(LSBへのMSB)| +------------+----------------------------------------------------+ | 2 | 主要なバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 3 | 小さい方のバージョンについて議定書の中で述べてください。| +------------+----------------------------------------------------+ | 4 | プロトコルリリース| +------------+----------------------------------------------------+ | 5 | パケットイド(LSBへのMSB)| +------------+----------------------------------------------------+ | 7 | パケットタイプ--SNMP_DPI_TRAP| +------------+----------------------------------------------------+ | 8 | SNMPジェネリック罠コード| +------------+----------------------------------------------------+ | 12 | SNMPの特定の罠コード| +------------+----------------------------------------------------+ | 14 | ヌル終えられた企業ID(引きずっているドットがありません)| +------------+----------------------------------------------------+ | 14 + L1| ヌル終えられたグループID(引きずっているドットがある)| +------------+----------------------------------------------------+ | 14 + L2| ヌル終えられたインスタンスID(引きずっているドットがありません)| +------------+----------------------------------------------------+ | 14 + L3| SNMPの可変タイプ価値| +------------+----------------------------------------------------+ | 14+L3+1| 価値(LSBへのMSB)の長さ| +------------+----------------------------------------------------+ | 14+L3+3| 値| +------------+----------------------------------------------------+ | 14 + L4| 任意により多くのvarBinds(グループIDの系列、| | | インスタンスID、Type、Length、およびValue)| +------------+----------------------------------------------------+ | 以下に注意してください。 | | | | o L1=は+ (企業ID)1をstrlenします。| | o L2はL1+strlen(グループID)+1と等しいです。| | o L3はL1+L2+strlen(インスタンスID)+1と等しいです。| | o L4はValueのL1+L2+L3+3+長さと等しいです。| | o 企業、グループ、および使用が選択したインスタンスIDストリング| | 文字集合| | o OIDとDisplayString値は選択された文字集合を使用します。| | o ネットワークバイトオーダーには整数値があります。| +-----------------------------------------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 32] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[32ページ]RFC1592SNMP-dpi行進1994
3.3 CONSTANTS AND VALUES
3.3 定数と値
This section describes the constants that have been defined for this version of the SNMP DPI Protocol.
このセクションはSNMP DPIプロトコルのこのバージョンのために定義された定数について説明します。
3.3.1 PROTOCOL VERSION AND RELEASE VALUES
3.3.1 プロトコルバージョンANDリリース値
+-----------------------------------------------------------------+
| Table 15. Protocol version and release values |
+--------------------------------+--------------------------------+
| FIELD | VALUE |
+--------------------------------+--------------------------------+
| protocol major version | 2 (SNMP DPI protocol) |
+--------------------------------+--------------------------------+
| protocol minor version | 2 (version 2) |
+--------------------------------+--------------------------------+
| protocol release | 0 (release 0) |
+--------------------------------+--------------------------------+
+-----------------------------------------------------------------+ | 15を見送ってください。 プロトコルバージョンとリリース値| +--------------------------------+--------------------------------+ | 分野| 値| +--------------------------------+--------------------------------+ | 主要なバージョンについて議定書の中で述べてください。| 2 (SNMP DPIプロトコル)| +--------------------------------+--------------------------------+ | 小さい方のバージョンについて議定書の中で述べてください。| 2 (バージョン2)| +--------------------------------+--------------------------------+ | プロトコルリリース| 0 (リリース0)| +--------------------------------+--------------------------------+
Previous versions of this protocol exist and should preferably be supported by an agent:
このプロトコルの旧バージョンは、存在していて、望ましくは、エージェントによってサポートされるべきです:
o version 1, release 0, described in [7]
o バージョン1(リリース0)はコネについて説明しました。[7]
Previous internal versions of this protocol exist and may or may not be supported by an agent:
このプロトコルの前の内回転術は、存在していて、エージェントによってサポートされるかもしれません:
o version 1, release 1, experimental within IBM.
o version 1, release 2, experimental within BNR.
o バージョン1 BNRの中で実験的にIBM oバージョン1、リリース2の中で実験的な1をリリースしてください。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 33] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[33ページ]RFC1592SNMP-dpi行進1994
3.3.2 PACKET TYPE VALUES
3.3.2 パケットタイプ値
+-----------------------------------------------------------------+
| Table 16. Valid values for the packet type field |
+-------+---------------------------------------------------------+
| VALUE | PACKET TYPE |
+-------+---------------------------------------------------------+
| 1 | SNMP_DPI_GET |
+-------+---------------------------------------------------------+
| 2 | SNMP_DPI_GETNEXT |
+-------+---------------------------------------------------------+
| 3 | SNMP_DPI_SET |
+-------+---------------------------------------------------------+
| 4 | SNMP_DPI_TRAP |
+-------+---------------------------------------------------------+
| 5 | SNMP_DPI_RESPONSE |
+-------+---------------------------------------------------------+
| 6 | SNMP_DPI_REGISTER |
+-------+---------------------------------------------------------+
| 7 | SNMP_DPI_UNREGISTER |
+-------+---------------------------------------------------------+
| 8 | SNMP_DPI_OPEN |
+-------+---------------------------------------------------------+
| 9 | SNMP_DPI_CLOSE |
+-------+---------------------------------------------------------+
| 10 | SNMP_DPI_COMMIT |
+-------+---------------------------------------------------------+
| 11 | SNMP_DPI_UNDO |
+-------+---------------------------------------------------------+
| 12 | SNMP_DPI_GETBULK |
+-------+---------------------------------------------------------+
| 13 | SNMP_DPI_TRAPV2 (not yet used) |
+-------+---------------------------------------------------------+
| 14 | SNMP_DPI_INFORM (not yet used) |
+-------+---------------------------------------------------------+
| 15 | SNMP_DPI_ARE_YOU_THERE |
+-------+---------------------------------------------------------+
+-----------------------------------------------------------------+ | 16を見送ってください。 パケットタイプ分野への有効値| +-------+---------------------------------------------------------+ | 値| パケットタイプ| +-------+---------------------------------------------------------+ | 1 | dpi_が手に入れるSNMP_| +-------+---------------------------------------------------------+ | 2 | _SNMP_dpi GETNEXT| +-------+---------------------------------------------------------+ | 3 | SNMP_dpi_はセットしました。| +-------+---------------------------------------------------------+ | 4 | SNMP_dpi_罠| +-------+---------------------------------------------------------+ | 5 | SNMP_dpi_応答| +-------+---------------------------------------------------------+ | 6 | SNMP_dpi_は登録されます。| +-------+---------------------------------------------------------+ | 7 | _SNMP_dpi UNREGISTER| +-------+---------------------------------------------------------+ | 8 | SNMP_dpi_は開きます。| +-------+---------------------------------------------------------+ | 9 | SNMP_dpi_は閉じます。| +-------+---------------------------------------------------------+ | 10 | SNMP_dpi_は公約されます。| +-------+---------------------------------------------------------+ | 11 | dpi_が元に戻すSNMP_| +-------+---------------------------------------------------------+ | 12 | _SNMP_dpi GETBULK| +-------+---------------------------------------------------------+ | 13 | SNMP_DPI_TRAPV2(まだ使用されていません)| +-------+---------------------------------------------------------+ | 14 | SNMP_DPI_INFORM(まだ使用されていません)| +-------+---------------------------------------------------------+ | 15 | SNMP_dpi、__あなたはそこの_です。| +-------+---------------------------------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 34] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[34ページ]RFC1592SNMP-dpi行進1994
3.3.3 VARIABLE TYPE VALUES
3.3.3 可変タイプ値
+-----------------------------------------------------------------+
| Table 17. Valid values for the Value Type field |
+-------+---------------------------------------------------------+
| VALUE | VALUE TYPE |
+-------+---------------------------------------------------------+
| 129 | SNMP_TYPE_Integer32 |
+-------+---------------------------------------------------------+
| 2 | SNMP_TYPE_OCTET_STRING |
+-------+---------------------------------------------------------+
| 3 | SNMP_TYPE_OBJECT_IDENTIFIER |
+-------+---------------------------------------------------------+
| 4 | SNMP_TYPE_NULL (empty, no value) |
+-------+---------------------------------------------------------+
| 5 | SNMP_TYPE_IpAddress |
+-------+---------------------------------------------------------+
| 134 | SNMP_TYPE_Counter32 |
+-------+---------------------------------------------------------+
| 135 | SNMP_TYPE_Gauge32 |
+-------+---------------------------------------------------------+
| 136 | SNMP_TYPE_TimeTicks (1/100ths seconds) |
+-------+---------------------------------------------------------+
| 9 | SNMP_TYPE_DisplayString |
+-------+---------------------------------------------------------+
| 10 | SNMP_TYPE_BIT_STRING |
+-------+---------------------------------------------------------+
| 11 | SNMP_TYPE_NsapAddress |
+-------+---------------------------------------------------------+
| 140 | SNMP_TYPE_UInteger32 |
+-------+---------------------------------------------------------+
| 13 | SNMP_TYPE_Counter64 |
+-------+---------------------------------------------------------+
| 14 | SNMP_TYPE_Opaque |
+-------+---------------------------------------------------------+
| 15 | SNMP_TYPE_noSuchObject |
+-------+---------------------------------------------------------+
| 16 | SNMP_TYPE_noSuchInstance |
+-------+---------------------------------------------------------+
| 17 | SNMP_TYPE_endOfMibView |
+-------+---------------------------------------------------------+
+-----------------------------------------------------------------+ | 17を見送ってください。 Value Type分野への有効値| +-------+---------------------------------------------------------+ | 値| 値のタイプ| +-------+---------------------------------------------------------+ | 129 | _SNMP_タイプInteger32| +-------+---------------------------------------------------------+ | 2 | SNMP_タイプ_八重奏_ストリング| +-------+---------------------------------------------------------+ | 3 | SNMP_タイプ_オブジェクト_識別子| +-------+---------------------------------------------------------+ | 4 | SNMP_TYPE_NULL、(空になってください、値がありません)| +-------+---------------------------------------------------------+ | 5 | _SNMP_タイプIpAddress| +-------+---------------------------------------------------------+ | 134 | _SNMP_タイプCounter32| +-------+---------------------------------------------------------+ | 135 | _SNMP_タイプGauge32| +-------+---------------------------------------------------------+ | 136 | SNMP_TYPE_TimeTicks(1/100ths秒)| +-------+---------------------------------------------------------+ | 9 | _SNMP_タイプDisplayString| +-------+---------------------------------------------------------+ | 10 | SNMP_タイプ_ビット_ストリング| +-------+---------------------------------------------------------+ | 11 | _SNMP_タイプNsapAddress| +-------+---------------------------------------------------------+ | 140 | _SNMP_タイプUInteger32| +-------+---------------------------------------------------------+ | 13 | _SNMP_タイプCounter64| +-------+---------------------------------------------------------+ | 14 | タイプ_が不透明にするSNMP_| +-------+---------------------------------------------------------+ | 15 | _SNMP_タイプnoSuchObject| +-------+---------------------------------------------------------+ | 16 | _SNMP_タイプnoSuchInstance| +-------+---------------------------------------------------------+ | 17 | _SNMP_タイプendOfMibView| +-------+---------------------------------------------------------+
Notes:
注意:
1. A 32-bit integer value has its base base type ORed with 128.
2. DisplayString is a textual convention. An SNMP PDU shows a
type of OCTET_STRING for the value. An agent can handle such
an object as DisplayString if the object is included in some
1. 32ビットの整数値で、ベースベースは128でORedをタイプします。 2. DisplayStringは原文のコンベンションです。 SNMP PDUは値のために一種のOCTET_STRINGを見せています。 オブジェクトがいくつかに含まれているなら、エージェントはDisplayStringのようなオブジェクトを扱うことができます。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 35] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[35ページ]RFC1592SNMP-dpi行進1994
form of a compiled MIB for the agent. If not, the agent passes
the value as an OCTET_STRING.
エージェントのためのコンパイルされたMIBのフォーム。 そうでなければ、エージェントはOCTET_STRINGとして値を通過します。
3.3.4 VALUE REPRESENTATION
3.3.4 値の表現
Values in the DPI packets are represented as follows:
DPIパケットの値は以下の通り表されます:
o 32-bit integers are 4-byte elements in network byte order, MSB
(most significant byte) first, LSB (least significant byte)
last. Example: '00000001'h represents 1.
o 64-bit integers are 8-byte elements in network byte order, MSB
first, LSB last.
Example: '0000000100000001'h represents 4,294,967,297.
o Object Identifiers are NULL terminated strings in the selected
character set, representing the OID in ASN.1 dotted notation.
The length includes the terminating NULL.
Example ASCII: '312e332e362e312e322e312e312e312e3000'h
represents "1.3.6.1.2.1.1.1.0" which is sysDescr.0.
Example EBCDIC: 'f14bf34bf64bf14bf24bf14bf14bf14bf000'h
represents "1.3.6.1.2.1.1.1.0" which is sysDescr.0.
o DisplayStrings are in the selected character set. The length
specifies the length of the string.
Example ASCII: '6162630d0a'h represents "abc\r\n", no NULL.
Example EBCDIC: '8182830d25'h represents "abc\r\n", no NULL.
o IpAddress, NsapAddress and Opaque are implicit OCTET_STRING, so
they are octets (e.g. IpAddress in network byte order).
o NULL has a zero length for the value, no value data.
o noSuchObject, noSuchInstance and endOfMibView are implicit NULL
and represented as such.
o BIT_STRING is an OCTET_STRING of the form uubbbb...bb, where
the first octet (uu) is 0x00-0x07 and indicates the number of
unused bits in the last octet (bb). The bb octets represent the
bit string itself, where bit zero (0) comes first and so on.
o 最後に32ビットの整数はネットワークバイトオーダーにおける4バイトの要素、MSB(最も重要なバイト)1番目、LSB(最も重要でないバイト)です。 例: hは1を表します。'00000001'最後にo64ビットの整数はネットワークバイトオーダー、MSB1番目、LSBの8バイトの要素です。 例: hは42億9496万7297を表します。'0000000100000001'o Object IdentifiersによるNULLは選択された文字集合でストリングを終えました、ASN.1の点を打たされた記法でOIDを表してことです。 長さは終わっているNULLを含んでいます。 例のASCII: '312e332e362e312e322e312e312e312e3000'hが表す、「1.3 .6 .1 .2 .1 .1 .1 sysDescr.0インチである0インチ、' 例のEBCDIC: sysDescr.0はどれですか?'f14bf34bf64bf14bf24bf14bf14bf14bf000'hが表す、「1.3、.6、.1、.2、.1、.1、.1、0インチ、選択された文字集合にはo DisplayStringsがあります」、' 長さはストリングの長さを指定します。 例のASCII: '6162630d0a'hは「abc\r\n」、NULLを全く表しません。' 例のEBCDIC: '8182830d25'hは「abc\r\n」(NULLがない)o IpAddressを表します、NsapAddressとOpaqueが内在しているOCTET_STRINGである、したがって、彼らは八重奏(例えば、ネットワークバイトオーダーにおけるIpAddress)です。o noSuchObject、noSuchInstance、およびendOfMibViewはそういうものとしてo NULLには、値(値のデータがない)のためのゼロ・レングスがあって、内在しているNULLであって表されます。o BIT_STRINGはフォームuubbbbの…OCTET_STRINGです'bb(bb)。(そこで、最初の八重奏(uu)は、0×00-0×07であり、最後の八重奏における、未使用のビットの数を示します)。 bb八重奏はビット列自体を表します。そこでは、ビットゼロ(0)が最初になどに来ます。
3.3.5 CHARACTER SET SELECTION
3.3.5 文字集合選択
In the DPI OPEN packet, the sub-agent can specify the character set to be used for the representation of:
DPI OPENパケットでは、サブエージェントは、以下の表現に使用されるために文字集合を指定できます。
o group and instance ID in the DPI REGISTER, UNREGISTER, GET,
GETNEXT, GETBULK, SET, UNDO, COMMIT, RESPONSE and TRAP packets.
o sub-agent ID and sub-agent Description in DPI OPEN packet.
o Object Identifiers in the value field for a value of type
SNMP_TYPE_OBJECT_IDENTIFIER.
o DisplayString in the value field for a value of type
SNMP_TYPE_DPI_DisplayString.
o グループとインスタンスIDはタイプSNMP_TYPEの値のためにTRAPパケット値におけるDPI OPENパケットo Object IdentifiersのDPI REGISTER、UNREGISTER、GET、GETNEXT、GETBULK、SET、UNDO、COMMIT、RESPONSE、およびoサブエージェントIDとサブエージェント記述で_OBJECT_IDENTIFIERをさばきます。値におけるo DisplayStringはタイプSNMP_TYPEの値のために_DPI_DisplayStringをさばきます。
The choice is the native character set or the ASCII character set.
選択は、ネイティブの文字集合かASCII文字の組です。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 36] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[36ページ]RFC1592SNMP-dpi行進1994
The native set is the set native to the platform where the agent runs. If the native set is ASCII, then character set selection is a moot point. On non-ASCII based platforms, the agent must convert between native and ASCII if the native character set is chosen.
自然なセットはエージェントが走るプラットホームについて自然なセットです。 自然なセットがASCIIであるなら、文字集合選択は論点です。 非ASCIIのベースのプラットホームでは、ネイティブの文字集合が選ばれているなら、エージェントがネイティブとASCIIの間で変換しなければなりません。
3.3.6 ERROR CODE VALUES FOR SNMP DPI RESPONSE PACKETS
3.3.6 SNMP dpi応答パケットのための誤りコード値
When the RESPONSE packet is a response to a GET, GETNEXT, GETBULK, SET, COMMIT, or UNDO, then the error code can have one of the following values:
次に、RESPONSEパケットがGET、GETNEXT、GETBULK、SET、COMMIT、またはUNDOへの応答であるときに、エラーコードは以下の値の1つを持つことができます:
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 37] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[37ページ]RFC1592SNMP-dpi行進1994
+-----------------------------------------------------------------+
| Table 18. Valid SNMP_ERROR values for RESPONSE error code |
+-------+---------------------------------------------------------+
| VALUE | ERROR CODE |
+-------+---------------------------------------------------------+
| 0 | SNMP_ERROR_noError |
+-------+---------------------------------------------------------+
| 1 | SNMP_ERROR_tooBig |
+-------+---------------------------------------------------------+
| 2 | SNMP_ERROR_noSuchName (SNMPv1, do not use) |
+-------+---------------------------------------------------------+
| 3 | SNMP_ERROR_badValue (SNMPv1, do not use) |
+-------+---------------------------------------------------------+
| 4 | SNMP_ERROR_readOnly (SNMPv1 do not use) |
+-------+---------------------------------------------------------+
| 5 | SNMP_ERROR_genErr |
+-------+---------------------------------------------------------+
| 6 | SNMP_ERROR_noAccess |
+-------+---------------------------------------------------------+
| 7 | SNMP_ERROR_wrongType |
+-------+---------------------------------------------------------+
| 8 | SNMP_ERROR_wrongLength |
+-------+---------------------------------------------------------+
| 9 | SNMP_ERROR_wrongEncoding |
+-------+---------------------------------------------------------+
| 10 | SNMP_ERROR_wrongValue |
+-------+---------------------------------------------------------+
| 11 | SNMP_ERROR_noCreation |
+-------+---------------------------------------------------------+
| 12 | SNMP_ERROR_inconsistentValue |
+-------+---------------------------------------------------------+
| 13 | SNMP_ERROR_resourceUnavailable |
+-------+---------------------------------------------------------+
| 14 | SNMP_ERROR_commitFailed |
+-------+---------------------------------------------------------+
| 15 | SNMP_ERROR_undoFailed |
+-------+---------------------------------------------------------+
| 16 | SNMP_ERROR_authorizationError |
+-------+---------------------------------------------------------+
| 17 | SNMP_ERROR_notWritable |
+-------+---------------------------------------------------------+
| 18 | SNMP_ERROR_inconsistentName |
+-------+---------------------------------------------------------+
+-----------------------------------------------------------------+ | 18を見送ってください。 RESPONSEエラーコードのための有効なSNMP_ERROR値| +-------+---------------------------------------------------------+ | 値| エラーコード| +-------+---------------------------------------------------------+ | 0 | _SNMP_誤りnoError| +-------+---------------------------------------------------------+ | 1 | _SNMP_誤りtooBig| +-------+---------------------------------------------------------+ | 2 | SNMP_ERROR_noSuchName(SNMPv1、どんな使用もしないでください)| +-------+---------------------------------------------------------+ | 3 | SNMP_ERROR_badValue(SNMPv1、どんな使用もしないでください)| +-------+---------------------------------------------------------+ | 4 | SNMP_ERROR_readOnly(SNMPv1はどんな使用もしません)| +-------+---------------------------------------------------------+ | 5 | _SNMP_誤りgenErr| +-------+---------------------------------------------------------+ | 6 | _SNMP_誤りnoAccess| +-------+---------------------------------------------------------+ | 7 | _SNMP_誤りwrongType| +-------+---------------------------------------------------------+ | 8 | _SNMP_誤りwrongLength| +-------+---------------------------------------------------------+ | 9 | _SNMP_誤りwrongEncoding| +-------+---------------------------------------------------------+ | 10 | _SNMP_誤りwrongValue| +-------+---------------------------------------------------------+ | 11 | _SNMP_誤りnoCreation| +-------+---------------------------------------------------------+ | 12 | _SNMP_誤りinconsistentValue| +-------+---------------------------------------------------------+ | 13 | _SNMP_誤りresourceUnavailable| +-------+---------------------------------------------------------+ | 14 | _SNMP_誤りcommitFailed| +-------+---------------------------------------------------------+ | 15 | _SNMP_誤りundoFailed| +-------+---------------------------------------------------------+ | 16 | _SNMP_誤りauthorizationError| +-------+---------------------------------------------------------+ | 17 | _SNMP_誤りnotWritable| +-------+---------------------------------------------------------+ | 18 | _SNMP_誤りinconsistentName| +-------+---------------------------------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 38] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[38ページ]RFC1592SNMP-dpi行進1994
When the RESPONSE packet is a response to an OPEN, REGISTER or UNREGISTER, then the error code can have one of the following values:
次に、RESPONSEパケットがオープン、REGISTERまたはUNREGISTERへの応答であるときに、エラーコードは以下の値の1つを持つことができます:
+-----------------------------------------------------------------+
| Table 19. Valid SNMP_ERROR_DPI values for RESPONSE error code |
+-------+---------------------------------------------------------+
| VALUE | ERROR CODE |
+-------+---------------------------------------------------------+
| 0 | SNMP_ERROR_DPI_noError |
+-------+---------------------------------------------------------+
| 101 | SNMP_ERROR_DPI_otherError |
+-------+---------------------------------------------------------+
| 102 | SNMP_ERROR_DPI_notFound |
+-------+---------------------------------------------------------+
| 103 | SNMP_ERROR_DPI_alreadyRegistered |
+-------+---------------------------------------------------------+
| 104 | SNMP_ERROR_DPI_higherPriorityRegistered |
+-------+---------------------------------------------------------+
| 105 | SNMP_ERROR_DPI_mustOpenFirst |
+-------+---------------------------------------------------------+
| 106 | SNMP_ERROR_DPI_notAuthorized |
+-------+---------------------------------------------------------+
| 107 | SNMP_ERROR_DPI_viewSelectionNotSupported |
+-------+---------------------------------------------------------+
| 108 | SNMP_ERROR_DPI_getBulkSelectionNotSupported |
+-------+---------------------------------------------------------+
| 109 | SNMP_ERROR_DPI_duplicateSubAgentIdentifier |
+-------+---------------------------------------------------------+
| 110 | SNMP_ERROR_DPI_invalidDisplayString |
+-------+---------------------------------------------------------+
| 111 | SNMP_ERROR_DPI_characterSetSelectionNotSupported |
+-------+---------------------------------------------------------+
+-----------------------------------------------------------------+ | 19を見送ってください。 RESPONSEエラーコードのための有効なSNMP_ERROR_DPI値| +-------+---------------------------------------------------------+ | 値| エラーコード| +-------+---------------------------------------------------------+ | 0 | _SNMP_誤りdpi_noError| +-------+---------------------------------------------------------+ | 101 | _SNMP_誤りdpi_otherError| +-------+---------------------------------------------------------+ | 102 | _SNMP_誤りdpi_notFound| +-------+---------------------------------------------------------+ | 103 | _SNMP_誤りdpi_alreadyRegistered| +-------+---------------------------------------------------------+ | 104 | _SNMP_誤りdpi_higherPriorityRegistered| +-------+---------------------------------------------------------+ | 105 | _SNMP_誤りdpi_mustOpenFirst| +-------+---------------------------------------------------------+ | 106 | _SNMP_誤りdpi_notAuthorized| +-------+---------------------------------------------------------+ | 107 | _SNMP_誤りdpi_viewSelectionNotSupported| +-------+---------------------------------------------------------+ | 108 | _SNMP_誤りdpi_getBulkSelectionNotSupported| +-------+---------------------------------------------------------+ | 109 | _SNMP_誤りdpi_duplicateSubAgentIdentifier| +-------+---------------------------------------------------------+ | 110 | _SNMP_誤りdpi_invalidDisplayString| +-------+---------------------------------------------------------+ | 111 | _SNMP_誤りdpi_characterSetSelectionNotSupported| +-------+---------------------------------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 39] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[39ページ]RFC1592SNMP-dpi行進1994
3.3.7 UNREGISTER REASON CODES
3.3.7 UNREGISTER理由コード
The following are valid reason codes in an UNREGISTER packet.
↓これはUNREGISTERパケットの正当な理由コードです。
+-----------------------------------------------------------------+
| Table 20. Valid UNREGISTER reason codes |
+-------+---------------------------------------------------------+
| VALUE | REASON CODE |
+-------+---------------------------------------------------------+
| 1 | SNMP_UNREGISTER_otherReason |
+-------+---------------------------------------------------------+
| 2 | SNMP_UNREGISTER_goingDown |
+-------+---------------------------------------------------------+
| 3 | SNMP_UNREGISTER_justUnregister |
+-------+---------------------------------------------------------+
| 4 | SNMP_UNREGISTER_newRegistration |
+-------+---------------------------------------------------------+
| 5 | SNMP_UNREGISTER_higherPriorityRegistered |
+-------+---------------------------------------------------------+
| 6 | SNMP_UNREGISTER_byManager |
+-------+---------------------------------------------------------+
| 7 | SNMP_UNREGISTER_timeout |
+-------+---------------------------------------------------------+
+-----------------------------------------------------------------+ | 20を見送ってください。 有効なUNREGISTER理由コード| +-------+---------------------------------------------------------+ | 値| 理由コード| +-------+---------------------------------------------------------+ | 1 | SNMP_UNREGISTER_otherReason| +-------+---------------------------------------------------------+ | 2 | SNMP_UNREGISTER_goingDown| +-------+---------------------------------------------------------+ | 3 | SNMP_UNREGISTER_justUnregister| +-------+---------------------------------------------------------+ | 4 | SNMP_UNREGISTER_newRegistration| +-------+---------------------------------------------------------+ | 5 | SNMP_UNREGISTER_higherPriorityRegistered| +-------+---------------------------------------------------------+ | 6 | SNMP_UNREGISTER_byManager| +-------+---------------------------------------------------------+ | 7 | SNMP_UNREGISTER_タイムアウト| +-------+---------------------------------------------------------+
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 40] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[40ページ]RFC1592SNMP-dpi行進1994
3.3.8 CLOSE REASON CODES
3.3.8 理由コードを閉じてください。
The following are valid reason codes in a CLOSE packet.
↓これはCLOSEパケットの正当な理由コードです。
+-----------------------------------------------------------------+
| Table 21. Valid CLOSE reason codes |
+-------+---------------------------------------------------------+
| VALUE | REASON CODE |
+-------+---------------------------------------------------------+
| 1 | SNMP_CLOSE_otherReason |
+-------+---------------------------------------------------------+
| 2 | SNMP_CLOSE_goingDown |
+-------+---------------------------------------------------------+
| 3 | SNMP_CLOSE_unsupportedVersion |
+-------+---------------------------------------------------------+
| 4 | SNMP_CLOSE_protocolError |
+-------+---------------------------------------------------------+
| 5 | SNMP_CLOSE_authenticationFailure |
+-------+---------------------------------------------------------+
| 6 | SNMP_CLOSE_byManager |
+-------+---------------------------------------------------------+
| 7 | SNMP_CLOSE_timeout |
+-------+---------------------------------------------------------+
| 8 | SNMP_CLOSE_openError |
+-------+---------------------------------------------------------+
+-----------------------------------------------------------------+ | 21を見送ってください。 有効なCLOSE理由コード| +-------+---------------------------------------------------------+ | 値| 理由コード| +-------+---------------------------------------------------------+ | 1 | SNMP_閉鎖_otherReason| +-------+---------------------------------------------------------+ | 2 | SNMP_閉鎖_goingDown| +-------+---------------------------------------------------------+ | 3 | SNMP_閉鎖_unsupportedVersion| +-------+---------------------------------------------------------+ | 4 | SNMP_閉鎖_protocolError| +-------+---------------------------------------------------------+ | 5 | SNMP_閉鎖_authenticationFailure| +-------+---------------------------------------------------------+ | 6 | SNMP_閉鎖_byManager| +-------+---------------------------------------------------------+ | 7 | SNMPの_の近い_タイムアウト| +-------+---------------------------------------------------------+ | 8 | SNMP_閉鎖_openError| +-------+---------------------------------------------------------+
4. DPI 2.0 MIB DEFINITION
4. dpi2.0MIB定義
DPI20-MIB DEFINITIONS ::= BEGIN
DPI20-MIB定義:、:= 始まってください。
-- Objects in this MIB are implemented in the local SNMP agent.
-- このMIBのオブジェクトは地元のSNMPエージェントで実装されます。
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, snmpModules, enterprises
FROM SNMPv2-SMI
IMPORTS MODULE-IDENTITY、OBJECT-TYPE、snmpModules、企業FROM SNMPv2-SMI
ibm OBJECT IDENTIFIER ::= { enterprises 2 }
ibmDPI OBJECT IDENTIFIER ::= { ibm 2 }
dpi20MIB OBJECT IDENTIFIER ::= { ibmDPI 1 }
ibm OBJECT IDENTIFIER:、:= 企業2ibmDPI OBJECT IDENTIFIER:、:= ibm2dpi20MIB OBJECT IDENTIFIER:、:= ibmDPI1
-- dpi20MIB MODULE-IDENTITY
-- LAST-UPDATED "9401210000Z"
-- ORGANIZATION "IBM Research - T.J. Watson Research Center"
-- CONTACT-INFO " Bert Wijnen
-- Postal: IBM International Operations
-- Watsonweg 2
-- 1423 ND Uithoorn
-- The Netherlands
-- dpi20MIBモジュールアイデンティティ--"9401210000Z"をアップデートします--組織「IBMは研究されます--T.J.ワトソン研究所」--コンタクトインフォメーション、「バートWijnen--郵便:、」 IBMの国際経営活動--Watsonweg2 -- 1423第オイトホルン--オランダ
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 41] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[41ページ]RFC1592SNMP-dpi行進1994
-- Tel: +31 2975 53316
-- Fax: +31 2975 62468
-- E-mail: wijnen@vnet.ibm.com"
-- DESCRIPTION "MIB module describing DPI objects."
-- ::= { snmpModules x }
-- Tel: +31 2975 53316--Fax: +31 2975 62468--メールしてください: " wijnen@vnet.ibm.com "--記述「MIBのモジュールの説明しているDPIオブジェクト。」 -- ::= snmpModules x
dpiPort OBJECT IDENTIFIER ::= { dpi20MIB 1 }
dpiPortオブジェクト識別子:、:= dpi20MIB1
dpiPortForTCP OBJECT-TYPE
SYNTAX INTEGER (0..65535)
ACCESS read-only
STATUS mandatory
DESCRIPTION "The TCP port number on which the agent
listens for DPI connections. A zero value
means the agent has no DPI TCP port."
::= { dpiPort 1 }
「TCPポートはエージェントがDPI接続のために聴くものに関して付番する」dpiPortForTCP OBJECT-TYPE SYNTAX INTEGER(0 .65535)のACCESSの書き込み禁止のSTATUSの義務的な記述。 「ゼロはエージェントがどんなDPI TCPも移植させない手段を評価します。」 ::= dpiPort1
dpiPortForUDP OBJECT-TYPE
SYNTAX INTEGER (0..65535)
ACCESS read-only
STATUS mandatory
DESCRIPTION "The UDP port number on which the agent
listens for DPI packets. A zero value
means the agent has no DPI UDP port."
::= { dpiPort 2 }
END
「UDPポートはエージェントがDPIパケットのために聴くものに関して付番する」dpiPortForUDP OBJECT-TYPE SYNTAX INTEGER(0 .65535)のACCESSの書き込み禁止のSTATUSの義務的な記述。 「ゼロはエージェントがどんなDPI UDPも移植させない手段を評価します。」 ::= dpiPort2は終わります。
5. SUBAGENT CONSIDERATIONS
5. 副代理店問題
When implementing a sub-agent, it is strongly recommended to use the DPI version 2 approach (SNMPv2 based). This means:
サブエージェントを実装するとき、DPIバージョン2アプローチ(基づくSNMPv2)を使用することが強く勧められます。 これは以下を意味します。
o Use SNMPv2 error codes only (even though we have definitions
for the old SNMPv1 error codes).
o Do implement SET, COMMIT, UNDO processing properly.
o For GET requests, use the SNMPv2 approach and pass back
noSuchInstance or noSuchObject value if such is the case.
Continue to process all remaining varBinds in this case.
o For GETNEXT, use the SNMPv2 approach and pass back endOfMibView
value if such is the case. Continue to process all remaining
varBinds in this case.
o When you are processing a request from the agent (GET, GETNEXT,
GETBULK, SET, COMMIT, UNDO) you are supposed to respond within
the timeout period (which you can specify in the OPEN and
REGISTER packets). If you fail to respond within that timeout
period, the agent will most probably close your DPI connection
and then discard your RESPONSE packet if it comes in later. If
you can detect that the response is not going to make it in
o SNMPv2エラーコードだけを使用してください(私たちには、古いSNMPv1エラーコードのための定義がありますが)。o DoはそのようなものがケースであるならSET、COMMIT(適切に処理するUNDO)にo For GET要求を実装して、SNMPv2アプローチを使用して、noSuchInstanceかnoSuchObject値を戻します。 この場合すべての残っているvarBindsを処理し続けてください。o For GETNEXT、SNMPv2アプローチを使用してください、そして、そのようなものがケースであるならendOfMibView値を戻してください。 この場合すべての残っているvarBindsを処理し続けてください。処理しているo Whenはあなたがタイムアウト時間(あなたがオープンとREGISTERパケットで指定できる)中にエージェント(GET、GETNEXT、GETBULK、SET、COMMIT、UNDO)からこたえるべきですaが、要求する。 それが遅刻して、あなたがそのタイムアウト時間中に応じないと、エージェントは、最もたぶんあなたのDPI接続を終えて、あなたのRESPONSEパケットを捨てるでしょう。 あなたがそれを検出できるなら、応答は中でそれを作らないでしょう。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 42] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[42ページ]RFC1592SNMP-dpi行進1994
time, then you might decide to abort the request and return an
SNMP_ERROR_genErr in the RESPONSE.
o If you have a UDP "connected" sub-agent, or one that uses
another unreliable protocol, you may want to issue an SNMP DPI
ARE_YOU_THERE request once in a while to ensure that the agent
is still alive and still knows about you.
o When you are running on an EBCDIC based machine, and you use
the (default) native character set, then all OID strings (as
used for things like group ID, instance ID, Enterprise ID,
sub-agent ID) and also all variable values of type
OBJECT_IDENTIFIER or DisplayString will be passed to you in
EBCDIC format. When you return a response, you should then
also use EBCDIC FORMAT.
o When you are running on an EBCDIC based machine, and you use
the ASCII character set (specified in DPI OPEN), then all OID
strings (as used for things like group ID, instance ID,
Enterprise ID, sub-agent ID) and also all variable values of
type OBJECT_IDENTIFIER or DisplayString will be passed to you
in ASCII format. When you return a response, you should then
also use ASCII FORMAT.
o When you are running on an ASCII machine, then the character
set selection for you basically is moot. Except maybe when you
connect to an EBCDIC based agent, in which case you may want to
specify in the DPI OPEN packet that you want to use ASCII
character set. After that, all this is transparent to you and
the burden of conversion is on the EBCDIC based agent.
o Please realize that DisplayString is only a textual convention.
In the SNMP PDU (SNMP packet), the type is just an
OCTET_STRING, and from that it is not clear if this is a
DisplayString or any arbitrary data. This means that the agent
can only know about an object being a DisplayString if the
object is included in some sort of a compiled MIB. If it is,
then the agent will use SNMP_TYPE_DisplayString in the type
field of the varBind in a DPI SET packet. When you send a
DisplayString in a RESPONSE packet, the agent will handle it as
such (e.g. translate EBCDIC to ASCII if needed).
時間、次に、あなたは要求を中止して、RESPONSEでSNMP_ERROR_genErrを返すと決めるかもしれません。別の頼り無いプロトコルを使用するo UDPが「接続した」というこのIfサブエージェント、または1人のエージェント、あなたは_あなたをSNMP DPI AREに発行したがっているかもしれません。THEREが時々エージェントがまだ生きていて、あなたに関してまだ知っているのを保証するよう要求する_、o When、あなたはEBCDICのベースのマシンで動いていて、(デフォルト)ネイティブの文字集合を使用します; そして、タイプOBJECT_IDENTIFIERかDisplayStringのすべてのOIDストリング(グループID、インスタンスID、エンタープライズID、サブエージェントIDのようなものに使用されるように)とすべての可変値もEBCDIC形式であなたに渡されるでしょう。 応答を返すとき、そしてときに返すべきです、また、EBCDIC FORMAT o Whenを使用してください。あなたはEBCDICのベースのマシンで動いています、そして、あなたはASCII文字の組(DPI OPENでは、指定される)を使用します、そして、次に、ASCII書式でタイプOBJECT_IDENTIFIERかDisplayStringのすべてのOIDストリング(グループID、インスタンスID、エンタープライズID、サブエージェントIDのようなものに使用されるように)とすべての可変値もあなたに送るでしょう。 応答を返すとき、そしてときに返すべきです、また、ASCII FORMAT o Whenを使用してください。あなたはASCIIマシンで動いていて、次に、あなたのための文字集合選択は基本的に論争中です。 時を除いて、あなたがASCII文字の組を使用したいDPI OPENパケットでどのケースを指定したいと思うかもしれないかでEBCDICベースのエージェントに接してください。 その後に、あなたにとって、このすべてが透明です、そして、EBCDICベースのエージェントの上に変換の負担があります。o Pleaseは、DisplayStringが原文のコンベンションにすぎないとわかります。 SNMP PDU(SNMPパケット)では、タイプはただOCTET_STRINGであり、それから、これがDisplayStringかそれとも任意のデータであるかがどんな明確ではありません。 これは、エージェントがオブジェクトがある種に含まれているならDisplayStringであるオブジェクトに関してコンパイルされたMIBを知ることができるだけであることを意味します。 それがあると、エージェントはDPI SETパケットでvarBindのタイプ分野でSNMP_TYPE_DisplayStringを使用するでしょう。 あなたがRESPONSEパケットでDisplayStringを送るとき、エージェントはそういうものとしてそれを扱うでしょう(例えば、必要であるなら、EBCDICをASCIIに翻訳してください)。
5.1 DPI API
5.1 DPIアピ
The primary goal of this document is to specify the SNMP DPI, a protocol by which sub-agents can exchange SNMP related information with an agent. On top of this protocol, one can imagine one or possibly many Application Programming Interfaces, but those are not addressed in this document.
このドキュメントのプライマリ目標はSNMP DPI(サブエージェントがSNMPの関連する情報をエージェントと交換できるプロトコル)を指定することです。 このプロトコルの上では、人は1かことによると多くのApplication Programming Interfacesを想像できますが、ものは本書では扱われません。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 43] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[43ページ]RFC1592SNMP-dpi行進1994
However, in order to provide an environment that is more or less platform independent, we strongly suggest to also define a DPI API. We have a sample DPI API available, see 9, "Sample Sources for Anonymous FTP" for a place to obtain that sample DPI API.
しかしながら、だいたいプラットホーム独立者である環境を提供して、私たちは、また、DPI APIを定義するために強く示します。 私たちは9が、利用可能なサンプルDPI APIがそのサンプルDPI APIを入手する場所に「アノニマス・エフテーピーのためにソースを抽出すること」がわからせます。
5.2 OVERVIEW OF REQUEST PROCESSING
5.2 要求処理の概要
5.2.1 GET PROCESSING
5.2.1 処理を得てください。
A GET request is the easiest to process. The DPI GET packet holds one or more varBinds that the sub-agent has taken responsibility for.
GET要求は最も処理しやすいです。 DPI GETパケットはサブエージェントが責任を取った1varBindsを持っています。
If the sub-agent encounters an error while processing the request, it creates a DPI RESPONSE packet with an appropriate error indication in the error_code field and sets the error_index to the position of the varBind at which the error occurs (first varBind is index 1, second varBind is index 2, and so on). No name/type/length/value information needs to be provided in the packet, because by definition, the varBind information is the same as in the request to which this is a response, and the agent still has that information.
サブエージェントが要求を処理している間、誤りに遭遇するなら、それは、誤り_コード分野で適切な誤り表示でDPI RESPONSEパケットを作成して、誤りが発生するvarBindの位置に誤り_インデックスを設定します(第2varBindは最初に、varBindがインデックス1であり、インデックス2などです)。 どんな名前/タイプ/長さ/値の情報も、パケットに提供される必要がありません、定義上、varBind情報がこれが応答である要求と同じであり、エージェントにはその情報がまだあるので。
If there are no errors, then the sub-agent creates a DPI RESPONSE packet in which the error_code is set to SNMP_ERROR_noError (zero) and error_index is set to zero. The packet must also include the name/type/length/value of each varBind requested. When you get a request for a non-existing object or a non-existing instance of an object, then you must return a NULL value with a type of SNMP_TYPE_noSuchObject or SNMP_TYPE_noSuchInstance respectively.
誤りが全くなければ、サブエージェントは誤り_コードがSNMP_ERROR_noError(ゼロ)と合わせてください_インデックスが設定されるゼロ誤りに設定されるDPI RESPONSEパケットを作成します。 また、パケットはvarBindが要求したそれぞれの名前/タイプ/長さ/値を含まなければなりません。 非既存のオブジェクトかオブジェクトの非既存のインスタンスを求める要求を得ると、あなたはそれぞれ一種のSNMP_TYPE_noSuchObjectかSNMP_TYPE_noSuchInstanceがあるNULL値を返さなければなりません。
These two values are not considered errors, so the error_code and error_index should be zero.
これらの2つの値が誤りであることは考えられないので、誤り_コードと誤り_インデックスはゼロであるべきです。
The DPI RESPONSE packet is then sent back to the agent.
そして、DPI RESPONSEパケットはエージェントに送り返されます。
5.2.2 SET PROCESSING
5.2.2 処理を設定してください。
Processing a DPI SET request is more difficult than a DPI GET request. In the case of a DPI SET packet, additional information is available in the packet, namely the value type, value length and value to be set.
DPI SET要求を処理するのはDPI GET要求より難しいです。 DPI SETパケットのケースでは、追加情報がパケットで利用可能であり、すなわち、値は、タイプと、値の長さと設定されるべき値です。
If the sub-agent encounters an error while processing the request, it creates a DPI RESPONSE packet with an appropriate error indication in the error_code field and an error_index listing the position of the varBind at which the error occurs (first varBind is index 1, second varBind is index 2, and so on). No name/type/length/value information needs to provided in the packet, because by definition, the varBind information is the same as in the request to which this
サブエージェントが要求を処理している間、誤りに遭遇するなら、適切な誤り表示が誤り_コード分野にあって、誤り_インデックスが誤りが発生するvarBindの位置を記載している状態で、それはDPI RESPONSEパケットを作成します(第2varBindは最初に、varBindがインデックス1であり、インデックス2などです)。 どんな名前/タイプ/長さ/値の情報も、パケットに提供していた状態で必要がありません、varBind情報が定義上要求と同じであるのでどれ、これ
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 44] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[44ページ]RFC1592SNMP-dpi行進1994
is a response, and the agent still has that information.
aは応答です、そして、エージェントには、その情報がまだあります。
If there are no errors, then the sub-agent creates a DPI RESPONSE packet in which the error_code is set to SNMP_ERROR_noError (zero) and error_index is set to zero. No name/type/length/value information is needed; by definition the RESPONSE to a SET should contain exactly the same varBind data as the data present in the request, so the agent can use the values it already has. (This suggests that the agent must keep state information, and that is indeed the case. It needs to do that anyway in order to be able to later pass the data with a DPI COMMIT or DPI UNDO packet). The sub- agent must have allocated the required resources and prepared itself for the SET. It does not yet effectuate the set, that will be done at COMMIT time.
誤りが全くなければ、サブエージェントは誤り_コードがSNMP_ERROR_noError(ゼロ)と合わせてください_インデックスが設定されるゼロ誤りに設定されるDPI RESPONSEパケットを作成します。 名前/タイプ/長さ/値の情報は全く必要ではありません。 定義上、SETへのRESPONSEがまさに要求の現在のデータと同じvarBindデータを含むはずであるので、エージェントはそれが既に持っている値を使用できます。 (これは、エージェントが、状態が情報であることを保たなければならないのを示します、そして、本当に、それはそうです。 それは、後でDPI COMMITかDPI UNDOパケットでデータを通過できるようにとにかくそれをする必要があります。). サブエージェントは、必要なリソースを割り当てて、SETのために準備したに違いありません。 それはまだセットを実現していなくて、COMMIT時にそれをするでしょう。
The sub-agent sends a DPI RESPONSE packet (indicating success or failure for the preparation phase) back to the agent.
サブエージェントはDPI RESPONSEパケット(準備フェーズのために成否を示す)をエージェントに送って戻します。
The agent will then issue a SET request for all other varBinds in the same original SNMP request it received. This may be to the same or to one or more different sub-agents. Once all SET requests have returned a "no error" condition, the agent starts sending DPI COMMIT packets to the sub-agent(s). If any SET request returns an error, then the agent sends DPI UNDO packets to those sub-agents that indicated successful processing of the SET preparation phase.
そして、エージェントはそれが受け取った同じオリジナルのSNMP要求における他のすべてのvarBindsを求めるSET要求を出すでしょう。 同じくらい、または、1人以上の異なったサブエージェントにこれはあるかもしれません。 すべてのSET要求がいったん「誤りがありません」状態を返すと、エージェントはサブエージェントへのパケットをDPI COMMITに送り始めます。 何かSET要求が誤りを返すなら、エージェントはSET準備フェーズのうまくいっている処理を示したサブエージェントであるものへのパケットをDPI UNDOに送ります。
When the sub-agent receives the DPI COMMIT packet, again all the varBind information will be available in the packet. The sub-agent can now effectuate the SET request.
サブエージェントがDPI COMMITパケットを受けるとき、再びすべてのvarBind情報がパケットで利用可能になるでしょう。 サブエージェントは現在、SET要求を実現できます。
If the sub-agent encounters an error while processing the COMMIT request, it creates a DPI RESPONSE packet with value SNMP_ERROR_commitFailed in the error_code field and an error_index that lists at which varBind the error occurs (first varBind is index 1 and so on). No name/type/length/value information is needed. The fact that a commitFailed error exists does not mean that this error should be returned easily. A sub-agent should do all that is possible to make a COMMIT succeed.
サブエージェントがCOMMIT要求を処理している間、誤りに遭遇するなら、値のSNMP_ERROR_commitFailedと共に誤り_コード分野でDPI RESPONSEパケットを作成します、そして、どのvarBindで誤りを記載する誤り_インデックスは起こります(最初に、varBindはインデックス1などです)。 名前/タイプ/長さ/値の情報は全く必要ではありません。 commitFailed誤りが存在しているという事実は、この誤りが容易に返されるべきであることを意味しません。 サブエージェントはCOMMITを成功させるのにおいて可能なすべてをするべきです。
If there are no errors, and the SET/COMMIT has been effectuated with success, then the sub-agent creates a DPI RESPONSE packet in which the error_code is set to SNMP_ERROR_noError (zero) and error_index is set to zero. No name/type/length/value information is needed.
誤りが全くなくて、SET/COMMITが成功で実現されたなら、サブエージェントは誤り_コードがSNMP_ERROR_noError(ゼロ)と合わせてください_インデックスが設定されるゼロ誤りに設定されるDPI RESPONSEパケットを作成します。 名前/タイプ/長さ/値の情報は全く必要ではありません。
So far we have discussed a SET, COMMIT sequence. That happens if all goes well. However, after a successful SET, the sub-agent may receive a DPI UNDO packet. The sub-agent must now undo any preparations it made during the SET processing (like free allocated
今までのところ、私たちはSET、COMMIT系列について議論しました。 すべてがうまく行くなら、それは起こります。 しかしながら、うまくいっているSETの後に、サブエージェントはDPI UNDOパケットを受けるかもしれません。 サブエージェントが現在それがSET処理の間にしたどんな準備も元に戻さなければならない、(無料で、割り当てて、好きです。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 45] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[45ページ]RFC1592SNMP-dpi行進1994
memory and such). Even after a COMMIT, a sub-agent may still receive a DPI UNDO packet. This is the case if some other sub-agent could not complete a COMMIT request. Because of the SNMP-requirement that all varBinds in a single SNMP SET request must be changed "as if simultaneous", all committed changes must be undone if any of the COMMIT requests fail. In this case the sub-agent must try and undo the committed SET operation.
メモリとそのようなもの) COMMITの後にさえ、サブエージェントはまだDPI UNDOパケットを受けているかもしれません。 ある他のサブエージェントがCOMMIT要求を終了できないなら、これはそうです。 独身のSNMP SETのすべてのvarBindsが「同時です」のように変えなければならないよう要求するSNMP-要件のために、COMMIT要求のどれかが失敗するなら、すべての遂行された変化を元に戻さなければなりません。 この場合、サブエージェントは遂行されたSET操作を元に戻してみなければなりません。
If the sub-agent encounters an error while processing the UNDO request, it creates a DPI RESPONSE packet with value SNMP_ERROR_undoFailed in the error_code field and an error_index that lists at which varBind the error occurs (first varBind is index 1 and so on). No name/type/length/value information is needed. The fact that an undoFailed error exists does not mean that this error should be returned easily. A sub-agent should do all that is possible to make an UNDO succeed.
サブエージェントがUNDO要求を処理している間、誤りに遭遇するなら、値のSNMP_ERROR_undoFailedと共に誤り_コード分野でDPI RESPONSEパケットを作成します、そして、どのvarBindで誤りを記載する誤り_インデックスは起こります(最初に、varBindはインデックス1などです)。 名前/タイプ/長さ/値の情報は全く必要ではありません。 undoFailed誤りが存在しているという事実は、この誤りが容易に返されるべきであることを意味しません。 サブエージェントはUNDOを成功させるのにおいて可能なすべてをするべきです。
If there are no errors, and the UNDO has been effectuated with success, then the sub-agent creates a DPI RESPONSE packet in which the error_code is set to SNMP_ERROR_noError (zero) and error_index is set to zero. No name/type/length/value information is needed.
誤りが全くなくて、UNDOが成功で実現されたなら、サブエージェントは誤り_コードがSNMP_ERROR_noError(ゼロ)と合わせてください_インデックスが設定されるゼロ誤りに設定されるDPI RESPONSEパケットを作成します。 名前/タイプ/長さ/値の情報は全く必要ではありません。
5.2.3 GETNEXT PROCESSING
5.2.3 GETNEXT処理
GETNEXT requests are a bit more complicated to process than a GET. The DPI GETNEXT packet contains the object(s) on which the GETNEXT operation must be performed. The semantics of the operation are that the sub-agent is to return the name/type/length/value of the next variable it supports whose (ASN.1) name lexicographically follows the one passed in the group ID (sub-tree) and instance ID.
GETNEXT要求は、処理するためにGETより複雑にされます。 DPI GETNEXTパケットはGETNEXT操作を実行しなければならない物を含んでいます。 操作の意味論はサブエージェントがそれが支持する(ASN.1)名が辞書編集にグループID(下位木)と例のIDで通過されたものに続く次の変数の名前/タイプ/長さ/値を返すことになっているということです。
In this case, the instance ID may not be present (NULL) implying that the NEXT object must be the first instance of the first object in the sub-tree that was registered.
この場合、ネクスト物が登録された下位木における最初の物の最初の例であるに違いないことを含意しながら、例のIDは存在していないかもしれません(NULL)。
It is important to realize that a given sub-agent may support several discontiguous sections of the MIB tree. In such a situation it would be incorrect to jump from one section to another. This problem is correctly handled by examining the group ID in the DPI packet. This group ID represents the "reason" why the sub-agent is being called. It holds the prefix of the tree that the sub-agent had indicated it supported (registered).
与えられたサブエージェントがMIB木のいくつかのdiscontiguous部を支持するかもしれないとわかるのは重要です。 そのような状況で、1つのセクションから別のものまでジャンプするのは不正確でしょう。 この問題は、DPIパケットでグループIDを調べることによって、正しく扱われます。 このグループIDはサブエージェントが呼ばれている「理由」を表します。 それはサブエージェントが支持したのを(登録されます)示した木の接頭語を保持します。
If the next variable supported by the sub-agent does not begin with that prefix, the sub-agent must return the same object instance as in the request (e.g. group ID and instance ID) with a value of SNMP_TYPE_endOfMibView (implied NULL value). This endOfMibView is not considered an error, so the error_code and error_index should be
サブエージェントによって支持された次の変数がその接頭語で始まらないなら、サブエージェントはSNMP_TYPE_endOfMibView(暗示しているNULL値)の値がある要求(例えば、グループIDと例のID)のように同じ物の例を返さなければなりません。 このendOfMibViewが誤りであることは考えられないので、誤り_コードと誤り_インデックスがあるべきです。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 46] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[46ページ]RFC1592SNMP-dpi行進1994
zero. If required, the SNMP agent will call upon the sub-agent again, but pass it a different group ID (prefix). This is illustrated in the discussion below.
ゼロ。 必要なら、SNMPエージェントは再びサブエージェントを訪問するでしょうが、異なったグループID(接頭語)をそれに通過してください。 これは以下での議論で例証されます。
Assume there are two sub-agents. The first sub-agent registers two distinct sections of the tree, A and C. In reality, the sub-agent supports variables A.1 and A.2, but it correctly registers the minimal prefix required to uniquely identify the variable class it supports.
2人のサブエージェントがいると仮定してください。 第1代サブエージェントは2つの異なったセクションの木、A、およびC.In現実を示しますが、サブエージェントは変数のA.1とA.2を支持しますが、それは正しく唯一それが支持する可変クラスを特定するのに必要である最小量の接頭語を登録します。
The second sub-agent registers a different section, B, which appears between the two sections registered by the first agent.
第2代サブエージェントは別区、Bを登録します。(それは、2つのセクションに間第1代エージェントによって示された現れます)。
If a management station begins dumping the MIB, starting from A, the following sequence of queries of the form get-next(group ID, instance ID) would be performed:
A、形式の質問の以下の系列から始めて、管理局が気付いた状態でMIBを捨て始めるなら(IDを分類してください、例のID)、実行されるでしょう:
Sub-agent 1 gets called:
get-next(A,none) = A.1
get-next(A,1) = A.2
get-next(A,2) = endOfMibView
サブエージェント1は呼ばれます: 気付いている(A、2)気付いている(なにものA)=気付いている(A、1)A.1=A.2=endOfMibView
Sub-agent 2 is then called:
get-next(B,none) = B.1
get-next(B,1) = endOfMibView
次に、サブエージェント2は呼ばれます: 気付いている(B、1)気付いている(なにものB)=B.1=endOfMibView
Sub-agent 1 gets called again:
get-next(C,none) = C.1
サブエージェント1は再び呼ばれます: 気付いている(なにものC)=C.1
5.2.4 GETBULK PROCESSING
5.2.4 GETBULK処理
You can ask the agent to translate GETBULK requests into multiple GETNEXT requests. This is basically the default and it is specified in the DPI REGISTER packet. In principle, we expect the majority of DPI sub-agents to run on the same machine as the agent (or otherwise, on the same physical network), so repetitive GETNEXT requests stay local and in general should not be a problem.
あなたは、複数のGETNEXT要求にGETBULK要求を翻訳するようにエージェントに頼むことができます。 これは基本的にデフォルトです、そして、それはDPI REGISTERパケットで指定されます。 原則として、私たちはエージェントと同じマシンで動くためにはサブエージェントの、そして、(同じ物理ネットワークでそうではありません)のDPIの大部分を期待します、とても反復性であるので、GETNEXT要求は、地方で滞在していて、一般に、問題であるべきではありません。
If experience tells us different, the sub-agent can tell the agent to pass on a DPI GETBULK packet.
経験が、異なって、サブエージェントが、DPI GETBULKパケットを伝えるようにエージェントに言うことができると私たちに言うなら。
When a GETBULK request is received, the sub-agent must process the request and send a RESPONSE that sends back as many varBinds as requested by the request, as long as they fit with in the buffers.
GETBULK要求が受信されているとき、サブエージェントは、要求を処理して、要求された通り彼らと同じくらい長い間要求でバッファで適任の状態で同じくらい多くのvarBindsを返送するRESPONSEを送らなければなりません。
The GETBULK requires similar processing as a GETNEXT with regard to endOfMibView handling.
GETBULKはGETNEXTとしてendOfMibView取り扱いに関して同様の処理を必要とします。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 47] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[47ページ]RFC1592SNMP-dpi行進1994
5.2.5 OPEN REQUEST
5.2.5 開いている要求
As the very first step, a DPI sub-agent must open a "connection" with the agent. To do so, it must send a DPI OPEN packet in which these things must be specified:
まさしくその第一歩として、DPIサブエージェントはエージェントとの「接続」を開かなければなりません。 そうするために、これらのものを指定しなければならないDPI OPENパケットを送らなければなりません:
o The max timeout value in seconds. The agent is requested to
wait this long for a response to any request for an object
being handled by this sub-agent. The agent may have an
absolute maximum timeout value which will be used if the
sub-agent asks for too big a timeout value. A value of zero
can be used to indicate that the agent's own default timeout
value should be used. A sub-agent is advised to use a
reasonably short interval of a few seconds or so. If a
specific sub-tree needs a (much) longer time, then a specific
REGISTER can be done for that sub-tree with a longer timeout
value.
o The maximum number of varBinds that the sub-agent is prepared
to handle per DPI packet. Specifying 1 would result in DPI
version 1 behavior of one varBind per DPI packet that the agent
sends to the sub-agent.
o The character set you want to use. By default (value 0) this is
the native character set of the machine (platform) where the
agent runs.
Since the sub-agent and agent normally run on the same system
or platform, you want to use the native character set (which on
many platforms is ASCII anyway).
If your platform is EBCDIC based, then using the native
character set of EBCDIC makes it easy to recognize the string
representations of the fields like group ID, instance ID, etc.
o 秒の最大タイムアウト価値。 エージェントがこのサブエージェントによって扱われる物を求めるどんな要求への応答のためにも長い間これを待つよう要求されています。 エージェントには、サブエージェントが大き過ぎるタイムアウト値を求めるなら使用される絶対最大値タイムアウト価値があるかもしれません。 エージェントの自己のデフォルトタイムアウト価値が使用されるべきであるのを示すのにゼロの値を使用できます。 サブエージェントが数秒かそうの適度に短い間隔を費やすようにアドバイスされます。 特定の下位木が(多くの)より長い時間を必要とするなら. ○ サブエージェントがvarBindsの最大数ですが、DPI単位でパケットを扱うように準備される場合その下位木のために、より長いタイムアウト値で特定のREGISTERをできるその時です。 指定1はそうするでしょう。エージェントが. ○ あなたが使用したい文字の組をサブエージェントに送るというDPIパケットあたり1varBindのDPIバージョン1動きにおける結果。 デフォルトで(値0)、これはエージェントが走るマシン(プラットホーム)の固有の文字の組です。 サブエージェントとエージェントが通常同じシステムかプラットホームで動くので、あなたは固有の文字の組(とにかく多くのプラットホームのASCIIである)を使用したがっています。 あなたのプラットホームがそれが基づいていて、次に、EBCDICの固有の文字の組を使用するとグループIDのように分野のストリング表現を認識するためにたやすくするEBCDICであるなら、例のIDですなど。
At the same time, the agent will translate the value from ASCII
NVT to EBCDIC (and vice versa) for objects that it knows (from
a compiled MIB) to have a textual convention of DisplayString.
Be aware that this fact cannot be determined from the SNMP PDU
encoding because in the PDU the object is only known to be an
OCTET_STRING.
If your sub-agent runs on an ASCII based platform and the agent
runs on an EBCDIC based platform (or the other way around),
then you can specify that you want to use the ASCII character
set, and so you both know how to handle the string-based data.
Beware that not all agents need to support other than native
character set selection. See 5, "Subagent Considerations"
and 3.3.5, "Character set selection" for more information on
character set usage.
o The sub-agent ID. This an ASN.1 Object Identifier that
uniquely identifies the sub-agent. This OID is represented as
a null terminated string using the selected character set.
同時に、エージェントはそれがDisplayStringの原文のコンベンションを開くのを知っている(コンパイルされたMIBから)物のためにASCII NVTからEBCDIC(逆もまた同様である)まで値を翻訳するでしょう。 物がPDUでOCTET_STRINGであることが知られているだけであるのでこの事実がSNMP PDUコード化から決定できないのを意識してください。 あなたのサブエージェントがASCIIのベースのプラットホームで走って、エージェントがEBCDICのベースのプラットホーム(逆である)で走るならあなたが、ASCII文字の組を使用したいと指定できるので、あなた方二人はストリングベースのデータを扱う方法を知っています。 エージェントがネイティブの文字の組選択を除いて、支持する必要があるすべてではなく、それに注意してください。 文字の組用法○ サブエージェントIDに関する詳しい情報のための5、「副代理店問題」、および3.3.5、「文字の組選択」を見てください。 これ、唯一サブエージェントを特定するASN.1Object Identifier。 このOIDは、ヌル終えられたストリングとして選択された文字の組を使用することで表されます。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 48] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[48ページ]RFC1592SNMP-dpi行進1994
Example: "1.3.5.1.2.3.4.5".
o The sub-agent Description. This is a DisplayString describing
the sub-agent. This is a character string using the selected
character set. Example: "DPI sample sub-agent version 2.0"
例: 「1.3、.5、.1、.2、.3、.4、0.5インチ○ サブエージェント記述、」 これはサブエージェントについて説明するDisplayStringです。 これは選択された文字の組を使用する文字列です。 例: 「DPIはサブエージェントバージョン2インチを抽出します」
Once a sub-agent has sent a DPI OPEN packet to an agent, it should expect a DPI RESPONSE packet that informs the sub-agent about the result of the request. The packet ID of the RESPONSE packet should be the same as that of the OPEN request to which the RESPONSE packet is the response. See Table 19 for a list of valid DPI RESPONSE error codes that may be expected. If you receive an error RESPONSE on the OPEN packet, then you will also receive a DPI CLOSE packet with an SNMP_CLOSE_openError code, and then the agent closes the "connection".
サブエージェントがいったんDPI OPENパケットをエージェントに送ると、それは要求の結果に関してサブエージェントに知らせるDPI RESPONSEパケットを予想するべきです。 RESPONSEパケットのパケットIDはRESPONSEパケットが応答であるオープン要求のものと同じであるべきです。 予想されるかもしれない有効なDPI RESPONSEエラーコードのリストに関してTable19を見てください。 また、オープンパケットの上に誤りRESPONSEを受け取ると、あなたはSNMP_CLOSE_openErrorコードでDPI CLOSEパケットを受けるでしょう、そして、次に、エージェントは「接続」を閉じます。
If the OPEN is accepted, then the next step is to REGISTER one or more MIB sub-trees.
オープンを受け入れるなら、より多くのREGISTER1MIB下位木には次のステップがあります。
5.2.6 CLOSE REQUEST
5.2.6 要求を終えてください。
When a sub-agent is finished and wants to terminate it should first UNREGISTER its sub-trees and then close the "connection" with the agent. To do so, it must send a DPI CLOSE packet in which it specifies a reason for the closing. See Table 21 for a list of valid CLOSE reason codes. You should not expect a response to the CLOSE request.
サブエージェントが終わって、終わりたがっているとき、最初にそうするべきである、UNREGISTER、下位木とその時はエージェントとの「接続」を閉じます。 そうするために、それは閉鎖の理由を指定するDPI CLOSEパケットを送らなければなりません。 有効なCLOSE理由コードのリストに関してTable21を見てください。 あなたはCLOSE要求への応答を予想するべきではありません。
A sub-agent should also be prepared to handle an incoming DPI CLOSE packet from the agent. Again, the packet will contain a reason code for the CLOSE request. A sub-agent need not send a response to a CLOSE request. The agent just assumes that the sub-agent will handle it appropriately. The close takes place, no matter what the sub- agent does with it.
また、サブエージェントはエージェントから入って来るDPI CLOSEパケットを扱う用意ができているべきです。 一方、パケットはCLOSE要求のための理由コードを含むでしょう。 サブエージェントはCLOSE要求に応答を送る必要はありません。 エージェントは、サブエージェントが適切にそれを扱うとただ仮定します。 サブエージェントがそれで何をしても、閉鎖は行われます。
5.2.7 REGISTER REQUEST
5.2.7 要求を登録してください。
Before a sub-agent will receive any requests for MIB variables it must first register the variables or sub-tree it supports with the SNMP agent. The sub-agent must specify a number of things in the REGISTER request:
サブエージェントがMIB変数を求めるどんな要求も受け取る前に、それは最初に、SNMPエージェントと共に支持する変数か下位木を示さなければなりません。 サブエージェントはREGISTER要求における多くのものを指定しなければなりません:
o The sub-tree to be registered. This is a null terminated
string in the selected character set. The sub-tree must have a
trailing dot (example: "1.3.6.1.2.3.4.5.").
o The requested priority for the registration, one of:
-1 Request for best available priority.
0 Request for next better available priority than highest
priority currently registered for this sub-tree.
o 登録されるべき下位木。 これは選択された文字の組のヌル終えられたストリングです。 下位木には引きずっているドットがなければならない、(例:、「1.3 .6 .1 .2 .3 .4 .5インチ) . ○ 登録のための要求された優先権、1つ、: -1 最も良い利用可能な優先権のために、要求します。 次の最優先より良い利用可能な優先権を求める0要求は現在、この下位木に登録しました。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 49] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[49ページ]RFC1592SNMP-dpi行進1994
NNN Any other positive value requests that specific priority if
available or the first worse priority that is available.
o The max timeout value in seconds. The agent is requested to
wait this long for a response to any request for an object in
this sub-tree. The agent may have an absolute maximum timeout
value which will be used if the sub-agents asks for too big a
timeout value. A value of zero can be used to indicate that
the DPI OPEN value should be used for timeout.
o A specification if the sub-agent wants to do view selection.
If it does, then the community name (from SNMPv1 packets) will
be passed in the DPI GET, GETNEXT, SET packets).
o A specification if the sub-agent wants to receive GETBULK
packets or if it just prefers that the agent converts a GETBULK
into multiple GETNEXT requests.
利用可能であるなら、NNN Any他の正の数がその特定の優先権を要求するか、または. ○ 最大タイムアウトが秒に評価する利用可能な優先権は最初に、より悪いです。 長い間、エージェントが物を求めるどんな要求への応答のためにもこの下位木でこれを待つよう要求されています。 エージェントには、サブエージェントが大き過ぎるタイムアウト値を求めるなら使用される絶対最大値タイムアウト価値があるかもしれません。 サブエージェントが視点選択をしたいならDPI OPEN値がタイムアウトo A仕様に使用されるべきであるのを示すのにゼロの値を使用できます。 それがそうすると、サブエージェントがGETBULKパケットを受けたいならSETパケット) . DPI GET、GETNEXT、o A仕様で通過されるか、またはそれが、エージェントが複数のGETNEXT要求にGETBULKを変換するのをただ好むと、共同体名(SNMPv1パケットからの)はそうでしょう。
Once a sub-agent has sent a DPI REGISTER packet to the agent, it should expect a DPI RESPONSE packet that informs the sub-agent about the result of the request. The packet ID of the RESPONSE packet should be the same as that of the REGISTER packet to which the RESPONSE packet is the response. If the response indicates success, then the error_index field in the RESPONSE packet contains the priority that the agent assigned to the sub-tree registration. See Table 19 for a list of valid DPI RESPONSE error codes that may be expected.
サブエージェントがいったんDPI REGISTERパケットをエージェントに送ると、それは要求の結果に関してサブエージェントに知らせるDPI RESPONSEパケットを予想するべきです。 RESPONSEパケットのパケットIDはRESPONSEパケットが応答であるREGISTERパケットのものと同じであるべきです。 応答が成功を示すなら、RESPONSEパケットの誤り_インデックス部はエージェントが下位木登録に割り当てた優先権を含んでいます。 予想されるかもしれない有効なDPI RESPONSEエラーコードのリストに関してTable19を見てください。
5.2.8 UNREGISTER REQUEST
5.2.8 UNREGISTER要求
A sub-agent may unregister a previously registered sub-tree. The sub-agent must specify a few things in the UNREGISTER request:
サブエージェントはより多くのunregisterにそうするかもしれません。以前に登録された下位木。 サブエージェントはUNREGISTER要求におけるいくつかのものを指定しなければなりません:
o The sub-tree to be unregistered. This is a null terminated
string in the selected character set. The sub-tree must have a
trailing dot (example: "1.3.6.1.2.3.4.5.").
o The reason for the unregister. See Table 20 for a
list of valid reason codes.
o 登録されていない下位木。 これは選択された文字集合でヌル終えられたストリングです。 下位木には引きずっているドットがなければならない、(例:、「1.3 .6 .1 .2 .3 .4 .5インチ) . ○ 「非-レジスタ」の理由。 正当な理由コードのリストに関してTable20を見てください。
Once a sub-agent has sent a DPI UNREGISTER packet to the agent, it should expect a DPI RESPONSE packet that informs the sub-agent about the result of the request. The packet ID of the RESPONSE packet should be the same as that of the REGISTER packet to which the RESPONSE packet is the response. See Table 19 for a list of valid DPI RESPONSE error codes that may be expected.
サブエージェントがいったんDPI UNREGISTERパケットをエージェントに送ると、それは要求の結果に関してサブエージェントに知らせるDPI RESPONSEパケットを予想するべきです。 RESPONSEパケットのパケットIDはRESPONSEパケットが応答であるREGISTERパケットのものと同じであるべきです。 予想されるかもしれない有効なDPI RESPONSEエラーコードのリストに関してTable19を見てください。
A sub-agent should also be prepared to handle incoming DPI UNREGISTER packets from the agent. Again, the DPI packet will contain a reason code for the UNREGISTER. A sub-agent need not send a response to an UNREGISTER request. The agent just assumes that the sub-agent will handle it appropriately. The registration is removed, no matter what
また、サブエージェントはエージェントから入って来るDPI UNREGISTERパケットを扱う用意ができているべきです。 一方、DPIパケットはUNREGISTERのための理由コードを含むでしょう。 サブエージェントはUNREGISTER要求に応答を送る必要はありません。 エージェントは、サブエージェントが適切にそれを扱うとただ仮定します。 たとえ何があっても、登録を取り除きます。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 50] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[50ページ]RFC1592SNMP-dpi行進1994
the sub-agent returns.
サブエージェントは戻ります。
5.2.9 TRAP REQUEST
5.2.9 罠要求
A sub-agent can request that the SNMP agent generates a trap for it. The sub-agent must provide the desired values for the generic and specific parameters of the trap. It may optionally provide a set of one or more name/type/length/value tuples that will be included in the trap packet. Also, it may optionally specify an Enterprise ID (Object Identifier) for the trap to be generated. If a NULL value is specified for the Enterprise ID, then the agent will use the sub- agent Identifier (from the DPI OPEN packet) as the Enterprise ID to be sent with the trap.
サブエージェントは、SNMPエージェントがそれのために罠を生成するよう要求できます。 サブエージェントは罠のジェネリックと特定のパラメタに目標値を提供しなければなりません。 それは任意に罠パケットに含まれている1名前/タイプ/長さ/値のtuplesの1セットを提供するかもしれません。 また、それは、罠が生成されるために、任意に、エンタープライズID(オブジェクトIdentifier)を指定するかもしれません。 NULL値がエンタープライズIDに指定されると、エージェントは、罠と共に送るのに、エンタープライズIDとしてサブエージェントIdentifier(DPI OPENパケットからの)を使用するでしょう。
5.2.10 ARE_YOU_THERE REQUEST
5.2.10 _あなたがそこの_である、要求
A sub-agent can send an ARE_YOU_THERE packet to the agent. This may be useful to do if you have a DPI "connection" over an unreliable transport protocol (like UDP).
サブエージェントが発信できる、__あなたはエージェントへのTHEREパケットですか? 頼り無いトランスポート・プロトコル(UDPのような)の上のDPI「接続」がありましたらこれは、するために役に立つかもしれません。
If the "connection" is in a healthy state, the agent responds with a RESPONSE packet with SNMP_ERROR_DPI_noError.
「接続」が健康な状態にあるなら、エージェントはSNMP_ERROR_DPI_noErrorと共にRESPONSEパケットで応じます。
If the "connection" is not in a healthy state, the agent may respond with a RESPONSE packet with an error indication, but the agent might not react at all, so you would timeout while waiting for a response.
したがって、「接続」が健康な状態にありませんが、エージェントが誤り表示があるRESPONSEパケットで応じるかもしれませんが、エージェントが全く反応しないかもしれないなら、あなたは応答を待っている間のタイムアウトが反応するでしょう。
5.2.11 HOW TO QUERY THE DPI PORT.
5.2.11 dpiポートについて質問する方法。
The DPI API implementations are encouraged to provide a facility that helps DPI sub-agent programmers to dynamically find the port that the agent is using for the TCP and/or UDP DPI port(s). A suggested name for such a function is: query_DPI_port().
DPI API実行がDPIサブエージェントのプログラマがダイナミックにエージェントがTCP、そして/または、UDP DPIに使用しているポートにポートを見つけるのを助ける施設を提供するよう奨励されます。 そのような機能のための提案された名前は以下の通りです。 _dpi_ポート()について質問してください。
6. REFERENCES
6. 参照
[1] Case, J., Fedor, M., Schoffstall M., and J. Davin, "Simple
Network Management Protocol (SNMP)", STD 15, RFC 1157, SNMP
Research, Performance Systems International, MIT Laboratory for
Computer Science, May 1990.
[1] ケース、J.、ヒョードルとM.、Schoffstall M.とJ.デーヴィン、「簡単なネットワーク管理プロトコル(SNMP)」STD15、RFC1157、SNMPは研究します、国際言語運用機構、MITコンピュータサイエンス研究所、1990年5月。
[2] Information processing systems - Open Systems Interconnection,
"Specification of Abstract Syntax Notation One (ASN.1)",
International Organization for Standardization, International
Standard 8824, December 1987.
[2]情報処理システム--オープン・システム・インターコネクション、「抽象構文記法1(ASN.1)の仕様」、国際標準化機構、国際規格8824(1987年12月)。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 51] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[51ページ]RFC1592SNMP-dpi行進1994
[3] Information processing systems - Open Systems Interconnection,
"Specification of Basic Encoding Rules for Abstract Syntax
Notation One (ASN.1)", International Organization for
Standardization, International Standard 8825, December 1987.
[3]情報処理システム--オープン・システム・インターコネクション、「基本的なコード化の仕様は抽象構文記法1(ASN.1)のために統治されます」、国際標準化機構、国際規格8825、1987年12月。
[4] McCloghrie, K., and M. Rose, "Management Information Base for
Network Management of TCP/IP-based internets: MIB II", STD 17,
RFC 1213, Hughes LAN Systems, Performance Systems International,
March 1991.
[4]McCloghrie、K.、およびM.ローズ、「TCP/IPベースのインターネットのNetwork Managementのための管理Information基地:」 「MIB II」、STD17、RFC1213、ヒューズLANシステム、国際言語運用機構、1991年3月。
[5] Rose, M., and K. McCloghrie, "Structure and Identification of
Management Information for TCP/IP-based internets", STD 16, RFC
1155, Performance Systems International, Hughes LAN Systems, May
1990.
[5]ローズ、M.、およびK.のMcCloghrieと、「TCP/IPベースのインターネットのためのManagement情報の構造とIdentification」、STD16、RFC1155、国際パフォーマンスSystemsヒューズLAN Systems(1990年5月)
[6] Rose, M., "SNMP MUX Protocol and MIB", RFC 1227, Performance
Systems International, RFC 1227, May 1991.
[6] ローズと、M.と、「SNMP多重化装置プロトコルとMIB」(RFC1227、国際言語運用機構、RFC1227)は1991がそうするかもしれません。
[7] Carpenter G., and B. Wijnen, "SNMP-DPI, Simple Network Management
Protocol Distributed Program Interface", RFC 1228, International
Business Machines, Inc., May 1991.
[7] 大工G.、およびB.Wijnen、「SNMP-dpi、簡単なネットワーク管理プロトコルはプログラムインタフェースを分配しました」、RFC1228、インターナショナル・ビジネス・マシーンズInc.、1991年5月。
[8] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "SNMPv2
RFCs (RFC 1441 through RFC 1452)", SNMP Research Inc, Hughes LAN
Systems, Dover Beach Consulting Inc, Carnegie Mellon University,
Trusted Information Systems, April 1993.
[8]ケース、J.、McCloghrie、K.、ローズ、M.、およびS.Waldbusser、「SNMPv2 RFCs(RFC1452を通したRFC1441)」SNMP研究Inc、ヒューズLANシステム、ドーヴァービーチコンサルティングInc(カーネギーメロン大学)は情報システム(1993年4月)を信じました。
[9] International Business Machines, Inc., TCP/IP for VM:
Programmer's Reference, SC31-6084-0, 1990.
[9] インターナショナル・ビジネス・マシーンズInc.、VMのためのTCP/IP: プログラマの参照、SC31-6084-0、1990。
[10] International Business Machines, Inc., Virtual Machine System
Facilities for Programming, Release 6, SC24-5288-01, 1988.
[10] インターナショナル・ビジネス・マシーンズInc.、プログラミング、リリース6、SC24-5288-01、1988年の仮想計算機システム施設。
7. SECURITY CONSIDERATIONS
7. セキュリティ問題
Security issues are not discussed in this memo.
このメモで安全保障問題について議論しません。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 52] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[52ページ]RFC1592SNMP-dpi行進1994
8. AUTHORS' ADDRESSES
8. 作者のアドレス
Bert Wijnen IBM International Operations Watsonweg 2 1423 ND Uithoorn The Netherlands
バートのWijnen IBMの国際経営活動Watsonweg2 1423第オイトホルンオランダ
Phone: +31-2975-53316 Fax: +31-2975-62468 EMail: wijnen@vnet.ibm.com
以下に電話をしてください。 +31-2975-53316Fax: +31-2975-62468はメールされます: wijnen@vnet.ibm.com
Geoffrey C. Carpenter IBM T.J. Watson Research Center P.O. Box 218 Yorktown Heights, NY 10598 USA
ジェフリーC.大工IBM T.J.ワトソン研究所私書箱218ヨークタウンの高さ、ニューヨーク10598米国
Phone: +1-914-945-1970 EMail: gcc@watson.ibm.com
以下に電話をしてください。 +1-914-945-1970 メールしてください: gcc@watson.ibm.com
Kim Curran Bell Northern Research Ltd. P.O. Box 3511 Station C Ottawa, Ontario K1Y 4HY Canada
キムカランベル北研究株式会社私書箱3511駅のCオタワ、オンタリオK1Y 4HYカナダ
Phone: +1-613-763-5283 EMail: kcurran@bnr.ca
以下に電話をしてください。 +1-613-763-5283 メールしてください: kcurran@bnr.ca
Aditya Sehgal Bell Northern Research Ltd. P. O. Box 3511 Station C Ottawa, Ontario K1Y 4HY Canada
Aditya Sehgalベル・北研究株式会社私書箱3511駅CのオンタリオK1Y 4HYオタワ(カナダ)
Phone: +1-613-763-8821 EMail: asehgal@bnr.ca
以下に電話をしてください。 +1-613-763-8821 メールしてください: asehgal@bnr.ca
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 53] RFC 1592 SNMP-DPI March 1994
Wijnen、大工、カラン、Sehgal、および水域[53ページ]RFC1592SNMP-dpi行進1994
Glen Waters Bell Northern Research Ltd. P.O. Box 3511 Station C Ottawa, Ontario K1Y 4HY Canada
谷間水域ベル・北研究株式会社私書箱3511駅のCオタワ、オンタリオK1Y 4HYカナダ
Phone: +1-613-763-3933 EMail: gwaters@bnr.ca
以下に電話をしてください。 +1-613-763-3933 メールしてください: gwaters@bnr.ca
9. SAMPLE SOURCES FOR ANONYMOUS FTP
9. アノニマスFTPのためのサンプルソース
An implementation sample of a DPI API (as used at the agent and sub- agent side) plus sample sub-agent code and documentation are available for anonymous FTP from:
以下からのコードとドキュメンテーションが利用可能であるDPI API(エージェントとサブエージェント側で使用されるように)とサンプルサブエージェント公開FTPの実装のサンプル
software.watson.ibm.com (129.34.139.5)
software.watson.ibm.com(129.34.139.5)
To obtain the source, perform the following steps:
ソースを得るには、以下のステップを実行してください:
ftp software.watson.ibm.com
user: anonymous
password: your_e-mail_address
cd /public/dpi
get README
binary
get dpi_api.tar (or compressed dpi_api.tar.Z)
quit
ftp software.watson.ibm.comユーザ: 匿名のパスワード: cd/公衆/dpiがREADMEバイナリーを得るあなたの_メール_アドレスで、dpi_api.tar(または、圧縮されたdpi_api.tar.Z)をやめます。
Wijnen, Carpenter, Curran, Sehgal & Waters [Page 54]
Wijnen、大工(カラン)Sehgal、および水域[54ページ]
一覧
スポンサーリンク
