Annotation of src/share/snmp/OPENBSD-CARP-MIB.txt, Revision 1.1
1.1 ! joel 1: -- $OpenBSD$
! 2: --
! 3: -- Copyright (c) 2006-2011 Joel Knight <knight.joel@gmail.com>
! 4: --
! 5: -- Permission to use, copy, modify, and distribute this document for any
! 6: -- purpose with or without fee is hereby granted, provided that the above
! 7: -- copyright notice and this permission notice appear in all copies.
! 8: --
! 9: -- THE DOCUMENT IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
! 10: -- WITH REGARD TO THIS DOCUMENT INCLUDING ALL IMPLIED WARRANTIES OF
! 11: -- MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
! 12: -- ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
! 13: -- WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
! 14: -- ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
! 15: -- OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS DOCUMENT.
! 16:
! 17:
! 18: OPENBSD-CARP-MIB DEFINITIONS ::= BEGIN
! 19:
! 20: IMPORTS
! 21: MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-TYPE,
! 22: Counter64, Integer32, enterprises
! 23: FROM SNMPv2-SMI
! 24:
! 25: TruthValue
! 26: FROM SNMPv2-TC
! 27:
! 28: openBSD
! 29: FROM OPENBSD-BASE-MIB
! 30:
! 31: MODULE-COMPLIANCE, OBJECT-GROUP
! 32: FROM SNMPv2-CONF;
! 33:
! 34: carpMIBObjects MODULE-IDENTITY
! 35: LAST-UPDATED "201105130000Z"
! 36: ORGANIZATION "OpenBSD"
! 37: CONTACT-INFO "
! 38: Author: Joel Knight
! 39: email: knight.joel@gmail.com
! 40: www: www.packetmischief.ca/openbsd-snmp-mibs/
! 41: "
! 42: DESCRIPTION "The MIB module for gathering information about
! 43: Common Address Redundancy Protocol (CARP) interfaces.
! 44: "
! 45: ::= { openBSD 6 }
! 46:
! 47:
! 48: -- define the sections of the MIB
! 49:
! 50: carpSysctl OBJECT IDENTIFIER ::= { carpMIBObjects 1 }
! 51: carpIf OBJECT IDENTIFIER ::= { carpMIBObjects 2 }
! 52: carpStats OBJECT IDENTIFIER ::= { carpMIBObjects 3 }
! 53:
! 54:
! 55: -- carpSysctl
! 56: carpAllow OBJECT-TYPE
! 57: SYNTAX TruthValue
! 58: MAX-ACCESS read-only
! 59: STATUS current
! 60: DESCRIPTION
! 61: "Indicates whether the node will respond to CARP packets."
! 62: ::= { carpSysctl 1 }
! 63:
! 64: carpPreempt OBJECT-TYPE
! 65: SYNTAX TruthValue
! 66: MAX-ACCESS read-only
! 67: STATUS current
! 68: DESCRIPTION
! 69: "Indicates whether preemption is enabled."
! 70: ::= { carpSysctl 2 }
! 71:
! 72: carpLog OBJECT-TYPE
! 73: SYNTAX TruthValue
! 74: MAX-ACCESS read-only
! 75: STATUS current
! 76: DESCRIPTION
! 77: "Indicates whether logging of invalud CARP packets is enabled."
! 78: ::= { carpSysctl 3 }
! 79:
! 80:
! 81: -- carpIf
! 82:
! 83: carpIfNumber OBJECT-TYPE
! 84: SYNTAX Integer32
! 85: MAX-ACCESS read-only
! 86: STATUS current
! 87: DESCRIPTION
! 88: "The number of CARP interfaces present on this system."
! 89: ::= { carpIf 1 }
! 90:
! 91: carpIfTable OBJECT-TYPE
! 92: SYNTAX SEQUENCE OF CarpIfEntry
! 93: MAX-ACCESS not-accessible
! 94: STATUS current
! 95: DESCRIPTION
! 96: "A list of individual CARP interfaces. The number of entries is
! 97: given by the value of carpIfNumber."
! 98: ::= { carpIf 2 }
! 99:
! 100: carpIfEntry OBJECT-TYPE
! 101: SYNTAX CarpIfEntry
! 102: MAX-ACCESS not-accessible
! 103: STATUS current
! 104: DESCRIPTION
! 105: "An entry containing management information applicable to a
! 106: particular CARP interface."
! 107: INDEX { carpIfIndex }
! 108: ::= { carpIfTable 1 }
! 109:
! 110: CarpIfEntry ::=
! 111: SEQUENCE {
! 112: carpIfIndex Integer32,
! 113: carpIfDescr OCTET STRING,
! 114: carpIfVhid Integer32,
! 115: carpIfDev OCTET STRING,
! 116: carpIfAdvbase Integer32,
! 117: carpIfAdvskew Integer32,
! 118: carpIfState Integer32
! 119: }
! 120:
! 121: carpIfIndex OBJECT-TYPE
! 122: SYNTAX Integer32 (1..2147483647)
! 123: MAX-ACCESS read-only
! 124: STATUS current
! 125: DESCRIPTION
! 126: "A unique value, greater than zero, for each CARP interface."
! 127: ::= { carpIfEntry 1 }
! 128:
! 129: carpIfDescr OBJECT-TYPE
! 130: SYNTAX OCTET STRING
! 131: MAX-ACCESS read-only
! 132: STATUS current
! 133: DESCRIPTION
! 134: "The name of the CARP interface."
! 135: ::= { carpIfEntry 2 }
! 136:
! 137: carpIfVhid OBJECT-TYPE
! 138: SYNTAX Integer32
! 139: MAX-ACCESS read-only
! 140: STATUS current
! 141: DESCRIPTION
! 142: "The Virtual HostID of the CARP interface."
! 143: ::= { carpIfEntry 3 }
! 144:
! 145: carpIfDev OBJECT-TYPE
! 146: SYNTAX OCTET STRING
! 147: MAX-ACCESS read-only
! 148: STATUS current
! 149: DESCRIPTION
! 150: "The parent interface that the CARP interface is bound to."
! 151: ::= { carpIfEntry 4 }
! 152:
! 153: carpIfAdvbase OBJECT-TYPE
! 154: SYNTAX Integer32
! 155: MAX-ACCESS read-only
! 156: STATUS current
! 157: DESCRIPTION
! 158: "The advbase value of the CARP interface."
! 159: ::= { carpIfEntry 5 }
! 160:
! 161: carpIfAdvskew OBJECT-TYPE
! 162: SYNTAX Integer32
! 163: MAX-ACCESS read-only
! 164: STATUS current
! 165: DESCRIPTION
! 166: "The advskew value of the CARP interface."
! 167: ::= { carpIfEntry 6 }
! 168:
! 169: carpIfState OBJECT-TYPE
! 170: SYNTAX INTEGER { init(0), backup(1), master(2) }
! 171: MAX-ACCESS read-only
! 172: STATUS current
! 173: DESCRIPTION
! 174: "Indicates the operational state of the CARP interface."
! 175: ::= { carpIfEntry 7 }
! 176:
! 177:
! 178: -- carpStats
! 179:
! 180: carpIpPktsRecv OBJECT-TYPE
! 181: SYNTAX Counter64
! 182: MAX-ACCESS read-only
! 183: STATUS current
! 184: DESCRIPTION
! 185: "Number of IPv4 CARP packets received on all interfaces."
! 186: ::= { carpStats 1 }
! 187:
! 188: carpIp6PktsRecv OBJECT-TYPE
! 189: SYNTAX Counter64
! 190: MAX-ACCESS read-only
! 191: STATUS current
! 192: DESCRIPTION
! 193: "Number of IPv6 CARP packets received on all interfaces."
! 194: ::= { carpStats 2 }
! 195:
! 196: carpPktDiscardsForBadInterface OBJECT-TYPE
! 197: SYNTAX Counter64
! 198: MAX-ACCESS read-only
! 199: STATUS current
! 200: DESCRIPTION
! 201: "Number of packets discarded due to being received on a
! 202: non-CARP interface."
! 203: ::= { carpStats 3 }
! 204:
! 205: carpPktDiscardsForWrongTtl OBJECT-TYPE
! 206: SYNTAX Counter64
! 207: MAX-ACCESS read-only
! 208: STATUS current
! 209: DESCRIPTION
! 210: "Number of packets discarded due to having a TTL less
! 211: than 255."
! 212: ::= { carpStats 4 }
! 213:
! 214: carpPktShorterThanHeader OBJECT-TYPE
! 215: SYNTAX Counter64
! 216: MAX-ACCESS read-only
! 217: STATUS current
! 218: DESCRIPTION
! 219: "Number of packets received on any interface that is
! 220: shorter than the size of the CARP packet header."
! 221: ::= { carpStats 5 }
! 222:
! 223: carpPktDiscardsForBadChecksum OBJECT-TYPE
! 224: SYNTAX Counter64
! 225: MAX-ACCESS read-only
! 226: STATUS current
! 227: DESCRIPTION
! 228: "Number of packets discarded due to bad checksum."
! 229: ::= { carpStats 6 }
! 230:
! 231: carpPktDiscardsForBadVersion OBJECT-TYPE
! 232: SYNTAX Counter64
! 233: MAX-ACCESS read-only
! 234: STATUS current
! 235: DESCRIPTION
! 236: "Number of packets discarded due to bad version in
! 237: the packet header."
! 238: ::= { carpStats 7 }
! 239:
! 240: carpPktDiscardsForTooShort OBJECT-TYPE
! 241: SYNTAX Counter64
! 242: MAX-ACCESS read-only
! 243: STATUS current
! 244: DESCRIPTION
! 245: "Number of packets discarded due to being too short."
! 246: ::= { carpStats 8 }
! 247:
! 248: carpPktDiscardsForBadAuth OBJECT-TYPE
! 249: SYNTAX Counter64
! 250: MAX-ACCESS read-only
! 251: STATUS current
! 252: DESCRIPTION
! 253: "Number of packets discarded because they failed the
! 254: HMAC authentication check."
! 255: ::= { carpStats 9 }
! 256:
! 257: carpPktDiscardsForBadVhid OBJECT-TYPE
! 258: SYNTAX Counter64
! 259: MAX-ACCESS read-only
! 260: STATUS current
! 261: DESCRIPTION
! 262: "Number of packets discarded due to incorrect VHID in
! 263: the packet header."
! 264: ::= { carpStats 10 }
! 265:
! 266: carpPktDiscardsForBadAddressList OBJECT-TYPE
! 267: SYNTAX Counter64
! 268: MAX-ACCESS read-only
! 269: STATUS current
! 270: DESCRIPTION
! 271: "Number of packets discarded due to bad addresses in
! 272: the CARP packet."
! 273: ::= { carpStats 11 }
! 274:
! 275: carpIpPktsSent OBJECT-TYPE
! 276: SYNTAX Counter64
! 277: MAX-ACCESS read-only
! 278: STATUS current
! 279: DESCRIPTION
! 280: "Number of IPv4 CARP packets sent on all interfaces."
! 281: ::= { carpStats 12 }
! 282:
! 283: carpIp6PktsSent OBJECT-TYPE
! 284: SYNTAX Counter64
! 285: MAX-ACCESS read-only
! 286: STATUS current
! 287: DESCRIPTION
! 288: "Number of IPv6 CARP packets sent on all interfaces."
! 289: ::= { carpStats 13 }
! 290:
! 291: carpNoMemory OBJECT-TYPE
! 292: SYNTAX Counter64
! 293: MAX-ACCESS read-only
! 294: STATUS current
! 295: DESCRIPTION
! 296: "Number of CARP advertisements that failed because memory
! 297: could not be allocated."
! 298: ::= { carpStats 14 }
! 299:
! 300: carpTransitionsToMaster OBJECT-TYPE
! 301: SYNTAX Counter64
! 302: MAX-ACCESS read-only
! 303: STATUS current
! 304: DESCRIPTION
! 305: "Number of times the host has transitioned to MASTER state
! 306: for any CARP group."
! 307: ::= { carpStats 15 }
! 308:
! 309: END
! 310: