Annotation of src/share/snmp/OPENBSD-CARP-MIB.txt, Revision 1.2
1.2 ! sthen 1: -- $OpenBSD: OPENBSD-CARP-MIB.txt,v 1.1 2012/01/31 18:00:46 joel Exp $
1.1 joel 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
1.2 ! sthen 35: LAST-UPDATED "201201310000Z"
1.1 joel 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: "
1.2 ! sthen 42: DESCRIPTION "The MIB module for gathering information about
! 43: Common Address Redundancy Protocol (CARP) interfaces."
! 44: REVISION "201201310000Z"
! 45: DESCRIPTION "Add the OPENBSD-CARP-MIB to snmpd."
1.1 joel 46: ::= { openBSD 6 }
47:
48:
49: -- define the sections of the MIB
50:
51: carpSysctl OBJECT IDENTIFIER ::= { carpMIBObjects 1 }
52: carpIf OBJECT IDENTIFIER ::= { carpMIBObjects 2 }
53: carpStats OBJECT IDENTIFIER ::= { carpMIBObjects 3 }
54:
55:
56: -- carpSysctl
57: carpAllow OBJECT-TYPE
58: SYNTAX TruthValue
59: MAX-ACCESS read-only
60: STATUS current
61: DESCRIPTION
62: "Indicates whether the node will respond to CARP packets."
63: ::= { carpSysctl 1 }
64:
65: carpPreempt OBJECT-TYPE
66: SYNTAX TruthValue
67: MAX-ACCESS read-only
68: STATUS current
69: DESCRIPTION
70: "Indicates whether preemption is enabled."
71: ::= { carpSysctl 2 }
72:
73: carpLog OBJECT-TYPE
74: SYNTAX TruthValue
75: MAX-ACCESS read-only
76: STATUS current
77: DESCRIPTION
78: "Indicates whether logging of invalud CARP packets is enabled."
79: ::= { carpSysctl 3 }
80:
81:
82: -- carpIf
83:
84: carpIfNumber OBJECT-TYPE
85: SYNTAX Integer32
86: MAX-ACCESS read-only
87: STATUS current
88: DESCRIPTION
89: "The number of CARP interfaces present on this system."
90: ::= { carpIf 1 }
91:
92: carpIfTable OBJECT-TYPE
93: SYNTAX SEQUENCE OF CarpIfEntry
94: MAX-ACCESS not-accessible
95: STATUS current
96: DESCRIPTION
97: "A list of individual CARP interfaces. The number of entries is
98: given by the value of carpIfNumber."
99: ::= { carpIf 2 }
100:
101: carpIfEntry OBJECT-TYPE
102: SYNTAX CarpIfEntry
103: MAX-ACCESS not-accessible
104: STATUS current
105: DESCRIPTION
106: "An entry containing management information applicable to a
107: particular CARP interface."
108: INDEX { carpIfIndex }
109: ::= { carpIfTable 1 }
110:
111: CarpIfEntry ::=
112: SEQUENCE {
113: carpIfIndex Integer32,
114: carpIfDescr OCTET STRING,
115: carpIfVhid Integer32,
116: carpIfDev OCTET STRING,
117: carpIfAdvbase Integer32,
118: carpIfAdvskew Integer32,
119: carpIfState Integer32
120: }
121:
122: carpIfIndex OBJECT-TYPE
123: SYNTAX Integer32 (1..2147483647)
124: MAX-ACCESS read-only
125: STATUS current
126: DESCRIPTION
127: "A unique value, greater than zero, for each CARP interface."
128: ::= { carpIfEntry 1 }
129:
130: carpIfDescr OBJECT-TYPE
131: SYNTAX OCTET STRING
132: MAX-ACCESS read-only
133: STATUS current
134: DESCRIPTION
135: "The name of the CARP interface."
136: ::= { carpIfEntry 2 }
137:
138: carpIfVhid OBJECT-TYPE
139: SYNTAX Integer32
140: MAX-ACCESS read-only
141: STATUS current
142: DESCRIPTION
143: "The Virtual HostID of the CARP interface."
144: ::= { carpIfEntry 3 }
145:
146: carpIfDev OBJECT-TYPE
147: SYNTAX OCTET STRING
148: MAX-ACCESS read-only
149: STATUS current
150: DESCRIPTION
151: "The parent interface that the CARP interface is bound to."
152: ::= { carpIfEntry 4 }
153:
154: carpIfAdvbase OBJECT-TYPE
155: SYNTAX Integer32
156: MAX-ACCESS read-only
157: STATUS current
158: DESCRIPTION
159: "The advbase value of the CARP interface."
160: ::= { carpIfEntry 5 }
161:
162: carpIfAdvskew OBJECT-TYPE
163: SYNTAX Integer32
164: MAX-ACCESS read-only
165: STATUS current
166: DESCRIPTION
167: "The advskew value of the CARP interface."
168: ::= { carpIfEntry 6 }
169:
170: carpIfState OBJECT-TYPE
171: SYNTAX INTEGER { init(0), backup(1), master(2) }
172: MAX-ACCESS read-only
173: STATUS current
174: DESCRIPTION
175: "Indicates the operational state of the CARP interface."
176: ::= { carpIfEntry 7 }
177:
178:
179: -- carpStats
180:
181: carpIpPktsRecv OBJECT-TYPE
182: SYNTAX Counter64
183: MAX-ACCESS read-only
184: STATUS current
185: DESCRIPTION
186: "Number of IPv4 CARP packets received on all interfaces."
187: ::= { carpStats 1 }
188:
189: carpIp6PktsRecv OBJECT-TYPE
190: SYNTAX Counter64
191: MAX-ACCESS read-only
192: STATUS current
193: DESCRIPTION
194: "Number of IPv6 CARP packets received on all interfaces."
195: ::= { carpStats 2 }
196:
197: carpPktDiscardsForBadInterface OBJECT-TYPE
198: SYNTAX Counter64
199: MAX-ACCESS read-only
200: STATUS current
201: DESCRIPTION
202: "Number of packets discarded due to being received on a
203: non-CARP interface."
204: ::= { carpStats 3 }
205:
206: carpPktDiscardsForWrongTtl OBJECT-TYPE
207: SYNTAX Counter64
208: MAX-ACCESS read-only
209: STATUS current
210: DESCRIPTION
211: "Number of packets discarded due to having a TTL less
212: than 255."
213: ::= { carpStats 4 }
214:
215: carpPktShorterThanHeader OBJECT-TYPE
216: SYNTAX Counter64
217: MAX-ACCESS read-only
218: STATUS current
219: DESCRIPTION
220: "Number of packets received on any interface that is
221: shorter than the size of the CARP packet header."
222: ::= { carpStats 5 }
223:
224: carpPktDiscardsForBadChecksum OBJECT-TYPE
225: SYNTAX Counter64
226: MAX-ACCESS read-only
227: STATUS current
228: DESCRIPTION
229: "Number of packets discarded due to bad checksum."
230: ::= { carpStats 6 }
231:
232: carpPktDiscardsForBadVersion OBJECT-TYPE
233: SYNTAX Counter64
234: MAX-ACCESS read-only
235: STATUS current
236: DESCRIPTION
237: "Number of packets discarded due to bad version in
238: the packet header."
239: ::= { carpStats 7 }
240:
241: carpPktDiscardsForTooShort OBJECT-TYPE
242: SYNTAX Counter64
243: MAX-ACCESS read-only
244: STATUS current
245: DESCRIPTION
246: "Number of packets discarded due to being too short."
247: ::= { carpStats 8 }
248:
249: carpPktDiscardsForBadAuth OBJECT-TYPE
250: SYNTAX Counter64
251: MAX-ACCESS read-only
252: STATUS current
253: DESCRIPTION
254: "Number of packets discarded because they failed the
255: HMAC authentication check."
256: ::= { carpStats 9 }
257:
258: carpPktDiscardsForBadVhid OBJECT-TYPE
259: SYNTAX Counter64
260: MAX-ACCESS read-only
261: STATUS current
262: DESCRIPTION
263: "Number of packets discarded due to incorrect VHID in
264: the packet header."
265: ::= { carpStats 10 }
266:
267: carpPktDiscardsForBadAddressList OBJECT-TYPE
268: SYNTAX Counter64
269: MAX-ACCESS read-only
270: STATUS current
271: DESCRIPTION
272: "Number of packets discarded due to bad addresses in
273: the CARP packet."
274: ::= { carpStats 11 }
275:
276: carpIpPktsSent OBJECT-TYPE
277: SYNTAX Counter64
278: MAX-ACCESS read-only
279: STATUS current
280: DESCRIPTION
281: "Number of IPv4 CARP packets sent on all interfaces."
282: ::= { carpStats 12 }
283:
284: carpIp6PktsSent OBJECT-TYPE
285: SYNTAX Counter64
286: MAX-ACCESS read-only
287: STATUS current
288: DESCRIPTION
289: "Number of IPv6 CARP packets sent on all interfaces."
290: ::= { carpStats 13 }
291:
292: carpNoMemory OBJECT-TYPE
293: SYNTAX Counter64
294: MAX-ACCESS read-only
295: STATUS current
296: DESCRIPTION
297: "Number of CARP advertisements that failed because memory
298: could not be allocated."
299: ::= { carpStats 14 }
300:
301: carpTransitionsToMaster OBJECT-TYPE
302: SYNTAX Counter64
303: MAX-ACCESS read-only
304: STATUS current
305: DESCRIPTION
306: "Number of times the host has transitioned to MASTER state
307: for any CARP group."
308: ::= { carpStats 15 }
309:
310: END
311: