Agent Extensibility (AgentX) Protocol Version 1
RFC 2257
Document | Type |
RFC - Proposed Standard
(January 1998; No errata)
Obsoleted by RFC 2741
|
|
---|---|---|---|
Authors | Michael Daniele , Dale Francisco , Bert Wijnen | ||
Last updated | 2013-03-02 | ||
Stream | IETF | ||
Formats | plain text html pdf htmlized bibtex | ||
Stream | WG state | (None) | |
Document shepherd | No shepherd assigned | ||
IESG | IESG state | RFC 2257 (Proposed Standard) | |
Consensus Boilerplate | Unknown | ||
Telechat date | |||
Responsible AD | (None) | ||
Send notices to | (None) |
Network Working Group M. Daniele Request for Comments: 2257 Digital Equipment Corporation Category: Standards Track B. Wijnen T.J. Watson Research Center, IBM Corp. D. Francisco, Ed. Cisco Systems, Inc. January 1998 Agent Extensibility (AgentX) Protocol Version 1 Status of this Memo This document specifies an Internet standards track protocol for the Internet community, and requests discussion and suggestions for improvements. Please refer to the current edition of the "Internet Official Protocol Standards" (STD 1) for the standardization state and status of this protocol. Distribution of this memo is unlimited. Copyright Notice Copyright (C) The Internet Society (1998). All Rights Reserved. Table of Contents 1 Introduction......................................................4 2 The SNMP Framework................................................4 2.1 A Note on Terminology.........................................4 3 Extending the MIB.................................................5 3.1 Motivation for AgentX.........................................5 4 AgentX Framework..................................................6 4.1 AgentX Roles..................................................7 4.2 Applicability.................................................8 4.3 Design Features of AgentX.....................................9 4.4 Non-Goals....................................................10 5 AgentX Encodings.................................................10 5.1 Object Identifier............................................11 5.2 SearchRange..................................................13 5.3 Octet String.................................................14 5.4 Value Representation.........................................14 6 Protocol Definitions.............................................16 6.1 AgentX PDU Header............................................16 Daniele, et. al. Standards Track [Page 1] RFC 2257 AgentX January 1998 6.1.1 Context..................................................19 6.2 AgentX PDUs..................................................20 6.2.1 The agentx-Open-PDU......................................20 6.2.2 The agentx-Close-PDU.....................................21 6.2.3 The agentx-Register-PDU..................................22 6.2.4 The agentx-Unregister-PDU................................25 6.2.5 The agentx-Get-PDU.......................................27 6.2.6 The agentx-GetNext-PDU...................................29 6.2.7 The agentx-GetBulk-PDU...................................30 6.2.8 The agentx-TestSet-PDU...................................31 6.2.9 The agentx-CommitSet, -UndoSet, -CleanupSet PDUs.....................................................33 6.2.10 The agentx-Notify-PDU...................................33 6.2.11 The agentx-Ping-PDU.....................................34 6.2.12 The agentx-IndexAllocate-PDU............................35 6.2.13 The agentx-IndexDeallocate-PDU..........................36 6.2.14 The agentx-AddAgentCaps-PDU.............................37 6.2.15 The agentx-RemoveAgentCaps-PDU..........................38 6.2.16 The agentx-Response-PDU.................................39 7 Elements of Procedure............................................41 7.1 Processing AgentX Administrative Messages....................42 7.1.1 Processing the agentx-Open-PDU...........................42 7.1.2 Processing the agentx-IndexAllocate-PDU..................43 7.1.3 Using the agentx-IndexAllocate-PDU.......................45 7.1.4 Processing the agentx-IndexDeallocate-PDU................47 7.1.5 Processing the agentx-Register-PDU.......................48 7.1.5.1 Handling Duplicate OID Ranges........................50 7.1.6 Processing the agentx-Unregister-PDU.....................51 7.1.7 Processing the agentx-AddAgentCaps-PDU...................51 7.1.8 Processing the agentx-RemoveAgentCaps-PDU................52 7.1.9 Processing the agentx-Close-PDU..........................52 7.1.10 Detecting Connection Loss...............................53 7.1.11 Processing the agentx-Notify-PDU........................53 7.1.12 Processing the agentx-Ping-PDU..........................54 7.2 Processing Received SNMP Protocol Messages...................54Show full document text