Leaked source code of windows server 2003
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

3352 lines
105 KiB

  1. Network Working Group K. McCloghrie
  2. Request for Comments: 1213 Hughes LAN Systems, Inc.
  3. Obsoletes: RFC 1158 M. Rose
  4. Performance Systems International
  5. Editors
  6. March 1991
  7. Management Information Base for Network Management
  8. of TCP/IP-based internets:
  9. MIB-II
  10. Status of this Memo
  11. This memo defines the second version of the Management Information
  12. Base (MIB-II) for use with network management protocols in TCP/IP-
  13. based internets. This RFC specifies an IAB standards track protocol
  14. for the Internet community, and requests discussion and suggestions
  15. for improvements. Please refer to the current edition of the "IAB
  16. Official Protocol Standards" for the standardization state and status
  17. of this protocol. Distribution of this memo is unlimited.
  18. Table of Contents
  19. 1. Abstract............................................... 2
  20. 2. Introduction .......................................... 2
  21. 3. Changes from RFC 1156 ................................. 3
  22. 3.1 Deprecated Objects ................................... 3
  23. 3.2 Display Strings ...................................... 4
  24. 3.3 Physical Addresses ................................... 4
  25. 3.4 The System Group ..................................... 5
  26. 3.5 The Interfaces Group ................................. 5
  27. 3.6 The Address Translation Group ........................ 6
  28. 3.7 The IP Group ......................................... 6
  29. 3.8 The ICMP Group ....................................... 7
  30. 3.9 The TCP Group ........................................ 7
  31. 3.10 The UDP Group ....................................... 7
  32. 3.11 The EGP Group ....................................... 7
  33. 3.12 The Transmission Group .............................. 8
  34. 3.13 The SNMP Group ...................................... 8
  35. 3.14 Changes from RFC 1158 ................. ............. 9
  36. 4. Objects ............................................... 10
  37. 4.1 Format of Definitions ................................ 10
  38. 5. Overview .............................................. 10
  39. 6. Definitions ........................................... 12
  40. 6.1 Textual Conventions .................................. 12
  41. 6.2 Groups in MIB-II ..................................... 13
  42. 6.3 The System Group ..................................... 13
  43. SNMP Working Group [Page 1]
  44. RFC 1213 MIB-II March 1991
  45. 6.4 The Interfaces Group ................................. 16
  46. 6.5 The Address Translation Group ........................ 23
  47. 6.6 The IP Group ......................................... 26
  48. 6.7 The ICMP Group ....................................... 41
  49. 6.8 The TCP Group ........................................ 46
  50. 6.9 The UDP Group ........................................ 52
  51. 6.10 The EGP Group ....................................... 54
  52. 6.11 The Transmission Group .............................. 60
  53. 6.12 The SNMP Group ...................................... 60
  54. 7. Acknowledgements ...................................... 67
  55. 8. References ............................................ 69
  56. 9. Security Considerations ............................... 70
  57. 10. Authors' Addresses ................................... 70
  58. 1. Abstract
  59. This memo defines the second version of the Management Information
  60. Base (MIB-II) for use with network management protocols in TCP/IP-
  61. based internets. In particular, together with its companion memos
  62. which describe the structure of management information (RFC 1155)
  63. along with the network management protocol (RFC 1157) for TCP/IP-
  64. based internets, these documents provide a simple, workable
  65. architecture and system for managing TCP/IP-based internets and in
  66. particular the Internet community.
  67. 2. Introduction
  68. As reported in RFC 1052, IAB Recommendations for the Development of
  69. Internet Network Management Standards [1], a two-prong strategy for
  70. network management of TCP/IP-based internets was undertaken. In the
  71. short-term, the Simple Network Management Protocol (SNMP) was to be
  72. used to manage nodes in the Internet community. In the long-term,
  73. the use of the OSI network management framework was to be examined.
  74. Two documents were produced to define the management information: RFC
  75. 1065, which defined the Structure of Management Information (SMI)
  76. [2], and RFC 1066, which defined the Management Information Base
  77. (MIB) [3]. Both of these documents were designed so as to be
  78. compatible with both the SNMP and the OSI network management
  79. framework.
  80. This strategy was quite successful in the short-term: Internet-based
  81. network management technology was fielded, by both the research and
  82. commercial communities, within a few months. As a result of this,
  83. portions of the Internet community became network manageable in a
  84. timely fashion.
  85. As reported in RFC 1109, Report of the Second Ad Hoc Network
  86. Management Review Group [4], the requirements of the SNMP and the OSI
  87. network management frameworks were more different than anticipated.
  88. As such, the requirement for compatibility between the SMI/MIB and
  89. both frameworks was suspended. This action permitted the operational
  90. network management framework, the SNMP, to respond to new operational
  91. needs in the Internet community by producing this document.
  92. As such, the current network management framework for TCP/IP- based
  93. internets consists of: Structure and Identification of Management
  94. Information for TCP/IP-based internets, RFC 1155 [12], which
  95. describes how managed objects contained in the MIB are defined;
  96. Management Information Base for Network Management of TCP/IP-based
  97. internets: MIB-II, this memo, which describes the managed objects
  98. contained in the MIB (and supercedes RFC 1156 [13]); and, the Simple
  99. Network Management Protocol, RFC 1098 [5], which defines the protocol
  100. used to manage these objects.
  101. 3. Changes from RFC 1156
  102. Features of this MIB include:
  103. (1) incremental additions to reflect new operational
  104. requirements;
  105. (2) upwards compatibility with the SMI/MIB and the SNMP;
  106. (3) improved support for multi-protocol entities; and,
  107. (4) textual clean-up of the MIB to improve clarity and
  108. readability.
  109. The objects defined in MIB-II have the OBJECT IDENTIFIER prefix:
  110. mib-2 OBJECT IDENTIFIER ::= { mgmt 1 }
  111. which is identical to the prefix used in MIB-I.
  112. 3.1. Deprecated Objects
  113. In order to better prepare implementors for future changes in the
  114. MIB, a new term "deprecated" may be used when describing an object.
  115. A deprecated object in the MIB is one which must be supported, but
  116. one which will most likely be removed from the next version of the
  117. MIB (e.g., MIB-III).
  118. MIB-II marks one object as being deprecated:
  119. atTable
  120. As a result of deprecating the atTable object, the entire Address
  121. Translation group is deprecated.
  122. Note that no functionality is lost with the deprecation of these
  123. objects: new objects providing equivalent or superior functionality
  124. are defined in MIB-II.
  125. 3.2. Display Strings
  126. In the past, there have been misinterpretations of the MIB as to when
  127. a string of octets should contain printable characters, meant to be
  128. displayed to a human. As a textual convention in the MIB, the
  129. datatype
  130. DisplayString ::=
  131. OCTET STRING
  132. is introduced. A DisplayString is restricted to the NVT ASCII
  133. character set, as defined in pages 10-11 of [6].
  134. The following objects are now defined in terms of DisplayString:
  135. sysDescr
  136. ifDescr
  137. It should be noted that this change has no effect on either the
  138. syntax nor semantics of these objects. The use of the DisplayString
  139. notation is merely an artifact of the explanatory method used in
  140. MIB-II and future MIBs.
  141. Further it should be noted that any object defined in terms of OCTET
  142. STRING may contain arbitrary binary data, in which each octet may
  143. take any value from 0 to 255 (decimal).
  144. 3.3. Physical Addresses
  145. As a further, textual convention in the MIB, the datatype
  146. PhysAddress ::=
  147. OCTET STRING
  148. is introduced to represent media- or physical-level addresses.
  149. The following objects are now defined in terms of PhysAddress:
  150. ifPhysAddress
  151. atPhysAddress
  152. ipNetToMediaPhysAddress
  153. It should be noted that this change has no effect on either the
  154. syntax nor semantics of these objects. The use of the PhysAddress
  155. notation is merely an artifact of the explanatory method used in
  156. MIB-II and future MIBs.
  157. 3.4. The System Group
  158. Four new objects are added to this group:
  159. sysContact
  160. sysName
  161. sysLocation
  162. sysServices
  163. These provide contact, administrative, location, and service
  164. information regarding the managed node.
  165. 3.5. The Interfaces Group
  166. The definition of the ifNumber object was incorrect, as it required
  167. all interfaces to support IP. (For example, devices without IP, such
  168. as MAC-layer bridges, could not be managed if this definition was
  169. strictly followed.) The description of the ifNumber object is
  170. changed accordingly.
  171. The ifTable object was mistaken marked as read-write, it has been
  172. (correctly) re-designated as not-accessible. In addition, several
  173. new values have been added to the ifType column in the ifTable
  174. object:
  175. ppp(23)
  176. softwareLoopback(24)
  177. eon(25)
  178. ethernet-3Mbit(26)
  179. nsip(27)
  180. slip(28)
  181. ultra(29)
  182. ds3(30)
  183. sip(31)
  184. frame-relay(32)
  185. Finally, a new column has been added to the ifTable object:
  186. ifSpecific
  187. which provides information about information specific to the media
  188. being used to realize the interface.
  189. 3.6. The Address Translation Group
  190. In MIB-I this group contained a table which permitted mappings from
  191. network addresses (e.g., IP addresses) to physical addresses (e.g.,
  192. MAC addresses). Experience has shown that efficient implementations
  193. of this table make two assumptions: a single network protocol
  194. environment, and mappings occur only from network address to physical
  195. address.
  196. The need to support multi-protocol nodes (e.g., those with both the
  197. IP and CLNP active), and the need to support the inverse mapping
  198. (e.g., for ES-IS), have invalidated both of these assumptions. As
  199. such, the atTable object is declared deprecated.
  200. In order to meet both the multi-protocol and inverse mapping
  201. requirements, MIB-II and its successors will allocate up to two
  202. address translation tables inside each network protocol group. That
  203. is, the IP group will contain one address translation table, for
  204. going from IP addresses to physical addresses. Similarly, when a
  205. document defining MIB objects for the CLNP is produced (e.g., [7]),
  206. it will contain two tables, for mappings in both directions, as this
  207. is required for full functionality.
  208. It should be noted that the choice of two tables (one for each
  209. direction of mapping) provides for ease of implementation in many
  210. cases, and does not introduce undue burden on implementations which
  211. realize the address translation abstraction through a single internal
  212. table.
  213. 3.7. The IP Group
  214. The access attribute of the variable ipForwarding has been changed
  215. from read-only to read-write.
  216. In addition, there is a new column to the ipAddrTable object,
  217. ipAdEntReasmMaxSize
  218. which keeps track of the largest IP datagram that can be re-assembled
  219. on a particular interface.
  220. The descriptor of the ipRoutingTable object has been changed to
  221. ipRouteTable for consistency with the other IP routing objects.
  222. There are also three new columns in the ipRouteTable object,
  223. ipRouteMask
  224. ipRouteMetric5
  225. ipRouteInfo
  226. the first is used for IP routing subsystems that support arbitrary
  227. subnet masks, and the latter two are IP routing protocol-specific.
  228. Two new objects are added to the IP group:
  229. ipNetToMediaTable
  230. ipRoutingDiscards
  231. the first is the address translation table for the IP group
  232. (providing identical functionality to the now deprecated atTable in
  233. the address translation group), and the latter provides information
  234. when routes are lost due to a lack of buffer space.
  235. 3.8. The ICMP Group
  236. There are no changes to this group.
  237. 3.9. The TCP Group
  238. Two new variables are added:
  239. tcpInErrs
  240. tcpOutRsts
  241. which keep track of the number of incoming TCP segments in error and
  242. the number of resets generated by a TCP.
  243. 3.10. The UDP Group
  244. A new table:
  245. udpTable
  246. is added.
  247. 3.11. The EGP Group
  248. Experience has indicated a need for additional objects that are
  249. useful in EGP monitoring. In addition to making several additions to
  250. the egpNeighborTable object, i.e.,
  251. egpNeighAs
  252. egpNeighInMsgs
  253. egpNeighInErrs
  254. egpNeighOutMsgs
  255. egpNeighOutErrs
  256. egpNeighInErrMsgs
  257. egpNeighOutErrMsgs
  258. egpNeighStateUps
  259. egpNeighStateDowns
  260. egpNeighIntervalHello
  261. egpNeighIntervalPoll
  262. egpNeighMode
  263. egpNeighEventTrigger
  264. a new variable is added:
  265. egpAs
  266. which gives the autonomous system associated with this EGP entity.
  267. 3.12. The Transmission Group
  268. MIB-I was lacking in that it did not distinguish between different
  269. types of transmission media. A new group, the Transmission group, is
  270. allocated for this purpose:
  271. transmission OBJECT IDENTIFIER ::= { mib-2 10 }
  272. When Internet-standard definitions for managing transmission media
  273. are defined, the transmission group is used to provide a prefix for
  274. the names of those objects.
  275. Typically, such definitions reside in the experimental portion of the
  276. MIB until they are "proven", then as a part of the Internet
  277. standardization process, the definitions are accordingly elevated and
  278. a new object identifier, under the transmission group is defined. By
  279. convention, the name assigned is:
  280. type OBJECT IDENTIFIER ::= { transmission number }
  281. where "type" is the symbolic value used for the media in the ifType
  282. column of the ifTable object, and "number" is the actual integer
  283. value corresponding to the symbol.
  284. 3.13. The SNMP Group
  285. The application-oriented working groups of the IETF have been tasked
  286. to be receptive towards defining MIB variables specific to their
  287. respective applications.
  288. For the SNMP, it is useful to have statistical information. A new
  289. group, the SNMP group, is allocated for this purpose:
  290. snmp OBJECT IDENTIFIER ::= { mib-2 11 }
  291. 3.14. Changes from RFC 1158
  292. Features of this MIB include:
  293. (1) The managed objects in this document have been defined
  294. using the conventions defined in the Internet-standard
  295. SMI, as amended by the extensions specified in [14]. It
  296. must be emphasized that definitions made using these
  297. extensions are semantically identically to those in RFC
  298. 1158.
  299. (2) The PhysAddress textual convention has been introduced to
  300. represent media addresses.
  301. (3) The ACCESS clause of sysLocation is now read-write.
  302. (4) The definition of sysServices has been clarified.
  303. (5) New ifType values (29-32) have been defined. In
  304. addition, the textual-descriptor for the DS1 and E1
  305. interface types has been corrected.
  306. (6) The definition of ipForwarding has been clarified.
  307. (7) The definition of ipRouteType has been clarified.
  308. (8) The ipRouteMetric5 and ipRouteInfo objects have been
  309. defined.
  310. (9) The ACCESS clause of tcpConnState is now read-write, to
  311. support deletion of the TCB associated with a TCP
  312. connection. The definition of this object has been
  313. clarified to explain this usage.
  314. (10) The definition of egpNeighEventTrigger has been
  315. clarified.
  316. (11) The definition of several of the variables in the new
  317. snmp group have been clarified. In addition, the
  318. snmpInBadTypes and snmpOutReadOnlys objects are no longer
  319. present. (However, the object identifiers associated
  320. with those objects are reserved to prevent future use.)
  321. (12) The definition of snmpInReadOnlys has been clarified.
  322. (13) The textual descriptor of the snmpEnableAuthTraps has
  323. been changed to snmpEnableAuthenTraps, and the definition
  324. has been clarified.
  325. (14) The ipRoutingDiscards object was added.
  326. (15) The optional use of an implementation-dependent, small
  327. positive integer was disallowed when identifying
  328. instances of the IP address and routing tables.
  329. 4. Objects
  330. Managed objects are accessed via a virtual information store, termed
  331. the Management Information Base or MIB. Objects in the MIB are
  332. defined using the subset of Abstract Syntax Notation One (ASN.1) [8]
  333. defined in the SMI. In particular, each object has a name, a syntax,
  334. and an encoding. The name is an object identifier, an
  335. administratively assigned name, which specifies an object type. The
  336. object type together with an object instance serves to uniquely
  337. identify a specific instantiation of the object. For human
  338. convenience, we often use a textual string, termed the OBJECT
  339. DESCRIPTOR, to also refer to the object type.
  340. The syntax of an object type defines the abstract data structure
  341. corresponding to that object type. The ASN.1 language is used for
  342. this purpose. However, the SMI [12] purposely restricts the ASN.1
  343. constructs which may be used. These restrictions are explicitly made
  344. for simplicity.
  345. The encoding of an object type is simply how that object type is
  346. represented using the object type's syntax. Implicitly tied to the
  347. notion of an object type's syntax and encoding is how the object type
  348. is represented when being transmitted on the network.
  349. The SMI specifies the use of the basic encoding rules of ASN.1 [9],
  350. subject to the additional requirements imposed by the SNMP.
  351. 4.1. Format of Definitions
  352. Section 6 contains contains the specification of all object types
  353. contained in this MIB module. The object types are defined using the
  354. conventions defined in the SMI, as amended by the extensions
  355. specified in [14].
  356. 5. Overview
  357. Consistent with the IAB directive to produce simple, workable systems
  358. in the short-term, the list of managed objects defined here, has been
  359. derived by taking only those elements which are considered essential.
  360. This approach of taking only the essential objects is NOT
  361. restrictive, since the SMI defined in the companion memo provides
  362. three extensibility mechanisms: one, the addition of new standard
  363. objects through the definitions of new versions of the MIB; two, the
  364. addition of widely-available but non-standard objects through the
  365. experimental subtree; and three, the addition of private objects
  366. through the enterprises subtree. Such additional objects can not
  367. only be used for vendor-specific elements, but also for
  368. experimentation as required to further the knowledge of which other
  369. objects are essential.
  370. The design of MIB-II is heavily influenced by the first extensibility
  371. mechanism. Several new variables have been added based on
  372. operational experience and need. Based on this, the criteria for
  373. including an object in MIB-II are remarkably similar to the MIB-I
  374. criteria:
  375. (1) An object needed to be essential for either fault or
  376. configuration management.
  377. (2) Only weak control objects were permitted (by weak, it is
  378. meant that tampering with them can do only limited
  379. damage). This criterion reflects the fact that the
  380. current management protocols are not sufficiently secure
  381. to do more powerful control operations.
  382. (3) Evidence of current use and utility was required.
  383. (4) In MIB-I, an attempt was made to limit the number of
  384. objects to about 100 to make it easier for vendors to
  385. fully instrument their software. In MIB-II, this limit
  386. was raised given the wide technological base now
  387. implementing MIB-I.
  388. (5) To avoid redundant variables, it was required that no
  389. object be included that can be derived from others in the
  390. MIB.
  391. (6) Implementation specific objects (e.g., for BSD UNIX) were
  392. excluded.
  393. (7) It was agreed to avoid heavily instrumenting critical
  394. sections of code. The general guideline was one counter
  395. per critical section per layer.
  396. MIB-II, like its predecessor, the Internet-standard MIB, contains
  397. only essential elements. There is no need to allow individual
  398. objects to be optional. Rather, the objects are arranged into the
  399. following groups:
  400. - System
  401. - Interfaces
  402. - Address Translation (deprecated)
  403. - IP
  404. - ICMP
  405. - TCP
  406. - UDP
  407. - EGP
  408. - Transmission
  409. - SNMP
  410. These groups are the basic unit of conformance: This method is as
  411. follows: if the semantics of a group is applicable to an
  412. implementation, then it must implement all objects in that group.
  413. For example, an implementation must implement the EGP group if and
  414. only if it implements the EGP.
  415. There are two reasons for defining these groups: to provide a means
  416. of assigning object identifiers; and, to provide a method for
  417. implementations of managed agents to know which objects they must
  418. implement.
  419. 6. Definitions
  420. RFC1213-MIB DEFINITIONS ::= BEGIN
  421. IMPORTS
  422. mgmt, NetworkAddress, IpAddress, Counter, Gauge,
  423. TimeTicks
  424. FROM RFC1155-SMI
  425. OBJECT-TYPE
  426. FROM RFC-1212;
  427. -- This MIB module uses the extended OBJECT-TYPE macro as
  428. -- defined in [14];
  429. -- MIB-II (same prefix as MIB-I)
  430. mib-2 OBJECT IDENTIFIER ::= { mgmt 1 }
  431. -- textual conventions
  432. DisplayString ::=
  433. OCTET STRING
  434. -- This data type is used to model textual information taken
  435. -- from the NVT ASCII character set. By convention, objects
  436. -- with this syntax are declared as having
  437. --
  438. -- SIZE (0..255)
  439. PhysAddress ::=
  440. OCTET STRING
  441. -- This data type is used to model media addresses. For many
  442. -- types of media, this will be in a binary representation.
  443. -- For example, an ethernet address would be represented as
  444. -- a string of 6 octets.
  445. -- groups in MIB-II
  446. system OBJECT IDENTIFIER ::= { mib-2 1 }
  447. interfaces OBJECT IDENTIFIER ::= { mib-2 2 }
  448. at OBJECT IDENTIFIER ::= { mib-2 3 }
  449. ip OBJECT IDENTIFIER ::= { mib-2 4 }
  450. icmp OBJECT IDENTIFIER ::= { mib-2 5 }
  451. tcp OBJECT IDENTIFIER ::= { mib-2 6 }
  452. udp OBJECT IDENTIFIER ::= { mib-2 7 }
  453. egp OBJECT IDENTIFIER ::= { mib-2 8 }
  454. -- historical (some say hysterical)
  455. -- cmot OBJECT IDENTIFIER ::= { mib-2 9 }
  456. transmission OBJECT IDENTIFIER ::= { mib-2 10 }
  457. snmp OBJECT IDENTIFIER ::= { mib-2 11 }
  458. -- the System group
  459. -- Implementation of the System group is mandatory for all
  460. -- systems. If an agent is not configured to have a value
  461. -- for any of these variables, a string of length 0 is
  462. -- returned.
  463. sysDescr OBJECT-TYPE
  464. SYNTAX DisplayString (SIZE (0..255))
  465. ACCESS read-only
  466. STATUS mandatory
  467. DESCRIPTION
  468. "A textual description of the entity. This value
  469. should include the full name and version
  470. identification of the system's hardware type,
  471. software operating-system, and networking
  472. software. It is mandatory that this only contain
  473. printable ASCII characters."
  474. ::= { system 1 }
  475. sysObjectID OBJECT-TYPE
  476. SYNTAX OBJECT IDENTIFIER
  477. ACCESS read-only
  478. STATUS mandatory
  479. DESCRIPTION
  480. "The vendor's authoritative identification of the
  481. network management subsystem contained in the
  482. entity. This value is allocated within the SMI
  483. enterprises subtree (1.3.6.1.4.1) and provides an
  484. easy and unambiguous means for determining `what
  485. kind of box' is being managed. For example, if
  486. vendor `Flintstones, Inc.' was assigned the
  487. subtree 1.3.6.1.4.1.4242, it could assign the
  488. identifier 1.3.6.1.4.1.4242.1.1 to its `Fred
  489. Router'."
  490. ::= { system 2 }
  491. sysUpTime OBJECT-TYPE
  492. SYNTAX TimeTicks
  493. ACCESS read-only
  494. STATUS mandatory
  495. DESCRIPTION
  496. "The time (in hundredths of a second) since the
  497. network management portion of the system was last
  498. re-initialized."
  499. ::= { system 3 }
  500. sysContact OBJECT-TYPE
  501. SYNTAX DisplayString (SIZE (0..255))
  502. ACCESS read-write
  503. STATUS mandatory
  504. DESCRIPTION
  505. "The textual identification of the contact person
  506. for this managed node, together with information
  507. on how to contact this person."
  508. ::= { system 4 }
  509. sysName OBJECT-TYPE
  510. SYNTAX DisplayString (SIZE (0..255))
  511. ACCESS read-write
  512. STATUS mandatory
  513. DESCRIPTION
  514. "An administratively-assigned name for this
  515. managed node. By convention, this is the node's
  516. fully-qualified domain name."
  517. ::= { system 5 }
  518. sysLocation OBJECT-TYPE
  519. SYNTAX DisplayString (SIZE (0..255))
  520. ACCESS read-write
  521. STATUS mandatory
  522. DESCRIPTION
  523. "The physical location of this node (e.g.,
  524. `telephone closet, 3rd floor')."
  525. ::= { system 6 }
  526. sysServices OBJECT-TYPE
  527. SYNTAX INTEGER (0..127)
  528. ACCESS read-only
  529. STATUS mandatory
  530. DESCRIPTION
  531. "A value which indicates the set of services that
  532. this entity primarily offers.
  533. The value is a sum. This sum initially takes the
  534. value zero, Then, for each layer, L, in the range
  535. 1 through 7, that this node performs transactions
  536. for, 2 raised to (L - 1) is added to the sum. For
  537. example, a node which performs primarily routing
  538. functions would have a value of 4 (2^(3-1)). In
  539. contrast, a node which is a host offering
  540. application services would have a value of 72
  541. (2^(4-1) + 2^(7-1)). Note that in the context of
  542. the Internet suite of protocols, values should be
  543. calculated accordingly:
  544. layer functionality
  545. 1 physical (e.g., repeaters)
  546. 2 datalink/subnetwork (e.g., bridges)
  547. 3 internet (e.g., IP gateways)
  548. 4 end-to-end (e.g., IP hosts)
  549. 7 applications (e.g., mail relays)
  550. For systems including OSI protocols, layers 5 and
  551. 6 may also be counted."
  552. ::= { system 7 }
  553. -- the Interfaces group
  554. -- Implementation of the Interfaces group is mandatory for
  555. -- all systems.
  556. ifNumber OBJECT-TYPE
  557. SYNTAX INTEGER
  558. ACCESS read-only
  559. STATUS mandatory
  560. DESCRIPTION
  561. "The number of network interfaces (regardless of
  562. their current state) present on this system."
  563. ::= { interfaces 1 }
  564. -- the Interfaces table
  565. -- The Interfaces table contains information on the entity's
  566. -- interfaces. Each interface is thought of as being
  567. -- attached to a `subnetwork'. Note that this term should
  568. -- not be confused with `subnet' which refers to an
  569. -- addressing partitioning scheme used in the Internet suite
  570. -- of protocols.
  571. ifTable OBJECT-TYPE
  572. SYNTAX SEQUENCE OF IfEntry
  573. ACCESS not-accessible
  574. STATUS mandatory
  575. DESCRIPTION
  576. "A list of interface entries. The number of
  577. entries is given by the value of ifNumber."
  578. ::= { interfaces 2 }
  579. ifEntry OBJECT-TYPE
  580. SYNTAX IfEntry
  581. ACCESS not-accessible
  582. STATUS mandatory
  583. DESCRIPTION
  584. "An interface entry containing objects at the
  585. subnetwork layer and below for a particular
  586. interface."
  587. INDEX { ifIndex }
  588. ::= { ifTable 1 }
  589. IfEntry ::=
  590. SEQUENCE {
  591. ifIndex
  592. INTEGER,
  593. ifDescr
  594. DisplayString,
  595. ifType
  596. INTEGER,
  597. ifMtu
  598. INTEGER,
  599. ifSpeed
  600. Gauge,
  601. ifPhysAddress
  602. PhysAddress,
  603. ifAdminStatus
  604. INTEGER,
  605. ifOperStatus
  606. INTEGER,
  607. ifLastChange
  608. TimeTicks,
  609. ifInOctets
  610. Counter,
  611. ifInUcastPkts
  612. Counter,
  613. ifInNUcastPkts
  614. Counter,
  615. ifInDiscards
  616. Counter,
  617. ifInErrors
  618. Counter,
  619. ifInUnknownProtos
  620. Counter,
  621. ifOutOctets
  622. Counter,
  623. ifOutUcastPkts
  624. Counter,
  625. ifOutNUcastPkts
  626. Counter,
  627. ifOutDiscards
  628. Counter,
  629. ifOutErrors
  630. Counter,
  631. ifOutQLen
  632. Gauge,
  633. ifSpecific
  634. OBJECT IDENTIFIER
  635. }
  636. ifIndex OBJECT-TYPE
  637. SYNTAX INTEGER
  638. ACCESS read-only
  639. STATUS mandatory
  640. DESCRIPTION
  641. "A unique value for each interface. Its value
  642. ranges between 1 and the value of ifNumber. The
  643. value for each interface must remain constant at
  644. least from one re-initialization of the entity's
  645. network management system to the next re-
  646. initialization."
  647. ::= { ifEntry 1 }
  648. ifDescr OBJECT-TYPE
  649. SYNTAX DisplayString (SIZE (0..255))
  650. ACCESS read-only
  651. STATUS mandatory
  652. DESCRIPTION
  653. "A textual string containing information about the
  654. interface. This string should include the name of
  655. the manufacturer, the product name and the version
  656. of the hardware interface."
  657. ::= { ifEntry 2 }
  658. ifType OBJECT-TYPE
  659. SYNTAX INTEGER {
  660. other(1), -- none of the following
  661. regular1822(2),
  662. hdh1822(3),
  663. ddn-x25(4),
  664. rfc877-x25(5),
  665. ethernet-csmacd(6),
  666. iso88023-csmacd(7),
  667. iso88024-tokenBus(8),
  668. iso88025-tokenRing(9),
  669. iso88026-man(10),
  670. starLan(11),
  671. proteon-10Mbit(12),
  672. proteon-80Mbit(13),
  673. hyperchannel(14),
  674. fddi(15),
  675. lapb(16),
  676. sdlc(17),
  677. ds1(18), -- T-1
  678. e1(19), -- european equiv. of T-1
  679. basicISDN(20),
  680. primaryISDN(21), -- proprietary serial
  681. propPointToPointSerial(22),
  682. ppp(23),
  683. softwareLoopback(24),
  684. eon(25), -- CLNP over IP [11]
  685. ethernet-3Mbit(26),
  686. nsip(27), -- XNS over IP
  687. slip(28), -- generic SLIP
  688. ultra(29), -- ULTRA technologies
  689. ds3(30), -- T-3
  690. sip(31), -- SMDS
  691. frame-relay(32)
  692. }
  693. ACCESS read-only
  694. STATUS mandatory
  695. DESCRIPTION
  696. "The type of interface, distinguished according to
  697. the physical/link protocol(s) immediately `below'
  698. the network layer in the protocol stack."
  699. ::= { ifEntry 3 }
  700. ifMtu OBJECT-TYPE
  701. SYNTAX INTEGER
  702. ACCESS read-only
  703. STATUS mandatory
  704. DESCRIPTION
  705. "The size of the largest datagram which can be
  706. sent/received on the interface, specified in
  707. octets. For interfaces that are used for
  708. transmitting network datagrams, this is the size
  709. of the largest network datagram that can be sent
  710. on the interface."
  711. ::= { ifEntry 4 }
  712. ifSpeed OBJECT-TYPE
  713. SYNTAX Gauge
  714. ACCESS read-only
  715. STATUS mandatory
  716. DESCRIPTION
  717. "An estimate of the interface's current bandwidth
  718. in bits per second. For interfaces which do not
  719. vary in bandwidth or for those where no accurate
  720. estimation can be made, this object should contain
  721. the nominal bandwidth."
  722. ::= { ifEntry 5 }
  723. ifPhysAddress OBJECT-TYPE
  724. SYNTAX PhysAddress
  725. ACCESS read-only
  726. STATUS mandatory
  727. DESCRIPTION
  728. "The interface's address at the protocol layer
  729. immediately `below' the network layer in the
  730. protocol stack. For interfaces which do not have
  731. such an address (e.g., a serial line), this object
  732. should contain an octet string of zero length."
  733. ::= { ifEntry 6 }
  734. ifAdminStatus OBJECT-TYPE
  735. SYNTAX INTEGER {
  736. up(1), -- ready to pass packets
  737. down(2),
  738. testing(3) -- in some test mode
  739. }
  740. ACCESS read-write
  741. STATUS mandatory
  742. DESCRIPTION
  743. "The desired state of the interface. The
  744. testing(3) state indicates that no operational
  745. packets can be passed."
  746. ::= { ifEntry 7 }
  747. ifOperStatus OBJECT-TYPE
  748. SYNTAX INTEGER {
  749. up(1), -- ready to pass packets
  750. down(2),
  751. testing(3) -- in some test mode
  752. }
  753. ACCESS read-only
  754. STATUS mandatory
  755. DESCRIPTION
  756. "The current operational state of the interface.
  757. The testing(3) state indicates that no operational
  758. packets can be passed."
  759. ::= { ifEntry 8 }
  760. ifLastChange OBJECT-TYPE
  761. SYNTAX TimeTicks
  762. ACCESS read-only
  763. STATUS mandatory
  764. DESCRIPTION
  765. "The value of sysUpTime at the time the interface
  766. entered its current operational state. If the
  767. current state was entered prior to the last re-
  768. initialization of the local network management
  769. subsystem, then this object contains a zero
  770. value."
  771. ::= { ifEntry 9 }
  772. ifInOctets OBJECT-TYPE
  773. SYNTAX Counter
  774. ACCESS read-only
  775. STATUS mandatory
  776. DESCRIPTION
  777. "The total number of octets received on the
  778. interface, including framing characters."
  779. ::= { ifEntry 10 }
  780. ifInUcastPkts OBJECT-TYPE
  781. SYNTAX Counter
  782. ACCESS read-only
  783. STATUS mandatory
  784. DESCRIPTION
  785. "The number of subnetwork-unicast packets
  786. delivered to a higher-layer protocol."
  787. ::= { ifEntry 11 }
  788. ifInNUcastPkts OBJECT-TYPE
  789. SYNTAX Counter
  790. ACCESS read-only
  791. STATUS mandatory
  792. DESCRIPTION
  793. "The number of non-unicast (i.e., subnetwork-
  794. broadcast or subnetwork-multicast) packets
  795. delivered to a higher-layer protocol."
  796. ::= { ifEntry 12 }
  797. ifInDiscards OBJECT-TYPE
  798. SYNTAX Counter
  799. ACCESS read-only
  800. STATUS mandatory
  801. DESCRIPTION
  802. "The number of inbound packets which were chosen
  803. to be discarded even though no errors had been
  804. detected to prevent their being deliverable to a
  805. higher-layer protocol. One possible reason for
  806. discarding such a packet could be to free up
  807. buffer space."
  808. ::= { ifEntry 13 }
  809. ifInErrors OBJECT-TYPE
  810. SYNTAX Counter
  811. ACCESS read-only
  812. STATUS mandatory
  813. DESCRIPTION
  814. "The number of inbound packets that contained
  815. errors preventing them from being deliverable to a
  816. higher-layer protocol."
  817. ::= { ifEntry 14 }
  818. ifInUnknownProtos OBJECT-TYPE
  819. SYNTAX Counter
  820. ACCESS read-only
  821. STATUS mandatory
  822. DESCRIPTION
  823. "The number of packets received via the interface
  824. which were discarded because of an unknown or
  825. unsupported protocol."
  826. ::= { ifEntry 15 }
  827. ifOutOctets OBJECT-TYPE
  828. SYNTAX Counter
  829. ACCESS read-only
  830. STATUS mandatory
  831. DESCRIPTION
  832. "The total number of octets transmitted out of the
  833. interface, including framing characters."
  834. ::= { ifEntry 16 }
  835. ifOutUcastPkts OBJECT-TYPE
  836. SYNTAX Counter
  837. ACCESS read-only
  838. STATUS mandatory
  839. DESCRIPTION
  840. "The total number of packets that higher-level
  841. protocols requested be transmitted to a
  842. subnetwork-unicast address, including those that
  843. were discarded or not sent."
  844. ::= { ifEntry 17 }
  845. ifOutNUcastPkts OBJECT-TYPE
  846. SYNTAX Counter
  847. ACCESS read-only
  848. STATUS mandatory
  849. DESCRIPTION
  850. "The total number of packets that higher-level
  851. protocols requested be transmitted to a non-
  852. unicast (i.e., a subnetwork-broadcast or
  853. subnetwork-multicast) address, including those
  854. that were discarded or not sent."
  855. ::= { ifEntry 18 }
  856. ifOutDiscards OBJECT-TYPE
  857. SYNTAX Counter
  858. ACCESS read-only
  859. STATUS mandatory
  860. DESCRIPTION
  861. "The number of outbound packets which were chosen
  862. to be discarded even though no errors had been
  863. detected to prevent their being transmitted. One
  864. possible reason for discarding such a packet could
  865. be to free up buffer space."
  866. ::= { ifEntry 19 }
  867. ifOutErrors OBJECT-TYPE
  868. SYNTAX Counter
  869. ACCESS read-only
  870. STATUS mandatory
  871. DESCRIPTION
  872. "The number of outbound packets that could not be
  873. transmitted because of errors."
  874. ::= { ifEntry 20 }
  875. ifOutQLen OBJECT-TYPE
  876. SYNTAX Gauge
  877. ACCESS read-only
  878. STATUS mandatory
  879. DESCRIPTION
  880. "The length of the output packet queue (in
  881. packets)."
  882. ::= { ifEntry 21 }
  883. ifSpecific OBJECT-TYPE
  884. SYNTAX OBJECT IDENTIFIER
  885. ACCESS read-only
  886. STATUS mandatory
  887. DESCRIPTION
  888. "A reference to MIB definitions specific to the
  889. particular media being used to realize the
  890. interface. For example, if the interface is
  891. realized by an ethernet, then the value of this
  892. object refers to a document defining objects
  893. specific to ethernet. If this information is not
  894. present, its value should be set to the OBJECT
  895. IDENTIFIER { 0 0 }, which is a syntatically valid
  896. object identifier, and any conformant
  897. implementation of ASN.1 and BER must be able to
  898. generate and recognize this value."
  899. ::= { ifEntry 22 }
  900. -- the Address Translation group
  901. -- Implementation of the Address Translation group is
  902. -- mandatory for all systems. Note however that this group
  903. -- is deprecated by MIB-II. That is, it is being included
  904. -- solely for compatibility with MIB-I nodes, and will most
  905. -- likely be excluded from MIB-III nodes. From MIB-II and
  906. -- onwards, each network protocol group contains its own
  907. -- address translation tables.
  908. -- The Address Translation group contains one table which is
  909. -- the union across all interfaces of the translation tables
  910. -- for converting a NetworkAddress (e.g., an IP address) into
  911. -- a subnetwork-specific address. For lack of a better term,
  912. -- this document refers to such a subnetwork-specific address
  913. -- as a `physical' address.
  914. -- Examples of such translation tables are: for broadcast
  915. -- media where ARP is in use, the translation table is
  916. -- equivalent to the ARP cache; or, on an X.25 network where
  917. -- non-algorithmic translation to X.121 addresses is
  918. -- required, the translation table contains the
  919. -- NetworkAddress to X.121 address equivalences.
  920. atTable OBJECT-TYPE
  921. SYNTAX SEQUENCE OF AtEntry
  922. ACCESS not-accessible
  923. STATUS deprecated
  924. DESCRIPTION
  925. "The Address Translation tables contain the
  926. NetworkAddress to `physical' address equivalences.
  927. Some interfaces do not use translation tables for
  928. determining address equivalences (e.g., DDN-X.25
  929. has an algorithmic method); if all interfaces are
  930. of this type, then the Address Translation table
  931. is empty, i.e., has zero entries."
  932. ::= { at 1 }
  933. atEntry OBJECT-TYPE
  934. SYNTAX AtEntry
  935. ACCESS not-accessible
  936. STATUS deprecated
  937. DESCRIPTION
  938. "Each entry contains one NetworkAddress to
  939. `physical' address equivalence."
  940. INDEX { atIfIndex,
  941. atNetAddress }
  942. ::= { atTable 1 }
  943. AtEntry ::=
  944. SEQUENCE {
  945. atIfIndex
  946. INTEGER,
  947. atPhysAddress
  948. PhysAddress,
  949. atNetAddress
  950. NetworkAddress
  951. }
  952. atIfIndex OBJECT-TYPE
  953. SYNTAX INTEGER
  954. ACCESS read-write
  955. STATUS deprecated
  956. DESCRIPTION
  957. "The interface on which this entry's equivalence
  958. is effective. The interface identified by a
  959. particular value of this index is the same
  960. interface as identified by the same value of
  961. ifIndex."
  962. ::= { atEntry 1 }
  963. atPhysAddress OBJECT-TYPE
  964. SYNTAX PhysAddress
  965. ACCESS read-write
  966. STATUS deprecated
  967. DESCRIPTION
  968. "The media-dependent `physical' address.
  969. Setting this object to a null string (one of zero
  970. length) has the effect of invaliding the
  971. corresponding entry in the atTable object. That
  972. is, it effectively dissasociates the interface
  973. identified with said entry from the mapping
  974. identified with said entry. It is an
  975. implementation-specific matter as to whether the
  976. agent removes an invalidated entry from the table.
  977. Accordingly, management stations must be prepared
  978. to receive tabular information from agents that
  979. corresponds to entries not currently in use.
  980. Proper interpretation of such entries requires
  981. examination of the relevant atPhysAddress object."
  982. ::= { atEntry 2 }
  983. atNetAddress OBJECT-TYPE
  984. SYNTAX NetworkAddress
  985. ACCESS read-write
  986. STATUS deprecated
  987. DESCRIPTION
  988. "The NetworkAddress (e.g., the IP address)
  989. corresponding to the media-dependent `physical'
  990. address."
  991. ::= { atEntry 3 }
  992. -- the IP group
  993. -- Implementation of the IP group is mandatory for all
  994. -- systems.
  995. ipForwarding OBJECT-TYPE
  996. SYNTAX INTEGER {
  997. forwarding(1), -- acting as a gateway
  998. not-forwarding(2) -- NOT acting as a gateway
  999. }
  1000. ACCESS read-write
  1001. STATUS mandatory
  1002. DESCRIPTION
  1003. "The indication of whether this entity is acting
  1004. as an IP gateway in respect to the forwarding of
  1005. datagrams received by, but not addressed to, this
  1006. entity. IP gateways forward datagrams. IP hosts
  1007. do not (except those source-routed via the host).
  1008. Note that for some managed nodes, this object may
  1009. take on only a subset of the values possible.
  1010. Accordingly, it is appropriate for an agent to
  1011. return a `badValue' response if a management
  1012. station attempts to change this object to an
  1013. inappropriate value."
  1014. ::= { ip 1 }
  1015. ipDefaultTTL OBJECT-TYPE
  1016. SYNTAX INTEGER
  1017. ACCESS read-write
  1018. STATUS mandatory
  1019. DESCRIPTION
  1020. "The default value inserted into the Time-To-Live
  1021. field of the IP header of datagrams originated at
  1022. this entity, whenever a TTL value is not supplied
  1023. by the transport layer protocol."
  1024. ::= { ip 2 }
  1025. ipInReceives OBJECT-TYPE
  1026. SYNTAX Counter
  1027. ACCESS read-only
  1028. STATUS mandatory
  1029. DESCRIPTION
  1030. "The total number of input datagrams received from
  1031. interfaces, including those received in error."
  1032. ::= { ip 3 }
  1033. ipInHdrErrors OBJECT-TYPE
  1034. SYNTAX Counter
  1035. ACCESS read-only
  1036. STATUS mandatory
  1037. DESCRIPTION
  1038. "The number of input datagrams discarded due to
  1039. errors in their IP headers, including bad
  1040. checksums, version number mismatch, other format
  1041. errors, time-to-live exceeded, errors discovered
  1042. in processing their IP options, etc."
  1043. ::= { ip 4 }
  1044. ipInAddrErrors OBJECT-TYPE
  1045. SYNTAX Counter
  1046. ACCESS read-only
  1047. STATUS mandatory
  1048. DESCRIPTION
  1049. "The number of input datagrams discarded because
  1050. the IP address in their IP header's destination
  1051. field was not a valid address to be received at
  1052. this entity. This count includes invalid
  1053. addresses (e.g., 0.0.0.0) and addresses of
  1054. unsupported Classes (e.g., Class E). For entities
  1055. which are not IP Gateways and therefore do not
  1056. forward datagrams, this counter includes datagrams
  1057. discarded because the destination address was not
  1058. a local address."
  1059. ::= { ip 5 }
  1060. ipForwDatagrams OBJECT-TYPE
  1061. SYNTAX Counter
  1062. ACCESS read-only
  1063. STATUS mandatory
  1064. DESCRIPTION
  1065. "The number of input datagrams for which this
  1066. entity was not their final IP destination, as a
  1067. result of which an attempt was made to find a
  1068. route to forward them to that final destination.
  1069. In entities which do not act as IP Gateways, this
  1070. counter will include only those packets which were
  1071. Source-Routed via this entity, and the Source-
  1072. Route option processing was successful."
  1073. ::= { ip 6 }
  1074. ipInUnknownProtos OBJECT-TYPE
  1075. SYNTAX Counter
  1076. ACCESS read-only
  1077. STATUS mandatory
  1078. DESCRIPTION
  1079. "The number of locally-addressed datagrams
  1080. received successfully but discarded because of an
  1081. unknown or unsupported protocol."
  1082. ::= { ip 7 }
  1083. ipInDiscards OBJECT-TYPE
  1084. SYNTAX Counter
  1085. ACCESS read-only
  1086. STATUS mandatory
  1087. DESCRIPTION
  1088. "The number of input IP datagrams for which no
  1089. problems were encountered to prevent their
  1090. continued processing, but which were discarded
  1091. (e.g., for lack of buffer space). Note that this
  1092. counter does not include any datagrams discarded
  1093. while awaiting re-assembly."
  1094. ::= { ip 8 }
  1095. ipInDelivers OBJECT-TYPE
  1096. SYNTAX Counter
  1097. ACCESS read-only
  1098. STATUS mandatory
  1099. DESCRIPTION
  1100. "The total number of input datagrams successfully
  1101. delivered to IP user-protocols (including ICMP)."
  1102. ::= { ip 9 }
  1103. ipOutRequests OBJECT-TYPE
  1104. SYNTAX Counter
  1105. ACCESS read-only
  1106. STATUS mandatory
  1107. DESCRIPTION
  1108. "The total number of IP datagrams which local IP
  1109. user-protocols (including ICMP) supplied to IP in
  1110. requests for transmission. Note that this counter
  1111. does not include any datagrams counted in
  1112. ipForwDatagrams."
  1113. ::= { ip 10 }
  1114. ipOutDiscards OBJECT-TYPE
  1115. SYNTAX Counter
  1116. ACCESS read-only
  1117. STATUS mandatory
  1118. DESCRIPTION
  1119. "The number of output IP datagrams for which no
  1120. problem was encountered to prevent their
  1121. transmission to their destination, but which were
  1122. discarded (e.g., for lack of buffer space). Note
  1123. that this counter would include datagrams counted
  1124. in ipForwDatagrams if any such packets met this
  1125. (discretionary) discard criterion."
  1126. ::= { ip 11 }
  1127. ipOutNoRoutes OBJECT-TYPE
  1128. SYNTAX Counter
  1129. ACCESS read-only
  1130. STATUS mandatory
  1131. DESCRIPTION
  1132. "The number of IP datagrams discarded because no
  1133. route could be found to transmit them to their
  1134. destination. Note that this counter includes any
  1135. packets counted in ipForwDatagrams which meet this
  1136. `no-route' criterion. Note that this includes any
  1137. datagarms which a host cannot route because all of
  1138. its default gateways are down."
  1139. ::= { ip 12 }
  1140. ipReasmTimeout OBJECT-TYPE
  1141. SYNTAX INTEGER
  1142. ACCESS read-only
  1143. STATUS mandatory
  1144. DESCRIPTION
  1145. "The maximum number of seconds which received
  1146. fragments are held while they are awaiting
  1147. reassembly at this entity."
  1148. ::= { ip 13 }
  1149. ipReasmReqds OBJECT-TYPE
  1150. SYNTAX Counter
  1151. ACCESS read-only
  1152. STATUS mandatory
  1153. DESCRIPTION
  1154. "The number of IP fragments received which needed
  1155. to be reassembled at this entity."
  1156. ::= { ip 14 }
  1157. ipReasmOKs OBJECT-TYPE
  1158. SYNTAX Counter
  1159. ACCESS read-only
  1160. STATUS mandatory
  1161. DESCRIPTION
  1162. "The number of IP datagrams successfully re-
  1163. assembled."
  1164. ::= { ip 15 }
  1165. ipReasmFails OBJECT-TYPE
  1166. SYNTAX Counter
  1167. ACCESS read-only
  1168. STATUS mandatory
  1169. DESCRIPTION
  1170. "The number of failures detected by the IP re-
  1171. assembly algorithm (for whatever reason: timed
  1172. out, errors, etc). Note that this is not
  1173. necessarily a count of discarded IP fragments
  1174. since some algorithms (notably the algorithm in
  1175. RFC 815) can lose track of the number of fragments
  1176. by combining them as they are received."
  1177. ::= { ip 16 }
  1178. ipFragOKs OBJECT-TYPE
  1179. SYNTAX Counter
  1180. ACCESS read-only
  1181. STATUS mandatory
  1182. DESCRIPTION
  1183. "The number of IP datagrams that have been
  1184. successfully fragmented at this entity."
  1185. ::= { ip 17 }
  1186. ipFragFails OBJECT-TYPE
  1187. SYNTAX Counter
  1188. ACCESS read-only
  1189. STATUS mandatory
  1190. DESCRIPTION
  1191. "The number of IP datagrams that have been
  1192. discarded because they needed to be fragmented at
  1193. this entity but could not be, e.g., because their
  1194. Don't Fragment flag was set."
  1195. ::= { ip 18 }
  1196. ipFragCreates OBJECT-TYPE
  1197. SYNTAX Counter
  1198. ACCESS read-only
  1199. STATUS mandatory
  1200. DESCRIPTION
  1201. "The number of IP datagram fragments that have
  1202. been generated as a result of fragmentation at
  1203. this entity."
  1204. ::= { ip 19 }
  1205. -- the IP address table
  1206. -- The IP address table contains this entity's IP addressing
  1207. -- information.
  1208. ipAddrTable OBJECT-TYPE
  1209. SYNTAX SEQUENCE OF IpAddrEntry
  1210. ACCESS not-accessible
  1211. STATUS mandatory
  1212. DESCRIPTION
  1213. "The table of addressing information relevant to
  1214. this entity's IP addresses."
  1215. ::= { ip 20 }
  1216. ipAddrEntry OBJECT-TYPE
  1217. SYNTAX IpAddrEntry
  1218. ACCESS not-accessible
  1219. STATUS mandatory
  1220. DESCRIPTION
  1221. "The addressing information for one of this
  1222. entity's IP addresses."
  1223. INDEX { ipAdEntAddr }
  1224. ::= { ipAddrTable 1 }
  1225. IpAddrEntry ::=
  1226. SEQUENCE {
  1227. ipAdEntAddr
  1228. IpAddress,
  1229. ipAdEntIfIndex
  1230. INTEGER,
  1231. ipAdEntNetMask
  1232. IpAddress,
  1233. ipAdEntBcastAddr
  1234. INTEGER,
  1235. ipAdEntReasmMaxSize
  1236. INTEGER (0..65535)
  1237. }
  1238. ipAdEntAddr OBJECT-TYPE
  1239. SYNTAX IpAddress
  1240. ACCESS read-only
  1241. STATUS mandatory
  1242. DESCRIPTION
  1243. "The IP address to which this entry's addressing
  1244. information pertains."
  1245. ::= { ipAddrEntry 1 }
  1246. ipAdEntIfIndex OBJECT-TYPE
  1247. SYNTAX INTEGER
  1248. ACCESS read-only
  1249. STATUS mandatory
  1250. DESCRIPTION
  1251. "The index value which uniquely identifies the
  1252. interface to which this entry is applicable. The
  1253. interface identified by a particular value of this
  1254. index is the same interface as identified by the
  1255. same value of ifIndex."
  1256. ::= { ipAddrEntry 2 }
  1257. ipAdEntNetMask OBJECT-TYPE
  1258. SYNTAX IpAddress
  1259. ACCESS read-only
  1260. STATUS mandatory
  1261. DESCRIPTION
  1262. "The subnet mask associated with the IP address of
  1263. this entry. The value of the mask is an IP
  1264. address with all the network bits set to 1 and all
  1265. the hosts bits set to 0."
  1266. ::= { ipAddrEntry 3 }
  1267. ipAdEntBcastAddr OBJECT-TYPE
  1268. SYNTAX INTEGER
  1269. ACCESS read-only
  1270. STATUS mandatory
  1271. DESCRIPTION
  1272. "The value of the least-significant bit in the IP
  1273. broadcast address used for sending datagrams on
  1274. the (logical) interface associated with the IP
  1275. address of this entry. For example, when the
  1276. Internet standard all-ones broadcast address is
  1277. used, the value will be 1. This value applies to
  1278. both the subnet and network broadcasts addresses
  1279. used by the entity on this (logical) interface."
  1280. ::= { ipAddrEntry 4 }
  1281. ipAdEntReasmMaxSize OBJECT-TYPE
  1282. SYNTAX INTEGER (0..65535)
  1283. ACCESS read-only
  1284. STATUS mandatory
  1285. DESCRIPTION
  1286. "The size of the largest IP datagram which this
  1287. entity can re-assemble from incoming IP fragmented
  1288. datagrams received on this interface."
  1289. ::= { ipAddrEntry 5 }
  1290. -- the IP routing table
  1291. -- The IP routing table contains an entry for each route
  1292. -- presently known to this entity.
  1293. ipRouteTable OBJECT-TYPE
  1294. SYNTAX SEQUENCE OF IpRouteEntry
  1295. ACCESS not-accessible
  1296. STATUS mandatory
  1297. DESCRIPTION
  1298. "This entity's IP Routing table."
  1299. ::= { ip 21 }
  1300. ipRouteEntry OBJECT-TYPE
  1301. SYNTAX IpRouteEntry
  1302. ACCESS not-accessible
  1303. STATUS mandatory
  1304. DESCRIPTION
  1305. "A route to a particular destination."
  1306. INDEX { ipRouteDest }
  1307. ::= { ipRouteTable 1 }
  1308. IpRouteEntry ::=
  1309. SEQUENCE {
  1310. ipRouteDest
  1311. IpAddress,
  1312. ipRouteIfIndex
  1313. INTEGER,
  1314. ipRouteMetric1
  1315. INTEGER,
  1316. ipRouteMetric2
  1317. INTEGER,
  1318. ipRouteMetric3
  1319. INTEGER,
  1320. ipRouteMetric4
  1321. INTEGER,
  1322. ipRouteNextHop
  1323. IpAddress,
  1324. ipRouteType
  1325. INTEGER,
  1326. ipRouteProto
  1327. INTEGER,
  1328. ipRouteAge
  1329. INTEGER,
  1330. ipRouteMask
  1331. IpAddress,
  1332. ipRouteMetric5
  1333. INTEGER,
  1334. ipRouteInfo
  1335. OBJECT IDENTIFIER
  1336. }
  1337. ipRouteDest OBJECT-TYPE
  1338. SYNTAX IpAddress
  1339. ACCESS read-write
  1340. STATUS mandatory
  1341. DESCRIPTION
  1342. "The destination IP address of this route. An
  1343. entry with a value of 0.0.0.0 is considered a
  1344. default route. Multiple routes to a single
  1345. destination can appear in the table, but access to
  1346. such multiple entries is dependent on the table-
  1347. access mechanisms defined by the network
  1348. management protocol in use."
  1349. ::= { ipRouteEntry 1 }
  1350. ipRouteIfIndex OBJECT-TYPE
  1351. SYNTAX INTEGER
  1352. ACCESS read-write
  1353. STATUS mandatory
  1354. DESCRIPTION
  1355. "The index value which uniquely identifies the
  1356. local interface through which the next hop of this
  1357. route should be reached. The interface identified
  1358. by a particular value of this index is the same
  1359. interface as identified by the same value of
  1360. ifIndex."
  1361. ::= { ipRouteEntry 2 }
  1362. ipRouteMetric1 OBJECT-TYPE
  1363. SYNTAX INTEGER
  1364. ACCESS read-write
  1365. STATUS mandatory
  1366. DESCRIPTION
  1367. "The primary routing metric for this route. The
  1368. semantics of this metric are determined by the
  1369. routing-protocol specified in the route's
  1370. ipRouteProto value. If this metric is not used,
  1371. its value should be set to -1."
  1372. ::= { ipRouteEntry 3 }
  1373. ipRouteMetric2 OBJECT-TYPE
  1374. SYNTAX INTEGER
  1375. ACCESS read-write
  1376. STATUS mandatory
  1377. DESCRIPTION
  1378. "An alternate routing metric for this route. The
  1379. semantics of this metric are determined by the
  1380. routing-protocol specified in the route's
  1381. ipRouteProto value. If this metric is not used,
  1382. its value should be set to -1."
  1383. ::= { ipRouteEntry 4 }
  1384. ipRouteMetric3 OBJECT-TYPE
  1385. SYNTAX INTEGER
  1386. ACCESS read-write
  1387. STATUS mandatory
  1388. DESCRIPTION
  1389. "An alternate routing metric for this route. The
  1390. semantics of this metric are determined by the
  1391. routing-protocol specified in the route's
  1392. ipRouteProto value. If this metric is not used,
  1393. its value should be set to -1."
  1394. ::= { ipRouteEntry 5 }
  1395. ipRouteMetric4 OBJECT-TYPE
  1396. SYNTAX INTEGER
  1397. ACCESS read-write
  1398. STATUS mandatory
  1399. DESCRIPTION
  1400. "An alternate routing metric for this route. The
  1401. semantics of this metric are determined by the
  1402. routing-protocol specified in the route's
  1403. ipRouteProto value. If this metric is not used,
  1404. its value should be set to -1."
  1405. ::= { ipRouteEntry 6 }
  1406. ipRouteNextHop OBJECT-TYPE
  1407. SYNTAX IpAddress
  1408. ACCESS read-write
  1409. STATUS mandatory
  1410. DESCRIPTION
  1411. "The IP address of the next hop of this route.
  1412. (In the case of a route bound to an interface
  1413. which is realized via a broadcast media, the value
  1414. of this field is the agent's IP address on that
  1415. interface.)"
  1416. ::= { ipRouteEntry 7 }
  1417. ipRouteType OBJECT-TYPE
  1418. SYNTAX INTEGER {
  1419. other(1), -- none of the following
  1420. invalid(2), -- an invalidated route
  1421. -- route to directly
  1422. direct(3), -- connected (sub-)network
  1423. -- route to a non-local
  1424. indirect(4) -- host/network/sub-network
  1425. }
  1426. ACCESS read-write
  1427. STATUS mandatory
  1428. DESCRIPTION
  1429. "The type of route. Note that the values
  1430. direct(3) and indirect(4) refer to the notion of
  1431. direct and indirect routing in the IP
  1432. architecture.
  1433. Setting this object to the value invalid(2) has
  1434. the effect of invalidating the corresponding entry
  1435. in the ipRouteTable object. That is, it
  1436. effectively dissasociates the destination
  1437. identified with said entry from the route
  1438. identified with said entry. It is an
  1439. implementation-specific matter as to whether the
  1440. agent removes an invalidated entry from the table.
  1441. Accordingly, management stations must be prepared
  1442. to receive tabular information from agents that
  1443. corresponds to entries not currently in use.
  1444. Proper interpretation of such entries requires
  1445. examination of the relevant ipRouteType object."
  1446. ::= { ipRouteEntry 8 }
  1447. ipRouteProto OBJECT-TYPE
  1448. SYNTAX INTEGER {
  1449. other(1), -- none of the following
  1450. -- non-protocol information,
  1451. -- e.g., manually configured
  1452. local(2), -- entries
  1453. -- set via a network
  1454. netmgmt(3), -- management protocol
  1455. -- obtained via ICMP,
  1456. icmp(4), -- e.g., Redirect
  1457. -- the remaining values are
  1458. -- all gateway routing
  1459. -- protocols
  1460. egp(5),
  1461. ggp(6),
  1462. hello(7),
  1463. rip(8),
  1464. is-is(9),
  1465. es-is(10),
  1466. ciscoIgrp(11),
  1467. bbnSpfIgp(12),
  1468. ospf(13),
  1469. bgp(14)
  1470. }
  1471. ACCESS read-only
  1472. STATUS mandatory
  1473. DESCRIPTION
  1474. "The routing mechanism via which this route was
  1475. learned. Inclusion of values for gateway routing
  1476. protocols is not intended to imply that hosts
  1477. should support those protocols."
  1478. ::= { ipRouteEntry 9 }
  1479. ipRouteAge OBJECT-TYPE
  1480. SYNTAX INTEGER
  1481. ACCESS read-write
  1482. STATUS mandatory
  1483. DESCRIPTION
  1484. "The number of seconds since this route was last
  1485. updated or otherwise determined to be correct.
  1486. Note that no semantics of `too old' can be implied
  1487. except through knowledge of the routing protocol
  1488. by which the route was learned."
  1489. ::= { ipRouteEntry 10 }
  1490. ipRouteMask OBJECT-TYPE
  1491. SYNTAX IpAddress
  1492. ACCESS read-write
  1493. STATUS mandatory
  1494. DESCRIPTION
  1495. "Indicate the mask to be logical-ANDed with the
  1496. destination address before being compared to the
  1497. value in the ipRouteDest field. For those systems
  1498. that do not support arbitrary subnet masks, an
  1499. agent constructs the value of the ipRouteMask by
  1500. determining whether the value of the correspondent
  1501. ipRouteDest field belong to a class-A, B, or C
  1502. network, and then using one of:
  1503. mask network
  1504. 255.0.0.0 class-A
  1505. 255.255.0.0 class-B
  1506. 255.255.255.0 class-C
  1507. If the value of the ipRouteDest is 0.0.0.0 (a
  1508. default route), then the mask value is also
  1509. 0.0.0.0. It should be noted that all IP routing
  1510. subsystems implicitly use this mechanism."
  1511. ::= { ipRouteEntry 11 }
  1512. ipRouteMetric5 OBJECT-TYPE
  1513. SYNTAX INTEGER
  1514. ACCESS read-write
  1515. STATUS mandatory
  1516. DESCRIPTION
  1517. "An alternate routing metric for this route. The
  1518. semantics of this metric are determined by the
  1519. routing-protocol specified in the route's
  1520. ipRouteProto value. If this metric is not used,
  1521. its value should be set to -1."
  1522. ::= { ipRouteEntry 12 }
  1523. ipRouteInfo OBJECT-TYPE
  1524. SYNTAX OBJECT IDENTIFIER
  1525. ACCESS read-only
  1526. STATUS mandatory
  1527. DESCRIPTION
  1528. "A reference to MIB definitions specific to the
  1529. particular routing protocol which is responsible
  1530. for this route, as determined by the value
  1531. specified in the route's ipRouteProto value. If
  1532. this information is not present, its value should
  1533. be set to the OBJECT IDENTIFIER { 0 0 }, which is
  1534. a syntatically valid object identifier, and any
  1535. conformant implementation of ASN.1 and BER must be
  1536. able to generate and recognize this value."
  1537. ::= { ipRouteEntry 13 }
  1538. -- the IP Address Translation table
  1539. -- The IP address translation table contain the IpAddress to
  1540. -- `physical' address equivalences. Some interfaces do not
  1541. -- use translation tables for determining address
  1542. -- equivalences (e.g., DDN-X.25 has an algorithmic method);
  1543. -- if all interfaces are of this type, then the Address
  1544. -- Translation table is empty, i.e., has zero entries.
  1545. ipNetToMediaTable OBJECT-TYPE
  1546. SYNTAX SEQUENCE OF IpNetToMediaEntry
  1547. ACCESS not-accessible
  1548. STATUS mandatory
  1549. DESCRIPTION
  1550. "The IP Address Translation table used for mapping
  1551. from IP addresses to physical addresses."
  1552. ::= { ip 22 }
  1553. ipNetToMediaEntry OBJECT-TYPE
  1554. SYNTAX IpNetToMediaEntry
  1555. ACCESS not-accessible
  1556. STATUS mandatory
  1557. DESCRIPTION
  1558. "Each entry contains one IpAddress to `physical'
  1559. address equivalence."
  1560. INDEX { ipNetToMediaIfIndex,
  1561. ipNetToMediaNetAddress }
  1562. ::= { ipNetToMediaTable 1 }
  1563. IpNetToMediaEntry ::=
  1564. SEQUENCE {
  1565. ipNetToMediaIfIndex
  1566. INTEGER,
  1567. ipNetToMediaPhysAddress
  1568. PhysAddress,
  1569. ipNetToMediaNetAddress
  1570. IpAddress,
  1571. ipNetToMediaType
  1572. INTEGER
  1573. }
  1574. ipNetToMediaIfIndex OBJECT-TYPE
  1575. SYNTAX INTEGER
  1576. ACCESS read-write
  1577. STATUS mandatory
  1578. DESCRIPTION
  1579. "The interface on which this entry's equivalence
  1580. is effective. The interface identified by a
  1581. particular value of this index is the same
  1582. interface as identified by the same value of
  1583. ifIndex."
  1584. ::= { ipNetToMediaEntry 1 }
  1585. ipNetToMediaPhysAddress OBJECT-TYPE
  1586. SYNTAX PhysAddress
  1587. ACCESS read-write
  1588. STATUS mandatory
  1589. DESCRIPTION
  1590. "The media-dependent `physical' address."
  1591. ::= { ipNetToMediaEntry 2 }
  1592. ipNetToMediaNetAddress OBJECT-TYPE
  1593. SYNTAX IpAddress
  1594. ACCESS read-write
  1595. STATUS mandatory
  1596. DESCRIPTION
  1597. "The IpAddress corresponding to the media-
  1598. dependent `physical' address."
  1599. ::= { ipNetToMediaEntry 3 }
  1600. ipNetToMediaType OBJECT-TYPE
  1601. SYNTAX INTEGER {
  1602. other(1), -- none of the following
  1603. invalid(2), -- an invalidated mapping
  1604. dynamic(3),
  1605. static(4)
  1606. }
  1607. ACCESS read-write
  1608. STATUS mandatory
  1609. DESCRIPTION
  1610. "The type of mapping.
  1611. Setting this object to the value invalid(2) has
  1612. the effect of invalidating the corresponding entry
  1613. in the ipNetToMediaTable. That is, it effectively
  1614. dissasociates the interface identified with said
  1615. entry from the mapping identified with said entry.
  1616. It is an implementation-specific matter as to
  1617. whether the agent removes an invalidated entry
  1618. from the table. Accordingly, management stations
  1619. must be prepared to receive tabular information
  1620. from agents that corresponds to entries not
  1621. currently in use. Proper interpretation of such
  1622. entries requires examination of the relevant
  1623. ipNetToMediaType object."
  1624. ::= { ipNetToMediaEntry 4 }
  1625. -- additional IP objects
  1626. ipRoutingDiscards OBJECT-TYPE
  1627. SYNTAX Counter
  1628. ACCESS read-only
  1629. STATUS mandatory
  1630. DESCRIPTION
  1631. "The number of routing entries which were chosen
  1632. to be discarded even though they are valid. One
  1633. possible reason for discarding such an entry could
  1634. be to free-up buffer space for other routing
  1635. entries."
  1636. ::= { ip 23 }
  1637. -- the ICMP group
  1638. -- Implementation of the ICMP group is mandatory for all
  1639. -- systems.
  1640. icmpInMsgs OBJECT-TYPE
  1641. SYNTAX Counter
  1642. ACCESS read-only
  1643. STATUS mandatory
  1644. DESCRIPTION
  1645. "The total number of ICMP messages which the
  1646. entity received. Note that this counter includes
  1647. all those counted by icmpInErrors."
  1648. ::= { icmp 1 }
  1649. icmpInErrors OBJECT-TYPE
  1650. SYNTAX Counter
  1651. ACCESS read-only
  1652. STATUS mandatory
  1653. DESCRIPTION
  1654. "The number of ICMP messages which the entity
  1655. received but determined as having ICMP-specific
  1656. errors (bad ICMP checksums, bad length, etc.)."
  1657. ::= { icmp 2 }
  1658. icmpInDestUnreachs OBJECT-TYPE
  1659. SYNTAX Counter
  1660. ACCESS read-only
  1661. STATUS mandatory
  1662. DESCRIPTION
  1663. "The number of ICMP Destination Unreachable
  1664. messages received."
  1665. ::= { icmp 3 }
  1666. icmpInTimeExcds OBJECT-TYPE
  1667. SYNTAX Counter
  1668. ACCESS read-only
  1669. STATUS mandatory
  1670. DESCRIPTION
  1671. "The number of ICMP Time Exceeded messages
  1672. received."
  1673. ::= { icmp 4 }
  1674. icmpInParmProbs OBJECT-TYPE
  1675. SYNTAX Counter
  1676. ACCESS read-only
  1677. STATUS mandatory
  1678. DESCRIPTION
  1679. "The number of ICMP Parameter Problem messages
  1680. received."
  1681. ::= { icmp 5 }
  1682. icmpInSrcQuenchs OBJECT-TYPE
  1683. SYNTAX Counter
  1684. ACCESS read-only
  1685. STATUS mandatory
  1686. DESCRIPTION
  1687. "The number of ICMP Source Quench messages
  1688. received."
  1689. ::= { icmp 6 }
  1690. icmpInRedirects OBJECT-TYPE
  1691. SYNTAX Counter
  1692. ACCESS read-only
  1693. STATUS mandatory
  1694. DESCRIPTION
  1695. "The number of ICMP Redirect messages received."
  1696. ::= { icmp 7 }
  1697. icmpInEchos OBJECT-TYPE
  1698. SYNTAX Counter
  1699. ACCESS read-only
  1700. STATUS mandatory
  1701. DESCRIPTION
  1702. "The number of ICMP Echo (request) messages
  1703. received."
  1704. ::= { icmp 8 }
  1705. icmpInEchoReps OBJECT-TYPE
  1706. SYNTAX Counter
  1707. ACCESS read-only
  1708. STATUS mandatory
  1709. DESCRIPTION
  1710. "The number of ICMP Echo Reply messages received."
  1711. ::= { icmp 9 }
  1712. icmpInTimestamps OBJECT-TYPE
  1713. SYNTAX Counter
  1714. ACCESS read-only
  1715. STATUS mandatory
  1716. DESCRIPTION
  1717. "The number of ICMP Timestamp (request) messages
  1718. received."
  1719. ::= { icmp 10 }
  1720. icmpInTimestampReps OBJECT-TYPE
  1721. SYNTAX Counter
  1722. ACCESS read-only
  1723. STATUS mandatory
  1724. DESCRIPTION
  1725. "The number of ICMP Timestamp Reply messages
  1726. received."
  1727. ::= { icmp 11 }
  1728. icmpInAddrMasks OBJECT-TYPE
  1729. SYNTAX Counter
  1730. ACCESS read-only
  1731. STATUS mandatory
  1732. DESCRIPTION
  1733. "The number of ICMP Address Mask Request messages
  1734. received."
  1735. ::= { icmp 12 }
  1736. icmpInAddrMaskReps OBJECT-TYPE
  1737. SYNTAX Counter
  1738. ACCESS read-only
  1739. STATUS mandatory
  1740. DESCRIPTION
  1741. "The number of ICMP Address Mask Reply messages
  1742. received."
  1743. ::= { icmp 13 }
  1744. icmpOutMsgs OBJECT-TYPE
  1745. SYNTAX Counter
  1746. ACCESS read-only
  1747. STATUS mandatory
  1748. DESCRIPTION
  1749. "The total number of ICMP messages which this
  1750. entity attempted to send. Note that this counter
  1751. includes all those counted by icmpOutErrors."
  1752. ::= { icmp 14 }
  1753. icmpOutErrors OBJECT-TYPE
  1754. SYNTAX Counter
  1755. ACCESS read-only
  1756. STATUS mandatory
  1757. DESCRIPTION
  1758. "The number of ICMP messages which this entity did
  1759. not send due to problems discovered within ICMP
  1760. such as a lack of buffers. This value should not
  1761. include errors discovered outside the ICMP layer
  1762. such as the inability of IP to route the resultant
  1763. datagram. In some implementations there may be no
  1764. types of error which contribute to this counter's
  1765. value."
  1766. ::= { icmp 15 }
  1767. icmpOutDestUnreachs OBJECT-TYPE
  1768. SYNTAX Counter
  1769. ACCESS read-only
  1770. STATUS mandatory
  1771. DESCRIPTION
  1772. "The number of ICMP Destination Unreachable
  1773. messages sent."
  1774. ::= { icmp 16 }
  1775. icmpOutTimeExcds OBJECT-TYPE
  1776. SYNTAX Counter
  1777. ACCESS read-only
  1778. STATUS mandatory
  1779. DESCRIPTION
  1780. "The number of ICMP Time Exceeded messages sent."
  1781. ::= { icmp 17 }
  1782. icmpOutParmProbs OBJECT-TYPE
  1783. SYNTAX Counter
  1784. ACCESS read-only
  1785. STATUS mandatory
  1786. DESCRIPTION
  1787. "The number of ICMP Parameter Problem messages
  1788. sent."
  1789. ::= { icmp 18 }
  1790. icmpOutSrcQuenchs OBJECT-TYPE
  1791. SYNTAX Counter
  1792. ACCESS read-only
  1793. STATUS mandatory
  1794. DESCRIPTION
  1795. "The number of ICMP Source Quench messages sent."
  1796. ::= { icmp 19 }
  1797. icmpOutRedirects OBJECT-TYPE
  1798. SYNTAX Counter
  1799. ACCESS read-only
  1800. STATUS mandatory
  1801. DESCRIPTION
  1802. "The number of ICMP Redirect messages sent. For a
  1803. host, this object will always be zero, since hosts
  1804. do not send redirects."
  1805. ::= { icmp 20 }
  1806. icmpOutEchos OBJECT-TYPE
  1807. SYNTAX Counter
  1808. ACCESS read-only
  1809. STATUS mandatory
  1810. DESCRIPTION
  1811. "The number of ICMP Echo (request) messages sent."
  1812. ::= { icmp 21 }
  1813. icmpOutEchoReps OBJECT-TYPE
  1814. SYNTAX Counter
  1815. ACCESS read-only
  1816. STATUS mandatory
  1817. DESCRIPTION
  1818. "The number of ICMP Echo Reply messages sent."
  1819. ::= { icmp 22 }
  1820. icmpOutTimestamps OBJECT-TYPE
  1821. SYNTAX Counter
  1822. ACCESS read-only
  1823. STATUS mandatory
  1824. DESCRIPTION
  1825. "The number of ICMP Timestamp (request) messages
  1826. sent."
  1827. ::= { icmp 23 }
  1828. icmpOutTimestampReps OBJECT-TYPE
  1829. SYNTAX Counter
  1830. ACCESS read-only
  1831. STATUS mandatory
  1832. DESCRIPTION
  1833. "The number of ICMP Timestamp Reply messages
  1834. sent."
  1835. ::= { icmp 24 }
  1836. icmpOutAddrMasks OBJECT-TYPE
  1837. SYNTAX Counter
  1838. ACCESS read-only
  1839. STATUS mandatory
  1840. DESCRIPTION
  1841. "The number of ICMP Address Mask Request messages
  1842. sent."
  1843. ::= { icmp 25 }
  1844. icmpOutAddrMaskReps OBJECT-TYPE
  1845. SYNTAX Counter
  1846. ACCESS read-only
  1847. STATUS mandatory
  1848. DESCRIPTION
  1849. "The number of ICMP Address Mask Reply messages
  1850. sent."
  1851. ::= { icmp 26 }
  1852. -- the TCP group
  1853. -- Implementation of the TCP group is mandatory for all
  1854. -- systems that implement the TCP.
  1855. -- Note that instances of object types that represent
  1856. -- information about a particular TCP connection are
  1857. -- transient; they persist only as long as the connection
  1858. -- in question.
  1859. tcpRtoAlgorithm OBJECT-TYPE
  1860. SYNTAX INTEGER {
  1861. other(1), -- none of the following
  1862. constant(2), -- a constant rto
  1863. rsre(3), -- MIL-STD-1778, Appendix B
  1864. vanj(4) -- Van Jacobson's algorithm [10]
  1865. }
  1866. ACCESS read-only
  1867. STATUS mandatory
  1868. DESCRIPTION
  1869. "The algorithm used to determine the timeout value
  1870. used for retransmitting unacknowledged octets."
  1871. ::= { tcp 1 }
  1872. tcpRtoMin OBJECT-TYPE
  1873. SYNTAX INTEGER
  1874. ACCESS read-only
  1875. STATUS mandatory
  1876. DESCRIPTION
  1877. "The minimum value permitted by a TCP
  1878. implementation for the retransmission timeout,
  1879. measured in milliseconds. More refined semantics
  1880. for objects of this type depend upon the algorithm
  1881. used to determine the retransmission timeout. In
  1882. particular, when the timeout algorithm is rsre(3),
  1883. an object of this type has the semantics of the
  1884. LBOUND quantity described in RFC 793."
  1885. ::= { tcp 2 }
  1886. tcpRtoMax OBJECT-TYPE
  1887. SYNTAX INTEGER
  1888. ACCESS read-only
  1889. STATUS mandatory
  1890. DESCRIPTION
  1891. "The maximum value permitted by a TCP
  1892. implementation for the retransmission timeout,
  1893. measured in milliseconds. More refined semantics
  1894. for objects of this type depend upon the algorithm
  1895. used to determine the retransmission timeout. In
  1896. particular, when the timeout algorithm is rsre(3),
  1897. an object of this type has the semantics of the
  1898. UBOUND quantity described in RFC 793."
  1899. ::= { tcp 3 }
  1900. tcpMaxConn OBJECT-TYPE
  1901. SYNTAX INTEGER
  1902. ACCESS read-only
  1903. STATUS mandatory
  1904. DESCRIPTION
  1905. "The limit on the total number of TCP connections
  1906. the entity can support. In entities where the
  1907. maximum number of connections is dynamic, this
  1908. object should contain the value -1."
  1909. ::= { tcp 4 }
  1910. tcpActiveOpens OBJECT-TYPE
  1911. SYNTAX Counter
  1912. ACCESS read-only
  1913. STATUS mandatory
  1914. DESCRIPTION
  1915. "The number of times TCP connections have made a
  1916. direct transition to the SYN-SENT state from the
  1917. CLOSED state."
  1918. ::= { tcp 5 }
  1919. tcpPassiveOpens OBJECT-TYPE
  1920. SYNTAX Counter
  1921. ACCESS read-only
  1922. STATUS mandatory
  1923. DESCRIPTION
  1924. "The number of times TCP connections have made a
  1925. direct transition to the SYN-RCVD state from the
  1926. LISTEN state."
  1927. ::= { tcp 6 }
  1928. tcpAttemptFails OBJECT-TYPE
  1929. SYNTAX Counter
  1930. ACCESS read-only
  1931. STATUS mandatory
  1932. DESCRIPTION
  1933. "The number of times TCP connections have made a
  1934. direct transition to the CLOSED state from either
  1935. the SYN-SENT state or the SYN-RCVD state, plus the
  1936. number of times TCP connections have made a direct
  1937. transition to the LISTEN state from the SYN-RCVD
  1938. state."
  1939. ::= { tcp 7 }
  1940. tcpEstabResets OBJECT-TYPE
  1941. SYNTAX Counter
  1942. ACCESS read-only
  1943. STATUS mandatory
  1944. DESCRIPTION
  1945. "The number of times TCP connections have made a
  1946. direct transition to the CLOSED state from either
  1947. the ESTABLISHED state or the CLOSE-WAIT state."
  1948. ::= { tcp 8 }
  1949. tcpCurrEstab OBJECT-TYPE
  1950. SYNTAX Gauge
  1951. ACCESS read-only
  1952. STATUS mandatory
  1953. DESCRIPTION
  1954. "The number of TCP connections for which the
  1955. current state is either ESTABLISHED or CLOSE-
  1956. WAIT."
  1957. ::= { tcp 9 }
  1958. tcpInSegs OBJECT-TYPE
  1959. SYNTAX Counter
  1960. ACCESS read-only
  1961. STATUS mandatory
  1962. DESCRIPTION
  1963. "The total number of segments received, including
  1964. those received in error. This count includes
  1965. segments received on currently established
  1966. connections."
  1967. ::= { tcp 10 }
  1968. tcpOutSegs OBJECT-TYPE
  1969. SYNTAX Counter
  1970. ACCESS read-only
  1971. STATUS mandatory
  1972. DESCRIPTION
  1973. "The total number of segments sent, including
  1974. those on current connections but excluding those
  1975. containing only retransmitted octets."
  1976. ::= { tcp 11 }
  1977. tcpRetransSegs OBJECT-TYPE
  1978. SYNTAX Counter
  1979. ACCESS read-only
  1980. STATUS mandatory
  1981. DESCRIPTION
  1982. "The total number of segments retransmitted - that
  1983. is, the number of TCP segments transmitted
  1984. containing one or more previously transmitted
  1985. octets."
  1986. ::= { tcp 12 }
  1987. -- the TCP Connection table
  1988. -- The TCP connection table contains information about this
  1989. -- entity's existing TCP connections.
  1990. tcpConnTable OBJECT-TYPE
  1991. SYNTAX SEQUENCE OF TcpConnEntry
  1992. ACCESS not-accessible
  1993. STATUS mandatory
  1994. DESCRIPTION
  1995. "A table containing TCP connection-specific
  1996. information."
  1997. ::= { tcp 13 }
  1998. tcpConnEntry OBJECT-TYPE
  1999. SYNTAX TcpConnEntry
  2000. ACCESS not-accessible
  2001. STATUS mandatory
  2002. DESCRIPTION
  2003. "Information about a particular current TCP
  2004. connection. An object of this type is transient,
  2005. in that it ceases to exist when (or soon after)
  2006. the connection makes the transition to the CLOSED
  2007. state."
  2008. INDEX { tcpConnLocalAddress,
  2009. tcpConnLocalPort,
  2010. tcpConnRemAddress,
  2011. tcpConnRemPort }
  2012. ::= { tcpConnTable 1 }
  2013. TcpConnEntry ::=
  2014. SEQUENCE {
  2015. tcpConnState
  2016. INTEGER,
  2017. tcpConnLocalAddress
  2018. IpAddress,
  2019. tcpConnLocalPort
  2020. INTEGER (0..65535),
  2021. tcpConnRemAddress
  2022. IpAddress,
  2023. tcpConnRemPort
  2024. INTEGER (0..65535)
  2025. }
  2026. tcpConnState OBJECT-TYPE
  2027. SYNTAX INTEGER {
  2028. closed(1),
  2029. listen(2),
  2030. synSent(3),
  2031. synReceived(4),
  2032. established(5),
  2033. finWait1(6),
  2034. finWait2(7),
  2035. closeWait(8),
  2036. lastAck(9),
  2037. closing(10),
  2038. timeWait(11),
  2039. deleteTCB(12)
  2040. }
  2041. ACCESS read-write
  2042. STATUS mandatory
  2043. DESCRIPTION
  2044. "The state of this TCP connection.
  2045. The only value which may be set by a management
  2046. station is deleteTCB(12). Accordingly, it is
  2047. appropriate for an agent to return a `badValue'
  2048. response if a management station attempts to set
  2049. this object to any other value.
  2050. If a management station sets this object to the
  2051. value deleteTCB(12), then this has the effect of
  2052. deleting the TCB (as defined in RFC 793) of the
  2053. corresponding connection on the managed node,
  2054. resulting in immediate termination of the
  2055. connection.
  2056. As an implementation-specific option, a RST
  2057. segment may be sent from the managed node to the
  2058. other TCP endpoint (note however that RST segments
  2059. are not sent reliably)."
  2060. ::= { tcpConnEntry 1 }
  2061. tcpConnLocalAddress OBJECT-TYPE
  2062. SYNTAX IpAddress
  2063. ACCESS read-only
  2064. STATUS mandatory
  2065. DESCRIPTION
  2066. "The local IP address for this TCP connection. In
  2067. the case of a connection in the listen state which
  2068. is willing to accept connections for any IP
  2069. interface associated with the node, the value
  2070. 0.0.0.0 is used."
  2071. ::= { tcpConnEntry 2 }
  2072. tcpConnLocalPort OBJECT-TYPE
  2073. SYNTAX INTEGER (0..65535)
  2074. ACCESS read-only
  2075. STATUS mandatory
  2076. DESCRIPTION
  2077. "The local port number for this TCP connection."
  2078. ::= { tcpConnEntry 3 }
  2079. tcpConnRemAddress OBJECT-TYPE
  2080. SYNTAX IpAddress
  2081. ACCESS read-only
  2082. STATUS mandatory
  2083. DESCRIPTION
  2084. "The remote IP address for this TCP connection."
  2085. ::= { tcpConnEntry 4 }
  2086. tcpConnRemPort OBJECT-TYPE
  2087. SYNTAX INTEGER (0..65535)
  2088. ACCESS read-only
  2089. STATUS mandatory
  2090. DESCRIPTION
  2091. "The remote port number for this TCP connection."
  2092. ::= { tcpConnEntry 5 }
  2093. -- additional TCP objects
  2094. tcpInErrs OBJECT-TYPE
  2095. SYNTAX Counter
  2096. ACCESS read-only
  2097. STATUS mandatory
  2098. DESCRIPTION
  2099. "The total number of segments received in error
  2100. (e.g., bad TCP checksums)."
  2101. ::= { tcp 14 }
  2102. tcpOutRsts OBJECT-TYPE
  2103. SYNTAX Counter
  2104. ACCESS read-only
  2105. STATUS mandatory
  2106. DESCRIPTION
  2107. "The number of TCP segments sent containing the
  2108. RST flag."
  2109. ::= { tcp 15 }
  2110. -- the UDP group
  2111. -- Implementation of the UDP group is mandatory for all
  2112. -- systems which implement the UDP.
  2113. udpInDatagrams OBJECT-TYPE
  2114. SYNTAX Counter
  2115. ACCESS read-only
  2116. STATUS mandatory
  2117. DESCRIPTION
  2118. "The total number of UDP datagrams delivered to
  2119. UDP users."
  2120. ::= { udp 1 }
  2121. udpNoPorts OBJECT-TYPE
  2122. SYNTAX Counter
  2123. ACCESS read-only
  2124. STATUS mandatory
  2125. DESCRIPTION
  2126. "The total number of received UDP datagrams for
  2127. which there was no application at the destination
  2128. port."
  2129. ::= { udp 2 }
  2130. udpInErrors OBJECT-TYPE
  2131. SYNTAX Counter
  2132. ACCESS read-only
  2133. STATUS mandatory
  2134. DESCRIPTION
  2135. "The number of received UDP datagrams that could
  2136. not be delivered for reasons other than the lack
  2137. of an application at the destination port."
  2138. ::= { udp 3 }
  2139. udpOutDatagrams OBJECT-TYPE
  2140. SYNTAX Counter
  2141. ACCESS read-only
  2142. STATUS mandatory
  2143. DESCRIPTION
  2144. "The total number of UDP datagrams sent from this
  2145. entity."
  2146. ::= { udp 4 }
  2147. -- the UDP Listener table
  2148. -- The UDP listener table contains information about this
  2149. -- entity's UDP end-points on which a local application is
  2150. -- currently accepting datagrams.
  2151. udpTable OBJECT-TYPE
  2152. SYNTAX SEQUENCE OF UdpEntry
  2153. ACCESS not-accessible
  2154. STATUS mandatory
  2155. DESCRIPTION
  2156. "A table containing UDP listener information."
  2157. ::= { udp 5 }
  2158. udpEntry OBJECT-TYPE
  2159. SYNTAX UdpEntry
  2160. ACCESS not-accessible
  2161. STATUS mandatory
  2162. DESCRIPTION
  2163. "Information about a particular current UDP
  2164. listener."
  2165. INDEX { udpLocalAddress, udpLocalPort }
  2166. ::= { udpTable 1 }
  2167. UdpEntry ::=
  2168. SEQUENCE {
  2169. udpLocalAddress
  2170. IpAddress,
  2171. udpLocalPort
  2172. INTEGER (0..65535)
  2173. }
  2174. udpLocalAddress OBJECT-TYPE
  2175. SYNTAX IpAddress
  2176. ACCESS read-only
  2177. STATUS mandatory
  2178. DESCRIPTION
  2179. "The local IP address for this UDP listener. In
  2180. the case of a UDP listener which is willing to
  2181. accept datagrams for any IP interface associated
  2182. with the node, the value 0.0.0.0 is used."
  2183. ::= { udpEntry 1 }
  2184. udpLocalPort OBJECT-TYPE
  2185. SYNTAX INTEGER (0..65535)
  2186. ACCESS read-only
  2187. STATUS mandatory
  2188. DESCRIPTION
  2189. "The local port number for this UDP listener."
  2190. ::= { udpEntry 2 }
  2191. -- the EGP group
  2192. -- Implementation of the EGP group is mandatory for all
  2193. -- systems which implement the EGP.
  2194. egpInMsgs OBJECT-TYPE
  2195. SYNTAX Counter
  2196. ACCESS read-only
  2197. STATUS mandatory
  2198. DESCRIPTION
  2199. "The number of EGP messages received without
  2200. error."
  2201. ::= { egp 1 }
  2202. egpInErrors OBJECT-TYPE
  2203. SYNTAX Counter
  2204. ACCESS read-only
  2205. STATUS mandatory
  2206. DESCRIPTION
  2207. "The number of EGP messages received that proved
  2208. to be in error."
  2209. ::= { egp 2 }
  2210. egpOutMsgs OBJECT-TYPE
  2211. SYNTAX Counter
  2212. ACCESS read-only
  2213. STATUS mandatory
  2214. DESCRIPTION
  2215. "The total number of locally generated EGP
  2216. messages."
  2217. ::= { egp 3 }
  2218. egpOutErrors OBJECT-TYPE
  2219. SYNTAX Counter
  2220. ACCESS read-only
  2221. STATUS mandatory
  2222. DESCRIPTION
  2223. "The number of locally generated EGP messages not
  2224. sent due to resource limitations within an EGP
  2225. entity."
  2226. ::= { egp 4 }
  2227. -- the EGP Neighbor table
  2228. -- The EGP neighbor table contains information about this
  2229. -- entity's EGP neighbors.
  2230. egpNeighTable OBJECT-TYPE
  2231. SYNTAX SEQUENCE OF EgpNeighEntry
  2232. ACCESS not-accessible
  2233. STATUS mandatory
  2234. DESCRIPTION
  2235. "The EGP neighbor table."
  2236. ::= { egp 5 }
  2237. egpNeighEntry OBJECT-TYPE
  2238. SYNTAX EgpNeighEntry
  2239. ACCESS not-accessible
  2240. STATUS mandatory
  2241. DESCRIPTION
  2242. "Information about this entity's relationship with
  2243. a particular EGP neighbor."
  2244. INDEX { egpNeighAddr }
  2245. ::= { egpNeighTable 1 }
  2246. EgpNeighEntry ::=
  2247. SEQUENCE {
  2248. egpNeighState
  2249. INTEGER,
  2250. egpNeighAddr
  2251. IpAddress,
  2252. egpNeighAs
  2253. INTEGER,
  2254. egpNeighInMsgs
  2255. Counter,
  2256. egpNeighInErrs
  2257. Counter,
  2258. egpNeighOutMsgs
  2259. Counter,
  2260. egpNeighOutErrs
  2261. Counter,
  2262. egpNeighInErrMsgs
  2263. Counter,
  2264. egpNeighOutErrMsgs
  2265. Counter,
  2266. egpNeighStateUps
  2267. Counter,
  2268. egpNeighStateDowns
  2269. Counter,
  2270. egpNeighIntervalHello
  2271. INTEGER,
  2272. egpNeighIntervalPoll
  2273. INTEGER,
  2274. egpNeighMode
  2275. INTEGER,
  2276. egpNeighEventTrigger
  2277. INTEGER
  2278. }
  2279. egpNeighState OBJECT-TYPE
  2280. SYNTAX INTEGER {
  2281. idle(1),
  2282. acquisition(2),
  2283. down(3),
  2284. up(4),
  2285. cease(5)
  2286. }
  2287. ACCESS read-only
  2288. STATUS mandatory
  2289. DESCRIPTION
  2290. "The EGP state of the local system with respect to
  2291. this entry's EGP neighbor. Each EGP state is
  2292. represented by a value that is one greater than
  2293. the numerical value associated with said state in
  2294. RFC 904."
  2295. ::= { egpNeighEntry 1 }
  2296. egpNeighAddr OBJECT-TYPE
  2297. SYNTAX IpAddress
  2298. ACCESS read-only
  2299. STATUS mandatory
  2300. DESCRIPTION
  2301. "The IP address of this entry's EGP neighbor."
  2302. ::= { egpNeighEntry 2 }
  2303. egpNeighAs OBJECT-TYPE
  2304. SYNTAX INTEGER
  2305. ACCESS read-only
  2306. STATUS mandatory
  2307. DESCRIPTION
  2308. "The autonomous system of this EGP peer. Zero
  2309. should be specified if the autonomous system
  2310. number of the neighbor is not yet known."
  2311. ::= { egpNeighEntry 3 }
  2312. egpNeighInMsgs OBJECT-TYPE
  2313. SYNTAX Counter
  2314. ACCESS read-only
  2315. STATUS mandatory
  2316. DESCRIPTION
  2317. "The number of EGP messages received without error
  2318. from this EGP peer."
  2319. ::= { egpNeighEntry 4 }
  2320. egpNeighInErrs OBJECT-TYPE
  2321. SYNTAX Counter
  2322. ACCESS read-only
  2323. STATUS mandatory
  2324. DESCRIPTION
  2325. "The number of EGP messages received from this EGP
  2326. peer that proved to be in error (e.g., bad EGP
  2327. checksum)."
  2328. ::= { egpNeighEntry 5 }
  2329. egpNeighOutMsgs OBJECT-TYPE
  2330. SYNTAX Counter
  2331. ACCESS read-only
  2332. STATUS mandatory
  2333. DESCRIPTION
  2334. "The number of locally generated EGP messages to
  2335. this EGP peer."
  2336. ::= { egpNeighEntry 6 }
  2337. egpNeighOutErrs OBJECT-TYPE
  2338. SYNTAX Counter
  2339. ACCESS read-only
  2340. STATUS mandatory
  2341. DESCRIPTION
  2342. "The number of locally generated EGP messages not
  2343. sent to this EGP peer due to resource limitations
  2344. within an EGP entity."
  2345. ::= { egpNeighEntry 7 }
  2346. egpNeighInErrMsgs OBJECT-TYPE
  2347. SYNTAX Counter
  2348. ACCESS read-only
  2349. STATUS mandatory
  2350. DESCRIPTION
  2351. "The number of EGP-defined error messages received
  2352. from this EGP peer."
  2353. ::= { egpNeighEntry 8 }
  2354. egpNeighOutErrMsgs OBJECT-TYPE
  2355. SYNTAX Counter
  2356. ACCESS read-only
  2357. STATUS mandatory
  2358. DESCRIPTION
  2359. "The number of EGP-defined error messages sent to
  2360. this EGP peer."
  2361. ::= { egpNeighEntry 9 }
  2362. egpNeighStateUps OBJECT-TYPE
  2363. SYNTAX Counter
  2364. ACCESS read-only
  2365. STATUS mandatory
  2366. DESCRIPTION
  2367. "The number of EGP state transitions to the UP
  2368. state with this EGP peer."
  2369. ::= { egpNeighEntry 10 }
  2370. egpNeighStateDowns OBJECT-TYPE
  2371. SYNTAX Counter
  2372. ACCESS read-only
  2373. STATUS mandatory
  2374. DESCRIPTION
  2375. "The number of EGP state transitions from the UP
  2376. state to any other state with this EGP peer."
  2377. ::= { egpNeighEntry 11 }
  2378. egpNeighIntervalHello OBJECT-TYPE
  2379. SYNTAX INTEGER
  2380. ACCESS read-only
  2381. STATUS mandatory
  2382. DESCRIPTION
  2383. "The interval between EGP Hello command
  2384. retransmissions (in hundredths of a second). This
  2385. represents the t1 timer as defined in RFC 904."
  2386. ::= { egpNeighEntry 12 }
  2387. egpNeighIntervalPoll OBJECT-TYPE
  2388. SYNTAX INTEGER
  2389. ACCESS read-only
  2390. STATUS mandatory
  2391. DESCRIPTION
  2392. "The interval between EGP poll command
  2393. retransmissions (in hundredths of a second). This
  2394. represents the t3 timer as defined in RFC 904."
  2395. ::= { egpNeighEntry 13 }
  2396. egpNeighMode OBJECT-TYPE
  2397. SYNTAX INTEGER { active(1), passive(2) }
  2398. ACCESS read-only
  2399. STATUS mandatory
  2400. DESCRIPTION
  2401. "The polling mode of this EGP entity, either
  2402. passive or active."
  2403. ::= { egpNeighEntry 14 }
  2404. egpNeighEventTrigger OBJECT-TYPE
  2405. SYNTAX INTEGER { start(1), stop(2) }
  2406. ACCESS read-write
  2407. STATUS mandatory
  2408. DESCRIPTION
  2409. "A control variable used to trigger operator-
  2410. initiated Start and Stop events. When read, this
  2411. variable always returns the most recent value that
  2412. egpNeighEventTrigger was set to. If it has not
  2413. been set since the last initialization of the
  2414. network management subsystem on the node, it
  2415. returns a value of `stop'.
  2416. When set, this variable causes a Start or Stop
  2417. event on the specified neighbor, as specified on
  2418. pages 8-10 of RFC 904. Briefly, a Start event
  2419. causes an Idle peer to begin neighbor acquisition
  2420. and a non-Idle peer to reinitiate neighbor
  2421. acquisition. A stop event causes a non-Idle peer
  2422. to return to the Idle state until a Start event
  2423. occurs, either via egpNeighEventTrigger or
  2424. otherwise."
  2425. ::= { egpNeighEntry 15 }
  2426. -- additional EGP objects
  2427. egpAs OBJECT-TYPE
  2428. SYNTAX INTEGER
  2429. ACCESS read-only
  2430. STATUS mandatory
  2431. DESCRIPTION
  2432. "The autonomous system number of this EGP entity."
  2433. ::= { egp 6 }
  2434. -- the Transmission group
  2435. -- Based on the transmission media underlying each interface
  2436. -- on a system, the corresponding portion of the Transmission
  2437. -- group is mandatory for that system.
  2438. -- When Internet-standard definitions for managing
  2439. -- transmission media are defined, the transmission group is
  2440. -- used to provide a prefix for the names of those objects.
  2441. -- Typically, such definitions reside in the experimental
  2442. -- portion of the MIB until they are "proven", then as a
  2443. -- part of the Internet standardization process, the
  2444. -- definitions are accordingly elevated and a new object
  2445. -- identifier, under the transmission group is defined. By
  2446. -- convention, the name assigned is:
  2447. --
  2448. -- type OBJECT IDENTIFIER ::= { transmission number }
  2449. --
  2450. -- where "type" is the symbolic value used for the media in
  2451. -- the ifType column of the ifTable object, and "number" is
  2452. -- the actual integer value corresponding to the symbol.
  2453. -- the SNMP group
  2454. -- Implementation of the SNMP group is mandatory for all
  2455. -- systems which support an SNMP protocol entity. Some of
  2456. -- the objects defined below will be zero-valued in those
  2457. -- SNMP implementations that are optimized to support only
  2458. -- those functions specific to either a management agent or
  2459. -- a management station. In particular, it should be
  2460. -- observed that the objects below refer to an SNMP entity,
  2461. -- and there may be several SNMP entities residing on a
  2462. -- managed node (e.g., if the node is hosting acting as
  2463. -- a management station).
  2464. snmpInPkts OBJECT-TYPE
  2465. SYNTAX Counter
  2466. ACCESS read-only
  2467. STATUS mandatory
  2468. DESCRIPTION
  2469. "The total number of Messages delivered to the
  2470. SNMP entity from the transport service."
  2471. ::= { snmp 1 }
  2472. snmpOutPkts OBJECT-TYPE
  2473. SYNTAX Counter
  2474. ACCESS read-only
  2475. STATUS mandatory
  2476. DESCRIPTION
  2477. "The total number of SNMP Messages which were
  2478. passed from the SNMP protocol entity to the
  2479. transport service."
  2480. ::= { snmp 2 }
  2481. snmpInBadVersions OBJECT-TYPE
  2482. SYNTAX Counter
  2483. ACCESS read-only
  2484. STATUS mandatory
  2485. DESCRIPTION
  2486. "The total number of SNMP Messages which were
  2487. delivered to the SNMP protocol entity and were for
  2488. an unsupported SNMP version."
  2489. ::= { snmp 3 }
  2490. snmpInBadCommunityNames OBJECT-TYPE
  2491. SYNTAX Counter
  2492. ACCESS read-only
  2493. STATUS mandatory
  2494. DESCRIPTION
  2495. "The total number of SNMP Messages delivered to
  2496. the SNMP protocol entity which used a SNMP
  2497. community name not known to said entity."
  2498. ::= { snmp 4 }
  2499. snmpInBadCommunityUses OBJECT-TYPE
  2500. SYNTAX Counter
  2501. ACCESS read-only
  2502. STATUS mandatory
  2503. DESCRIPTION
  2504. "The total number of SNMP Messages delivered to
  2505. the SNMP protocol entity which represented an SNMP
  2506. operation which was not allowed by the SNMP
  2507. community named in the Message."
  2508. ::= { snmp 5 }
  2509. snmpInASNParseErrs OBJECT-TYPE
  2510. SYNTAX Counter
  2511. ACCESS read-only
  2512. STATUS mandatory
  2513. DESCRIPTION
  2514. "The total number of ASN.1 or BER errors
  2515. encountered by the SNMP protocol entity when
  2516. decoding received SNMP Messages."
  2517. ::= { snmp 6 }
  2518. -- { snmp 7 } is not used
  2519. snmpInTooBigs OBJECT-TYPE
  2520. SYNTAX Counter
  2521. ACCESS read-only
  2522. STATUS mandatory
  2523. DESCRIPTION
  2524. "The total number of SNMP PDUs which were
  2525. delivered to the SNMP protocol entity and for
  2526. which the value of the error-status field is
  2527. `tooBig'."
  2528. ::= { snmp 8 }
  2529. snmpInNoSuchNames OBJECT-TYPE
  2530. SYNTAX Counter
  2531. ACCESS read-only
  2532. STATUS mandatory
  2533. DESCRIPTION
  2534. "The total number of SNMP PDUs which were
  2535. delivered to the SNMP protocol entity and for
  2536. which the value of the error-status field is
  2537. `noSuchName'."
  2538. ::= { snmp 9 }
  2539. snmpInBadValues OBJECT-TYPE
  2540. SYNTAX Counter
  2541. ACCESS read-only
  2542. STATUS mandatory
  2543. DESCRIPTION
  2544. "The total number of SNMP PDUs which were
  2545. delivered to the SNMP protocol entity and for
  2546. which the value of the error-status field is
  2547. `badValue'."
  2548. ::= { snmp 10 }
  2549. snmpInReadOnlys OBJECT-TYPE
  2550. SYNTAX Counter
  2551. ACCESS read-only
  2552. STATUS mandatory
  2553. DESCRIPTION
  2554. "The total number valid SNMP PDUs which were
  2555. delivered to the SNMP protocol entity and for
  2556. which the value of the error-status field is
  2557. `readOnly'. It should be noted that it is a
  2558. protocol error to generate an SNMP PDU which
  2559. contains the value `readOnly' in the error-status
  2560. field, as such this object is provided as a means
  2561. of detecting incorrect implementations of the
  2562. SNMP."
  2563. ::= { snmp 11 }
  2564. snmpInGenErrs OBJECT-TYPE
  2565. SYNTAX Counter
  2566. ACCESS read-only
  2567. STATUS mandatory
  2568. DESCRIPTION
  2569. "The total number of SNMP PDUs which were
  2570. delivered to the SNMP protocol entity and for
  2571. which the value of the error-status field is
  2572. `genErr'."
  2573. ::= { snmp 12 }
  2574. snmpInTotalReqVars OBJECT-TYPE
  2575. SYNTAX Counter
  2576. ACCESS read-only
  2577. STATUS mandatory
  2578. DESCRIPTION
  2579. "The total number of MIB objects which have been
  2580. retrieved successfully by the SNMP protocol entity
  2581. as the result of receiving valid SNMP Get-Request
  2582. and Get-Next PDUs."
  2583. ::= { snmp 13 }
  2584. snmpInTotalSetVars OBJECT-TYPE
  2585. SYNTAX Counter
  2586. ACCESS read-only
  2587. STATUS mandatory
  2588. DESCRIPTION
  2589. "The total number of MIB objects which have been
  2590. altered successfully by the SNMP protocol entity
  2591. as the result of receiving valid SNMP Set-Request
  2592. PDUs."
  2593. ::= { snmp 14 }
  2594. snmpInGetRequests OBJECT-TYPE
  2595. SYNTAX Counter
  2596. ACCESS read-only
  2597. STATUS mandatory
  2598. DESCRIPTION
  2599. "The total number of SNMP Get-Request PDUs which
  2600. have been accepted and processed by the SNMP
  2601. protocol entity."
  2602. ::= { snmp 15 }
  2603. snmpInGetNexts OBJECT-TYPE
  2604. SYNTAX Counter
  2605. ACCESS read-only
  2606. STATUS mandatory
  2607. DESCRIPTION
  2608. "The total number of SNMP Get-Next PDUs which have
  2609. been accepted and processed by the SNMP protocol
  2610. entity."
  2611. ::= { snmp 16 }
  2612. snmpInSetRequests OBJECT-TYPE
  2613. SYNTAX Counter
  2614. ACCESS read-only
  2615. STATUS mandatory
  2616. DESCRIPTION
  2617. "The total number of SNMP Set-Request PDUs which
  2618. have been accepted and processed by the SNMP
  2619. protocol entity."
  2620. ::= { snmp 17 }
  2621. snmpInGetResponses OBJECT-TYPE
  2622. SYNTAX Counter
  2623. ACCESS read-only
  2624. STATUS mandatory
  2625. DESCRIPTION
  2626. "The total number of SNMP Get-Response PDUs which
  2627. have been accepted and processed by the SNMP
  2628. protocol entity."
  2629. ::= { snmp 18 }
  2630. snmpInTraps OBJECT-TYPE
  2631. SYNTAX Counter
  2632. ACCESS read-only
  2633. STATUS mandatory
  2634. DESCRIPTION
  2635. "The total number of SNMP Trap PDUs which have
  2636. been accepted and processed by the SNMP protocol
  2637. entity."
  2638. ::= { snmp 19 }
  2639. snmpOutTooBigs OBJECT-TYPE
  2640. SYNTAX Counter
  2641. ACCESS read-only
  2642. STATUS mandatory
  2643. DESCRIPTION
  2644. "The total number of SNMP PDUs which were
  2645. generated by the SNMP protocol entity and for
  2646. which the value of the error-status field is
  2647. `tooBig.'"
  2648. ::= { snmp 20 }
  2649. snmpOutNoSuchNames OBJECT-TYPE
  2650. SYNTAX Counter
  2651. ACCESS read-only
  2652. STATUS mandatory
  2653. DESCRIPTION
  2654. "The total number of SNMP PDUs which were
  2655. generated by the SNMP protocol entity and for
  2656. which the value of the error-status is
  2657. `noSuchName'."
  2658. ::= { snmp 21 }
  2659. snmpOutBadValues OBJECT-TYPE
  2660. SYNTAX Counter
  2661. ACCESS read-only
  2662. STATUS mandatory
  2663. DESCRIPTION
  2664. "The total number of SNMP PDUs which were
  2665. generated by the SNMP protocol entity and for
  2666. which the value of the error-status field is
  2667. `badValue'."
  2668. ::= { snmp 22 }
  2669. -- { snmp 23 } is not used
  2670. snmpOutGenErrs OBJECT-TYPE
  2671. SYNTAX Counter
  2672. ACCESS read-only
  2673. STATUS mandatory
  2674. DESCRIPTION
  2675. "The total number of SNMP PDUs which were
  2676. generated by the SNMP protocol entity and for
  2677. which the value of the error-status field is
  2678. `genErr'."
  2679. ::= { snmp 24 }
  2680. snmpOutGetRequests OBJECT-TYPE
  2681. SYNTAX Counter
  2682. ACCESS read-only
  2683. STATUS mandatory
  2684. DESCRIPTION
  2685. "The total number of SNMP Get-Request PDUs which
  2686. have been generated by the SNMP protocol entity."
  2687. ::= { snmp 25 }
  2688. snmpOutGetNexts OBJECT-TYPE
  2689. SYNTAX Counter
  2690. ACCESS read-only
  2691. STATUS mandatory
  2692. DESCRIPTION
  2693. "The total number of SNMP Get-Next PDUs which have
  2694. been generated by the SNMP protocol entity."
  2695. ::= { snmp 26 }
  2696. snmpOutSetRequests OBJECT-TYPE
  2697. SYNTAX Counter
  2698. ACCESS read-only
  2699. STATUS mandatory
  2700. DESCRIPTION
  2701. "The total number of SNMP Set-Request PDUs which
  2702. have been generated by the SNMP protocol entity."
  2703. ::= { snmp 27 }
  2704. snmpOutGetResponses OBJECT-TYPE
  2705. SYNTAX Counter
  2706. ACCESS read-only
  2707. STATUS mandatory
  2708. DESCRIPTION
  2709. "The total number of SNMP Get-Response PDUs which
  2710. have been generated by the SNMP protocol entity."
  2711. ::= { snmp 28 }
  2712. snmpOutTraps OBJECT-TYPE
  2713. SYNTAX Counter
  2714. ACCESS read-only
  2715. STATUS mandatory
  2716. DESCRIPTION
  2717. "The total number of SNMP Trap PDUs which have
  2718. been generated by the SNMP protocol entity."
  2719. ::= { snmp 29 }
  2720. snmpEnableAuthenTraps OBJECT-TYPE
  2721. SYNTAX INTEGER { enabled(1), disabled(2) }
  2722. ACCESS read-write
  2723. STATUS mandatory
  2724. DESCRIPTION
  2725. "Indicates whether the SNMP agent process is
  2726. permitted to generate authentication-failure
  2727. traps. The value of this object overrides any
  2728. configuration information; as such, it provides a
  2729. means whereby all authentication-failure traps may
  2730. be disabled.
  2731. Note that it is strongly recommended that this
  2732. object be stored in non-volatile memory so that it
  2733. remains constant between re-initializations of the
  2734. network management system."
  2735. ::= { snmp 30 }
  2736. END
  2737. 7. Acknowledgements
  2738. This document was produced by the SNMP Working Group:
  2739. Anne Ambler, Spider
  2740. Karl Auerbach, Sun
  2741. Fred Baker, ACC
  2742. David Bridgham, Epilogue Technology
  2743. Ken Brinkerhoff
  2744. Ron Broersma, NOSC
  2745. Brian Brown, Synoptics
  2746. Jack Brown, US Army
  2747. Theodore Brunner, Bellcore
  2748. Jeff Buffum, HP
  2749. Jeffrey Buffum, HP
  2750. John Burress, Wellfleet
  2751. Jeffrey D. Case, University of Tennessee at Knoxville
  2752. Chris Chiptasso, Spartacus
  2753. Paul Ciarfella, DEC
  2754. Bob Collet
  2755. John Cook, Chipcom
  2756. Tracy Cox, Bellcore
  2757. James R. Davin, MIT-LCS
  2758. Eric Decker, cisco
  2759. Kurt Dobbins, Cabletron
  2760. Nadya El-Afandi, Network Systems
  2761. Gary Ellis, HP
  2762. Fred Engle
  2763. Mike Erlinger
  2764. Mark S. Fedor, PSI
  2765. Richard Fox, Synoptics
  2766. Karen Frisa, CMU
  2767. Stan Froyd, ACC
  2768. Chris Gunner, DEC
  2769. Fred Harris, University of Tennessee at Knoxville
  2770. Ken Hibbard, Xylogics
  2771. Ole Jacobsen, Interop
  2772. Ken Jones
  2773. Satish Joshi, Synoptics
  2774. Frank Kastenholz, Racal-Interlan
  2775. Shimshon Kaufman, Spartacus
  2776. Ken Key, University of Tennessee at Knoxville
  2777. Jim Kinder, Fibercom
  2778. Alex Koifman, BBN
  2779. Christopher Kolb, PSI
  2780. Cheryl Krupczak, NCR
  2781. Paul Langille, DEC
  2782. Martin Lee Schoffstall, PSI
  2783. Peter Lin, Vitalink
  2784. John Lunny, TWG
  2785. Carl Malamud
  2786. Gary Malkin, FTP Software, Inc.
  2787. Randy Mayhew, University of Tennessee at Knoxville
  2788. Keith McCloghrie, Hughes LAN Systems
  2789. Donna McMaster, David Systems
  2790. Lynn Monsanto, Sun
  2791. Dave Perkins, 3COM
  2792. Jim Reinstedler, Ungerman Bass
  2793. Anil Rijsinghani, DEC
  2794. Kathy Rinehart, Arnold AFB
  2795. Kary Robertson
  2796. Marshall T. Rose, PSI (chair)
  2797. L. Michael Sabo, NCSC
  2798. Jon Saperia, DEC
  2799. Greg Satz, cisco
  2800. Martin Schoffstall, PSI
  2801. John Seligson
  2802. Steve Sherry, Xyplex
  2803. Fei Shu, NEC
  2804. Sam Sjogren, TGV
  2805. Mark Sleeper, Sparta
  2806. Lance Sprung
  2807. Mike St.Johns
  2808. Bob Stewart, Xyplex
  2809. Emil Sturniold
  2810. Kaj Tesink, Bellcore
  2811. Geoff Thompson, Synoptics
  2812. Dean Throop, Data General
  2813. Bill Townsend, Xylogics
  2814. Maurice Turcotte, Racal-Milgo
  2815. Kannan Varadhou
  2816. Sudhanshu Verma, HP
  2817. Bill Versteeg, Network Research Corporation
  2818. Warren Vik, Interactive Systems
  2819. David Waitzman, BBN
  2820. Steve Waldbusser, CMU
  2821. Dan Wintringhan
  2822. David Wood
  2823. Wengyik Yeong, PSI
  2824. Jeff Young, Cray Research
  2825. In addition, the comments of the following individuals are also
  2826. acknolwedged:
  2827. Craig A. Finseth, Minnesota Supercomputer Center, Inc.
  2828. Jeffrey C. Honig, Cornell University Theory Center
  2829. Philip R. Karn, Bellcore
  2830. 8. References
  2831. [1] Cerf, V., "IAB Recommendations for the Development of Internet
  2832. Network Management Standards", RFC 1052, NRI, April 1988.
  2833. [2] Rose M., and K. McCloghrie, "Structure and Identification of
  2834. Management Information for TCP/IP-based internets," RFC 1065,
  2835. TWG, August 1988.
  2836. [3] McCloghrie, K., and M. Rose, "Management Information Base for
  2837. Network Management of TCP/IP-based internets, RFC 1066, TWG,
  2838. August 1988.
  2839. [4] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  2840. Group", RFC 1109, NRI, August 1989.
  2841. [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  2842. Network Management Protocol (SNMP)", RFC 1098, University of
  2843. Tennessee at Knoxville, NYSERNet, Inc., Rensselaer Polytechnic
  2844. Institute, MIT Laboratory for Computer Science, April 1989.
  2845. [6] Postel, J., and J. Reynolds, "TELNET Protocol Specification", RFC
  2846. 854, USC/Information Sciences Institute, May 1983.
  2847. [7] Satz, G., "Connectionless Network Protocol (ISO 8473) and End
  2848. System to Intermediate System (ISO 9542) Management Information
  2849. Base", RFC 1162, cisco Systems, Inc., June 1990.
  2850. [8] Information processing systems - Open Systems Interconnection -
  2851. Specification of Abstract Syntax Notation One (ASN.1),
  2852. International Organization for Standardization, International
  2853. Standard 8824, December 1987.
  2854. [9] Information processing systems - Open Systems Interconnection -
  2855. Specification of Basic Encoding Rules for Abstract Notation One
  2856. (ASN.1), International Organization for Standardization,
  2857. International Standard 8825, December 1987.
  2858. [10] Jacobson, V., "Congestion Avoidance and Control", SIGCOMM 1988,
  2859. Stanford, California.
  2860. [11] Hagens, R., Hall, N., and M. Rose, "Use of the Internet as a
  2861. Subnetwork for Experimentation with the OSI Network Layer", RFC
  2862. 1070, U of Wiscsonsin - Madison, U of Wiscsonsin - Madison, The
  2863. Wollongong Group, February 1989.
  2864. [12] Rose M., and K. McCloghrie, "Structure and Identification of
  2865. Management Information for TCP/IP-based internets", RFC 1155,
  2866. Performance Systems International, Hughes LAN Systems, May 1990.
  2867. [13] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  2868. Network Management Protocol", RFC 1157, SNMP Research,
  2869. Performance Systems International, Performance Systems
  2870. International, MIT Laboratory for Computer Science, May 1990.
  2871. [14] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  2872. RFC 1212, Performance Systems International, Hughes LAN Systems,
  2873. March 1991.
  2874. 9. Security Considerations
  2875. Security issues are not discussed in this memo.
  2876. 10. Authors' Addresses
  2877. Keith McCloghrie
  2878. Hughes LAN Systems
  2879. 1225 Charleston Road
  2880. Mountain View, CA 94043
  2881. 1225 Charleston Road
  2882. Mountain View, CA 94043
  2883. Phone: (415) 966-7934
  2884. EMail: [email protected]
  2885. Marshall T. Rose
  2886. Performance Systems International
  2887. 5201 Great America Parkway
  2888. Suite 3106
  2889. Santa Clara, CA 95054
  2890. Phone: +1 408 562 6222
  2891. EMail: [email protected]
  2892. X.500: rose, psi, us
  2893. SNMP Working Group [Page 70]