RFC 1592 (rfc1592) - Page 2 of 54


Simple Network Management Protocol Distributed Protocol Interface Version 2



Alternative Format: Original Text Document



RFC 1592                        SNMP-DPI                      March 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

1.  INTRODUCTION

   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.

   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.

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

   Versions 1.0 and 1.1 of this protocol have been in use within IBM



Wijnen, Carpenter, Curran, Sehgal & Waters