home *** CD-ROM | disk | FTP | other *** search
/ Internet Core Protocols / Oreilly-InternetCoreProtocols.iso / RFCs / rfc2257.txt < prev    next >
Encoding:
Text File  |  1999-10-14  |  177.7 KB  |  4,484 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. Network Working Group                                         M. Daniele
  8. Request for Comments: 2257                 Digital Equipment Corporation
  9. Category: Standards Track                                      B. Wijnen
  10.                                   T.J. Watson Research Center, IBM Corp.
  11.                                                        D. Francisco, Ed.
  12.                                                      Cisco Systems, Inc.
  13.                                                             January 1998
  14.  
  15.                  Agent Extensibility (AgentX) Protocol
  16.                                Version 1
  17.  
  18.  
  19. Status of this Memo
  20.  
  21.    This document specifies an Internet standards track protocol for the
  22.    Internet community, and requests discussion and suggestions for
  23.    improvements.  Please refer to the current edition of the "Internet
  24.    Official Protocol Standards" (STD 1) for the standardization state
  25.    and status of this protocol.  Distribution of this memo is unlimited.
  26.  
  27. Copyright Notice
  28.  
  29.    Copyright (C) The Internet Society (1998).  All Rights Reserved.
  30.  
  31. Table of Contents
  32.  
  33.    1 Introduction......................................................4
  34.  
  35.    2 The SNMP Framework................................................4
  36.      2.1 A Note on Terminology.........................................4
  37.  
  38.    3 Extending the MIB.................................................5
  39.      3.1 Motivation for AgentX.........................................5
  40.  
  41.    4 AgentX Framework..................................................6
  42.      4.1 AgentX Roles..................................................7
  43.      4.2 Applicability.................................................8
  44.      4.3 Design Features of AgentX.....................................9
  45.      4.4 Non-Goals....................................................10
  46.  
  47.    5 AgentX Encodings.................................................10
  48.      5.1 Object Identifier............................................11
  49.      5.2 SearchRange..................................................13
  50.      5.3 Octet String.................................................14
  51.      5.4 Value Representation.........................................14
  52.  
  53.    6 Protocol Definitions.............................................16
  54.      6.1 AgentX PDU Header............................................16
  55.  
  56.  
  57.  
  58. Daniele, et. al.            Standards Track                     [Page 1]
  59.  
  60. RFC 2257                        AgentX                      January 1998
  61.  
  62.  
  63.        6.1.1 Context..................................................19
  64.      6.2 AgentX PDUs..................................................20
  65.        6.2.1 The agentx-Open-PDU......................................20
  66.        6.2.2 The agentx-Close-PDU.....................................21
  67.        6.2.3 The agentx-Register-PDU..................................22
  68.        6.2.4 The agentx-Unregister-PDU................................25
  69.        6.2.5 The agentx-Get-PDU.......................................27
  70.        6.2.6 The agentx-GetNext-PDU...................................29
  71.        6.2.7 The agentx-GetBulk-PDU...................................30
  72.        6.2.8 The agentx-TestSet-PDU...................................31
  73.        6.2.9 The agentx-CommitSet, -UndoSet, -CleanupSet
  74.              PDUs.....................................................33
  75.        6.2.10 The agentx-Notify-PDU...................................33
  76.        6.2.11 The agentx-Ping-PDU.....................................34
  77.        6.2.12 The agentx-IndexAllocate-PDU............................35
  78.        6.2.13 The agentx-IndexDeallocate-PDU..........................36
  79.        6.2.14 The agentx-AddAgentCaps-PDU.............................37
  80.        6.2.15 The agentx-RemoveAgentCaps-PDU..........................38
  81.        6.2.16 The agentx-Response-PDU.................................39
  82.  
  83.    7 Elements of Procedure............................................41
  84.      7.1 Processing AgentX Administrative Messages....................42
  85.        7.1.1 Processing the agentx-Open-PDU...........................42
  86.        7.1.2 Processing the agentx-IndexAllocate-PDU..................43
  87.        7.1.3 Using the agentx-IndexAllocate-PDU.......................45
  88.        7.1.4 Processing the agentx-IndexDeallocate-PDU................47
  89.        7.1.5 Processing the agentx-Register-PDU.......................48
  90.          7.1.5.1 Handling Duplicate OID Ranges........................50
  91.        7.1.6 Processing the agentx-Unregister-PDU.....................51
  92.        7.1.7 Processing the agentx-AddAgentCaps-PDU...................51
  93.        7.1.8 Processing the agentx-RemoveAgentCaps-PDU................52
  94.        7.1.9 Processing the agentx-Close-PDU..........................52
  95.        7.1.10 Detecting Connection Loss...............................53
  96.        7.1.11 Processing the agentx-Notify-PDU........................53
  97.        7.1.12 Processing the agentx-Ping-PDU..........................54
  98.      7.2 Processing Received SNMP Protocol Messages...................54
  99.        7.2.1 Dispatching AgentX PDUs..................................55
  100.          7.2.1.1 agentx-Get-PDU.......................................57
  101.          7.2.1.2 agentx-GetNext-PDU...................................58
  102.          7.2.1.3 agentx-GetBulk-PDU...................................59
  103.          7.2.1.4 agentx-TestSet-PDU...................................60
  104.          7.2.1.5 Dispatch.............................................60
  105.        7.2.2 Subagent Processing of agentx-Get, GetNext,
  106.              GetBulk-PDUs.............................................61
  107.          7.2.2.1 Subagent Processing of the agentx-Get-PDU............61
  108.          7.2.2.2 Subagent Processing of the
  109.                  agentx-GetNext-PDU...................................62
  110.  
  111.  
  112.  
  113.  
  114. Daniele, et. al.            Standards Track                     [Page 2]
  115.  
  116. RFC 2257                        AgentX                      January 1998
  117.  
  118.  
  119.          7.2.2.3 Subagent Processing of the
  120.                  agentx-GetBulk-PDU...................................62
  121.        7.2.3 Subagent Processing of agentx-TestSet,
  122.              -CommitSet, -UndoSet, -CleanupSet-PDUs...................63
  123.          7.2.3.1 Subagent Processing of the
  124.                  agentx-TestSet-PDU...................................64
  125.          7.2.3.2 Subagent Processing of the
  126.                  agentx-CommitSet-PDU.................................65
  127.          7.2.3.3 Subagent Processing of the
  128.                  agentx-UndoSet-PDU...................................65
  129.          7.2.3.4 Subagent Processing of the
  130.                  agentx-CleanupSet-PDU................................65
  131.        7.2.4 Master Agent Processing of AgentX Responses..............66
  132.          7.2.4.1 Common Processing of All AgentX Response
  133.                  PDUs.................................................66
  134.          7.2.4.2 Processing of Responses to agentx-Get-PDUs...........66
  135.          7.2.4.3 Processing of Responses to
  136.                  agentx-GetNext-PDU and agentx-GetBulk-PDU............67
  137.          7.2.4.4 Processing of Responses to
  138.                  agentx-TestSet-PDUs..................................68
  139.          7.2.4.5 Processing of Responses to
  140.                  agentx-CommitSet-PDUs................................68
  141.          7.2.4.6 Processing of Responses to
  142.                  agentx-UndoSet-PDUs..................................69
  143.        7.2.5 Sending the SNMP Response-PDU............................69
  144.        7.2.6 MIB Views................................................69
  145.      7.3 State Transitions............................................70
  146.        7.3.1 Set Transaction States...................................70
  147.        7.3.2 Transport Connection States..............................71
  148.        7.3.3 Session States...........................................73
  149.  
  150.    8 Transport Mappings...............................................74
  151.      8.1 AgentX over TCP..............................................74
  152.        8.1.1 Well-known Values........................................74
  153.        8.1.2 Operation................................................74
  154.      8.2 AgentX over UNIX-domain Sockets..............................75
  155.        8.2.1 Well-known Values........................................75
  156.        8.2.2 Operation................................................75
  157.  
  158.    9 Security Considerations..........................................76
  159.  
  160.    10 Acknowledgements................................................77
  161.  
  162.    11 Authors' and Editor's Addresses.................................77
  163.  
  164.    12 References......................................................78
  165.  
  166.    13 Full Copyright Statement........................................80
  167.  
  168.  
  169.  
  170. Daniele, et. al.            Standards Track                     [Page 3]
  171.  
  172. RFC 2257                        AgentX                      January 1998
  173.  
  174.  
  175. 1.  Introduction
  176.  
  177.    This memo defines a standardized framework for extensible SNMP
  178.    agents.  It defines processing entities called master agents and
  179.    subagents, a protocol (AgentX) used to communicate between them, and
  180.    the elements of procedure by which the extensible agent processes
  181.    SNMP protocol messages.
  182.  
  183. 2.  The SNMP Framework
  184.  
  185.    A management system contains:  several (potentially many) nodes, each
  186.    with a processing entity, termed an agent, which has access to
  187.    management instrumentation; at least one management station; and, a
  188.    management protocol, used to convey management information between
  189.    the agents and management stations.  Operations of the protocol are
  190.    carried out under an administrative framework which defines
  191.    authentication, authorization, access control, and privacy policies.
  192.  
  193.    Management stations execute management applications which monitor and
  194.    control managed elements.  Managed elements are devices such as
  195.    hosts, routers, terminal servers, etc., which are monitored and
  196.    controlled via access to their management information.
  197.  
  198.    Management information is viewed as a collection of managed objects,
  199.    residing in a virtual information store, termed the Management
  200.    Information Base (MIB).  Collections of related objects are defined
  201.    in MIB modules.  These modules are written using a subset of OSI's
  202.    Abstract Syntax Notation One (ASN.1) [1], termed the Structure of
  203.    Management Information (SMI) (see RFC 1902 [2]).
  204.  
  205. 2.1.  A Note on Terminology
  206.  
  207.    The term "variable" refers to an instance of a non-aggregate object
  208.    type defined according to the conventions set forth in the SMI (RFC
  209.    1902, [2]) or the textual conventions based on the SMI (RFC 1903
  210.    [3]).  The term "variable binding" normally refers to the pairing of
  211.    the name of a variable and its associated value.  However, if certain
  212.    kinds of exceptional conditions occur during processing of a
  213.    retrieval request, a variable binding will pair a name and an
  214.    indication of that exception.
  215.  
  216.    A variable-binding list is a simple list of variable bindings.
  217.  
  218.    The name of a variable is an OBJECT IDENTIFIER, which is the
  219.    concatenation of the OBJECT IDENTIFIER of the corresponding object
  220.    type together with an OBJECT IDENTIFIER fragment identifying the
  221.  
  222.  
  223.  
  224.  
  225.  
  226. Daniele, et. al.            Standards Track                     [Page 4]
  227.  
  228. RFC 2257                        AgentX                      January 1998
  229.  
  230.  
  231.    instance.  The OBJECT IDENTIFIER of the corresponding object-type is
  232.    called the OBJECT IDENTIFIER prefix of the variable.  For the purpose
  233.    of exposition, the original Internet-standard
  234.  
  235.    Network Management Framework, as described in RFCs 1155 (STD 16),
  236.    1157 (STD 15), and 1212 (STD 16), is termed the SNMP version 1
  237.    framework (SNMPv1).  The current framework, as described in RFCs
  238.    1902-1908, is termed the SNMP version 2 framework (SNMPv2).
  239.  
  240. 3.  Extending the MIB
  241.  
  242.    New MIB modules that extend the Internet-standard MIB are
  243.    continuously being defined by various IETF working groups.  It is
  244.    also common for enterprises or individuals to create or extend
  245.    enterprise-specific or experimental MIBs.
  246.  
  247.    As a result, managed devices are frequently complex collections of
  248.    manageable components that have been independently installed on a
  249.    managed node.  Each component provides instrumentation for the
  250.    managed objects defined in the MIB module(s) it implements.
  251.  
  252.    Neither the SNMP version 1 nor version 2 framework describes how the
  253.    set of managed objects supported by a particular agent may be changed
  254.    dynamically.
  255.  
  256. 3.1.  Motivation for AgentX
  257.  
  258.    This very real need to dynamically extend the management objects
  259.    within a node has given rise to a variety of "extensible agents",
  260.    which typically comprise
  261.  
  262.       - a "master" agent that is available on the standard transport
  263.         address and that accepts SNMP protocol messages
  264.  
  265.       - a set of "subagents" that each contain management
  266.         instrumentation
  267.  
  268.       - a protocol that operates between the master agent and subagents,
  269.         permitting subagents to "connect" to the master agent, and the
  270.         master agent to multiplex received SNMP protocol messages
  271.         amongst the subagents.
  272.  
  273.       - a set of tools to aid subagent development, and a runtime (API)
  274.         environment that hides much of the protocol operation between a
  275.         subagent and the master agent.
  276.  
  277.  
  278.  
  279.  
  280.  
  281.  
  282. Daniele, et. al.            Standards Track                     [Page 5]
  283.  
  284. RFC 2257                        AgentX                      January 1998
  285.  
  286.  
  287.    The wide deployment of extensible SNMP agents, coupled with the lack
  288.    of Internet standards in this area, makes it difficult to field
  289.    SNMP-manageable applications.  A vendor may have to support several
  290.    different subagent environments (APIs) in order to support different
  291.    target platforms.
  292.  
  293.    It can also become quite cumbersome to configure subagents and
  294.    (possibly multiple) master agents on a particular managed node.
  295.  
  296.    Specifying a standard protocol for agent extensibility (AgentX)
  297.    provides the technical foundation required to solve both of these
  298.    problems.  Independently developed AgentX-capable master agents and
  299.    subagents will be able to interoperate at the protocol level.
  300.    Vendors can continue to differentiate their products in all other
  301.    respects.
  302.  
  303. 4.  AgentX Framework
  304.  
  305.    Within the SNMP framework, a managed node contains a processing
  306.    entity, called an agent, which has access to management information.
  307.  
  308.    Within the AgentX framework, an agent is further defined to consist
  309.    of
  310.  
  311.       - a single processing entity called the master agent, which sends
  312.         and receives SNMP protocol messages in an agent role (as
  313.         specified by the SNMP version 1 and version 2 framework
  314.         documents) but typically has little or no direct access to
  315.         management information.
  316.  
  317.       - 0 or more processing entities called subagents, which are
  318.         "shielded" from the SNMP protocol messages processed by the
  319.         master agent, but which have access to management information.
  320.  
  321.    The master and subagent entities communicate via AgentX protocol
  322.    messages, as specified in this memo.  Other interfaces (if any) on
  323.    these entities, and their associated protocols, are outside the scope
  324.    of this document.  While some of the AgentX protocol messages appear
  325.    similar in syntax and semantics to the SNMP, bear in mind that AgentX
  326.    is not SNMP.
  327.  
  328.    The internal operations of AgentX are invisible to an SNMP entity
  329.    operating in a manager role.  From a manager's point of view, an
  330.    extensible agent behaves exactly as would a non-extensible
  331.    (monolithic) agent that has access to the same management
  332.    instrumentation.
  333.  
  334.  
  335.  
  336.  
  337.  
  338. Daniele, et. al.            Standards Track                     [Page 6]
  339.  
  340. RFC 2257                        AgentX                      January 1998
  341.  
  342.  
  343.    This transparency to managers is a fundamental requirement of AgentX,
  344.    and is what differentiates AgentX subagents from SNMP proxy agents.
  345.  
  346. 4.1.  AgentX Roles
  347.  
  348.    An entity acting in a master agent role performs the following
  349.    functions:
  350.  
  351.       - Accepts AgentX session establishment requests from subagents.
  352.  
  353.       - Accepts registration of MIB regions by subagents.
  354.  
  355.       - Sends and accepts SNMP protocol messages on the agent's
  356.         specified transport addresses.
  357.  
  358.       - Implements the agent role Elements of Procedure specified
  359.         for the administrative framework applicable to the SNMP protocol
  360.         message, except where they specify performing management
  361.         operations.  (The application of MIB views, and the access
  362.         control policy for the managed node, are implemented by the
  363.         master agent.)
  364.  
  365.       - Provides instrumentation for the MIB objects defined in RFC
  366.         1907 [5], and for any MIB objects relevant to any administrative
  367.         framework it supports.
  368.  
  369.       - Sends and receives AgentX protocol messages to access
  370.         management information, based on the current registry of MIB
  371.         regions.
  372.  
  373.       - Forwards notifications on behalf of subagents.
  374.  
  375.    An entity acting in a subagent role performs the following functions:
  376.  
  377.       - Initiates an AgentX session with the master agent.
  378.  
  379.       - Registers MIB regions with the master agent.
  380.  
  381.       - Instantiates managed objects.
  382.  
  383.       - Binds OIDs within its registered MIB regions to actual
  384.         variables.
  385.  
  386.       - Performs management operations on variables.
  387.  
  388.       - Initiates notifications.
  389.  
  390.  
  391.  
  392.  
  393.  
  394. Daniele, et. al.            Standards Track                     [Page 7]
  395.  
  396. RFC 2257                        AgentX                      January 1998
  397.  
  398.  
  399. 4.2  Applicability
  400.  
  401.    It is intended that this memo specify the smallest amount of required
  402.    behavior necessary to achieve the largest benefit, that is, to cover
  403.    a very large number of possible MIB implementations and
  404.    configurations with minimum complexity and low "cost of entry".
  405.  
  406.    This section discusses several typical usage scenarios.
  407.  
  408.    1) Subagents implement separate MIB modules--for example,
  409.       subagent A implements "mib-2", subagent b implements "host-
  410.       resources".
  411.  
  412.       It is anticipated that this will be the most common subagent
  413.       configuration.
  414.  
  415.    2) Subagents implement rows in a "simple table".  A simple table
  416.       is one in which row creation is not specified, and for which the
  417.       MIB does not define an object that counts entries in the table.
  418.       Examples of simple tables are rdbmsDbTable, udpTable, and
  419.       hrSWRunTable.
  420.  
  421.       This is the most commonly defined type of MIB table, and probably
  422.       represents the next most typical configuration that AgentX would
  423.       support.
  424.  
  425.    3) Subagents share MIBs along non-row partitions.  Subagents
  426.       register "chunks" of the MIB that represent multiple rows, due to
  427.       the nature of the MIB's index structure.  Examples include
  428.       registering ipNetToMediaEntry.n, where n represents the ifIndex
  429.       value for an interface implemented by the subagent, and
  430.       tcpConnEntry.a.b.c.d, where a.b.c.d represents an IP address on an
  431.       interface implemented by the subagent.
  432.  
  433.    AgentX supports these three common configurations, and all
  434.    permutations of them, completely.  The consensus is that they
  435.    comprise a very large majority of current and likely future uses of
  436.    multi-vendor extensible agent configurations.
  437.  
  438.    4) Subagents implement rows in "complex tables".  Complex tables
  439.       here are defined as tables permitting row creation, or whose MIB
  440.       also defines an object that counts entries in the table.  Examples
  441.       include the MIB-2 ifTable (due to ifNumber), and the RMON
  442.       historyControlTable.
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450. Daniele, et. al.            Standards Track                     [Page 8]
  451.  
  452. RFC 2257                        AgentX                      January 1998
  453.  
  454.  
  455.    The subagent that implements such a counter object (like ifNumber)
  456.    must go beyond AgentX to correctly implement it.  This is an
  457.    implementation issue (and most new MIB designs no longer include such
  458.    objects).
  459.  
  460.    To implement row creation in such tables, at least one AgentX
  461.    subagent must register at a point "higher" in the OID tree than an
  462.    individual row (per AgentX's dispatching procedure).  Again, this is
  463.    an implementation issue.
  464.  
  465.    Scenarios in this category were thought to occur somewhat rarely in
  466.    configurations where subagents are independently implemented by
  467.    different vendors.  The focus of a standard protocol, however, must
  468.    be in just those areas where multi- vendor interoperability must be
  469.    assured.
  470.  
  471.    Note that it would be inefficient (due to AgentX registration
  472.    overhead) to share a table among AgentX subagents if the table
  473.    contains very dynamic instances, and each subagent registers fully
  474.    qualified instances.  ipRouteTable could be an example of such a
  475.    table in some environments.
  476.  
  477. 4.3.  Design Features of AgentX
  478.  
  479.    The primary features of the design described in this memo are:
  480.  
  481.    1) A general architectural division of labor between master agent
  482.       and subagent: The master agent is MIB ignorant and SNMP
  483.       omniscient, while the subagent is SNMP ignorant and MIB omniscient
  484.       (for the MIB variables it instantiates).  That is, master agents,
  485.       exclusively, are concerned with SNMP protocol operations and the
  486.       translations to and from AgentX protocol operations needed to
  487.       carry them out; subagents are exclusively concerned with
  488.       management instrumentation; and neither should intrude on the
  489.       other's territory.
  490.  
  491.    2) A standard protocol and "rules of engagement" to enable
  492.       interoperability between management instrumentation and extensible
  493.       agents.
  494.  
  495.    3) Mechanisms for independently developed subagents to
  496.       integrate into the extensible agent on a particular managed node
  497.       in such a way that they need not be aware of any other existing
  498.       subagents.
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506. Daniele, et. al.            Standards Track                     [Page 9]
  507.  
  508. RFC 2257                        AgentX                      January 1998
  509.  
  510.  
  511.    4) A simple, deterministic registry and dispatching algorithm.
  512.       For a given extensible agent configuration, there is a single
  513.       subagent who is "authoritative" for any particular region of the
  514.       MIB (where "region" may extend from an entire MIB down to a single
  515.       object-instance).
  516.  
  517.    5) Performance considerations.  It is likely that the master
  518.       agent and all subagents will reside on the same host, and in such
  519.       cases AgentX is more a form of inter-process communication than a
  520.       traditional communications protocol.
  521.  
  522.       Some of the design decisions made with this in mind include:
  523.  
  524.          - 32-bit alignment of data within PDUs
  525.  
  526.          - Native byte-order encoding by subagents
  527.  
  528.          - Large AgentX PDU payload sizes.
  529.  
  530. 4.4  Non-Goals
  531.  
  532.    1) Subagent-to-subagent communication.  This is out of scope,
  533.       due to the security ramifications and complexity involved.
  534.  
  535.    2) Subagent access (via the master agent) to MIB variables.
  536.       This is not addressed, since various other mechanisms are
  537.       available and it was not a fundamental requirement.
  538.  
  539.    3) The ability to accommodate every conceivable extensible
  540.       agent configuration option. This was the most contentious aspect
  541.       in the development of this protocol.  In essence, certain features
  542.       currently available in some commercial extensible agent products
  543.       are not included in AgentX.  Although useful or even vital in some
  544.       implementation strategies, the rough consensus was that these
  545.       features were not appropriate for an Internet Standard, or not
  546.       typically required for independently developed subagents to
  547.       coexist.  The set of supported extensible agent configurations is
  548.       described above, in Section 4.2.
  549.  
  550.    Some possible future version of the AgentX protocol may provide
  551.    coverage for one or more of these "non-goals" or for new goals that
  552.    might be identified after greater deployment experience.
  553.  
  554. 5.  AgentX Encodings
  555.  
  556.    AgentX PDUs consist of a common header, followed by PDU-specific data
  557.    of variable length.  Unlike SNMP PDUs, AgentX PDUs are not encoded
  558.    using the BER (as specified in ISO 8824 [1]), but are transmitted as
  559.  
  560.  
  561.  
  562. Daniele, et. al.            Standards Track                    [Page 10]
  563.  
  564. RFC 2257                        AgentX                      January 1998
  565.  
  566.  
  567.    a contiguous byte stream.  The data within this stream is organized
  568.    to provide natural alignment with respect to the start of the PDU,
  569.    permitting direct (integer) access by the processing entities.
  570.  
  571.    The first four fields in the header are single-byte values.  A bit
  572.    (NETWORK_BYTE_ORDER) in the third field (h.flags) is used to indicate
  573.    the byte ordering of all multi-byte integer values in the PDU,
  574.    including those which follow in the header itself.  This is described
  575.    in more detail in Section 6.1, "AgentX PDU Header", below.
  576.  
  577.    PDUs are depicted in this memo using the following convention (where
  578.    byte 1 is the first transmitted byte):
  579.  
  580.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  581.    |  byte 1       |  byte 2       |  byte 3       |  byte 4       |
  582.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  583.    |  byte 5       |  byte 6       |  byte 7       |  byte 8       |
  584.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  585.  
  586.    Fields marked "<reserved>" are reserved for future use and must be
  587.    zero-filled.
  588.  
  589. 5.1.  Object Identifier
  590.  
  591.    An object identifier is encoded as a 4-byte header, followed by a
  592.    variable number of contiguous 4-byte fields representing sub-
  593.    identifiers.  This representation (termed Object Identifier) is as
  594.    follows:
  595.  
  596.    Object Identifier
  597.  
  598.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  599.    |  n_subid      |  prefix       |  include      |  <reserved>   |
  600.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  601.    |                       sub-identifier #1                       |
  602.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  603.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  604.    |                       sub-identifier #n_subid                 |
  605.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  606.  
  607.    Object Identifier header fields:
  608.  
  609.       n_subid
  610.  
  611.          The number (0-128) of sub-identifiers in the object identifier.
  612.          An ordered list of "n_subid" 4-byte sub-identifiers follows the
  613.          4-byte header.
  614.  
  615.  
  616.  
  617.  
  618. Daniele, et. al.            Standards Track                    [Page 11]
  619.  
  620. RFC 2257                        AgentX                      January 1998
  621.  
  622.  
  623.       prefix
  624.  
  625.          An unsigned value used to reduce the length of object
  626.          identifier encodings.  A non-zero value "x" is interpreted as
  627.          the first sub-identifier after "internet" (1.3.6.1), and
  628.          indicates an implicit prefix "internet.x" to the actual sub-
  629.          identifiers encoded in the Object Identifier.  For example, a
  630.          prefix field value 2 indicates an implicit prefix "1.3.6.1.2".
  631.          A value of 0 in the prefix field indicates there is no prefix
  632.          to the sub-identifiers.
  633.  
  634.       include
  635.  
  636.          Used only when the Object Identifier is the start of a
  637.          SearchRange, as described in section 5.2.
  638.  
  639.    A null Object Identifier consists of the 4-byte header with all bytes
  640.    set to 0.
  641.  
  642.    Examples:
  643.  
  644.    sysDescr.0 (1.3.6.1.2.1.1.1.0)
  645.  
  646.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  647.    | 4             | 2             | 0             | 0             |
  648.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  649.    | 1                                                             |
  650.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  651.    | 1                                                             |
  652.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  653.    | 1                                                             |
  654.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  655.    | 0                                                             |
  656.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  657.  
  658.    1.2.3.4
  659.  
  660.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  661.    | 4             | 0             | 0             | 0             |
  662.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  663.    | 1                                                             |
  664.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  665.    | 2                                                             |
  666.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  667.    | 3                                                             |
  668.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  669.    | 4                                                             |
  670.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  671.  
  672.  
  673.  
  674. Daniele, et. al.            Standards Track                    [Page 12]
  675.  
  676. RFC 2257                        AgentX                      January 1998
  677.  
  678.  
  679. 5.2.  SearchRange
  680.  
  681.    A SearchRange consists of two Object Identifiers.  In its
  682.    communication with a subagent, the master agent uses a SearchRange to
  683.    identify a requested variable binding, and, in GetNext and GetBulk
  684.    operations, to set an upper bound on the names of managed object
  685.    instances the subagent may send in reply.
  686.  
  687.    The first Object Identifier in a SearchRange (called the starting
  688.    OID) indicates the beginning of the range.  It is frequently (but not
  689.    necessarily) the name of a requested variable binding.
  690.  
  691.    The "include" field in this OID's header is a boolean value (0 or 1)
  692.    indicating whether or not the starting OID is included in the range.
  693.  
  694.    The second object identifier indicates the non-inclusive end of the
  695.    range, and its "include" field is always 0.
  696.  
  697.    Example:  To indicate a search range from 1.3.6.1.2.1.25.2
  698.    (inclusive) to 1.3.6.1.2.1.25.2.1 (exclusive), the SearchRange would
  699.    be
  700.  
  701.    (start)
  702.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  703.    | 3             | 2             | 1             |       0       |
  704.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  705.    | 1                                                             |
  706.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  707.    | 25                                                            |
  708.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  709.    | 2                                                             |
  710.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  711.  
  712.    (end)
  713.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  714.    | 4             | 2             | 0             |       0       |
  715.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  716.    | 1                                                             |
  717.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  718.    | 25                                                            |
  719.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  720.    | 2                                                             |
  721.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  722.    | 1                                                             |
  723.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  724.  
  725.    A SearchRangeList is a contiguous list of SearchRanges.
  726.  
  727.  
  728.  
  729.  
  730. Daniele, et. al.            Standards Track                    [Page 13]
  731.  
  732. RFC 2257                        AgentX                      January 1998
  733.  
  734.  
  735. 5.3.  Octet String
  736.  
  737.    An octet string is represented by a contiguous series of bytes,
  738.    beginning with a 4-byte integer whose value is the number of octets
  739.    in the octet string, followed by the octets themselves.  This
  740.    representation is termed an Octet String.  If the last octet does not
  741.    end on a 4-byte offset from the start of the Octet String, padding
  742.    bytes are appended to achieve alignment of following data.  This
  743.    padding must be added even if the Octet String is the last item in
  744.    the PDU.  Padding bytes must be zero filled.
  745.  
  746.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  747.    |                     Octet String Length (L)                   |
  748.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  749.    |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  750.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  751.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  752.    |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  753.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  754.  
  755.    A null Octet String consists of a 4-byte length field set to 0.
  756.  
  757. 5.4.  Value Representation
  758.  
  759.    Variable bindings may be encoded within the variable-length portion
  760.    of some PDUs.  The representation of a variable binding (termed a
  761.    VarBind) consists of a 2-byte type field, a name (Object Identifier),
  762.    and the actual value data.
  763.  
  764.    VarBind
  765.  
  766.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  767.    |          v.type               |          <reserved>           |
  768.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  769.  
  770.    (v.name)
  771.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  772.    |  n_subid      |  prefix       |      0        |       0       |
  773.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  774.    |                       sub-identifier #1                       |
  775.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  776.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  777.    |                       sub-identifier #n_subid                 |
  778.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786. Daniele, et. al.            Standards Track                    [Page 14]
  787.  
  788. RFC 2257                        AgentX                      January 1998
  789.  
  790.  
  791.    (v.data)
  792.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  793.    |                       data                                    |
  794.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  795.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  796.    |                       data                                    |
  797.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  798.  
  799.    VarBind fields:
  800.  
  801.    v.type
  802.  
  803.          Indicates the variable binding's syntax, and must be one of
  804.          the following values:
  805.  
  806.                      Integer                  (2),
  807.                      Octet String             (4),
  808.                      Null                     (5),
  809.                      Object Identifier        (6),
  810.                      IpAddress               (64),
  811.                      Counter32               (65),
  812.                      Gauge32                 (66),
  813.                      TimeTicks               (67),
  814.                      Opaque                  (68),
  815.                      Counter64               (70),
  816.                      noSuchObject           (128),
  817.                      noSuchInstance         (129),
  818.                      endOfMibView           (130)
  819.  
  820.    v.name
  821.  
  822.          The Object Identifier which names the variable.
  823.  
  824.    v.data
  825.  
  826.          The actual value, encoded as follows:
  827.  
  828.           - Integer, Counter32, Gauge32, and TimeTicks are encoded as
  829.             4 contiguous bytes.  If the NETWORK_BYTE_ORDER bit is set
  830.             in h.flags, the bytes are ordered most significant to least
  831.             significant, otherwise they are ordered least significant
  832.             to most significant.
  833.  
  834.           - Counter64 is encoded as 8 contiguous bytes.  If the
  835.             NETWORK_BYTE_ORDER bit is set in h.flags, the bytes are
  836.             ordered most significant to least significant, otherwise
  837.             they are ordered least significant to most significant.
  838.  
  839.  
  840.  
  841.  
  842. Daniele, et. al.            Standards Track                    [Page 15]
  843.  
  844. RFC 2257                        AgentX                      January 1998
  845.  
  846.  
  847.           - Object Identifiers are encoded as described in section
  848.             5.1, Object Identifier.
  849.  
  850.           - IpAddress, Opaque, and Octet String are all octet strings
  851.             and are encoded as described in section 5.3, Octet String.
  852.  
  853.             Value data always follows v.name whenever v.type is one
  854.             of the above types.  These data bytes are present even if
  855.             they will not be used (as, for example, in certain types
  856.             of index allocation).
  857.  
  858.           - Null, noSuchObject, noSuchInstance, and endOfMibView do not
  859.             contain any encoded value.  Value data never follows
  860.             v.name in these cases.
  861.  
  862.          Note that the VarBind itself does not contain the value size.
  863.          That information is implied for the fixed-length types, and
  864.          explicitly contained in the encodings of variable-length types
  865.          (Object Identifier and Octet String).
  866.  
  867.    A VarBindList is a contiguous list of VarBinds.  Within a
  868.    VarBindList, a particular VarBind is identified by an index value.
  869.    The first VarBind in a VarBindList has index value 1, the second
  870.    has index value 2, and so on.
  871.  
  872. 6.  Protocol Definitions
  873.  
  874. 6.1.  AgentX PDU Header
  875.  
  876.    The AgentX PDU header is a fixed-format, 20-octet structure:
  877.  
  878.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  879.    |   h.version   |    h.type     |    h.flags    |  <reserved>   |
  880.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  881.    |                          h.sessionID                          |
  882.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  883.    |                        h.transactionID                        |
  884.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  885.    |                          h.packetID                           |
  886.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  887.    |                        h.payload_length                       |
  888.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  889.  
  890.    An AgentX PDU header contains the following fields:
  891.  
  892.       h.version
  893.  
  894.          The version of the AgentX protocol (1 for this memo).
  895.  
  896.  
  897.  
  898. Daniele, et. al.            Standards Track                    [Page 16]
  899.  
  900. RFC 2257                        AgentX                      January 1998
  901.  
  902.  
  903.       h.type
  904.  
  905.          The PDU type; one of the following values:
  906.  
  907.               agentx-Open-PDU             (1),
  908.               agentx-Close-PDU            (2),
  909.               agentx-Register-PDU         (3),
  910.               agentx-Unregister-PDU       (4),
  911.               agentx-Get-PDU              (5),
  912.               agentx-GetNext-PDU          (6),
  913.               agentx-GetBulk-PDU          (7),
  914.               agentx-TestSet-PDU          (8),
  915.               agentx-CommitSet-PDU        (9),
  916.               agentx-UndoSet-PDU         (10),
  917.               agentx-CleanupSet-PDU      (11),
  918.               agentx-Notify-PDU          (12),
  919.               agentx-Ping-PDU            (13),
  920.               agentx-IndexAllocate-PDU   (14),
  921.               agentx-IndexDeallocate-PDU (15),
  922.               agentx-AddAgentCaps-PDU    (16),
  923.               agentx-RemoveAgentCaps-PDU (17),
  924.               agentx-Response-PDU        (18)
  925.  
  926.       h.flags
  927.  
  928.          A bitmask, with bit 0 the least significant bit.  The bit
  929.          definitions are as follows:
  930.  
  931.                  Bit             Definition
  932.                  ---             ----------
  933.                  0               INSTANCE_REGISTRATION
  934.                  1               NEW_INDEX
  935.                  2               ANY_INDEX
  936.                  3               NON_DEFAULT_CONTEXT
  937.                  4               NETWORK_BYTE_ORDER
  938.                  5-7             (reserved)
  939.  
  940.          The NETWORK_BYTE_ORDER bit applies to all multi-byte integer
  941.          values in the entire AgentX packet, including the remaining
  942.          header fields.  If set, then network byte order (most
  943.          significant byte first; "big endian") is used.  If not set,
  944.          then least significant byte first ("little endian") is used.
  945.  
  946.          The NETWORK_BYTE_ORDER bit applies to all AgentX PDUs.
  947.  
  948.          The NON_DEFAULT_CONTEXT bit is used only in the AgentX PDUs
  949.          described in section 6.1.1.
  950.  
  951.  
  952.  
  953.  
  954. Daniele, et. al.            Standards Track                    [Page 17]
  955.  
  956. RFC 2257                        AgentX                      January 1998
  957.  
  958.  
  959.          The NEW_INDEX and ANY_INDEX bits are used only within the
  960.          agentx-IndexAllocate-, and -IndexDeallocate-PDUs.
  961.  
  962.          The INSTANCE_REGISTRATION bit is used only within the agentx-
  963.          Register-PDU.
  964.  
  965.       h.sessionID
  966.  
  967.          The session ID uniquely identifies a session over which AgentX
  968.          PDUs are exchanged between a subagent and the master agent.
  969.          The session ID has no significance and no defined value in the
  970.          agentx-Open-PDU sent by a subagent to open a session with the
  971.          master agent; in this case, the master agent will assign a
  972.          unique sessionID that it will pass back in the corresponding
  973.          agentx-Response-PDU.  From that point on, that same sessionID
  974.          will appear in every AgentX PDU exchanged over that session
  975.          between the master and the subagent.  A subagent may establish
  976.          multiple AgentX sessions by sending multiple agentx-Open-PDUs
  977.          to the master agent.
  978.  
  979.          In master agents that support multiple transport protocols, the
  980.          sessionID should be globally unique rather than unique just to
  981.          a particular transport.
  982.  
  983.       h.transactionID
  984.  
  985.          The transaction ID uniquely identifies, for a given session,
  986.          the single SNMP management request (and single SNMP PDU) with
  987.          which an AgentX PDU is associated.  If a single SNMP management
  988.          request results in multiple AgentX PDUs being sent by the
  989.          master agent with the same sessionID, each of these AgentX PDUs
  990.          must contain the same transaction ID; conversely, AgentX PDUs
  991.          sent during a particular session, that result from distinct
  992.          SNMP management requests, must have distinct transaction IDs
  993.          within the limits of the 32-bit field).
  994.  
  995.          Note that the transaction ID is not the same as the SNMP PDU's
  996.          request-id (as described in section 4.1 of RFC 1905 [4]), nor
  997.          can it be, since a master agent might receive SNMP requests
  998.          with the same request-ids from different managers.
  999.  
  1000.          The transaction ID has no significance and no defined value in
  1001.          AgentX administrative PDUs, i.e., AgentX PDUs that are not
  1002.          associated with an SNMP management request.
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010. Daniele, et. al.            Standards Track                    [Page 18]
  1011.  
  1012. RFC 2257                        AgentX                      January 1998
  1013.  
  1014.  
  1015.       h.packetID
  1016.  
  1017.          A packet ID generated by the sender for all AgentX PDUs except
  1018.          the agentx-Response-PDU. In an agentx-Response-PDU, the packet
  1019.          ID must be the same as that in the received AgentX PDU to which
  1020.          it is a response.  A master agent might use this field to
  1021.          associate subagent response PDUs with their corresponding
  1022.          request PDUs.  A subagent might use this field to correlate
  1023.          responses to multiple (batched) registrations.
  1024.  
  1025.       h.payload_length
  1026.  
  1027.          The size in octets of the PDU contents, excluding the 20-byte
  1028.          header.  As a result of the encoding schemes and PDU layouts,
  1029.          this value will always be either 0, or a multiple of 4.
  1030.  
  1031. 6.1.1.  Context
  1032.  
  1033.    In the SNMPv1 or v2c frameworks, the community string may be used as
  1034.    an index into a local repository of configuration information that
  1035.    may include community profiles or more complex context information.
  1036.    Future versions of the SNMP will likely formalize this notion of
  1037.    "context".
  1038.  
  1039.    AgentX provides a mechanism for transmitting a context specification
  1040.    within relevant PDUs, but does not place any constraints on the
  1041.    content of that specification.
  1042.  
  1043.    An optional context field may be present in the agentx-Register-,
  1044.    UnRegister-, AddAgentCaps-, RemoveAgentCaps-, Get-, GetNext-,
  1045.    GetBulk-, IndexAllocate-, IndexDeallocate-, Notify-, TestSet-, and
  1046.    Ping- PDUs.
  1047.  
  1048.    If the NON_DEFAULT_CONTEXT bit in the AgentX header field h.flags is
  1049.    clear, then there is no context field in the PDU, and the operation
  1050.    refers to the default context.
  1051.  
  1052.    If the NON_DEFAULT_CONTEXT bit is set, then a context field
  1053.    immediately follows the AgentX header, and the operation refers to
  1054.    that specific context.  The context is represented as an Octet
  1055.    String.  There are no constraints on its length or contents.
  1056.  
  1057.    Thus, all of these AgentX PDUs (that is, those listed immediately
  1058.    above) refer to, or "indicate" a context, which is either the default
  1059.    context, or a non-default context explicitly named in the PDU.
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.  
  1066. Daniele, et. al.            Standards Track                    [Page 19]
  1067.  
  1068. RFC 2257                        AgentX                      January 1998
  1069.  
  1070.  
  1071. 6.2.  AgentX PDUs
  1072.  
  1073. 6.2.1.  The agentx-Open-PDU
  1074.  
  1075.    An agentx-Open-PDU is generated by a subagent to request
  1076.    establishment of an AgentX session with the master agent.
  1077.  
  1078.    (AgentX header)
  1079.  
  1080.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1081.    | h.version (1) |  h.type (1)   |    h.flags    |  <reserved>   |
  1082.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1083.    |                          h.sessionID                          |
  1084.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1085.    |                        h.transactionID                        |
  1086.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1087.    |                           h.packetID                          |
  1088.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1089.    |                        h.payload_length                       |
  1090.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1091.  
  1092.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1093.    |  o.timeout    |                     <reserved>                |
  1094.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1095.  
  1096.    (o.id)
  1097.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1098.    |  n_subid      |  prefix       |       0       |  <reserved>   |
  1099.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1100.    |             subidentifier #1                                  |
  1101.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1102.    ...                                                             |
  1103.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1104.    |             subidentifier #n_subid                            |
  1105.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1106.  
  1107.    (o.descr)
  1108.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1109.    |                     Octet String Length (L)                   |
  1110.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1111.    |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1112.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1113.    ...
  1114.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1115.    |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1116.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1117.  
  1118.    An agentx-Open-PDU contains the following fields:
  1119.  
  1120.  
  1121.  
  1122. Daniele, et. al.            Standards Track                    [Page 20]
  1123.  
  1124. RFC 2257                        AgentX                      January 1998
  1125.  
  1126.  
  1127.       o.timeout
  1128.  
  1129.          The length of time, in seconds, that a master agent should
  1130.          allow to elapse after dispatching a message to a subagent
  1131.          before it regards the subagent as not responding.  This is a
  1132.          subagent-wide default value that may be overridden by values
  1133.          associated with specific registered MIB regions.  The default
  1134.          value of 0 indicates that no subagent-wide value is requested.
  1135.  
  1136.       o.id
  1137.  
  1138.          An Object Identifier that identifies the subagent.  Subagents
  1139.          that do not support such an notion may send a null Object
  1140.          Identifier.
  1141.  
  1142.       o.descr
  1143.  
  1144.          An Octet String containing a DisplayString describing the
  1145.          subagent.
  1146.  
  1147. 6.2.2.  The agentx-Close-PDU
  1148.  
  1149.    An agentx-Close-PDU issued by either a subagent or the master agent
  1150.    terminates an AgentX session.
  1151.  
  1152.    (AgentX header)
  1153.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1154.    | h.version (1) |  h.type (2)   |    h.flags    |  <reserved>   |
  1155.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1156.    |                          h.sessionID                          |
  1157.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1158.    |                        h.transactionID                        |
  1159.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1160.    |                           h.packetID                          |
  1161.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1162.    |                        h.payload_length                       |
  1163.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1164.  
  1165.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1166.    |  c.reason     |                     <reserved>                |
  1167.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1168.  
  1169.    An agentx-Close-PDU contains the following field:
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.  
  1176.  
  1177.  
  1178. Daniele, et. al.            Standards Track                    [Page 21]
  1179.  
  1180. RFC 2257                        AgentX                      January 1998
  1181.  
  1182.  
  1183.       c.reason
  1184.  
  1185.          An enumerated value that gives the reason that the master agent
  1186.          or subagent closed the AgentX session.  This field may take one
  1187.          of the following values:
  1188.  
  1189.             reasonOther(1)
  1190.                None of the following reasons
  1191.  
  1192.             reasonParseError(2)
  1193.                Too many AgentX parse errors from peer
  1194.  
  1195.             reasonProtocolError(3)
  1196.                Too many AgentX protocol errors from peer
  1197.  
  1198.             reasonTimeouts(4)
  1199.                Too many timeouts waiting for peer
  1200.  
  1201.             reasonShutdown(5)
  1202.                Sending entity is shutting down
  1203.  
  1204.             reasonByManager(6)
  1205.                Due to Set operation; this reason code can be used only
  1206.                by the master agent, in response to an SNMP management
  1207.                request.
  1208.  
  1209. 6.2.3.  The agentx-Register-PDU
  1210.  
  1211.    An agentx-Register-PDU is generated by a subagent for each region of
  1212.    the MIB variable naming tree (within one or more contexts) that it
  1213.    wishes to support.
  1214.  
  1215.     (AgentX header)
  1216.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1217.    | h.version (1) |  h.type (3)   |    h.flags    |  <reserved>   |
  1218.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1219.    |                          h.sessionID                          |
  1220.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1221.    |                        h.transactionID                        |
  1222.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1223.    |                           h.packetID                          |
  1224.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1225.    |                        h.payload_length                       |
  1226.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234. Daniele, et. al.            Standards Track                    [Page 22]
  1235.  
  1236. RFC 2257                        AgentX                      January 1998
  1237.  
  1238.  
  1239.     (r.context) (OPTIONAL)
  1240.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1241.     |                     Octet String Length (L)                   |
  1242.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1243.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1244.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1245.     ...
  1246.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1247.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1248.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1249.  
  1250.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1251.     |  r.timeout    |  r.priority   | r.range_subid |  <reserved>   |
  1252.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1253.  
  1254.     (r.region)
  1255.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1256.     |  n_subid      |  prefix       |      0        |  <reserved>   |
  1257.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1258.     |             sub-identifier #1                                 |
  1259.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1260.     ...
  1261.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1262.     |             sub-identifier #n_subid                           |
  1263.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1264.  
  1265.     (r.upper_bound)
  1266.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1267.     |             optional upper-bound sub-identifier               |
  1268.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1269.  
  1270.    An agentx-Register-PDU contains the following fields:
  1271.  
  1272.       r.context
  1273.  
  1274.          An optional non-default context.
  1275.  
  1276.       r.timeout
  1277.  
  1278.          The length of time, in seconds, that a master agent should
  1279.          allow to elapse after dispatching a message to a subagent
  1280.          before it regards the subagent as not responding.  r.timeout
  1281.          applies only to messages that concern MIB objects within
  1282.          r.region.  It overrides both the subagent-wide value (if any)
  1283.          indicated when the AgentX session with the master agent was
  1284.          established, and the master agent's default timeout.  The
  1285.          default value for r.timeout is 0 (no override).
  1286.  
  1287.  
  1288.  
  1289.  
  1290. Daniele, et. al.            Standards Track                    [Page 23]
  1291.  
  1292. RFC 2257                        AgentX                      January 1998
  1293.  
  1294.  
  1295.       r.priority
  1296.  
  1297.          A value between 1 and 255, used to achieve a desired
  1298.          configuration when different subagents register identical or
  1299.          overlapping regions.  Subagents with no particular knowledge of
  1300.          priority should register with the default value of 255 (lowest
  1301.          priority).
  1302.  
  1303.          In the master agent's dispatching algorithm, smaller values of
  1304.          r.priority take precedence over larger values, as described in
  1305.          section 7.1.5.1.
  1306.  
  1307.       r.region
  1308.  
  1309.          An Object Identifier that, in conjunction with r.range_subid,
  1310.          indicates a region of the MIB that a subagent wishes to
  1311.          support.  It may be a fully-qualified instance name, a partial
  1312.          instance name, a MIB table, an entire MIB, or ranges of any of
  1313.          these.
  1314.  
  1315.          The choice of what to register is implementation-specific; this
  1316.          memo does not specify permissible values.  Standard practice
  1317.          however is for a subagent to register at the highest level of
  1318.          the naming tree that makes sense.  Registration of fully-
  1319.          qualified instances is typically done only when a subagent can
  1320.          perform management operations only on particular rows of a
  1321.          conceptual table.
  1322.  
  1323.          If r.region is in fact a fully qualified instance name, the
  1324.          INSTANCE_REGISTRATION bit in h.flags must be set, otherwise it
  1325.          must be cleared.  The master agent may save this information to
  1326.          optimize subsequent operational dispatching.
  1327.  
  1328.       r.range_subid
  1329.  
  1330.          Permits specifying a range in place of one of r.region's sub-
  1331.          identifiers.  If this value is 0, no range is specified.
  1332.          Otherwise the "r.range_subid"-th sub-identifier in r.region is
  1333.          a range lower bound, and the range upper bound sub-identifier
  1334.          (r.upper_bound) immediately follows r.region.
  1335.  
  1336.          This permits registering a conceptual row with a single PDU.
  1337.          For example, the following PDU would register row 7 of the RFC
  1338.          1573 ifTable (1.3.6.1.2.1.2.2.1.1-22.7):
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346. Daniele, et. al.            Standards Track                    [Page 24]
  1347.  
  1348. RFC 2257                        AgentX                      January 1998
  1349.  
  1350.  
  1351.    (AgentX header)
  1352.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1353.    | h.version (1) |  h.type (3)   |    h.flags    |  <reserved>   |
  1354.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1355.    |                          h.sessionID                          |
  1356.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1357.    |                        h.transactionID                        |
  1358.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1359.    |                           h.packetID                          |
  1360.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1361.    |                        h.payload_length                       |
  1362.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1363.  
  1364.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1365.    |   r.timeout   |  r.priority   | 5             |  <reserved>   |
  1366.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1367.  
  1368.    (r.region)
  1369.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1370.    | 6             |  2            |  0            |  <reserved>   |
  1371.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1372.    | 1                                                             |
  1373.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1374.    | 2                                                             |
  1375.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1376.    | 2                                                             |
  1377.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1378.    | 1                                                             |
  1379.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1380.    | 1                                                             |
  1381.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1382.    | 7                                                             |
  1383.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1384.  
  1385.    (r.upper_bound)
  1386.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1387.    | 22                                                            |
  1388.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1389.  
  1390. 6.2.4.  The agentx-Unregister-PDU
  1391.  
  1392.    The agentx-Unregister-PDU is sent by a subagent to remove a
  1393.    previously registered MIB region from the master agent's OID space.
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402. Daniele, et. al.            Standards Track                    [Page 25]
  1403.  
  1404. RFC 2257                        AgentX                      January 1998
  1405.  
  1406.  
  1407.    (AgentX header)
  1408.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1409.    | h.version (1) |  h.type (4)   |    h.flags    |  <reserved>   |
  1410.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1411.    |                          h.sessionID                          |
  1412.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1413.    |                        h.transactionID                        |
  1414.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1415.    |                           h.packetID                          |
  1416.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1417.    |                        h.payload_length                       |
  1418.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1419.  
  1420.    (u.context) OPTIONAL
  1421.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1422.    |                     Octet String Length (L)                   |
  1423.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1424.    |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1425.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1426.    ...
  1427.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1428.    |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1429.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1430.  
  1431.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1432.    |    <reserved> |  u.priority   | u.range_subid |  <reserved>   |
  1433.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1434.  
  1435.    (u.region)
  1436.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1437.    |  n_subid      |  prefix       |      0        |  <reserved>   |
  1438.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1439.    |             sub-identifier #1                                 |
  1440.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1441.    ...
  1442.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1443.    |             sub-identifier #n_subid                           |
  1444.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1445.  
  1446.    (u.upper_bound)
  1447.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1448.    |             optional upper-bound sub-identifier               |
  1449.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1450.  
  1451.    An agentx-Unregister-PDU contains the following fields:
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.  
  1458. Daniele, et. al.            Standards Track                    [Page 26]
  1459.  
  1460. RFC 2257                        AgentX                      January 1998
  1461.  
  1462.  
  1463.       u.context
  1464.  
  1465.          An optional non-default context.
  1466.  
  1467.       u.priority
  1468.  
  1469.          The priority at which this region was originally registered.
  1470.  
  1471.       u.region
  1472.  
  1473.          Indicates a previously-registered region of the MIB that a
  1474.          subagent no longer wishes to support.
  1475.  
  1476. 6.2.5.  The agentx-Get-PDU
  1477.  
  1478.     (AgentX header)
  1479.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1480.     | h.version (1) |  h.type (5)   |    h.flags    |  <reserved>   |
  1481.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1482.     |                          h.sessionID                          |
  1483.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1484.     |                        h.transactionID                        |
  1485.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1486.     |                           h.packetID                          |
  1487.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1488.     |                        h.payload_length                       |
  1489.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1490.  
  1491.     (g.context) OPTIONAL
  1492.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1493.     |                     Octet String Length (L)                   |
  1494.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1495.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1496.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1497.     ...
  1498.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1499.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1500.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1501.  
  1502.     (g.sr)
  1503.  
  1504.     (start 1)
  1505.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1506.     |  n_subid      |  prefix       |  include      |  <reserved>   |
  1507.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1508.     |             sub-identifier #1                                 |
  1509.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1510.  
  1511.  
  1512.  
  1513.  
  1514. Daniele, et. al.            Standards Track                    [Page 27]
  1515.  
  1516. RFC 2257                        AgentX                      January 1998
  1517.  
  1518.  
  1519.     ...
  1520.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1521.     |             sub-identifier #n_subid                           |
  1522.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1523.  
  1524.     (end 1)
  1525.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1526.     | 0             | 0             | 0             |       0       |
  1527.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1528.     ...
  1529.     (start n)
  1530.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1531.     |  n_subid      |  prefix       |  include      |  <reserved>   |
  1532.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1533.     |             sub-identifier #1                                 |
  1534.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1535.     ...
  1536.  
  1537.  
  1538.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1539.     |             sub-identifier #n_subid                           |
  1540.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1541.  
  1542.     (end n)
  1543.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1544.     | 0             | 0             | 0             |       0       |
  1545.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1546.  
  1547.  
  1548.    An agentx-Get-PDU contains the following fields:
  1549.  
  1550.       g.context
  1551.  
  1552.          An optional non-default context.
  1553.  
  1554.       g.sr
  1555.  
  1556.          A SearchRangeList containing the requested variables for this
  1557.          subagent.
  1558.  
  1559.  
  1560.  
  1561.  
  1562.  
  1563.  
  1564.  
  1565.  
  1566.  
  1567.  
  1568.  
  1569.  
  1570. Daniele, et. al.            Standards Track                    [Page 28]
  1571.  
  1572. RFC 2257                        AgentX                      January 1998
  1573.  
  1574.  
  1575. 6.2.6.  The agentx-GetNext-PDU
  1576.  
  1577.     (AgentX header)
  1578.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1579.     | h.version (1) |  h.type (6)   |    h.flags    |  <reserved>   |
  1580.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1581.     |                          h.sessionID                          |
  1582.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1583.     |                        h.transactionID                        |
  1584.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1585.     |                           h.packetID                          |
  1586.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1587.     |                        h.payload_length                       |
  1588.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1589.  
  1590.     (g.context) OPTIONAL
  1591.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1592.     |                     Octet String Length (L)                   |
  1593.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1594.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1595.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1596.     ...
  1597.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1598.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1599.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1600.  
  1601.     (g.sr)
  1602.  
  1603.  
  1604.     (start 1)
  1605.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1606.     |  n_subid      |  prefix       |  include      |  <reserved>   |
  1607.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1608.     |             sub-identifier #1                                 |
  1609.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1610.     ...
  1611.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1612.     |             sub-identifier #n_subid                           |
  1613.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1614.  
  1615.     (end 1)
  1616.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1617.     |  n_subid      |  prefix       |      0        |  <reserved>   |
  1618.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1619.     |             sub-identifier #1                                 |
  1620.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626. Daniele, et. al.            Standards Track                    [Page 29]
  1627.  
  1628. RFC 2257                        AgentX                      January 1998
  1629.  
  1630.  
  1631.     ...
  1632.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1633.     |             sub-identifier #n_subid                           |
  1634.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1635.     ...
  1636.  
  1637.     (start n)
  1638.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1639.     |  n_subid      |  prefix       |  include      |  <reserved>   |
  1640.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1641.     |             sub-identifier #1                                 |
  1642.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1643.     ...
  1644.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1645.     |             sub-identifier #n_subid                           |
  1646.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1647.  
  1648.     (end n)
  1649.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1650.     |  n_subid      |  prefix       |      0        |  <reserved>   |
  1651.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1652.     |             sub-identifier #1                                 |
  1653.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1654.     ...
  1655.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1656.     |             sub-identifier #n_subid                           |
  1657.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1658.     ...
  1659.  
  1660. 6.2.7.  The agentx-GetBulk-PDU
  1661.  
  1662.     (AgentX header)
  1663.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1664.     | h.version (1) |  h.type (7)   |    h.flags    |  <reserved>   |
  1665.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1666.     |                          h.sessionID                          |
  1667.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1668.     |                        h.transactionID                        |
  1669.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1670.     |                           h.packetID                          |
  1671.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1672.     |                        h.payload_length                       |
  1673.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682. Daniele, et. al.            Standards Track                    [Page 30]
  1683.  
  1684. RFC 2257                        AgentX                      January 1998
  1685.  
  1686.  
  1687.     (g.context) OPTIONAL
  1688.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1689.     |                     Octet String Length (L)                   |
  1690.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1691.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1692.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1693.     ...
  1694.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1695.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1696.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1697.  
  1698.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1699.     |             g.non_repeaters   |     g.max_repetitions         |
  1700.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1701.  
  1702.     (g.sr) as in agentx-GetNext-PDU above
  1703.     ...
  1704.  
  1705. 6.2.8.  The agentx-TestSet-PDU
  1706.  
  1707.     (AgentX header)
  1708.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1709.     | h.version (1) |  h.type (8)   |    h.flags    |  <reserved>   |
  1710.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1711.     |                          h.sessionID                          |
  1712.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1713.     |                        h.transactionID                        |
  1714.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1715.     |                           h.packetID                          |
  1716.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1717.     |                        h.payload_length                       |
  1718.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1719.  
  1720.     (t.context) OPTIONAL
  1721.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1722.     |                     Octet String Length (L)                   |
  1723.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1724.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1725.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1726.     ...
  1727.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1728.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1729.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1730.  
  1731.     (t.vb)
  1732.  
  1733.  
  1734.  
  1735.  
  1736.  
  1737.  
  1738. Daniele, et. al.            Standards Track                    [Page 31]
  1739.  
  1740. RFC 2257                        AgentX                      January 1998
  1741.  
  1742.  
  1743.     (VarBind 1)
  1744.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1745.     |          v.type               |        <reserved>             |
  1746.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1747.     |  n_subid      |  prefix       |      0        |  <reserved>   |
  1748.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1749.     |                       sub-identifier #1                       |
  1750.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1751.     ...
  1752.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1753.     |                       sub-identifier #n_subid                 |
  1754.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1755.     |                       data                                    |
  1756.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1757.     ...
  1758.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1759.     |                       data                                    |
  1760.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1761.     ...
  1762.  
  1763.  
  1764.     (VarBind n)
  1765.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1766.     |          v.type               |        <reserved>             |
  1767.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1768.     |  n_subid      |  prefix       |      0        |  <reserved>   |
  1769.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1770.     |                       sub-identifier #1                       |
  1771.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1772.     ...
  1773.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1774.     |                       sub-identifier #n_subid                 |
  1775.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1776.     |                       data                                    |
  1777.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1778.     ...
  1779.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1780.     |                       data                                    |
  1781.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1782.  
  1783.    An agentx-TestSet-PDU contains the following fields:
  1784.  
  1785.       t.context
  1786.  
  1787.          An optional non-default context.
  1788.  
  1789.  
  1790.  
  1791.  
  1792.  
  1793.  
  1794. Daniele, et. al.            Standards Track                    [Page 32]
  1795.  
  1796. RFC 2257                        AgentX                      January 1998
  1797.  
  1798.  
  1799.       t.vb
  1800.  
  1801.          A VarBindList containing the requested VarBinds for this
  1802.          subagent.
  1803.  
  1804. 6.2.9.  The agentx-CommitSet, -UndoSet, -CleanupSet PDUs
  1805.  
  1806.    These PDUs consist of the AgentX header only.
  1807.  
  1808.    The agentx-CommitSet-, -UndoSet-, and -Cleanup-PDUs are used in
  1809.    processing an SNMP SetRequest operation.
  1810.  
  1811. 6.2.10.  The agentx-Notify-PDU
  1812.  
  1813.    An agentx-Notify-PDU is sent by a subagent to cause the master agent
  1814.    to forward a notification.
  1815.  
  1816.     (AgentX header)
  1817.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1818.     | h.version (1) |  h.type (12)  |    h.flags    |  <reserved>   |
  1819.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1820.     |                          h.sessionID                          |
  1821.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1822.     |                        h.transactionID                        |
  1823.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1824.     |                           h.packetID                          |
  1825.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1826.     |                        h.payload_length                       |
  1827.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1828.  
  1829.     (n.context) OPTIONAL
  1830.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1831.     |                     Octet String Length (L)                   |
  1832.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1833.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1834.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1835.     ...
  1836.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1837.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1838.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1839.  
  1840.     (n.vb)
  1841.     ...
  1842.  
  1843.  
  1844.    An agentx-Notify-PDU contains the following fields:
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850. Daniele, et. al.            Standards Track                    [Page 33]
  1851.  
  1852. RFC 2257                        AgentX                      January 1998
  1853.  
  1854.  
  1855.       n.context
  1856.  
  1857.          An optional non-default context.
  1858.  
  1859.       n.vb
  1860.  
  1861.          A VarBindList whose contents define the actual PDU to be sent.
  1862.          This memo places the following restrictions on its contents:
  1863.  
  1864.              - If the subagent supplies sysUpTime.0, it must be
  1865.                present as the first varbind.
  1866.  
  1867.              - snmpTrapOID.0 must be present, as the second
  1868.                varbind if sysUpTime.0 was supplied, as the first if it
  1869.                was not.
  1870.  
  1871. 6.2.11  The agentx-Ping-PDU
  1872.  
  1873.    The agentx-Ping-PDU is sent by a subagent to the master agent to
  1874.    monitor the master agent's ability to receive and send AgentX PDUs
  1875.    over their AgentX session.
  1876.  
  1877.     (AgentX header)
  1878.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1879.     | h.version (1) |  h.type (13)  |    h.flags    |  <reserved>   |
  1880.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1881.     |                          h.sessionID                          |
  1882.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1883.     |                        h.transactionID                        |
  1884.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1885.     |                           h.packetID                          |
  1886.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1887.     |                        h.payload_length                       |
  1888.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1889.  
  1890.    (p.context) OPTIONAL
  1891.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1892.     |                     Octet String Length (L)                   |
  1893.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1894.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1895.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1896.     ...
  1897.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1898.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1899.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1900.  
  1901.    An agentx-Ping-PDU may contain the following field:
  1902.  
  1903.  
  1904.  
  1905.  
  1906. Daniele, et. al.            Standards Track                    [Page 34]
  1907.  
  1908. RFC 2257                        AgentX                      January 1998
  1909.  
  1910.  
  1911.       p.context
  1912.  
  1913.          An optional non-default context.
  1914.  
  1915.    Using p.context a subagent can retrieve the sysUpTime value for a
  1916.    specific context, if required.
  1917.  
  1918. 6.2.12.  The agentx-IndexAllocate-PDU
  1919.  
  1920.    An agentx-IndexAllocate-PDU is sent by a subagent to request
  1921.    allocation of a value for specific index objects.  Refer to section
  1922.    7.1.3 (Using the agentx-IndexAllocate-PDU) for suggested usage.
  1923.  
  1924.     (AgentX header)
  1925.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1926.     | h.version (1) |  h.type (14)  |    h.flags    |  <reserved>   |
  1927.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1928.     |                          h.sessionID                          |
  1929.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1930.     |                        h.transactionID                        |
  1931.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1932.     |                           h.packetID                          |
  1933.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1934.     |                        h.payload_length                       |
  1935.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1936.  
  1937.     (i.context) OPTIONAL
  1938.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1939.     |                     Octet String Length (L)                   |
  1940.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1941.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1942.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1943.     ...
  1944.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1945.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1946.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1947.  
  1948.     (i.vb)
  1949.     ...
  1950.  
  1951.    An agentx-IndexAllocate-PDU contains the following fields:
  1952.  
  1953.       i.context
  1954.  
  1955.          An optional non-default context.
  1956.  
  1957.  
  1958.  
  1959.  
  1960.  
  1961.  
  1962. Daniele, et. al.            Standards Track                    [Page 35]
  1963.  
  1964. RFC 2257                        AgentX                      January 1998
  1965.  
  1966.  
  1967.       i.vb
  1968.  
  1969.          A VarBindList containing the index names and values requested
  1970.          for allocation.
  1971.  
  1972. 6.2.13.  The agentx-IndexDeallocate-PDU
  1973.  
  1974.    An agentx-IndexDeallocate-PDU is sent by a subagent to release
  1975.    previously allocated index values.
  1976.  
  1977.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1978.     | h.version (1) |  h.type (15)  |    h.flags    |  <reserved>   |
  1979.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1980.     |                          h.sessionID                          |
  1981.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1982.     |                        h.transactionID                        |
  1983.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1984.     |                           h.packetID                          |
  1985.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1986.     |                        h.payload_length                       |
  1987.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1988.  
  1989.     (i.context) OPTIONAL
  1990.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1991.     |                     Octet String Length (L)                   |
  1992.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1993.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  1994.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1995.     ...
  1996.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1997.     |  Octet L - 1  |  Octet L      |       Padding (as required)   |
  1998.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  1999.  
  2000.     (i.vb)
  2001.     ...
  2002.  
  2003.    An agentx-IndexDeallocate-PDU contains the following fields:
  2004.  
  2005.       i.context
  2006.  
  2007.          An optional non-default context.
  2008.  
  2009.       i.vb
  2010.  
  2011.          A VarBindList containing the index names and values to be
  2012.          released.
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018. Daniele, et. al.            Standards Track                    [Page 36]
  2019.  
  2020. RFC 2257                        AgentX                      January 1998
  2021.  
  2022.  
  2023. 6.2.14.  The agentx-AddAgentCaps-PDU
  2024.  
  2025.    An agentx-AddAgentCaps-PDU is generated by a subagent to inform the
  2026.    master agent of its agent capabilities.
  2027.  
  2028.     (AgentX header)
  2029.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2030.     | h.version (1) |  h.type (16)  |    h.flags    |  <reserved>   |
  2031.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2032.     |                          h.sessionID                          |
  2033.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2034.     |                        h.transactionID                        |
  2035.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2036.     |                           h.packetID                          |
  2037.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2038.     |                        h.payload_length                       |
  2039.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2040.  
  2041.     (a.context) (OPTIONAL)
  2042.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2043.     |                     Octet String Length (L)                   |
  2044.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2045.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  2046.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2047.     ...
  2048.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2049.     |  Octet L - 1  |  Octet L      |       Optional Padding        |
  2050.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2051.  
  2052.     (a.id)
  2053.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2054.     |  n_subid      |  prefix       |      0        |  <reserved>   |
  2055.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2056.     |             sub-identifier #1                                 |
  2057.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2058.     ...
  2059.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2060.     |             sub-identifier #n_subid                           |
  2061.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2062.  
  2063.     (a.descr)
  2064.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2065.     |                     Octet String Length (L)                   |
  2066.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2067.     |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  2068.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074. Daniele, et. al.            Standards Track                    [Page 37]
  2075.  
  2076. RFC 2257                        AgentX                      January 1998
  2077.  
  2078.  
  2079.     ...
  2080.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2081.     |  Octet L - 1  |  Octet L      |       Optional Padding        |
  2082.     +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2083.  
  2084.    An agentx-AddAgentCaps-PDU contains the following fields:
  2085.  
  2086.       a.context
  2087.  
  2088.          An optional non-default context.
  2089.  
  2090.       a.id
  2091.  
  2092.          An Object Identifier containing the value of an invocation of
  2093.          the AGENT-CAPABILITIES macro, which the master agent exports as
  2094.          a value of sysORID for the indicated context.  (Recall that the
  2095.          value of an invocation of an AGENT-CAPABILITIES macro is an
  2096.          object identifier that describes a precise level of support
  2097.          with respect to implemented MIB modules.  A more complete
  2098.          discussion of the AGENT-CAPABILITIES macro and related sysORID
  2099.          values can be found in section 6 of RFC 1904 [10].)
  2100.  
  2101.       a.descr
  2102.  
  2103.          An Octet String containing a DisplayString to be used as the
  2104.          value of sysORDescr corresponding to the sysORID value above.
  2105.  
  2106. 6.2.15.  The agentx-RemoveAgentCaps-PDU
  2107.  
  2108.    An agentx-RemoveAgentCaps-PDU is generated by a subagent to request
  2109.    that the master agent stop exporting a particular value of sysORID.
  2110.    This value must have previously been advertised by the subagent in an
  2111.    agentx-AddAgentCaps-PDU.
  2112.  
  2113.    (AgentX header)
  2114.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2115.    | h.version (1) |  h.type (17)  |    h.flags    |  <reserved>   |
  2116.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2117.    |                          h.sessionID                          |
  2118.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2119.    |                        h.transactionID                        |
  2120.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2121.    |                           h.packetID                          |
  2122.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2123.    |                        h.payload_length                       |
  2124.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130. Daniele, et. al.            Standards Track                    [Page 38]
  2131.  
  2132. RFC 2257                        AgentX                      January 1998
  2133.  
  2134.  
  2135.    (a.context) (OPTIONAL)
  2136.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2137.    |                     Octet String Length (L)                   |
  2138.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2139.    |  Octet 1      |  Octet 2      |   Octet 3     |   Octet 4     |
  2140.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2141.    ...
  2142.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2143.    |  Octet L - 1  |  Octet L      |       Optional Padding        |
  2144.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2145.  
  2146.    (a.id)
  2147.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2148.    |  n_subid      |  prefix       |       0       |   <reserved>  |
  2149.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2150.    |             sub-identifier #1                                 |
  2151.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2152.    ...
  2153.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2154.    |             sub-identifier #n_subid                           |
  2155.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2156.  
  2157.    An agentx-RemoveAgentCaps-PDU contains the following fields:
  2158.  
  2159.       a.context
  2160.  
  2161.          An optional non-default context.
  2162.  
  2163.       a.id
  2164.  
  2165.          An ObjectIdentifier containing the value of sysORID that should
  2166.          no longer be exported.
  2167.  
  2168. 6.2.16.  The agentx-Response-PDU
  2169.  
  2170.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2171.    | h.version (1) |  h.type (18)  |    h.flags    |  <reserved>   |
  2172.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2173.    |                          h.sessionID                          |
  2174.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2175.    |                        h.transactionID                        |
  2176.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2177.    |                           h.packetID                          |
  2178.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2179.    |                        h.payload_length                       |
  2180.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186. Daniele, et. al.            Standards Track                    [Page 39]
  2187.  
  2188. RFC 2257                        AgentX                      January 1998
  2189.  
  2190.  
  2191.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2192.    |                        res.sysUpTime                          |
  2193.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2194.    |             res.error         |     res.index                 |
  2195.    +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
  2196.    ...
  2197.  
  2198.    An agentx-Response-PDU contains the following fields:
  2199.  
  2200.       h.sessionID
  2201.  
  2202.          If this is a response to a agentx-Open-PDU, then it contains
  2203.          the new and unique sessionID (as assigned by the master agent)
  2204.          for this session.
  2205.  
  2206.          Otherwise it must be identical to the h.sessionID value in the
  2207.          PDU to which this PDU is a response.
  2208.  
  2209.       h.transactionID
  2210.  
  2211.          Must be identical to the h.transactionID value in the PDU to
  2212.          which this PDU is a response.
  2213.  
  2214.          In an agentx response PDU from the master agent to the
  2215.          subagent, the value of h.transactionID has no significance and
  2216.          can be ignored by the subagent.
  2217.  
  2218.       h.packetID
  2219.  
  2220.          Must be identical to the h.packetID value in the PDU to which
  2221.          this PDU is a response.
  2222.  
  2223.       res.sysUpTime
  2224.  
  2225.          This field contains the current value of sysUpTime for the
  2226.          indicated context.  It is relevant only in agentx response PDUs
  2227.          sent from the master agent to a subagent in response to the
  2228.          following agentx PDUs:
  2229.  
  2230.                agentx-Open-PDU               (1),
  2231.                agentx-Close-PDU              (2),
  2232.                agentx-Register-PDU           (3),
  2233.                agentx-Unregister-PDU         (4),
  2234.                agentx-Ping-PDU              (13),
  2235.                agentx-IndexAllocate-PDU     (14),
  2236.                agentx-IndexDeallocate-PDU   (15),
  2237.                agentx-AddAgentCaps-PDU      (16),
  2238.                agentx-RemoveAgentCaps-PDU   (17)
  2239.  
  2240.  
  2241.  
  2242. Daniele, et. al.            Standards Track                    [Page 40]
  2243.  
  2244. RFC 2257                        AgentX                      January 1998
  2245.  
  2246.  
  2247.          In an agentx response PDU from the subagent to the master
  2248.          agent, the value of res.sysUpTime has no significance and is
  2249.          ignored by the master agent.
  2250.  
  2251.       res.error
  2252.  
  2253.          Indicates error status (including `noError').  Values are
  2254.          limited to those defined for errors in the SNMPv2 SMI (RFC 1905
  2255.          [4]), and the following AgentX-specific values:
  2256.  
  2257.                 openFailed                 (256),
  2258.                 notOpen                    (257),
  2259.                 indexWrongType             (258),
  2260.                 indexAlreadyAllocated      (259),
  2261.                 indexNoneAvailable         (260),
  2262.                 indexNotAllocated          (261),
  2263.                 unsupportedContext         (262),
  2264.                 duplicateRegistration      (263),
  2265.                 unknownRegistration        (264),
  2266.                 unknownAgentCaps           (265)
  2267.  
  2268.       res.index
  2269.  
  2270.          In error cases, this is the index of the failed variable
  2271.          binding within a received request PDU.  (Note: As explained in
  2272.          section 5.4, Value Representation, the index values of variable
  2273.          bindings within a variable binding list are 1-based.)
  2274.  
  2275.    A VarBindList may follow these latter two fields, depending on which
  2276.    AgentX PDU is being responded to.  These data are specified in the
  2277.    subsequent elements of procedure.
  2278.  
  2279. 7.  Elements of Procedure
  2280.  
  2281.    This section describes the actions of protocol entities (master
  2282.    agents and subagents) implementing the AgentX protocol.  Note,
  2283.    however, that it is not intended to constrain the internal
  2284.    architecture of any conformant implementation.
  2285.  
  2286.    Specific error conditions and associated actions are described in
  2287.    various places.  Other error conditions not specifically mentioned
  2288.    fall into one of two categories, "parse" errors and "protocol"
  2289.    errors.
  2290.  
  2291.    A parse error occurs when a receiving entity cannot decode the PDU.
  2292.    For instance, a VarBind contains an unknown type, or a PDU contains a
  2293.    malformed Object Identifier.
  2294.  
  2295.  
  2296.  
  2297.  
  2298. Daniele, et. al.            Standards Track                    [Page 41]
  2299.  
  2300. RFC 2257                        AgentX                      January 1998
  2301.  
  2302.  
  2303.    A protocol error occurs when a receiving entity can parse a PDU, but
  2304.    the resulting data is unspecified.  For instance, an agentx-
  2305.    Response-PDU is successfully parsed, but contains an unknown
  2306.    res.error value.
  2307.  
  2308.    An implementation may choose either to ignore such messages, or to
  2309.    close the session on which they are received, using the appropriate
  2310.    reason code as defined in the agentx-Close-PDU.
  2311.  
  2312.    The actions of AgentX protocol entities can be broadly categorized
  2313.    under two headings, each of which is described separately:
  2314.  
  2315.       (1) processing AgentX administrative messages (e.g., connection
  2316.           requests from a subagent to a master agent); and
  2317.  
  2318.       (2) processing SNMP messages (the coordinated actions of a
  2319.           master agent and one or more subagents in processing, for
  2320.           example, a received SNMP GetRequest-PDU).
  2321.  
  2322. 7.1.  Processing AgentX Administrative Messages
  2323.  
  2324.    This subsection describes the actions of AgentX protocol entities in
  2325.    processing AgentX administrative messages.  Such messages include
  2326.    those involved in establishing and terminating an AgentX session
  2327.    between a subagent and a master agent, those by which a subagent
  2328.    requests allocation of instance index values, and those by which a
  2329.    subagent communicates to a master agent which MIB regions it
  2330.    supports.
  2331.  
  2332. 7.1.1.  Processing the agentx-Open-PDU
  2333.  
  2334.    When the master agent receives an agentx-Open-PDU, it processes it as
  2335.    follows:
  2336.  
  2337.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2338.       the value of sysUpTime.0 for the indicated context.
  2339.  
  2340.    2) If the master agent is unable to open an AgentX session for
  2341.       any reason, it may refuse the session establishment request,
  2342.       sending in reply the agentx-Response-PDU, with res.error field set
  2343.       to `openFailed'.
  2344.  
  2345.    3) Otherwise:  The master agent assigns a sessionID to the new
  2346.       session and puts the value in the h.sessionID field of the
  2347.       agentx-Response-PDU.  This value must be unique among all existing
  2348.       open sessions.
  2349.  
  2350.  
  2351.  
  2352.  
  2353.  
  2354. Daniele, et. al.            Standards Track                    [Page 42]
  2355.  
  2356. RFC 2257                        AgentX                      January 1998
  2357.  
  2358.  
  2359.    4) The master agent retains session-specific information
  2360.       from the PDU for this subagent:
  2361.  
  2362.        - The NETWORK_BYTE_ORDER value in h.flags is retained.
  2363.          All subsequent AgentX protocol operations initiated by the
  2364.          master agent for this session must use this byte ordering and
  2365.          set this bit accordingly.
  2366.  
  2367.          The subagent typically sets this bit to correspond to its
  2368.          native byte ordering, and typically does not vary byte ordering
  2369.          for an initiated session.  The master agent must be able to
  2370.          decode each PDU according to the h.flag NETWORK_BYTE_ORDER bit
  2371.          in the PDU, but does not need to toggle its retained value for
  2372.          the session if the subagent varies its byte ordering.
  2373.  
  2374.        - The o.timeout value is used in calculating response
  2375.          timeout conditions for this subagent.
  2376.  
  2377.        - The o.id and o.descr fields are used for informational
  2378.          purposes.  (Such purposes are implementation-specific for now,
  2379.          and may be used in a possible future standard AgentX MIB.)
  2380.  
  2381.    5) The agentx-Response-PDU is sent with the res.error field
  2382.       set to `noError'.
  2383.  
  2384.    At this point, an AgentX session is considered established between
  2385.    the master agent and the subagent.  An AgentX session is a distinct
  2386.    channel for the exchange of AgentX protocol messages between a master
  2387.    agent and one subagent, qualified by the session-specific attributes
  2388.    listed in 4) above.  AgentX session establishment is initiated by the
  2389.    subagent.  An AgentX session can be terminated by either the master
  2390.    agent or the subagent.
  2391.  
  2392. 7.1.2.  Processing the agentx-IndexAllocate-PDU
  2393.  
  2394.    When the master agent receives an agentx-IndexAllocate-PDU, it
  2395.    processes it as follows:
  2396.  
  2397.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2398.       the value of sysUpTime.0 for the default context.
  2399.  
  2400.    2) If h.sessionID does not correspond to a currently established
  2401.       session with this subagent, the agentx-Response-PDU is sent in
  2402.       reply with res.error set to `notOpen'.
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410. Daniele, et. al.            Standards Track                    [Page 43]
  2411.  
  2412. RFC 2257                        AgentX                      January 1998
  2413.  
  2414.  
  2415.    3) If the NON_DEFAULT_CONTEXT bit is set, and the master agent
  2416.       supports only a default context, the agentx-Response-PDU is
  2417.       returned with res.error set to `unsupportedContext', and the
  2418.       requested allocation fails.  Otherwise: The value of res.sysUpTime
  2419.       is set to the value of sysUpTime.0 for the indicated context.
  2420.  
  2421.    4) Each VarBind in the VarBindList is processed until either all
  2422.       are successful, or one fails.  If any VarBind fails, the agentx-
  2423.       Response-PDU is sent in reply containing the original VarBindList,
  2424.       with res.index set to indicate the failed VarBind, and with
  2425.       res.error set as described subsequently.  All other VarBinds are
  2426.       ignored; no index values are allocated.
  2427.  
  2428.       VarBinds are processed as follows:
  2429.  
  2430.       - v.name is the name of the index for which a value is to be
  2431.         allocated.
  2432.  
  2433.       - v.type is the syntax of the index object.
  2434.  
  2435.       - v.data indicates the specific index value requested.
  2436.         If the NEW_INDEX or the ANY_INDEX bit is set, the actual value
  2437.         in v.data is ignored and an appropriate index value is
  2438.         generated.
  2439.  
  2440.       a) If there are no currently allocated index values for v.name
  2441.          in the indicated context, and v.type does not correspond to a
  2442.          valid index type value, the VarBind fails and res.error is set
  2443.          to `indexWrongType'.
  2444.  
  2445.       b) If there are currently allocated index values for v.name
  2446.          in the indicated context, but the syntax of those values does
  2447.          not match v.type, the VarBind fails and res.error is set to
  2448.          `indexWrongType'.
  2449.  
  2450.       c) Otherwise, if both the NEW_INDEX and ANY_INDEX bits are
  2451.          clear, allocation of a specific index value is being requested.
  2452.          If the requested index is already allocated for v.name in the
  2453.          indicated context, the VarBind fails and res.error is set to
  2454.          `indexAlreadyAllocated'.
  2455.  
  2456.       d) Otherwise, if the NEW_INDEX bit is set, the master agent
  2457.          should generate the next available index value for v.name in
  2458.          the indicated context, with the constraint that this value must
  2459.          not have been allocated (even if subsequently released) to any
  2460.          subagent since the last re-initialization of the master agent.
  2461.          If no such value can be generated, the VarBind fails and
  2462.          res.error is set to `indexNoneAvailable'.
  2463.  
  2464.  
  2465.  
  2466. Daniele, et. al.            Standards Track                    [Page 44]
  2467.  
  2468. RFC 2257                        AgentX                      January 1998
  2469.  
  2470.  
  2471.       e) Otherwise, if the ANY_INDEX bit is set, the master agent
  2472.          should generate an index value for v.name in the indicated
  2473.          context, with the constraint that this value is not currently
  2474.          allocated to any subagent.  If no such value can be generated,
  2475.          then the VarBind fails and res.error is set to
  2476.          `indexNoneAvailable'.
  2477.  
  2478.    5) If all VarBinds are processed successfully, the
  2479.       agentx-Response-PDU is sent in reply with res.error set to
  2480.       `noError'.  A VarBindList is included that is identical to the one
  2481.       sent in the agentx-IndexAllocate-PDU, except that VarBinds
  2482.       requesting a NEW_INDEX or ANY_INDEX value are generated with an
  2483.       appropriate value.
  2484.  
  2485. 7.1.3.  Using the agentx-IndexAllocate-PDU
  2486.  
  2487.    Index allocation is a service provided by an AgentX master agent.  It
  2488.    provides generic support for sharing MIB conceptual tables among
  2489.    subagents who are assumed to have no knowledge of each other.
  2490.  
  2491.    Each subagent sharing a table should first request allocation of
  2492.    index values, then use those index values to qualify MIB regions in
  2493.    its subsequent registrations.
  2494.  
  2495.    The master agent maintains a database of index objects (OIDs), and,
  2496.    for each index, the values that have been allocated for it.  It is
  2497.    unaware of what MIB variables (if any) the index objects represent.
  2498.  
  2499.    By convention, subagents use the MIB variable listed in the INDEX
  2500.    clause as the index object for which values must be allocated.  For
  2501.    tables indexed by multiple variables, values may be allocated for
  2502.    each index (although this is frequently unnecessary; see example 2
  2503.    below).  The subagent may request allocation of
  2504.  
  2505.         - a specific index value - an index value that is not currently
  2506.         allocated - an index value that has never been allocated
  2507.  
  2508.    The last two alternatives reflect the uniqueness and constancy
  2509.    requirements present in many MIB specifications for arbitrary integer
  2510.    indexes (e.g., ifIndex in the IF MIB (RFC 1573 [11]),
  2511.    snmpFddiSMTIndex in the FDDI MIB (RFC 1285 [12]), or
  2512.    sysApplInstallPkgIndex in the System Application MIB [13]).  The need
  2513.    for subagents to share tables using such indexes is the main
  2514.    motivation for index allocation in AgentX.
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522. Daniele, et. al.            Standards Track                    [Page 45]
  2523.  
  2524. RFC 2257                        AgentX                      January 1998
  2525.  
  2526.  
  2527.    Example 1:
  2528.  
  2529.       A subagent implements an interface, and wishes to register a
  2530.       single row of the RFC 1573 ifTable.  It requests an allocation for
  2531.       the index object "ifIndex", for a value that has never been
  2532.       allocated (since ifIndex values must be unique).  The master agent
  2533.       returns the value "7".
  2534.  
  2535.       The subagent now attempts to register row 7 of ifTable, by
  2536.       specifying a MIB region in the agentx-Register-PDU of
  2537.       1.3.6.1.2.1.2.2.1.[1-22].7.  If the registration succeeds, no
  2538.       further processing is required.  The master agent will dispatch to
  2539.       this subagent correctly.
  2540.  
  2541.       But the registration may fail.  Index allocation and MIB region
  2542.       registration are not coupled in the master agent.  Some other
  2543.       subagent may have already registered ifTable row 7 without first
  2544.       having requested allocation of the index.  The current state of
  2545.       index allocations is not considered when processing registration
  2546.       requests, and the current registry is not considered when
  2547.       processing index allocation requests.  If subagents follow the
  2548.       model of "first request allocation of an index, then register the
  2549.       corresponding region", then a successful index allocation request
  2550.       gives a subagent a good hint (but no guarantee) of what it should
  2551.       be able to register.
  2552.  
  2553.       If the registration failed, the subagent should request allocation
  2554.       of a new index i, and attempt to register ifTable.[1-22].i, until
  2555.       successful.
  2556.  
  2557.    Example 2:
  2558.  
  2559.       This same subagent wishes to register ipNetToMediaTable rows
  2560.       corresponding to its interface (ifIndex i).  Due to structure of
  2561.       this table, no further index allocation need be done.  The
  2562.       subagent can register the MIB region ipNetToMediaTable.[1-4].i, It
  2563.       is claiming responsibility for all rows of the table whose value
  2564.       of ipNetToMediaIfIndex is i.
  2565.  
  2566.    Example 3:
  2567.  
  2568.       A network device consists of a set of processors, each of which
  2569.       accepts network connections for a unique set of IP addresses.
  2570.  
  2571.       Further, each processor contains a subagent that implements
  2572.       tcpConnTable.  In order to represent tcpConnTable for the entire
  2573.       managed device, the subagents need to share tcpConnTable.
  2574.  
  2575.  
  2576.  
  2577.  
  2578. Daniele, et. al.            Standards Track                    [Page 46]
  2579.  
  2580. RFC 2257                        AgentX                      January 1998
  2581.  
  2582.  
  2583.       In this case, no index allocation need be done at all.  Each
  2584.       subagent can register a MIB region of tcpConnTable.[1-5].a.b.c.d,
  2585.       where a.b.c.d represents an unique IP address of the individual
  2586.       processor.
  2587.  
  2588.       Each subagent is claiming responsibility for the region of
  2589.       tcpConnTable where the value of tcpConnLocalAddress is a.b.c.d.
  2590.  
  2591. 7.1.4   Processing the agentx-IndexDeallocate-PDU
  2592.  
  2593.    When the master agent receives an agentx-IndexDeallocate-PDU, it
  2594.    processes it as follows:
  2595.  
  2596.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2597.       the value of sysUpTime.0 for the default context.
  2598.  
  2599.    2) If h.sessionID does not correspond to a currently
  2600.       established session with this subagent, the agentx-Response-PDU is
  2601.       sent in reply with res.error set to `notOpen'.
  2602.  
  2603.    3) If the NON_DEFAULT_CONTEXT bit is set, and the master agent
  2604.       supports only a default context, the agentx-Response-PDU is
  2605.       returned with res.error set to `unsupportedContext', and the
  2606.       requested deallocation fails.  Otherwise: The value of
  2607.       res.sysUpTime is set to the value of sysUpTime.0 for the indicated
  2608.       context.
  2609.  
  2610.    4) Each VarBind in the VarBindList is processed until either all
  2611.       are successful, or one fails.  If any VarBind fails, the agentx-
  2612.       Response-PDU is sent in reply, containing the original
  2613.       VarBindList, with res.index set to indicate the failed VarBind,
  2614.       and with res.error set as described subsequently.  All other
  2615.       VarBinds are ignored; no index values are released.
  2616.  
  2617.       VarBinds are processed as follows:
  2618.  
  2619.       - v.name is the name of the index for which a value is to be
  2620.         released
  2621.  
  2622.       - v.type is the syntax of the index object
  2623.  
  2624.       - v.data indicates the specific index value to be released.
  2625.         The NEW_INDEX and ANY_INDEX bits are ignored.
  2626.  
  2627.       a) If the index value for the named index is not currently
  2628.          allocated to this subagent, the VarBind fails and res.error is
  2629.          set to `indexNotAllocated'.
  2630.  
  2631.  
  2632.  
  2633.  
  2634. Daniele, et. al.            Standards Track                    [Page 47]
  2635.  
  2636. RFC 2257                        AgentX                      January 1998
  2637.  
  2638.  
  2639.    5) If all VarBinds are processed successfully, res.error is
  2640.       set to `noError' and the agentx-Response-PDU is sent.  A
  2641.       VarBindList is included which is identical to the one sent in the
  2642.       agentx-IndexDeallocate-PDU.
  2643.  
  2644.       All released index values are now available, and may be used in
  2645.       response to subsequent allocation requests for ANY_INDEX values
  2646.       for the particular index.
  2647.  
  2648. 7.1.5.  Processing the agentx-Register-PDU
  2649.  
  2650.    When the master agent receives an agentx-Register-PDU, it processes
  2651.    it as follows:
  2652.  
  2653.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2654.       the value of sysUpTime.0 for the default context.
  2655.  
  2656.    2) If h.sessionID does not correspond to a currently
  2657.       established session with this subagent, the agentx-Response-PDU is
  2658.       sent in reply with res.error set to `notOpen'.
  2659.  
  2660.    3) If the NON_DEFAULT_CONTEXT bit is set, and the master agent
  2661.       supports only a default context, the agentx-Response-PDU is
  2662.       returned with res.error set to `unsupportedContext', and the
  2663.       requested registration fails.  Otherwise:  The value of
  2664.       res.sysUpTime is set to the value of sysUpTime.0 for the indicated
  2665.       context.
  2666.  
  2667.       Note: Non-default contexts might be added on the fly by
  2668.             the master agent, or the master agent might require such
  2669.             non-default contexts to be pre-configured.  The choice is
  2670.             implementation-specific.
  2671.  
  2672.    4) Characterize the request.
  2673.  
  2674.       If r.region (or any of its set of Object Identifiers, if r.range
  2675.       is non-zero) is exactly the same as any currently registered value
  2676.       of r.region (or any of its set of Object Identifiers), this
  2677.       registration is termed a duplicate region.
  2678.  
  2679.       If r.region (or any of its set of Object Identifiers, if r.range
  2680.       is non-zero) is a subtree of, or contains, any currently
  2681.       registered value of r.region (or any of its set of Object
  2682.       Identifiers), this registration is termed an overlapping region.
  2683.  
  2684.       If the NON_DEFAULT_CONTEXT bit is set, this region is to be
  2685.       logically registered within the context indicated by r.context.
  2686.  
  2687.  
  2688.  
  2689.  
  2690. Daniele, et. al.            Standards Track                    [Page 48]
  2691.  
  2692. RFC 2257                        AgentX                      January 1998
  2693.  
  2694.  
  2695.       Otherwise this region is to be logically registered within the
  2696.       default context.
  2697.  
  2698.       A registration that would result in a duplicate region with the
  2699.       same priority and within the same context as that of a current
  2700.       registration is termed a duplicate registration.
  2701.  
  2702.    5) Otherwise, if this is a duplicate registration, the
  2703.       agentx-Response-PDU is returned with res.error set to
  2704.       `duplicateRegistration', and the requested registration fails.
  2705.  
  2706.    6) Otherwise, the agentx-Response-PDU is returned with res.error
  2707.       set to `noError'.
  2708.  
  2709.       The master agent adds this region to its registered OID space for
  2710.       the indicated context, to be considered during the dispatching
  2711.       phase for subsequently received SNMP protocol messages.
  2712.  
  2713.       Note: The following algorithm describes maintaining a set of OID
  2714.       ranges derived from "splitting" registered regions.  The algorithm
  2715.       for operational dispatching is also stated in terms of these OID
  2716.       ranges.
  2717.  
  2718.       These OID ranges are a useful explanatory device, but are not
  2719.       required for a correct implementation.
  2720.  
  2721.        - If r.region (R1) is a subtree of a currently registered
  2722.          region (R2), split R2 into 3 new regions (R2a, R2b, and R2c)
  2723.          such that R2b is an exact duplicate of R1.  Now remove R2 and
  2724.          add R1, R2a, R2b, and R2c to the master agent's
  2725.          lexicographically ordered set of ranges (the registered OID
  2726.          space).  Note: Though newly-added ranges R1 and R2b are
  2727.          identical in terms of the MIB objects they contain, they are
  2728.          registered by different subagents, possibly at different
  2729.          priorities.
  2730.  
  2731.          For instance, if subagent S2 registered "ip" (R2 is
  2732.          1.3.6.1.2.1.4) and subagent S1 subsequently registered
  2733.          "ipNetToMediaTable" (R1 is 1.3.6.1.2.1.4.22), the resulting set
  2734.          of registered regions would be:
  2735.  
  2736.    1.3.6.1.2.1.4    up to but not including 1.3.6.1.2.1.4.22     (by S2)
  2737.    1.3.6.1.2.1.4.22 up to but not including 1.3.6.1.2.1.4.23     (by S2)
  2738.    1.3.6.1.2.1.4.22 up to but not including 1.3.6.1.2.1.4.23     (by S1)
  2739.    1.3.6.1.2.1.4.23 up to but not including 1.3.6.1.2.1.5        (by S2)
  2740.  
  2741.  
  2742.  
  2743.  
  2744.  
  2745.  
  2746. Daniele, et. al.            Standards Track                    [Page 49]
  2747.  
  2748. RFC 2257                        AgentX                      January 1998
  2749.  
  2750.  
  2751.        - If r.region (R1) overlaps one or more currently registered
  2752.          regions, then for each overlapped region (R2) split R1 into 3
  2753.          new ranges (R1a, R1b, R1c) such that R1b is an exact
  2754.          duplicate of R2.  Add R1b and R2 into the lexicographically
  2755.          ordered set of regions.  Apply (5) above iteratively to R1a and
  2756.          R1c (since they may overlap, or be subtrees of, other regions).
  2757.  
  2758.          For instance, given the currently registered regions in the
  2759.          example above, if subagent S3 now registers mib-2 (R1 is
  2760.          1.3.6.1.2.1) the resulting set of regions would be:
  2761.  
  2762.    1.3.6.1.2.1      up to but not including 1.3.6.1.2.1.4        (by S3)
  2763.    1.3.6.1.2.1.4    up to but not including 1.3.6.1.2.1.4.22     (by S2)
  2764.    1.3.6.1.2.1.4    up to but not including 1.3.6.1.2.1.4.22     (by S3)
  2765.    1.3.6.1.2.1.4.22 up to but not including 1.3.6.1.2.1.4.23     (by S2)
  2766.    1.3.6.1.2.1.4.22 up to but not including 1.3.6.1.2.1.4.23     (by S1)
  2767.    1.3.6.1.2.1.4.22 up to but not including 1.3.6.1.2.1.4.23     (by S3)
  2768.    1.3.6.1.2.1.4.23 up to but not including 1.3.6.1.2.1.5        (by S2)
  2769.    1.3.6.1.2.1.4.23 up to but not including 1.3.6.1.2.1.5        (by S3)
  2770.    1.3.6.1.2.1.5    up to but not including 1.3.6.1.2.2          (by S3)
  2771.  
  2772.    Note that at registration time a region may be split into multiple
  2773.    OID ranges due to pre-existing registrations, or as a result of any
  2774.    subsequent registration.  This region splitting is transparent to
  2775.    subagents.  Hence the master agent must always be able to associate
  2776.    any OID range with the information contained in its original agentx-
  2777.    Register-PDU.
  2778.  
  2779. 7.1.5.1.  Handling Duplicate OID Ranges
  2780.  
  2781.    As a result of this registration algorithm there are likely to be
  2782.    duplicate OID ranges (regions of identical MIB objects registered to
  2783.    different subagents) in the master agent's registered OID space.
  2784.    Whenever the master agent's dispatching algorithm (see 7.2.1,
  2785.    Dispatching AgentX PDUs) results in  a duplicate OID range, the
  2786.    master agent selects one to use, termed the 'authoritative region',
  2787.    as follows:
  2788.  
  2789.       1) Choose the one whose original agentx-Register-PDU
  2790.          r.region contained the most subids, i.e., the most specific
  2791.          r.region.  Note: The presence or absence of a range subid has
  2792.          no bearing on how "specific" one object identifier is compared
  2793.          to another.
  2794.  
  2795.       2) If still ambiguous, there were duplicate regions.  Choose the
  2796.          one whose original agentx-Register-PDU specified the smaller
  2797.          value of r.priority.
  2798.  
  2799.  
  2800.  
  2801.  
  2802. Daniele, et. al.            Standards Track                    [Page 50]
  2803.  
  2804. RFC 2257                        AgentX                      January 1998
  2805.  
  2806.  
  2807. 7.1.6.  Processing the agentx-Unregister-PDU
  2808.  
  2809.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2810.       the value of sysUpTime.0 for the default context.
  2811.  
  2812.    2) If h.sessionID does not correspond to a currently
  2813.       established session with this subagent, the agentx-Response-PDU is
  2814.       sent in reply with res.error set to `notOpen'.
  2815.  
  2816.    3) If the NON_DEFAULT_CONTEXT bit is set, and the master agent
  2817.       supports only a default context, the agentx-Response-PDU is
  2818.       returned with res.error set to `unsupportedContext', and the
  2819.       requested unregistration fails.  Otherwise:  The value of
  2820.       res.sysUpTime is set to the value of sysUpTime.0 for the indicated
  2821.       context.
  2822.  
  2823.    4) If u.region, u.priority, and the indicated context do not match
  2824.       an existing registration made during this session, the agentx-
  2825.       Response-PDU is returned with res.error set to
  2826.       `unknownRegistration'.
  2827.  
  2828.    5) Otherwise, the agentx-Response-PDU is sent in reply with res.error
  2829.       set to `noError', and the previous registration is removed:
  2830.  
  2831.       - The master agent removes u.region from its registered OID space
  2832.         within the indicated context.  If the original region had been
  2833.         split, all such related regions are removed.
  2834.  
  2835.         For instance, given the example registry above, if subagent S2
  2836.         unregisters "ip", the resulting registry would be:
  2837.  
  2838.    1.3.6.1.2.1      up to but not including 1.3.6.1.2.1.4        (by S3)
  2839.    1.3.6.1.2.1.4    up to but not including 1.3.6.1.2.1.4.22     (by S3)
  2840.    1.3.6.1.2.1.4.22 up to but not including 1.3.6.1.2.1.4.23     (by S1)
  2841.    1.3.6.1.2.1.4.22 up to but not including 1.3.6.1.2.1.4.23     (by S3)
  2842.    1.3.6.1.2.1.4.23 up to but not including 1.3.6.1.2.1.5        (by S3)
  2843.    1.3.6.1.2.1.5    up to but not including 1.3.6.1.2.2          (by S3)
  2844.  
  2845. 7.1.7.  Processing the agentx-AddAgentCaps-PDU
  2846.  
  2847.    When the master agent receives an agentx-AddAgentCaps-PDU, it
  2848.    processes it as follows:
  2849.  
  2850.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2851.       the value of sysUpTime.0 for the default context.
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858. Daniele, et. al.            Standards Track                    [Page 51]
  2859.  
  2860. RFC 2257                        AgentX                      January 1998
  2861.  
  2862.  
  2863.    2) If h.sessionID does not correspond to a currently
  2864.       established session with this subagent, the agentx-Response-PDU is
  2865.       sent in reply with res.error set to `notOpen'.
  2866.  
  2867.    3) If the NON_DEFAULT_CONTEXT bit is set, and the master agent
  2868.       supports only a default context, the agentx-Response-PDU is
  2869.       returned with res.error set to `unsupportedContext', and the
  2870.       requested operation fails.  Otherwise:  The value of res.sysUpTime
  2871.       is set to the value of sysUpTime.0 for the indicated context.
  2872.  
  2873.    4) Otherwise, the master agent adds the subagent's capabilities
  2874.       information to the sysORTable for the indicated context.  An
  2875.       agentx-Response-PDU is sent in reply with res.error set to
  2876.       `noError'.
  2877.  
  2878. 7.1.8.  Processing the agentx-RemoveAgentCaps-PDU
  2879.  
  2880.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2881.       the value of sysUpTime.0 for the default context.
  2882.  
  2883.    2) If h.sessionID does not correspond to a currently
  2884.       established session with this subagent, the agentx-Response-PDU is
  2885.       sent in reply with res.error set to `notOpen'.
  2886.  
  2887.    3) If the NON_DEFAULT_CONTEXT bit is set, and the master agent
  2888.       supports only a default context, the agentx-Response-PDU is
  2889.       returned with res.error set to `unsupportedContext', and the
  2890.       requested operation fails.  Otherwise:  The value of res.sysUpTime
  2891.       is set to the value of sysUpTime.0 for the indicated context.
  2892.  
  2893.    4) If the combination of a.id and the optional a.context does not
  2894.       represent a sysORTable entry that was added by this subagent,
  2895.       during this session, the agentx-Response-PDU is returned with
  2896.       res.error set to `unknownAgentCaps'.
  2897.  
  2898.    5) Otherwise the master agent deletes the corresponding sysORTable
  2899.       entry and sends in reply the agentx-Response-PDU, with res.error
  2900.       set to `noError'.
  2901.  
  2902. 7.1.9.  Processing the agentx-Close-PDU
  2903.  
  2904.    When the master agent receives an agentx-Close-PDU, it processes it
  2905.    as follows:
  2906.  
  2907.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2908.       the value of sysUpTime.0 for the default context.
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914. Daniele, et. al.            Standards Track                    [Page 52]
  2915.  
  2916. RFC 2257                        AgentX                      January 1998
  2917.  
  2918.  
  2919.    2) If h.sessionID does not correspond to a currently
  2920.       established session with this subagent, the agentx-Response-PDU is
  2921.       sent in reply with res.error set to `notOpen'.
  2922.  
  2923.    3) Otherwise, the master agent closes the AgentX session
  2924.       as described below.  No agentx-Response-PDU is sent.
  2925.  
  2926.       - All MIB regions that have been registered during this session
  2927.         are unregistered, as described in 7.1.6.
  2928.  
  2929.       - All index values allocated during this session are freed, as
  2930.         described in section 7.1.4.
  2931.  
  2932.       - All sysORID values that were registered during this session
  2933.         are removed, as described in section 7.1.8.
  2934.  
  2935.    The master agent does not maintain state for closed sessions.  If a
  2936.    subagent wishes to re-establish a session after receiving an agentx-
  2937.    Close-PDU, it needs to re-register MIB regions, agent capabilities,
  2938.    etc.
  2939.  
  2940. 7.1.10.  Detecting Connection Loss
  2941.  
  2942.    If a master agent is able to detect (from the underlying transport)
  2943.    that a subagent cannot receive AgentX PDUs, it should close all
  2944.    affected AgentX sessions as described in 7.1.9, step 3).
  2945.  
  2946. 7.1.11.  Processing the agentx-Notify-PDU
  2947.  
  2948.    A subagent sending SNMPv1 trap information must map this into
  2949.    (minimally) a value of snmpTrapOID.0, as described in 3.1.2 of RFC
  2950.    1908 [8].
  2951.  
  2952.    The master agent processes the agentx-Notify-PDU as follows:
  2953.  
  2954.    1) If h.sessionID does not correspond to a currently
  2955.          established session with this subagent, an agentx-Response-PDU
  2956.          is sent in reply with res.error set to `notOpen', and
  2957.          res.sysUpTime set to the value of sysUpTime.0 for the indicated
  2958.          context.
  2959.  
  2960.    2) The VarBindList is parsed.  If it does not contain a value for
  2961.          sysUpTime.0, the master agent supplies the current value of
  2962.          sysUpTime.0 for the indicated context.  If the next VarBind
  2963.          (either the first or second VarBind; see section 6.2.10.1) is
  2964.          not snmpTrapOID.0, the master agent ceases further processing
  2965.          of the notification.
  2966.  
  2967.  
  2968.  
  2969.  
  2970. Daniele, et. al.            Standards Track                    [Page 53]
  2971.  
  2972. RFC 2257                        AgentX                      January 1998
  2973.  
  2974.  
  2975.    3) Notifications are sent according to the implementation-specific
  2976.          configuration of the master agent.
  2977.  
  2978.          If SNMPv1 Trap PDUs are generated, the recommended mapping is
  2979.          as described in RFC 2089 [9].
  2980.  
  2981.          Except in the case of a `notOpen' error as described in (1)
  2982.          above, no agentx-Response-PDU is sent to the subagent when the
  2983.          master agent finishes processing the notification.
  2984.  
  2985. 7.1.12.  Processing the agentx-Ping-PDU
  2986.  
  2987.    When the master agent receives an agentx-Ping-PDU, it processes it as
  2988.    follows:
  2989.  
  2990.    1) An agentx-Response-PDU is created and res.sysUpTime is set to
  2991.       the value of sysUpTime.0 for the default context.
  2992.  
  2993.    2) If h.sessionID does not correspond to a currently
  2994.       established session with this subagent, the agentx-Response-PDU is
  2995.       sent in reply with res.error set to `notOpen'.
  2996.  
  2997.    3) If the NON_DEFAULT_CONTEXT bit is set, and the master agent
  2998.       supports only a default context, the agentx-Response-PDU is
  2999.       returned with res.error set to `unsupportedContext'.  Otherwise:
  3000.       The value of res.sysUpTime is set to the value of sysUpTime.0 for
  3001.       the indicated context.
  3002.  
  3003.    4) The agentx-Response-PDU is sent, with res.error set to
  3004.       `noError'.
  3005.  
  3006.    If a subagent does not receive a response to its pings, or if it is
  3007.    able to detect (from the underlying transport) that the master agent
  3008.    is not able to receive AgentX messages, then it eventually must
  3009.    initiate a new AgentX session, re-register its regions, etc.
  3010.  
  3011. 7.2.  Processing Received SNMP Protocol Messages
  3012.  
  3013.    When an SNMP GetRequest, GetNextRequest, GetBulkRequest, or
  3014.    SetRequest protocol message is received by the master agent, the
  3015.    master agent applies its access control policy.
  3016.  
  3017.    In particular, for SNMPv1 or SNMPv2c PDUs, the master agent applies
  3018.    the Elements of Procedure defined in section 4.1 of RFC 1157 [6] that
  3019.    apply to receiving entities.  (For other versions of SNMP, the master
  3020.    agent applies the access control policy defined in the Elements of
  3021.    Procedure for those versions.)
  3022.  
  3023.  
  3024.  
  3025.  
  3026. Daniele, et. al.            Standards Track                    [Page 54]
  3027.  
  3028. RFC 2257                        AgentX                      January 1998
  3029.  
  3030.  
  3031.    In the SNMPv1 or v2c frameworks, the master agent uses the community
  3032.    string as an index into a local repository of configuration
  3033.    information that may include community profiles or more complex
  3034.    context information.
  3035.  
  3036.    If application of the access control policy results in a valid SNMP
  3037.    request PDU, then an SNMP Response-PDU is constructed from
  3038.    information gathered in the exchange of AgentX PDUs between the
  3039.    master agent and one or more subagents.  Upon receipt and initial
  3040.    validation of an SNMP request PDU, a master agent uses the procedures
  3041.    described below to dispatch AgentX PDUs to the proper subagents,
  3042.    marshal the subagent responses, and construct an SNMP response PDU.
  3043.  
  3044. 7.2.1.  Dispatching AgentX PDUs
  3045.  
  3046.    Upon receipt and initial validation of an SNMP request PDU, a master
  3047.    agent uses the procedures described below to dispatch AgentX PDUs to
  3048.    the proper subagents.
  3049.  
  3050.    Note: In the following procedures, an object identifier is said to be
  3051.    "contained" within an OID range when both of the following are true:
  3052.  
  3053.        - The object identifier does not lexicographically precede
  3054.          the range.
  3055.  
  3056.        - The object identifier lexicographically precedes the end
  3057.          of the range.
  3058.  
  3059.    General Rules of Procedure
  3060.  
  3061.    While processing a particular SNMP request, the master agent may send
  3062.    one or more AgentX PDUs to one or more subagents.  The following
  3063.    rules of procedure apply in general to the AgentX master agent. PDU-
  3064.    specific rules are listed in the applicable sections.
  3065.  
  3066.    1) Honoring the registry
  3067.  
  3068.       Because AgentX supports overlapping registrations, it is possible
  3069.       for the master agent to obtain a value for a requested varbind
  3070.       from within multiple registered MIB regions.
  3071.  
  3072.       The master agent must ensure that the value (or exception)
  3073.       actually returned in the SNMP response PDU is taken from the
  3074.       authoritative region (as defined in section 7.1.5.1).
  3075.  
  3076.  
  3077.  
  3078.  
  3079.  
  3080.  
  3081.  
  3082. Daniele, et. al.            Standards Track                    [Page 55]
  3083.  
  3084. RFC 2257                        AgentX                      January 1998
  3085.  
  3086.  
  3087.    2) GetNext and GetBulk Processing
  3088.  
  3089.       The master agent may choose to send agentx-Get-PDUs while
  3090.       servicing an SNMP GetNextRequest-PDU.  The master agent may choose
  3091.       to send agentx-Get-PDUs or agentx-GetNext-PDUs while servicing an
  3092.       SNMP GetBulkRequest-PDU.  One possible reason for this would be if
  3093.       the current iteration has targeted instance-level registrations.
  3094.  
  3095.       The master agent may choose to "scope" the possible instances
  3096.       returned by a subagent by specifying an ending OID in the
  3097.       SearchRange.  If such scoping is used, typically the ending OID
  3098.       would be the first lexicographical successor to the target OID
  3099.       range that was registered by a subagent other than the target
  3100.       subagent.  Regardless of this choice, rule (1) must be obeyed.
  3101.  
  3102.       The master agent may require multiple request-response iterations
  3103.       on the same subagent session, to determine the final value of all
  3104.       requested variables.
  3105.  
  3106.       All AgentX PDUs sent on the session while processing a given SNMP
  3107.       request must contain identical values of transactionID.  Each
  3108.       different SNMP request processed by the master agent must present
  3109.       a unique value of transactionID (within the limits of the 32-bit
  3110.       field) to the session.
  3111.  
  3112.    3) Number and order of variables sent per AgentX PDU
  3113.  
  3114.       For Get/GetNext/GetBulk operations, at any stage of the possibly
  3115.       iterative process, the master agent may need to dispatch several
  3116.       SearchRanges to a particular subagent session.  The master agent
  3117.       may send one, some, or all of the SearchRanges in a single AgentX
  3118.       PDU.
  3119.  
  3120.       The master agent must ensure that the correct contents and
  3121.       ordering of the VarBindList in the SNMP Response-PDU are
  3122.       maintained.
  3123.  
  3124.       The following rules govern the number of VarBinds in a given
  3125.       AgentX PDU:
  3126.  
  3127.          a) The subagent must support processing of AgentX PDUs
  3128.             with multiple VarBinds.
  3129.  
  3130.          b) When processing an SNMP Set request, the master agent
  3131.             must send all of the VarBinds applicable to a particular
  3132.             subagent session in a single Test/Set transaction.
  3133.  
  3134.  
  3135.  
  3136.  
  3137.  
  3138. Daniele, et. al.            Standards Track                    [Page 56]
  3139.  
  3140. RFC 2257                        AgentX                      January 1998
  3141.  
  3142.  
  3143.          c) When processing an SNMP Get, GetNext, or GetBulk request,
  3144.             the master agent may send a single AgentX PDU to the
  3145.             subagent with all applicable VarBinds, or multiple PDUs with
  3146.             single VarBinds, or something in between those extremes. The
  3147.             determination of which method to use in a particular case is
  3148.             implementation-specific.
  3149.  
  3150.    4) Timeout Values
  3151.  
  3152.       The master agent chooses a timeout value for each MIB region being
  3153.       queried, which is
  3154.  
  3155.          a) the value specified during registration of the MIB region,
  3156.             if it was non-zero
  3157.  
  3158.          b) otherwise, the value specified during establishment of
  3159.             the session in which this region was subsequently
  3160.             registered, if that value was non-zero.
  3161.  
  3162.          c) otherwise, the master agent's default value
  3163.  
  3164.       When an AgentX PDU that references multiple MIB regions is
  3165.       dispatched, the timeout value used for the PDU is the maximum
  3166.       value of the timeouts so determined for each of the referenced MIB
  3167.       regions.
  3168.  
  3169.    5) Context
  3170.  
  3171.       If the master agent has determined that a specific non-default
  3172.       context is associated with the SNMP request PDU, that context is
  3173.       encoded into the AgentX PDU's context field and the
  3174.       NON_DEFAULT_CONTEXT bit is set in h.flags.
  3175.  
  3176.       Otherwise, no context Octet String is added to the PDU, and the
  3177.       NON_DEFAULT_CONTEXT bit is cleared.
  3178.  
  3179. 7.2.1.1.  agentx-Get-PDU
  3180.  
  3181.    Each variable binding in the SNMP request PDU is processed as
  3182.    follows:
  3183.  
  3184.    (1) Identify the target OID range.
  3185.  
  3186.        Within a lexicographically ordered set of OID ranges, valid for
  3187.        the indicated context, locate the authoritative region that
  3188.        contains the binding's name.
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194. Daniele, et. al.            Standards Track                    [Page 57]
  3195.  
  3196. RFC 2257                        AgentX                      January 1998
  3197.  
  3198.  
  3199.    (2) If no such OID range exists, the variable binding is not
  3200.        processed further, and its value is set to `noSuchObject'.
  3201.  
  3202.    (3) Identify the subagent session in which this region was
  3203.        registered, termed the target session.
  3204.  
  3205.    (4) If this is the first variable binding to be dispatched over
  3206.        the target session in a request-response exchange entailed in the
  3207.        processing of this management request:
  3208.  
  3209.        - Create an agentx-Get-PDU for this session, with the header
  3210.          fields initialized as described above (see 6.1 AgentX PDU
  3211.          Header).
  3212.  
  3213.    (5) Add a SearchRange to the end of the target session's PDU
  3214.        for this variable binding.
  3215.  
  3216.        - The variable binding's name is encoded into the starting OID.
  3217.  
  3218.        - The ending OID is encoded as null.
  3219.  
  3220. 7.2.1.2.  agentx-GetNext-PDU
  3221.  
  3222.    Each variable binding in the SNMP request PDU is processed as
  3223.    follows:
  3224.  
  3225.    (1) Identify the target OID range.
  3226.  
  3227.        Within a lexicographically ordered set of OID ranges, valid for
  3228.        the indicated context, locate
  3229.  
  3230.         a) the authoritative OID range that contains the variable
  3231.            binding's name and is not a fully qualified instance, or
  3232.  
  3233.         b) the authoritative OID range that is the first
  3234.            lexicographical successor to the variable binding's name.
  3235.  
  3236.    (2) If no such OID range exists, the variable binding is not
  3237.        processed further, and its value is set to `endOfMibView'.
  3238.  
  3239.    (3) Identify the subagent session in which this region was
  3240.        registered, termed the target session.
  3241.  
  3242.    (4) If this is the first variable binding to be dispatched over the
  3243.        target session in a request-response exchange entailed in the
  3244.        processing of this management request:
  3245.  
  3246.  
  3247.  
  3248.  
  3249.  
  3250. Daniele, et. al.            Standards Track                    [Page 58]
  3251.  
  3252. RFC 2257                        AgentX                      January 1998
  3253.  
  3254.  
  3255.        - Create an agentx-GetNext-PDU for the session, with
  3256.          the header fields initialized as described above (see 6.1
  3257.          AgentX PDU Header).
  3258.  
  3259.    (5) Add a SearchRange to the end of the target session's
  3260.        agentx-GetNext-PDU for this variable binding.
  3261.  
  3262.         - if (1a) applies, the variable binding's name is encoded
  3263.           into the starting OID, and the OID's "include" field is set to
  3264.           0.
  3265.  
  3266.         - if (1b) applies, the target OID is encoded into the starting
  3267.           OID, and its "include" field is set to 1.
  3268.  
  3269. 7.2.1.3.  agentx-GetBulk-PDU
  3270.  
  3271.    (Note: The outline of the following procedure is based closely on
  3272.    section 4.2.3, "The GetBulkRequest-PDU" of RFC 1905 [4].  Please
  3273.    refer to it for details on the format of the SNMP GetBulkRequest-PDU
  3274.    itself.)
  3275.  
  3276.    Each variable binding in the request PDU is processed as follows:
  3277.  
  3278.    (1) Identify the authoritative target OID range and target session,
  3279.        exactly as described for the agentx-GetNext-PDU (see 7.2.1.2).
  3280.  
  3281.    (2) If this is the first variable binding to be dispatched over the
  3282.        target session in a request-response exchange entailed in the
  3283.        processing of this management request:
  3284.  
  3285.        - Create an agentx-GetBulk-PDU for the session, with
  3286.          the header fields initialized as described above (see 6.1
  3287.          AgentX PDU Header).
  3288.  
  3289.    (3) Add a SearchRange to the end of the target session's
  3290.        agentx-GetBulk-PDU for this variable binding, as described for
  3291.        the agentx-GetNext-PDU.  If the variable binding was a non-
  3292.        repeater in the original request PDU, it must be a non-repeater
  3293.        in the agentx-GetBulk-PDU.
  3294.  
  3295.    The value of g.max_repetitions in the agentx-GetBulk-PDU may be less
  3296.    than (but not greater than) the value in the original request PDU.
  3297.  
  3298.    The master agent may make such alterations due to simple sanity
  3299.    checking, optimizations for the current iteration based on the
  3300.    registry, the maximum possible size of a potential Response-PDU,
  3301.    known constraints of the AgentX transport, or any other
  3302.    implementation-specific constraint.
  3303.  
  3304.  
  3305.  
  3306. Daniele, et. al.            Standards Track                    [Page 59]
  3307.  
  3308. RFC 2257                        AgentX                      January 1998
  3309.  
  3310.  
  3311. 7.2.1.4.  agentx-TestSet-PDU
  3312.  
  3313.    AgentX employs test-commit-undo-cleanup phases to achieve "as if
  3314.    simultaneous" semantics of the SNMP SetRequest-PDU within the
  3315.    extensible agent.  The initial phase involves the agentx-TestSet-PDU.
  3316.  
  3317.    Each variable binding in the SNMP request PDU is processed in order,
  3318.    as follows:
  3319.  
  3320.    (1) Identify the target OID range.
  3321.  
  3322.        Within a lexicographically ordered set of OID ranges, valid for
  3323.        the indicated context, locate the authoritative range that
  3324.        contains the variable binding's name.
  3325.  
  3326.    (2) If no such OID range exists, this variable binding fails with an
  3327.        error of `notWritable'.  Processing is complete for this request.
  3328.  
  3329.    (3) Identify the single subagent responsible for this OID range,
  3330.        termed the target subagent, and the applicable session, termed
  3331.        the target session.
  3332.  
  3333.    (4) If this is the first variable binding to be dispatched over
  3334.        the target session in a request-response exchange entailed in the
  3335.        processing of this management request:
  3336.  
  3337.        - create an agentx-TestSet-PDU for the session, with the
  3338.          header fields initialized as described above (see 6.1 AgentX
  3339.          PDU Header).
  3340.  
  3341.    (5) Add a VarBind to the end of the target session's PDU
  3342.        for this variable binding, as described in section 5.4.
  3343.  
  3344.     Note that all VarBinds applicable to a given session must be sent in
  3345.     a single agentx-TestSet-PDU.
  3346.  
  3347. 7.2.1.5.  Dispatch
  3348.  
  3349.    A timeout value is calculated for each PDU to be sent, which is the
  3350.    maximum value of the timeouts determined for each of the PDU's
  3351.    SearchRanges (as described above in 7.2.1 Dispatching AgentX PDUs,
  3352.    item 4). Each pending PDU is mapped (via its h.sessionID value) to a
  3353.    particular transport domain/endpoint, as described in section 8
  3354.    (Transport Mappings).
  3355.  
  3356.  
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362. Daniele, et. al.            Standards Track                    [Page 60]
  3363.  
  3364. RFC 2257                        AgentX                      January 1998
  3365.  
  3366.  
  3367. 7.2.2.  Subagent Processing of agentx-Get, GetNext, GetBulk-PDUs
  3368.  
  3369.    A conformant AgentX subagent must support the agentx-Get, -GetNext,
  3370.    and -GetBulk PDUs, and must support multiple variables being supplied
  3371.    in each PDU.
  3372.  
  3373.    When a subagent receives an agentx-Get-, GetNext-, or GetBulk-PDU, it
  3374.    performs the indicated management operations and returns an agentx-
  3375.    Response-PDU.
  3376.  
  3377.    The agentx-Response-PDU header fields are identical to the received
  3378.    request PDU except that, at the start of processing, the subagent
  3379.    initializes h.type to Response, res.error to `noError', res.index to
  3380.    0, and the VarBindList to null.
  3381.  
  3382.    Each SearchRange in the request PDU's SearchRangeList is processed as
  3383.    described below, and a VarBind is added in the corresponding location
  3384.    of the agentx-Response-PDU's  VarbindList.  If processing should fail
  3385.    for any reason not described below, res.error is set to `genErr',
  3386.    res.index to the index of the failed SearchRange, the VarBindList is
  3387.    reset to null, and this agentx-Response-PDU is returned to the master
  3388.    agent.
  3389.  
  3390. 7.2.2.1.  Subagent Processing of the agentx-Get-PDU
  3391.  
  3392.    Upon the subagent's receipt of an agentx-Get-PDU, each SearchRange in
  3393.    the request is processed as follows:
  3394.  
  3395.    (1) The starting OID is copied to v.name.
  3396.  
  3397.    (2) If the starting OID exactly matches the name of a
  3398.        variable instantiated by this subagent within the indicated
  3399.        context and session, v.type and v.data are encoded to represent
  3400.        the variable's syntax and value, as described in section 5.4,
  3401.        Value Representation.
  3402.  
  3403.    (3) Otherwise, if the starting OID does not match the object
  3404.        identifier prefix of any variable instantiated within the
  3405.        indicated context and session, the VarBind is set to
  3406.        `noSuchObject', in the manner described in section 5.4, Value
  3407.        Representation.
  3408.  
  3409.    (4) Otherwise, the VarBind is set to `noSuchInstance'
  3410.        in the manner described in section 5.4, Value Representation.
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418. Daniele, et. al.            Standards Track                    [Page 61]
  3419.  
  3420. RFC 2257                        AgentX                      January 1998
  3421.  
  3422.  
  3423. 7.2.2.2.  Subagent Processing of the agentx-GetNext-PDU
  3424.  
  3425.    Upon the subagent's receipt of an agentx-GetNext-PDU, each
  3426.    SearchRange in the request is processed as follows:
  3427.  
  3428.    (1) The subagent searches for a variable within the
  3429.        lexicographically ordered list of variable names for all
  3430.        variables it instantiates (without regard to registration of
  3431.        regions) within the indicated context and session, for which the
  3432.        following are all true:
  3433.  
  3434.        - if the "include" field of the starting OID is 0, the
  3435.          variable's name is the closest lexicographical successor to the
  3436.          starting OID.
  3437.  
  3438.        - if the "include" field of the starting OID is 1, the
  3439.          variable's name is either equal to, or the closest
  3440.          lexicographical successor to, the starting OID.
  3441.  
  3442.        - If the ending OID is not null, the variable's name
  3443.          lexicographically precedes the ending OID.
  3444.  
  3445.        If all of these conditions are met, v.name is set to the located
  3446.        variable's name.  v.type and v.data are encoded to represent the
  3447.        variable's syntax and value, as described in section 5.4, Value
  3448.        Representation.
  3449.  
  3450.    (2) If no such variable exists, v.name is set to the starting OID,
  3451.        and the VarBind is set to `endOfMibView', in the manner described
  3452.        in section 5.4, Value Representation.
  3453.  
  3454. 7.2.2.3.  Subagent Processing of the agentx-GetBulk-PDU
  3455.  
  3456.    A maximum of N + (M * R) VarBinds are returned, where
  3457.  
  3458.       N equals g.non_repeaters,
  3459.       M equals g.max_repetitions, and
  3460.       R is (number of SearchRanges in the GetBulk request) - N.
  3461.  
  3462.    The first N SearchRanges are processed exactly as for the agentx-
  3463.    GetNext-PDU.
  3464.  
  3465.    If M and R are both non-zero, the remaining R SearchRanges are
  3466.    processed iteratively to produce potentially many VarBinds.  For each
  3467.    iteration i, such that i is greater than zero and less than or equal
  3468.    to M, and for each repeated SearchRange s, such that s is greater
  3469.    than zero and less than or equal to R, the (N+((i-1)*R)+s)-th VarBind
  3470.    is added to the agentx-Response-PDU as follows:
  3471.  
  3472.  
  3473.  
  3474. Daniele, et. al.            Standards Track                    [Page 62]
  3475.  
  3476. RFC 2257                        AgentX                      January 1998
  3477.  
  3478.  
  3479.       1) The subagent searches for a variable within the
  3480.          lexicographically ordered list of variable names for all
  3481.          variables it instantiates (without regard to registration of
  3482.          regions) within the indicated context and session, for which
  3483.          the following are all true:
  3484.  
  3485.           - The variable's name is the (i)-th lexicographical successor
  3486.             to the (N+s)-th requested OID.
  3487.  
  3488.             (Note that if i is 0 and the "include" field is 1, the
  3489.             variable's name may be equivalent to, or the first
  3490.             lexicographical successor to, the (N+s)-th requested OID.)
  3491.  
  3492.           - If the ending OID is not null, the variable's name
  3493.             lexicographically precedes the ending OID.
  3494.  
  3495.          If all of these conditions are met, v.name is set to the
  3496.          located variable's name.  v.type and v.data are encoded to
  3497.          represent the variable's syntax and value, as described in
  3498.          section 5.4, Value Representation.
  3499.  
  3500.       2) If no such variable exists, the VarBind is set to
  3501.          `endOfMibView' as described in section 5.4, Value
  3502.          Representation.  v.name is set to v.name of the (N+((i-
  3503.          2)*R)+s)-th VarBind unless i is currently 1, in which case it
  3504.          is set to the value of the starting OID in the (N+s)-th
  3505.          SearchRange.
  3506.  
  3507.    Note that further iterative processing should stop if
  3508.  
  3509.         - For any iteration i, all s values of v.type are
  3510.           `endOfMibView'.
  3511.  
  3512.         - An AgentX transport constraint or other
  3513.           implementation-specific constraint is reached.
  3514.  
  3515. 7.2.3.  Subagent Processing of agentx-TestSet, -CommitSet, -UndoSet,
  3516.                   -CleanupSet-PDUs
  3517.  
  3518.    A conformant AgentX subagent must support the agentx-TestSet,
  3519.    -CommitSet, -UndoSet, and -CleanupSet PDUs, and must support multiple
  3520.    variables being supplied in each PDU.
  3521.  
  3522.    These four PDUs are used to collectively perform the indicated
  3523.    management operation.  An agentx-Response-PDU is sent in reply to
  3524.    each of the PDUs, to inform the master agent of the state of the
  3525.    operation.
  3526.  
  3527.  
  3528.  
  3529.  
  3530. Daniele, et. al.            Standards Track                    [Page 63]
  3531.  
  3532. RFC 2257                        AgentX                      January 1998
  3533.  
  3534.  
  3535.    The agentx-Response-PDU header fields are identical to the received
  3536.    request PDU except that, at the start of processing, the subagent
  3537.    initializes h.type to Response, res.error to `noError', and res.index
  3538.    to 0.
  3539.  
  3540.    These Response-PDUs do not contain a VarBindList.
  3541.  
  3542. 7.2.3.1.  Subagent Processing of the agentx-TestSet-PDU
  3543.  
  3544.    Upon the subagent's receipt of an agentx-TestSet-PDU, each VarBind in
  3545.    the PDU is validated until they are all successful, or until one
  3546.    fails, as described in section 4.2.5 of RFC 1905 [4]. The subagent
  3547.    validates variables with respect to the context and session indicated
  3548.    in the testSet-PDU.
  3549.  
  3550.    If each VarBind is successful, the subagent has a further
  3551.    responsibility to ensure the availability of all resources (memory,
  3552.    write access, etc.) required for successfully carrying out a
  3553.    subsequent agentx-CommitSet operation.  If this cannot be guaranteed,
  3554.    the subagent should set res.error to `resourceUnavailable'.
  3555.  
  3556.    As a result of this validation step, an agentx-Response-PDU is sent
  3557.    in reply whose res.error field is set to one of the following (SNMPv2
  3558.    SMI) values:
  3559.  
  3560.             noError                    (0),
  3561.             genErr                     (5),
  3562.             noAccess                   (6),
  3563.             wrongType                  (7),
  3564.             wrongLength                (8),
  3565.             wrongEncoding              (9),
  3566.             wrongValue                (10),
  3567.             noCreation                (11),
  3568.             inconsistentValue         (12),
  3569.             resourceUnavailable       (13),
  3570.             notWritable               (17),
  3571.             inconsistentName          (18)
  3572.  
  3573.    If this value is not `noError', the res.index field must be set to
  3574.    the index of the VarBind for which validation failed.
  3575.  
  3576.    Implementation of rigorous validation code may be one of the most
  3577.    demanding aspects of subagent development.  Implementors are strongly
  3578.    encouraged to do this right, so as to avoid if at all possible the
  3579.    extensible agent's having to return `commitFailed' or `undoFailed'
  3580.    during subsequent processing.
  3581.  
  3582.  
  3583.  
  3584.  
  3585.  
  3586. Daniele, et. al.            Standards Track                    [Page 64]
  3587.  
  3588. RFC 2257                        AgentX                      January 1998
  3589.  
  3590.  
  3591. 7.2.3.2.  Subagent Processing of the agentx-CommitSet-PDU
  3592.  
  3593.    The agentx-CommitSet-PDU indicates that the subagent should actually
  3594.    perform (as described in the post-validation sections of 4.2.5 of RFC
  3595.    1905 [4]) the management operation indicated by the previous
  3596.    TestSet-PDU.  After carrying out the management operation, the
  3597.    subagent sends in reply an agentx-Response-PDU whose res.error field
  3598.    is set to one of the following (SNMPv2 SMI) values:
  3599.  
  3600.             noError                    (0),
  3601.             commitFailed              (14)
  3602.  
  3603.    If this value is `commitFailed', the res.index field must be set to
  3604.    the index of the VarBind for which the operation failed.  Otherwise
  3605.    res.index is set to 0.
  3606.  
  3607. 7.2.3.3.  Subagent Processing of the agentx-UndoSet-PDU
  3608.  
  3609.    The agentx-UndoSet-PDU indicates that the subagent should undo the
  3610.    management operation requested in a preceding CommitSet-PDU.  The
  3611.    undo process is as described in section 4.2.5 of RFC 1905 [4].
  3612.  
  3613.    After carrying out the undo process, the subagent sends in reply an
  3614.    agentx-Response-PDU whose res.index field is set to 0, and whose
  3615.    res.error field is set to one of the following (SNMPv2 SMI) values:
  3616.  
  3617.             noError                    (0),
  3618.             undoFailed                (15)
  3619.  
  3620.    If this value is `undoFailed', the res.index field must be set to the
  3621.    index of the VarBind for which the operation failed.  Otherwise
  3622.    res.index is set to 0.
  3623.  
  3624.    This PDU also signals the end of processing of the management
  3625.    operation initiated by the previous TestSet-PDU.  The subagent should
  3626.    release resources, etc. as described in section 7.2.3.4.
  3627.  
  3628. 7.2.3.4.  Subagent Processing of the agentx-CleanupSet-PDU
  3629.  
  3630.    The agentx-CleanupSet-PDU signals the end of processing of the
  3631.    management operation requested in the previous TestSet-PDU.  This is
  3632.    an indication to the subagent that it may now release any resources
  3633.    it may have reserved in order to carry out the management request.
  3634.  
  3635.    No response is sent by the subagent.
  3636.  
  3637.  
  3638.  
  3639.  
  3640.  
  3641.  
  3642. Daniele, et. al.            Standards Track                    [Page 65]
  3643.  
  3644. RFC 2257                        AgentX                      January 1998
  3645.  
  3646.  
  3647. 7.2.4.  Master Agent Processing of AgentX Responses
  3648.  
  3649.    The master agent now marshals all subagent AgentX response PDUs and
  3650.    builds an SNMP response PDU.  In the next several subsections, the
  3651.    initial processing of all subagent AgentX response PDUs is described,
  3652.    followed by descriptions of subsequent processing for each specific
  3653.    subagent Response.
  3654.  
  3655. 7.2.4.1.  Common Processing of All AgentX Response PDUs
  3656.  
  3657.    1) If a subagent does not respond within the timeout interval for
  3658.       this dispatch, it is treated as if the subagent had returned
  3659.       `genErr' and processed as described below.
  3660.  
  3661.       A timeout may be due to a variety of reasons, and does not
  3662.       necessarily denote a failed or malfunctioning subagent.  As such,
  3663.       the master agent's response to a subagent timeout is
  3664.       implementation-specific, but with the following constraint:
  3665.  
  3666.          A subagent that times out on three consecutive requests is
  3667.          considered unable to respond, and the master agent must close
  3668.          the AgentX session as described in 7.1.9, step (2).
  3669.  
  3670.    2) Otherwise, the h.packetID, h.sessionID, and h.transactionID
  3671.       fields of the AgentX response PDU are used to correlate subagent
  3672.       responses.  If the response does not pertain to this SNMP
  3673.       operation, it is ignored.
  3674.  
  3675.    3) Otherwise, the responses are processed jointly to form the SNMP
  3676.       response PDU.
  3677.  
  3678. 7.2.4.2.  Processing of Responses to agentx-Get-PDUs
  3679.  
  3680.    After common processing of the subagent's response to an agentx-Get-
  3681.    PDU (see 7.2.4.1 above), processing continues with the following
  3682.    steps:
  3683.  
  3684.    1)  For any received AgentX response PDU, if res.error is not
  3685.        `noError', the SNMP response PDU's error code is set to this
  3686.        value, and its error index to the index of the variable binding
  3687.        corresponding to the failed VarBind in the subagent's AgentX
  3688.        response PDU.
  3689.  
  3690.        All other AgentX response PDUs received due to processing this
  3691.        SNMP request are ignored.  Processing is complete; the SNMP
  3692.        Response PDU is ready to be sent (see section 7.2.5, Sending the
  3693.        SNMP Response-PDU).
  3694.  
  3695.  
  3696.  
  3697.  
  3698. Daniele, et. al.            Standards Track                    [Page 66]
  3699.  
  3700. RFC 2257                        AgentX                      January 1998
  3701.  
  3702.  
  3703.    2)  Otherwise, the content of each VarBind in the AgentX response PDU
  3704.        is used to update the corresponding variable binding in the SNMP
  3705.        Response-PDU.
  3706.  
  3707. 7.2.4.3.  Processing of Responses to agentx-GetNext-PDU and
  3708.                  agentx-GetBulk-PDU
  3709.  
  3710.    After common processing of the subagent's response to an agentx-
  3711.    GetNext-PDU or agentx-GetBulk-PDU (see 7.2.4.1 above), processing
  3712.    continues with the following steps:
  3713.  
  3714.    1)  For any received AgentX response PDU, if res.error is not
  3715.        `noError', the SNMP response PDU's error code is set to this
  3716.        value, and its error index to the index of the VarBind
  3717.        corresponding to the failed VarBind in the subagent's AgentX
  3718.        response PDU.
  3719.  
  3720.        All other AgentX response PDUs received due to processing this
  3721.        SNMP request are ignored.  Processing is complete; the SNMP
  3722.        response PDU is ready to be sent (see section 7.2.5, Sending the
  3723.        SNMP Response PDU).
  3724.  
  3725.    2)  Otherwise, the content of each VarBind in the AgentX response
  3726.        PDU is used to update the corresponding VarBind in the SNMP
  3727.        response PDU.
  3728.  
  3729.    After all expected AgentX response PDUs have been processed, if any
  3730.    VarBinds still contain the value `endOfMibView' in their v.type
  3731.    fields, processing must continue:
  3732.  
  3733.    3)  A new iteration of AgentX request dispatching is initiated
  3734.        (as described in section 7.2.1.1), in which only those VarBinds
  3735.        whose v.type is `endOfMibView' are processed.
  3736.  
  3737.    4)  For each such VarBind, a target OID range is identified
  3738.        which is the lexicographical successor to the target OID range
  3739.        for this VarBind on the last iteration.  The target subagent is
  3740.        the one that registered the target OID range.  The target session
  3741.        is the one in which the target OID range was registered.
  3742.  
  3743.        If an agentx-GetNext- or GetBulk-PDU is being dispatched, the
  3744.        starting OID in the SearchRanges is set to the target OID range,
  3745.        and its "include" field is set to 1.
  3746.  
  3747.    5)  The value of transactionID must be identical to the value
  3748.        used during the previous iteration.
  3749.  
  3750.  
  3751.  
  3752.  
  3753.  
  3754. Daniele, et. al.            Standards Track                    [Page 67]
  3755.  
  3756. RFC 2257                        AgentX                      January 1998
  3757.  
  3758.  
  3759.    6)  The AgentX PDUs are sent to the subagent(s), and the responses
  3760.        are received and processed according to the steps described in
  3761.        section 7.2.4.
  3762.  
  3763.    7)  This process continues iteratively until a complete SNMP
  3764.        Response-PDU has been built, or until there remain no target OID
  3765.        range lexicographical successors.
  3766.  
  3767. 7.2.4.4.  Processing of Responses to agentx-TestSet-PDUs
  3768.  
  3769.    After common processing of the subagent's response to an agentx-
  3770.    TestSet-PDU (see 7.2.4.1 above), processing continues with the
  3771.    further exchange of AgentX PDUs.  The value of h.transactionID in the
  3772.    agentx-CommitSet, -UndoSet, and -CleanupSet-PDUs must be identical to
  3773.    the value sent in the testSet-PDU.
  3774.  
  3775.    The state transitions and PDU sequences are depicted in section 7.3.
  3776.  
  3777.    1)  If any target subagent's response is not `noError', all other
  3778.        agentx-Response-PDUs received due to processing this SNMP request
  3779.        are ignored.
  3780.  
  3781.        An agentx-CleanupSet-PDU is sent to each target subagent that has
  3782.        been sent a agentx-TestSet-PDU.
  3783.  
  3784.        Processing is complete; the SNMP response PDU is constructed as
  3785.        described below in 7.2.4.6.
  3786.  
  3787.    2)  Otherwise an agentx-CommitSet-PDU is sent to each target
  3788.        subagent.
  3789.  
  3790. 7.2.4.5.  Processing of Responses to agentx-CommitSet-PDUs
  3791.  
  3792.    After common processing of the subagent's response to an agentx-
  3793.    CommitSet-PDU (see 7.2.4.1 above), processing continues with the
  3794.    following steps:
  3795.  
  3796.    1)  If any response is not `noError', all other
  3797.        agentx-Response-PDUs received due to processing this SNMP request
  3798.        are ignored.
  3799.  
  3800.        An agentx-UndoSet-PDU is sent to each target subagent that has
  3801.        been sent a agentx-CommitSet-PDU.  All other subagents are sent a
  3802.        agentx-CleanupSet-PDU.
  3803.  
  3804.    2)  Otherwise an agentx-CleanupSet-PDU is sent to each target
  3805.        subagent.  Processing is complete; the SNMP response PDU is
  3806.        constructed as described below in 7.2.4.6.
  3807.  
  3808.  
  3809.  
  3810. Daniele, et. al.            Standards Track                    [Page 68]
  3811.  
  3812. RFC 2257                        AgentX                      January 1998
  3813.  
  3814.  
  3815. 7.2.4.6.  Processing of Responses to agentx-UndoSet-PDUs
  3816.  
  3817.    After common processing of the subagent's response to an agentx-
  3818.    UndoSet-PDU (see 7.2.4.1 above), processing continues with the
  3819.    following steps:
  3820.  
  3821.    1)  If any response is not `noError' the SNMP response
  3822.        PDU's error code is set to this value, and its error index to the
  3823.        index of the VarBind corresponding to the failed VarBind in the
  3824.        agentx-TestSet-PDU.
  3825.  
  3826.        Otherwise the SNMP response PDU's error code is set to `noError'
  3827.        and its error index to 0.
  3828.  
  3829. 7.2.5.  Sending the SNMP Response-PDU
  3830.  
  3831.    Once the processing described in sections 7.2.1 - 7.2.4 is complete,
  3832.    there is an SNMP response PDU available.  The master agent now
  3833.    implements the Elements of Procedure for the applicable version of
  3834.    the SNMP protocol in order to encapsulate the PDU into a message, and
  3835.    transmit it to the originator of the SNMP management request.  Note
  3836.    that this may involve altering the PDU contents (for instance, to
  3837.    replace the original VarBinds if an error condition is to be
  3838.    returned).
  3839.  
  3840.    The response PDU may also be altered in order to support the SNMP
  3841.    version 1 framework.  In such cases the required mapping is that
  3842.    defined in RFC 2089 [9].  (Note in particular that the rules for
  3843.    handling Counter64 syntax may require re-sending AgentX GetBulk or
  3844.    GetNext PDUs until a VarBind of suitable syntax is returned.)
  3845.  
  3846. 7.2.6.  MIB Views
  3847.  
  3848.    AgentX subagents are not aware of MIB views, since view information
  3849.    is not contained in AgentX PDUs.
  3850.  
  3851.    As stated above, the descriptions of procedures in section 7 of this
  3852.    memo are not intended to constrain the internal architecture of any
  3853.    conformant implementation.  In particular, the master agent
  3854.    procedures described in sections 7.2.1 and 7.2.4 may be altered so as
  3855.    to optimize AgentX exchanges when implementing MIB views.
  3856.  
  3857.    Such optimizations are beyond the scope of this memo.  But note that
  3858.    section 7.2.3 defines subagent behavior in such a way that alteration
  3859.    of SearchRanges may be used in such optimizations.
  3860.  
  3861.  
  3862.  
  3863.  
  3864.  
  3865.  
  3866. Daniele, et. al.            Standards Track                    [Page 69]
  3867.  
  3868. RFC 2257                        AgentX                      January 1998
  3869.  
  3870.  
  3871. 7.3.  State Transitions
  3872.  
  3873.    State diagrams are presented from the master agent's perspective for
  3874.    transport connection and session establishment, and from the
  3875.    subagent's perspective for Set transaction processing.
  3876.  
  3877. 7.3.1.  Set Transaction States
  3878.  
  3879.    The following table presents, from the subagent's perspective, the
  3880.    state transitions involved in Set transaction processing:
  3881.  
  3882.                                        STATE
  3883.             +----------------+--------------+---------+--------+--------
  3884.             |       A        |      B       |   C     |   D    |   E
  3885.             |   (Initial     |    TestOK    | Commit  | Test   | Commit
  3886.             |     State)     |              |  OK     | Fail   |  Fail
  3887.             |                |              |         |        |
  3888.     EVENT   |                |              |         |        |
  3889.    ---------+----------------+--------------+---------+--------+--------
  3890.             | 7.2.3.1        |              |         |        |
  3891.    Receive  | All varbinds   |              |         |        |
  3892.    TestSet  | OK?            |      X       |    X    |   X    |    X
  3893.    PDU      |   Yes ->B      |              |         |        |
  3894.             |   No  ->D      |              |         |        |
  3895.    ---------+----------------+--------------+---------+--------+--------
  3896.             |                |  7.2.3.2     |         |        |
  3897.    Receive  |                |  NoError?    |         |        |
  3898.    Commit-  |       X        |   Yes ->C    |    X    |   X    |    X
  3899.    Set PDU  |                |   No  ->E    |         |        |
  3900.    ---------+----------------+--------------+---------+--------+--------
  3901.    Receive  |                |              | 7.2.3.3 |        |7.2.4.5
  3902.    UndoSet  |       X        |       X      | ->done  |   X    | ->done
  3903.    PDU      |                |              |         |        |
  3904.    ---------+----------------+--------------+---------+--------+--------
  3905.    Receive  |                |  7.2.4.4     | 7.2.3.4 |7.2.4.4 |
  3906.    Cleanup- |       X        |   ->done     | ->done  | ->done |   X
  3907.    Set PDU  |                |              |         |        |
  3908.    ---------+----------------+--------------+---------+--------+--------
  3909.    Session  |                | rollback     | undo    |        |
  3910.    Loss     |  ->done        |  ->done      |  ->done | ->done | ->done
  3911.    ---------+----------------+--------------+---------+--------+--------
  3912.  
  3913.    There are three possible sequences that a subagent may follow for a
  3914.    particular set transaction:
  3915.  
  3916.       1) TestSet CommitSet CleanupSet
  3917.       2) TestSet CommitSet UndoSet
  3918.       3) TestSet           CleanupSet
  3919.  
  3920.  
  3921.  
  3922. Daniele, et. al.            Standards Track                    [Page 70]
  3923.  
  3924. RFC 2257                        AgentX                      January 1998
  3925.  
  3926.  
  3927.    Note that a single PDU sequence may result in multiple paths through
  3928.    the finite state machine (FSM).  For example, the sequence
  3929.  
  3930.       TestSet CommitSet UndoSet
  3931.  
  3932.    may walk through either of these two state sequences:
  3933.  
  3934.       (initial) TestOK CommitOK   (done)
  3935.       (initial) TestOK CommitFail (done)
  3936.  
  3937. 7.3.2  Transport Connection States
  3938.  
  3939.    The following table presents, from the master agent's perspective,
  3940.    the state transitions involved in transport connection setup and
  3941.    teardown:
  3942.  
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.  
  3949.  
  3950.  
  3951.  
  3952.  
  3953.  
  3954.  
  3955.  
  3956.  
  3957.  
  3958.  
  3959.  
  3960.  
  3961.  
  3962.  
  3963.  
  3964.  
  3965.  
  3966.  
  3967.  
  3968.  
  3969.  
  3970.  
  3971.  
  3972.  
  3973.  
  3974.  
  3975.  
  3976.  
  3977.  
  3978. Daniele, et. al.            Standards Track                    [Page 71]
  3979.  
  3980. RFC 2257                        AgentX                      January 1998
  3981.  
  3982.  
  3983.                                 STATE
  3984.                    +--------------+--------------
  3985.                    |      A       |      B
  3986.                    | No transport |  Transport
  3987.                    |              |  connected
  3988.                    |              |
  3989.    EVENT           |              |
  3990.    ----------------+--------------+--------------
  3991.    Transport       |              |
  3992.    connect         |     ->B      |      X
  3993.    indication      |              |
  3994.    ----------------+--------------+--------------
  3995.    Receive         |              | if duplicate
  3996.    Open-PDU        |              | session id,
  3997.                    |              | reject, else
  3998.                    |      X       | establish
  3999.                    |              | session
  4000.                    |              |
  4001.                    |              |     ->B
  4002.    ----------------+--------------+--------------
  4003.    Receive         |              | if matching
  4004.    Response-PDU    |              | session id,
  4005.                    |              | feed to that
  4006.                    |      X       | session's FSM
  4007.                    |              | else ignore
  4008.                    |              |
  4009.                    |              |     ->B
  4010.    ----------------+--------------+--------------
  4011.    Receive other   |              | if matching
  4012.    PDUs            |              | session id,
  4013.                    |              | feed to that
  4014.                    |      X       | session's FSM
  4015.                    |              | else reject
  4016.                    |              |
  4017.                    |              |     ->B
  4018.    ----------------+--------------+--------------
  4019.    Transport       |              |notify all
  4020.    disconnect      |              |sessions on
  4021.    indication      |      X       |this transport
  4022.                    |              |
  4023.                    |              |     ->A
  4024.    ----------------+--------------+--------------
  4025.  
  4026.  
  4027.  
  4028.  
  4029.  
  4030.  
  4031.  
  4032.  
  4033.  
  4034. Daniele, et. al.            Standards Track                    [Page 72]
  4035.  
  4036. RFC 2257                        AgentX                      January 1998
  4037.  
  4038.  
  4039. 7.3.3  Session States
  4040.  
  4041.    The following table presents, from the master agent's perspective,
  4042.    the state transitions involved in session setup and teardown:
  4043.  
  4044.                               STATE
  4045.                   +-------------+----------------
  4046.                   |     A       |      B
  4047.                   |  No session |  Session
  4048.                   |             |  established
  4049.    EVENT          |             |
  4050.    ---------------+-------------+----------------
  4051.                   |  7.1.1      |
  4052.    Receive        |             |      X
  4053.    Open PDU       |    ->B      |
  4054.    ---------------+-------------+----------------
  4055.                   |             |  7.1.9
  4056.    Receive        |      X      |
  4057.    Close PDU      |             |    ->A
  4058.    ---------------+-------------+----------------
  4059.    Receive        |             |  7.1.5
  4060.    Register PDU   |      X      |
  4061.                   |             |    ->B
  4062.    ---------------+-------------+----------------
  4063.    Receive        |             |  7.1.6
  4064.    Unregister     |      X      |
  4065.    PDU            |             |    ->B
  4066.    ---------------+-------------+----------------
  4067.    Receive        |             |
  4068.    Get PDU        |             |
  4069.    GetNext PDU    |             |
  4070.    GetBulk PDU    |      X      |       X
  4071.    TestSet PDU    |             |
  4072.    CommitSet PDU  |             |
  4073.    UndoSet PDU    |             |
  4074.    CleanupSet PDU |             |
  4075.    ---------------+-------------+----------------
  4076.    Receive        |             |  7.1.11
  4077.    Notify PDU     |      X      |
  4078.                   |             |    ->B
  4079.    ---------------+-------------+----------------
  4080.    Receive Ping   |             |  7.1.12
  4081.    PDU            |      X      |
  4082.                   |             |    ->B
  4083.    ---------------+-------------+----------------
  4084.    (continued next page)
  4085.  
  4086.  
  4087.  
  4088.  
  4089.  
  4090. Daniele, et. al.            Standards Track                    [Page 73]
  4091.  
  4092. RFC 2257                        AgentX                      January 1998
  4093.  
  4094.  
  4095.    ---------------+-------------+----------------
  4096.    Receive        |             |  7.1.2
  4097.    IndexAllocate  |      X      |
  4098.    PDU            |             |    ->B
  4099.    ---------------+-------------+----------------
  4100.    Receive        |             |  7.1.4
  4101.    IndexDeallocate|      X      |
  4102.    PDU            |             |    ->B
  4103.    ---------------+-------------+----------------
  4104.    Receive        |             |  7.1.7
  4105.    AddAgentxCaps  |      X      |
  4106.    PDU            |             |    ->B
  4107.    ---------------+-------------+----------------
  4108.    Receive        |             |  7.1.8
  4109.    RemoveAgentxCap|      X      |
  4110.    PDU            |             |    ->B
  4111.    ---------------+-------------+----------------
  4112.    Receive        |             |  7.2.4
  4113.    Response PDU   |      X      |
  4114.                   |             |    ->B
  4115.    ---------------+-------------+----------------
  4116.    Receive        |             |
  4117.    Other PDU      |      X      |       X
  4118.    ---------------+-------------+----------------
  4119.  
  4120. 8.  Transport Mappings
  4121.  
  4122.    The same AgentX PDU formats, encodings, and elements of procedure are
  4123.    used regardless of the underlying transport.
  4124.  
  4125. 8.1.  AgentX over TCP
  4126.  
  4127. 8.1.1.  Well-known Values
  4128.  
  4129.    The master agent accepts TCP connection requests for the well-known
  4130.    port 705.  Subagents connect to the master agent using this port
  4131.    number.
  4132.  
  4133. 8.1.2.  Operation
  4134.  
  4135.    Once a TCP connection has been established, the AgentX peers use this
  4136.    connection to carry all AgentX PDUs. Multiple AgentX sessions may be
  4137.    established using the same TCP connection.  AgentX PDUs are sent
  4138.    within an AgentX session.  AgentX peers are responsible for mapping
  4139.    the h.sessionID to a particular TCP connection.
  4140.  
  4141.    All AgentX PDUs are presented individually to the TCP, to be sent as
  4142.    the data portion of a TCP PDU.
  4143.  
  4144.  
  4145.  
  4146. Daniele, et. al.            Standards Track                    [Page 74]
  4147.  
  4148. RFC 2257                        AgentX                      January 1998
  4149.  
  4150.  
  4151. 8.2.  AgentX over UNIX-domain Sockets
  4152.  
  4153.    Many (BSD-derived) implementations of the UNIX operating system
  4154.    support the UNIX pathname address family (AF_UNIX) for socket
  4155.    communications.  This provides a convenient method of sending and
  4156.    receiving data between processes on the same host.
  4157.  
  4158.    Mapping AgentX to this transport is useful for environments that
  4159.  
  4160.        - wish to guarantee subagents are running on the same
  4161.          managed node as the master agent, and where
  4162.  
  4163.        - sockets provide better performance than TCP or UDP,
  4164.          especially in the presence of heavy network I/O
  4165.  
  4166. 8.2.1.  Well-known Values
  4167.  
  4168.    The master agent creates a well-known UNIX-domain socket endpoint
  4169.    called "/var/agentx/master".  (It may create other, implementation-
  4170.    specific endpoints.)
  4171.  
  4172.    This endpoint name uses the character set encoding native to the
  4173.    managed node, and represents a UNIX-domain stream (SOCK_STREAM)
  4174.    socket.
  4175.  
  4176. 8.2.2.  Operation
  4177.  
  4178.    Once a connection has been established, the AgentX peers use this
  4179.    connection to carry all AgentX PDUs.
  4180.  
  4181.    Multiple AgentX sessions may be established using the same
  4182.    connection.  AgentX PDUs are sent within an AgentX session.  AgentX
  4183.    peers are responsible for mapping the h.sessionID to a particular
  4184.    connection.
  4185.  
  4186.    All AgentX PDUs are presented individually to the socket layer, to be
  4187.    sent in the data stream.
  4188.  
  4189.  
  4190. 9.  Security Considerations
  4191.  
  4192.    This memo defines a protocol between two processing entities, one of
  4193.    which (the master agent) is assumed to perform authentication of
  4194.    received SNMP requests and to control access to management
  4195.    information.  The master agent performs these security operations
  4196.    independently of the other processing entity (the subagent).
  4197.  
  4198.  
  4199.  
  4200.  
  4201.  
  4202. Daniele, et. al.            Standards Track                    [Page 75]
  4203.  
  4204. RFC 2257                        AgentX                      January 1998
  4205.  
  4206.  
  4207.    Security considerations require three questions to be answered:
  4208.  
  4209.       1. Is a particular subagent allowed to initiate a session with a
  4210.          particular master agent?
  4211.  
  4212.       2. During an AgentX session, is any SNMP security-related
  4213.          information (for example, community names) passed from the
  4214.          master agent to the subagent?
  4215.  
  4216.       3. During an AgentX session, what part of the MIB tree is this
  4217.          subagent allowed to register?
  4218.  
  4219.    The answer to the third question is: A subagent can register any
  4220.    subtree (subject to AgentX elements of procedure, section 7.1.5).
  4221.    Currently there is no access control mechanism defined in AgentX. A
  4222.    concern here is that a malicious subagent that registers an
  4223.    unauthorized "sensitive" subtree, could see modification requests to
  4224.    those objects, or by giving its own clever answer to NMS queries,
  4225.    could cause the NMS to do something that leads to information
  4226.    disclosure or other damage.
  4227.  
  4228.    The answer to the second question is: No.
  4229.  
  4230.    Now we can answer the first question.  AgentX does not contain a
  4231.    mechanism for authorizing/refusing session initiations.  Thus,
  4232.    controlling subagent access to the master agent may only be done at a
  4233.    lower layer (e.g., transport).
  4234.  
  4235.    An AgentX subagent can connect to a master agent using either a
  4236.    network transport mechanism (e.g., TCP), or a "local" mechanism
  4237.    (e.g., shared memory, named pipes).
  4238.  
  4239.    In the case where a local transport mechanism is used and both
  4240.    subagent and master agent are running on the same host, connection
  4241.    authorization can be delegated to the operating system features.  The
  4242.    answer to the first security question then becomes: "If and only if
  4243.    the subagent has sufficient privileges, then the operating system
  4244.    will allow the connection".
  4245.  
  4246.    If a network transport is used, currently there is no inherent
  4247.    security.  Transport Layer Security or SSL could be used to control
  4248.    subagent connections, but that is beyond the scope of this document.
  4249.  
  4250.    Thus it is recommended that subagents always run on the same host as
  4251.    the master agent and that operating system features be used to ensure
  4252.    that only properly authorized subagents can establish connections to
  4253.    the master agent.
  4254.  
  4255.  
  4256.  
  4257.  
  4258. Daniele, et. al.            Standards Track                    [Page 76]
  4259.  
  4260. RFC 2257                        AgentX                      January 1998
  4261.  
  4262.  
  4263. 10.  Acknowledgements
  4264.  
  4265.    The initial development of this memo was heavily influenced by the
  4266.    DPI 2.0 specification RFC 1592 [7].
  4267.  
  4268.    This document was produced by the IETF Agent Extensibility (AgentX)
  4269.    Working Group, and benefited especially from the contributions of the
  4270.    following working group members:
  4271.  
  4272.       David Battle, Uri Blumenthal, Jeff Case, Maria Greene, Dave
  4273.       Keeney, Harmen van der Linde, Bob Natale, Randy Presuhn, Aleksey
  4274.       Romanov, Don Ryan, and Juergen Schoenwaelder.
  4275.  
  4276.    The AgentX Working Group is chaired by:
  4277.  
  4278.    Bob Natale
  4279.    ACE*COMM Corporation
  4280.    704 Quince Orchard Road
  4281.    Gaithersburg MD  20878
  4282.  
  4283.    Phone: +1-301-721-3000
  4284.    Fax:   +1-301-721-3001
  4285.    EMail: bnatale@acecomm.com
  4286.  
  4287. 11.  Authors' and Editor's Addresses
  4288.  
  4289.    Mike Daniele
  4290.    Digital Equipment Corporation
  4291.    110 Spit Brook Rd
  4292.    Nashua, NH 03062
  4293.  
  4294.    Phone: +1-603-881-1423
  4295.    EMail: daniele@zk3.dec.com
  4296.  
  4297.  
  4298.    Bert Wijnen
  4299.    IBM Professional Services
  4300.    Watsonweg 2
  4301.    1423 ND Uithoorn
  4302.    The Netherlands
  4303.  
  4304.    Phone: +31-79-322-8316
  4305.    EMail: wijnen@vnet.ibm.com
  4306.  
  4307.  
  4308.  
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314. Daniele, et. al.            Standards Track                    [Page 77]
  4315.  
  4316. RFC 2257                        AgentX                      January 1998
  4317.  
  4318.  
  4319.    Dale Francisco (editor)
  4320.    Cisco Systems
  4321.    150 Castilian Dr
  4322.    Goleta CA 93117
  4323.  
  4324.    Phone: +1-805-961-3642
  4325.    Fax:   +1-805-961-3600
  4326.    EMail: dfrancis@cisco.com
  4327.  
  4328. 12.  References
  4329.  
  4330. [1]  Information processing systems - Open Systems Interconnection -
  4331.      Specification of Abstract Syntax Notation One (ASN.1),
  4332.      International Organization for Standardization.  International
  4333.      Standard 8824, (December, 1987).
  4334.  
  4335. [2]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
  4336.      "Structure of Management Information for Version 2 of the Simple
  4337.      Network Management Protocol (SNMPv2)", RFC 1902, January 1996.
  4338.  
  4339. [3]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
  4340.      "Textual Conventions for Version 2 of the Simple Network Management
  4341.      Protocol (SNMPv2)", RFC 1903, January 1996.
  4342.  
  4343. [4]  Case, J., McCloghrie, K., Rose, M., and S. Waldbusser,
  4344.      "Protocol Operations for Version 2 of the Simple Network Management
  4345.      Protocol (SNMPv2)", RFC 1905, January 1996.
  4346.  
  4347. [5]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
  4348.      "Management Information Base for Version 2 of the Simple Network
  4349.      Management Protocol (SNMPv2)", RFC 1907, January 1996.
  4350.  
  4351. [6]  Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network
  4352.      Management Protocol", STD 15, RFC 1157, SNMP Research, Performance
  4353.      Systems International, MIT Laboratory for Computer Science, May
  4354.      1990.
  4355.  
  4356. [7]  Wijnen, B., Carpenter, G., Curran, K., Sehgal, A. and G. Waters,
  4357.      "Simple Network Management Protocol: Distributed Protocol
  4358.      Interface, Version 2.0", RFC 1592, March 1994.
  4359.  
  4360. [8]  Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
  4361.      "Coexistence between Version 1 and Version 2 of the Internet-
  4362.      standard Network Management Framework", RFC 1908, January 1996.
  4363.  
  4364. [9]  Wijnen, B. and D. Levi, "V2ToV1: Mapping SNMPv2 onto SNMPv1
  4365.      Within a Bilingual SNMP Agent", RFC 2089, January 1997.
  4366.  
  4367.  
  4368.  
  4369.  
  4370. Daniele, et. al.            Standards Track                    [Page 78]
  4371.  
  4372. RFC 2257                        AgentX                      January 1998
  4373.  
  4374.  
  4375. [10] Case, J., McCloghrie, K., Rose, M. and S. Waldbusser,
  4376.      "Conformance Statements for Version 2 of the Simple Network
  4377.      Management Protocol (SNMPv2)", RFC 1904, January 1996.
  4378.  
  4379. [11] McCloghrie, K. and F. Kastenholz, "Evolution of the
  4380.      Interfaces Group of MIB-II", RFC 1573, January 1994.
  4381.  
  4382. [12] Case, J., "FDDI Management Information Base", RFC 1285,
  4383.      January 1992.
  4384.  
  4385. [13] Application MIB Working Group, Krupczak, C., and J. Saperia,
  4386.      "Definitions of System-Level Managed Objects for Applications",
  4387.      draft-ietf-applmib-sysapplmib-08.txt, 15 Apr 1997.
  4388.  
  4389.  
  4390.  
  4391.  
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.  
  4423.  
  4424.  
  4425.  
  4426. Daniele, et. al.            Standards Track                    [Page 79]
  4427.  
  4428. RFC 2257                        AgentX                      January 1998
  4429.  
  4430.  
  4431. 13.  Full Copyright Statement
  4432.  
  4433.    Copyright (C) The Internet Society (1998).  All Rights Reserved.
  4434.  
  4435.    This document and translations of it may be copied and furnished to
  4436.    others, and derivative works that comment on or otherwise explain it
  4437.    or assist in its implementation may be prepared, copied, published
  4438.    and distributed, in whole or in part, without restriction of any
  4439.    kind, provided that the above copyright notice and this paragraph are
  4440.    included on all such copies and derivative works.  However, this
  4441.    document itself may not be modified in any way, such as by removing
  4442.    the copyright notice or references to the Internet Society or other
  4443.    Internet organizations, except as needed for the purpose of
  4444.    developing Internet standards in which case the procedures for
  4445.    copyrights defined in the Internet Standards process must be
  4446.    followed, or as required to translate it into languages other than
  4447.    English.
  4448.  
  4449.    The limited permissions granted above are perpetual and will not be
  4450.    revoked by the Internet Society or its successors or assigns.
  4451.  
  4452.    This document and the information contained herein is provided on an
  4453.    "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
  4454.    TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
  4455.    BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
  4456.    HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
  4457.    MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
  4458.  
  4459.  
  4460.  
  4461.  
  4462.  
  4463.  
  4464.  
  4465.  
  4466.  
  4467.  
  4468.  
  4469.  
  4470.  
  4471.  
  4472.  
  4473.  
  4474.  
  4475.  
  4476.  
  4477.  
  4478.  
  4479.  
  4480.  
  4481.  
  4482. Daniele, et. al.            Standards Track                    [Page 80]
  4483.  
  4484.