finally in sync with archive
[bcm963xx.git] / userapps / opensource / net-snmp / mibs / AGENTX-MIB.txt
diff --git a/userapps/opensource/net-snmp/mibs/AGENTX-MIB.txt b/userapps/opensource/net-snmp/mibs/AGENTX-MIB.txt
deleted file mode 100755 (executable)
index f9e5acd..0000000
+++ /dev/null
@@ -1,527 +0,0 @@
-AGENTX-MIB DEFINITIONS ::= BEGIN
-
-IMPORTS
- MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, mib-2
-    FROM SNMPv2-SMI
- SnmpAdminString
-    FROM SNMP-FRAMEWORK-MIB
- MODULE-COMPLIANCE, OBJECT-GROUP
-    FROM SNMPv2-CONF
- TEXTUAL-CONVENTION, TimeStamp, TruthValue, TDomain
-    FROM SNMPv2-TC;
-agentxMIB MODULE-IDENTITY
- LAST-UPDATED "200001100000Z" -- Midnight 10 January 2000
- ORGANIZATION "AgentX Working Group"
- CONTACT-INFO "WG-email:   agentx@dorothy.bmc.com
-               Subscribe:  agentx-request@dorothy.bmc.com
-               WG-email Archive:  ftp://ftp.peer.com/pub/agentx/archives
-               FTP repository:  ftp://ftp.peer.com/pub/agentx
-               http://www.ietf.org/html.charters/agentx-charter.html
-
-               Chair:      Bob Natale
-                           ACE*COMM Corporation
-               Email:      bnatale@acecomm.com
-
-               WG editor:  Mark Ellison
-                           Ellison Software Consulting, Inc.
-               Email:      ellison@world.std.com
-
-               Co-author:  Lauren Heintz
-                           Cisco Systems,
-               EMail:      lheintz@cisco.com
-
-               Co-author:  Smitha Gudur
-                           Independent Consultant
-               Email:      sgudur@hotmail.com
-              "
- DESCRIPTION    "This is the MIB module for the SNMP Agent Extensibility
-     Protocol (AgentX).  This MIB module will be implemented by
-     the master agent.
-    "
-
-  REVISION     "200001100000Z" -- Midnight 10 January 2000
- DESCRIPTION
-    "Initial version published as RFC 2742."
-  ::= { mib-2  74 }
-
- -- Textual Conventions
-
- AgentxTAddress ::= TEXTUAL-CONVENTION
-   STATUS       current
-   DESCRIPTION
-     "Denotes a transport service address.  This is identical to
-      the TAddress textual convention (SNMPv2-SMI) except that
-      zero-length values are permitted.
-     "
-   SYNTAX       OCTET STRING (SIZE (0..255))
-
- -- Administrative assignments
-
- agentxObjects OBJECT IDENTIFIER      ::= { agentxMIB 1 }
- agentxGeneral OBJECT IDENTIFIER      ::= { agentxObjects 1 }
- agentxConnection OBJECT IDENTIFIER   ::= { agentxObjects 2 }
- agentxSession OBJECT IDENTIFIER      ::= { agentxObjects 3 }
- agentxRegistration OBJECT IDENTIFIER ::= { agentxObjects 4 }
-
- agentxDefaultTimeout OBJECT-TYPE
-  SYNTAX      INTEGER (0..255)
-  UNITS       "seconds"
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The default length of time, in seconds, that the master
-      agent should allow to elapse after dispatching a message
-      to a session before it regards the subagent as not
-      responding.  This is a system-wide value that may
-      override the timeout value associated with a particular
-      session (agentxSessionTimeout) or a particular registered
-      MIB region (agentxRegTimeout).  If the associated value of
-      agentxSessionTimeout and agentxRegTimeout are zero, or
-      impractical in accordance with implementation-specific
-      procedure of the master agent, the value represented by
-      this object will be the effective timeout value for the
-
-      master agent to await a response to a dispatch from a
-      given subagent.
-     "
-  DEFVAL      { 5 }
-  ::= { agentxGeneral 1 }
-
- agentxMasterAgentXVer OBJECT-TYPE
-  SYNTAX      INTEGER (1..255)
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The AgentX protocol version supported by this master agent.
-      The current protocol version is 1.  Note that the master agent
-      must also allow interaction with earlier version subagents.
-     "
-  ::= { agentxGeneral 2 }
-
- --      The AgentX Subagent Connection Group
-
- agentxConnTableLastChange OBJECT-TYPE
-  SYNTAX      TimeStamp
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The value of sysUpTime when the last row creation or deletion
-      occurred in the agentxConnectionTable.
-     "
-  ::= { agentxConnection 1 }
-
- agentxConnectionTable OBJECT-TYPE
-   SYNTAX      SEQUENCE OF AgentxConnectionEntry
-   MAX-ACCESS  not-accessible
-   STATUS      current
-   DESCRIPTION
-     "The agentxConnectionTable tracks all current AgentX transport
-      connections.  There may be zero, one, or more AgentX sessions
-      carried on a given AgentX connection.
-     "
-   ::= { agentxConnection 2 }
-
- agentxConnectionEntry OBJECT-TYPE
-   SYNTAX      AgentxConnectionEntry
-   MAX-ACCESS  not-accessible
-   STATUS      current
-   DESCRIPTION
-     "An agentxConnectionEntry contains information describing a
-      single AgentX transport connection.  A connection may be
-
-      used to support zero or more AgentX sessions.  An entry is
-      created when a new transport connection is established,
-      and is destroyed when the transport connection is terminated.
-     "
-   INDEX { agentxConnIndex }
-   ::= { agentxConnectionTable 1 }
-
- AgentxConnectionEntry ::= SEQUENCE {
-          agentxConnIndex            Unsigned32,
-          agentxConnOpenTime         TimeStamp,
-          agentxConnTransportDomain  TDomain,
-          agentxConnTransportAddress AgentxTAddress }
-
- agentxConnIndex OBJECT-TYPE
-   SYNTAX       Unsigned32 (1..4294967295)
-   MAX-ACCESS   not-accessible
-   STATUS       current
-   DESCRIPTION
-     "agentxConnIndex contains the value that uniquely identifies
-      an open transport connection used by this master agent
-      to provide AgentX service.  Values of this index should
-      not be re-used.  The value assigned to a given transport
-      connection is constant for the lifetime of that connection.
-     "
-   ::= { agentxConnectionEntry 1 }
-
- agentxConnOpenTime OBJECT-TYPE
-   SYNTAX       TimeStamp
-   MAX-ACCESS   read-only
-   STATUS       current
-   DESCRIPTION
-     "The value of sysUpTime when this connection was established
-      and, therefore, its value when this entry was added to the table.
-     "
-   ::= { agentxConnectionEntry 2 }
-
- agentxConnTransportDomain OBJECT-TYPE
-   SYNTAX       TDomain
-   MAX-ACCESS   read-only
-   STATUS       current
-   DESCRIPTION
-     "The transport protocol in use for this connection to the
-      subagent.
-     "
-   ::= { agentxConnectionEntry 3 }
-
- agentxConnTransportAddress OBJECT-TYPE
-   SYNTAX       AgentxTAddress
-   MAX-ACCESS   read-only
-   STATUS       current
-   DESCRIPTION
-     "The transport address of the remote (subagent) end of this
-      connection to the master agent.  This object may be zero-length
-      for unix-domain sockets (and possibly other types of transport
-      addresses) since the subagent need not bind a filename to its
-      local socket.
-     "
-   ::= { agentxConnectionEntry 4 }
-
- -- The AgentX Subagent Session Group
-
- agentxSessionTableLastChange OBJECT-TYPE
-  SYNTAX      TimeStamp
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The value of sysUpTime when the last row creation or deletion
-      occurred in the agentxSessionTable.
-     "
-  ::= { agentxSession 1 }
-
- agentxSessionTable OBJECT-TYPE
-  SYNTAX      SEQUENCE OF AgentxSessionEntry
-  MAX-ACCESS  not-accessible
-  STATUS      current
-  DESCRIPTION
-     "A table of AgentX subagent sessions currently in effect.
-     "
-  ::= { agentxSession 2 }
-
- agentxSessionEntry OBJECT-TYPE
-  SYNTAX      AgentxSessionEntry
-  MAX-ACCESS  not-accessible
-  STATUS      current
-  DESCRIPTION
-     "Information about a single open session between the AgentX
-      master agent and a subagent is contained in this entry.  An
-      entry is created when a new session is successfully established
-      and is destroyed either when the subagent transport connection
-      has terminated or when the subagent session is closed.
-     "
-  INDEX       { agentxConnIndex, agentxSessionIndex }
-  ::= { agentxSessionTable 1 }
-
- AgentxSessionEntry ::= SEQUENCE {
-  agentxSessionIndex         Unsigned32,
-  agentxSessionObjectID      OBJECT IDENTIFIER,
-  agentxSessionDescr         SnmpAdminString,
-  agentxSessionAdminStatus   INTEGER,
-  agentxSessionOpenTime      TimeStamp,
-  agentxSessionAgentXVer     INTEGER,
-  agentxSessionTimeout       INTEGER
- }
-
- agentxSessionIndex OBJECT-TYPE
-  SYNTAX      Unsigned32 (0..4294967295)
-  MAX-ACCESS  not-accessible
-  STATUS      current
-  DESCRIPTION
-     "A unique index for the subagent session.  It is the same as
-      h.sessionID defined in the agentx header.  Note that if
-      a subagent's session with the master agent is closed for
-      any reason its index should not be re-used.
-      A value of zero(0) is specifically allowed in order
-      to be compatible with the definition of h.sessionId.
-     "
-  ::= { agentxSessionEntry 1 }
-
- agentxSessionObjectID OBJECT-TYPE
-  SYNTAX      OBJECT IDENTIFIER
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "This is taken from the o.id field of the agentx-Open-PDU.
-      This attribute will report a value of '0.0' for subagents
-      not supporting the notion of an AgentX session object
-      identifier.
-     "
-  ::= { agentxSessionEntry 2 }
-
- agentxSessionDescr OBJECT-TYPE
-  SYNTAX      SnmpAdminString
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "A textual description of the session.  This is analogous to
-      sysDescr defined in the SNMPv2-MIB in RFC 1907 [19] and is
-      taken from the o.descr field of the agentx-Open-PDU.
-      This attribute will report a zero-length string value for
-      subagents not supporting the notion of a session description.
-     "
-  ::= { agentxSessionEntry 3 }
-
- agentxSessionAdminStatus OBJECT-TYPE
-  SYNTAX      INTEGER {
-                 up(1),
-                 down(2)
-              }
-  MAX-ACCESS  read-write
-  STATUS      current
-  DESCRIPTION
-     "The administrative (desired) status of the session.  Setting
-      the value to 'down(2)' closes the subagent session (with c.reason
-      set to 'reasonByManager').
-     "
-  ::= { agentxSessionEntry 4 }
-
- agentxSessionOpenTime OBJECT-TYPE
-  SYNTAX      TimeStamp
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The value of sysUpTime when this session was opened and,
-      therefore, its value when this entry was added to the table.
-     "
-  ::= { agentxSessionEntry 5 }
-
- agentxSessionAgentXVer OBJECT-TYPE
-  SYNTAX      INTEGER (1..255)
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The version of the AgentX protocol supported by the
-      session.  This must be less than or equal to the value of
-      agentxMasterAgentXVer.
-     "
-  ::= { agentxSessionEntry 6 }
-
- agentxSessionTimeout OBJECT-TYPE
-  SYNTAX     INTEGER (0..255)
-  UNITS      "seconds"
-  MAX-ACCESS read-only
-  STATUS     current
-  DESCRIPTION
-     "The length of time, in seconds, that a master agent should
-      allow to elapse after dispatching a message to this session
-      before it regards the subagent as not responding.  This value
-      is taken from the o.timeout field of the agentx-Open-PDU.
-      This is a session-specific value that may be overridden by
-      values associated with the specific registered MIB regions
-      (see agentxRegTimeout). A value of zero(0) indicates that
-      the master agent's default timeout value should be used
-
-      (see agentxDefaultTimeout).
-     "
-  ::= { agentxSessionEntry 7 }
-
- -- The AgentX Registration Group
-
- agentxRegistrationTableLastChange OBJECT-TYPE
-  SYNTAX      TimeStamp
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The value of sysUpTime when the last row creation or deletion
-      occurred in the agentxRegistrationTable.
-     "
-  ::= { agentxRegistration 1 }
-
- agentxRegistrationTable OBJECT-TYPE
-  SYNTAX      SEQUENCE OF AgentxRegistrationEntry
-  MAX-ACCESS  not-accessible
-  STATUS      current
-  DESCRIPTION
-     "A table of registered regions.
-     "
-  ::= { agentxRegistration 2 }
-
- agentxRegistrationEntry OBJECT-TYPE
-  SYNTAX      AgentxRegistrationEntry
-  MAX-ACCESS  not-accessible
-  STATUS      current
-  DESCRIPTION
-     "Contains information for a single registered region.  An
-      entry is created when a session  successfully registers a
-      region and is destroyed for any of three reasons: this region
-      is unregistered by the session, the session is closed,
-      or the subagent connection is closed.
-     "
-  INDEX       { agentxConnIndex, agentxSessionIndex, agentxRegIndex }
-  ::= { agentxRegistrationTable 1 }
-
- AgentxRegistrationEntry ::= SEQUENCE {
-  agentxRegIndex           Unsigned32,
-  agentxRegContext         OCTET STRING,
-  agentxRegStart           OBJECT IDENTIFIER,
-  agentxRegRangeSubId      Unsigned32,
-  agentxRegUpperBound      Unsigned32,
-  agentxRegPriority        Unsigned32,
-  agentxRegTimeout         INTEGER,
-  agentxRegInstance        TruthValue }
-
- agentxRegIndex OBJECT-TYPE
-  SYNTAX      Unsigned32 (1..4294967295)
-  MAX-ACCESS  not-accessible
-  STATUS      current
-  DESCRIPTION
-     "agentxRegIndex uniquely identifies a registration entry.
-      This value is constant for the lifetime of an entry.
-     "
-  ::= { agentxRegistrationEntry 1 }
-
- agentxRegContext OBJECT-TYPE
-  SYNTAX      OCTET STRING
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The context in which the session supports the objects in this
-      region.  A zero-length context indicates the default context.
-     "
-  ::= { agentxRegistrationEntry 2 }
-
- agentxRegStart OBJECT-TYPE
-  SYNTAX      OBJECT IDENTIFIER
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The starting OBJECT IDENTIFIER of this registration entry.  The
-      session identified by agentxSessionIndex implements objects
-      starting at this value (inclusive).  Note that this value could
-      identify an object type, an object instance, or a partial object
-      instance.
-     "
-  ::= { agentxRegistrationEntry 3 }
-
- agentxRegRangeSubId OBJECT-TYPE
-  SYNTAX      Unsigned32
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "agentxRegRangeSubId is used to specify the range.  This is
-      taken from r.region_subid in the registration PDU.  If the value
-      of this object is zero, no range is specified.  If it is non-zero,
-      it identifies the `nth' sub-identifier in r.region for which
-      this entry's agentxRegUpperBound value is substituted in the
-      OID for purposes of defining the region's upper bound.
-     "
-  ::= { agentxRegistrationEntry 4 }
-
- agentxRegUpperBound OBJECT-TYPE
-  SYNTAX      Unsigned32
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-    "agentxRegUpperBound represents the upper-bound sub-identifier in
-     a registration.  This is taken from the r.upper_bound in the
-     registration PDU.  If agentxRegRangeSubid (r.region_subid) is
-     zero, this value is also zero and is not used to define an upper
-     bound for this registration.
-    "
-  ::= { agentxRegistrationEntry 5 }
-
- agentxRegPriority OBJECT-TYPE
-  SYNTAX      Unsigned32
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The registration priority.  Lower values have higher priority.
-      This value is taken from r.priority in the register PDU.
-      Sessions should use the value of 127 for r.priority if a
-      default value is desired.
-     "
-  ::= { agentxRegistrationEntry 6 }
-
- agentxRegTimeout OBJECT-TYPE
-  SYNTAX      INTEGER (0..255)
-  UNITS       "seconds"
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The timeout value, in seconds, for responses to
-      requests associated with this registered MIB region.
-      A value of zero(0) indicates the default value (indicated
-      by by agentxSessionTimeout or agentxDefaultTimeout) is to
-      be used.  This value is taken from the r.timeout field of
-      the agentx-Register-PDU.
-     "
-  ::= { agentxRegistrationEntry 7 }
-
- agentxRegInstance OBJECT-TYPE
-  SYNTAX      TruthValue
-  MAX-ACCESS  read-only
-  STATUS      current
-  DESCRIPTION
-     "The value of agentxRegInstance is `true' for
-      registrations for which the INSTANCE_REGISTRATION
-      was set, and is `false' for all other registrations.
-     "
-  ::= { agentxRegistrationEntry 8 }
-
- -- Conformance Statements for AgentX
-
- agentxConformance     OBJECT IDENTIFIER ::= { agentxMIB 2 }
- agentxMIBGroups       OBJECT IDENTIFIER ::= { agentxConformance 1 }
- agentxMIBCompliances  OBJECT IDENTIFIER ::= { agentxConformance 2 }
-
- -- Compliance Statements for AgentX
-
- agentxMIBCompliance MODULE-COMPLIANCE
-  STATUS      current
-  DESCRIPTION
-     "The compliance statement for SNMP entities that implement the
-      AgentX protocol.  Note that a compliant agent can implement all
-      objects in this MIB module as read-only.
-     "
-  MODULE -- this module
-     MANDATORY-GROUPS  { agentxMIBGroup }
-
-     OBJECT agentxSessionAdminStatus
-        MIN-ACCESS read-only
-        DESCRIPTION
-           "Write access is not required.
-           "
-  ::= { agentxMIBCompliances 1 }
-
- agentxMIBGroup OBJECT-GROUP
-  OBJECTS {
-     agentxDefaultTimeout,
-     agentxMasterAgentXVer,
-     agentxConnTableLastChange,
-     agentxConnOpenTime,
-     agentxConnTransportDomain,
-     agentxConnTransportAddress,
-     agentxSessionTableLastChange,
-     agentxSessionTimeout,
-     agentxSessionObjectID,
-     agentxSessionDescr,
-     agentxSessionAdminStatus,
-     agentxSessionOpenTime,
-     agentxSessionAgentXVer,
-     agentxRegistrationTableLastChange,
-     agentxRegContext,
-     agentxRegStart,
-     agentxRegRangeSubId,
-     agentxRegUpperBound,
-     agentxRegPriority,
-     agentxRegTimeout,
-     agentxRegInstance
-    }
-  STATUS      current
-  DESCRIPTION
-     "All accessible objects in the AgentX MIB.
-     "
-  ::= { agentxMIBGroups 1 }
-
- END