smilint output for ./SIP-REGISTRAR-MIB
| Message Severities |
|---|
| Severity | Count |
|---|
| severe | 2 |
| Message Types |
|---|
| Type | Count |
|---|
| internal-other (severe) | 1 |
| lexical (severe) | 1 |
Messages:
SIP-REGISTRAR-MIB
1: -- extracted from draft-ietf-sip-mib-01.txt
2: -- at Sat Jul 15 07:08:00 2000
3:
4: SIP-REGISTRAR-MIB DEFINITIONS ::= BEGIN
5:
6: IMPORTS
7: MODULE-IDENTITY,
8: OBJECT-TYPE,
9: Counter32,
10: Gauge32,
11: Unsigned32
12: FROM SNMPv2-SMI
13:
14: DateAndTime,
15: RowStatus,
16: TimeStamp,
17: TruthValue
18: FROM SNMPv2-TC
19:
20: Lingle/Maeng/Walker 61
20: severe -
lexically unexpected character, skipping to end of line
21: Internet Draft SIP-MIB July, 2000
21: severe -
syntax error, unexpected UPPERCASE_IDENTIFIER, expecting FROM or ','
22:
23:
24: MODULE-COMPLIANCE,
25: OBJECT-GROUP
26: FROM SNMPv2-CONF
27:
28: SnmpAdminString
29: FROM SNMP-FRAMEWORK-MIB
30:
31: SipServerActions
32: FROM SIP-TC
33:
34: sipMIB
35: FROM SIP-MIB-SMI
36:
37: applIndex
38: FROM NETWORK-SERVICES-MIB;
39:
40: sipRegistrarMIB MODULE-IDENTITY
41: LAST-UPDATED "200007080000Z"
42: ORGANIZATION "IETF SIP Working Group, SIP MIB Team"
43: CONTACT-INFO
44: "SIP MIB Team email: sip-mib@egroups.com
45:
46: Co-editor Kevin Lingle
47: Cisco Systems, Inc.
48: postal: 7025 Kit Creek Road
49: P.O. Box 14987
50: Research Triangle Park, NC 27709
51: USA
52: email: klingle@cisco.com
53: phone: +1-919-392-2029
54:
55: Co-editor Joon Maeng
56: VTEL Corporation
57: postal: 108 Wild Basin Rd.
58: Austin, TX 78746
59: USA
60: email: joon_maeng@vtel.com
61: phone: +1-512-437-4567
62:
63: Co-editor Dave Walker
64: SS8 Networks, Inc.
65: postal: 80 Hines Road
66: Kanata, ON K2K 2T8
67: Canada
68: email: drwalker@ss8networks.com
69: phone: +1 613 592 2100"
70: DESCRIPTION
71: "Initial version of Session Initiation Protocol (SIP)
72: Registrar MIB module.
73:
74: SIP is an application-layer signalling protocol for
75: creating, modifying and terminating multimedia
76: sessions with one or more participants. These sessions
77:
78: Lingle/Maeng/Walker 62
79: Internet Draft SIP-MIB July, 2000
80:
81: include Internet multimedia conferences and Internet
82: telephone calls. SIP is defined in RFC 2543 (March
83: 1999).
84:
85: A Registrar is a server that accepts REGISTER
86: requests. A Registrar is typically co-located with a
87: Proxy or Redirect Server."
88: ::= { sipMIB 5 }
89:
90:
91: --
92: -- sipReg group
93: -- This group contains MIB objects related to SIP Registrars.
94: --
95: sipRegCfg OBJECT IDENTIFIER ::= { sipRegistrarMIB 1 }
96: sipRegStats OBJECT IDENTIFIER ::= { sipRegistrarMIB 2 }
97:
98:
99: --
100: -- Registrar Configuration
101: --
102: sipRegCfgTable OBJECT-TYPE
103: SYNTAX SEQUENCE OF SipRegCfgEntry
104: MAX-ACCESS not-accessible
105: STATUS current
106: DESCRIPTION
107: "This table contains configuration objects applicable
108: SIP registrars. Each row represents those objects
109: for a particular SIP registrar present in this system.
110: The instances of SIP registrars are uniquely identified
111: by applIndex."
112: ::= { sipRegCfg 1 }
113:
114: sipRegCfgEntry OBJECT-TYPE
115: SYNTAX SipRegCfgEntry
116: MAX-ACCESS not-accessible
117: STATUS current
118: DESCRIPTION
119: "A row of common configuration."
120: INDEX { applIndex }
121: ::= { sipRegCfgTable 1 }
122:
123: SipRegCfgEntry ::=
124: SEQUENCE {
125: sipRegAllowThirdParty TruthValue,
126: sipRegContactDfltExpiryDuration Unsigned32,
127: sipRegContactDfltExpiryDate DateAndTime,
128: sipRegMaxContactExpiryDate Unsigned32,
129: sipRegRespHasContacts TruthValue,
130: sipRegMaxUsers Unsigned32,
131: sipRegCurrentUsers Gauge32
132: }
133:
134: sipRegAllowThirdParty OBJECT-TYPE
135:
136: Lingle/Maeng/Walker 63
137: Internet Draft SIP-MIB July, 2000
138:
139: SYNTAX TruthValue
140: MAX-ACCESS read-write
141: STATUS current
142: DESCRIPTION
143: "This object specifies whether or not the Registrar should
144: allows third party registrations. In third-party
145: registration, the entity issuing the request (in the From
146: header) is different from the entity being registered (in
147: the To header) to whom the
148: provided Contact information applies.
149:
150: If the value of this object is TRUE, the Registrar allows
151: third party registrations. If the value is FALSE, third
152: party registrations are rejected: a 403 Forbidden status
153: code is returned to the requestor."
154: REFERENCE
155: "RFC 2543, Section 4.2.6"
156: ::= { sipRegCfgEntry 1 }
157:
158: sipRegContactDfltExpiryDuration OBJECT-TYPE
159: SYNTAX Unsigned32
160: UNITS "seconds"
161: MAX-ACCESS read-write
162: STATUS current
163: DESCRIPTION
164: "This object specifies the default expiration (time-to-
165: live) of Contact information that is provided by User
166: Agents when registering with this Registrar. This value
167: is only used when no expiration has been specified by the
168: user in the REGISTER
169: request.
170:
171: If the value is applied to a registration and is different
172: from the default (one hour), the server must return the
173: value to the registered User Agent.
174:
175: The value contained in this object only applies if the
176: value of the sipContactDfltExpiryDate object is NULL. If
177: the value of this object applies, and is zero, then no
178: default expiry is applied to registered contact
179: information."
180: REFERENCE
181: "RFC 2543, Section 4.2.6"
182: DEFVAL { 3600 }
183: ::= { sipRegCfgEntry 2 }
184:
185: sipRegContactDfltExpiryDate OBJECT-TYPE
186: SYNTAX DateAndTime
187: MAX-ACCESS read-write
188: STATUS current
189: DESCRIPTION
190: "This object specifies the default expiration date (time-
191: to-live) of Contact information that is provided by User
192: Agents when registering with this Registrar. This value
193:
194: Lingle/Maeng/Walker 64
195: Internet Draft SIP-MIB July, 2000
196:
197: is only used when no expiration has been specified by the
198: user in the REGISTER request.
199:
200: If this value is applied to a registration, the server
201: must return the value to the registered User Agent.
202:
203: The value contained in this object only applies if the
204: value of the sipContactDfltExpiryDuration object is zero.
205: If the value of this object applies, and is NULL, then no
206: default expiry is applied to
207: registered contact information."
208: REFERENCE
209: "RFC 2543, Section 4.2.6"
210: ::= { sipRegCfgEntry 3 }
211:
212: sipRegMaxContactExpiryDate OBJECT-TYPE
213: SYNTAX Unsigned32 (0..4294967295)
214: UNITS "seconds"
215: MAX-ACCESS read-write
216: STATUS current
217: DESCRIPTION
218: "This object specifies the maximum expiry that may be
219: requested by a User Agent for a particular Contact. User
220: Agents can specify expiry using either an Expiry header in
221: a REGISTER request, or using an Expires parameter in a
222: Contact header in a REGISTER request. If the value
223: requested by the User Agent is greater than the value of
224: this object, then the contact information is given the
225: duration specified by this object, and that duration
226: is indicated to the User Agent in the response."
227: DEFVAL { 4294967295 }
228: ::= { sipRegCfgEntry 4 }
229:
230: sipRegRespHasContacts OBJECT-TYPE
231: SYNTAX TruthValue
232: MAX-ACCESS read-write
233: STATUS current
234: DESCRIPTION
235: "This object specifies whether or not the Registrar should
236: return all currently reachable locations for a
237: successfully registering party in the REGISTER response
238: message.
239:
240: If the value of this object is TRUE, the Registrar returns
241: the locations in the REGISTER response. If the value is
242: FALSE, no location information is provided."
243: ::= { sipRegCfgEntry 5 }
244:
245: sipRegMaxUsers OBJECT-TYPE
246: SYNTAX Unsigned32 (1..4294967295)
247: MAX-ACCESS read-only
248: STATUS current
249: DESCRIPTION
250: "This object specifies the maximum number of users that the
251:
252: Lingle/Maeng/Walker 65
253: Internet Draft SIP-MIB July, 2000
254:
255: registrar supports. The current number of users is
256: reflected by sipRegCurrentUsers."
257: ::= { sipRegCfgEntry 6 }
258:
259: sipRegCurrentUsers OBJECT-TYPE
260: SYNTAX Gauge32 (0..4294967295)
261: MAX-ACCESS read-only
262: STATUS current
263: DESCRIPTION
264: "This object specifies the number of users currently
265: configured on the registrar."
266: ::= { sipRegCfgEntry 7 }
267:
268: --
269: -- Per User Information
270: --
271: sipRegUserTable OBJECT-TYPE
272: SYNTAX SEQUENCE OF SipRegUserEntry
273: MAX-ACCESS not-accessible
274: STATUS current
275: DESCRIPTION
276: "This table contains information on all users registered to
277: each Registrar in this system. The instances of SIP
278: Registrar are uniquely identified by applIndex."
279: ::= { sipRegCfg 2 }
280:
281: sipRegUserEntry OBJECT-TYPE
282: SYNTAX SipRegUserEntry
283: MAX-ACCESS not-accessible
284: STATUS current
285: DESCRIPTION
286: "This entry contains information for a single user
287: registered to this Registrar."
288: INDEX { applIndex, sipUserIndex }
289: ::= { sipRegUserTable 1 }
290:
291: SipRegUserEntry ::=
292: SEQUENCE {
293: sipUserIndex Unsigned32,
294: sipUserUri SnmpAdminString,
295: sipUserPassword OCTET STRING,
296: sipUserAuthenticationFailures Counter32,
297: sipUserTableRowStatus RowStatus
298: }
299:
300: sipUserIndex OBJECT-TYPE
301: SYNTAX Unsigned32 (1..4294967295)
302: MAX-ACCESS not-accessible
303: STATUS current
304: DESCRIPTION
305: "This object uniquely identifies a conceptual row in the
306: table."
307: ::= { sipRegUserEntry 1 }
308:
309:
310: Lingle/Maeng/Walker 66
311: Internet Draft SIP-MIB July, 2000
312:
313: sipUserUri OBJECT-TYPE
314: SYNTAX SnmpAdminString
315: MAX-ACCESS read-create
316: STATUS current
317: DESCRIPTION
318: "This object contains the user's address-of-record. It is
319: the main form by which the registrar knows the user. The
320: format is typically 'user@domain'. It is contained in the
321: To header for all REGISTER requests."
322: ::= { sipRegUserEntry 2 }
323:
324: sipUserPassword OBJECT-TYPE
325: SYNTAX OCTET STRING (SIZE(0..255))
326: MAX-ACCESS read-create
327: STATUS current
328: DESCRIPTION
329: "This object specifies the password that the user must
330: enter when being authenticated."
331: ::= { sipRegUserEntry 3 }
332:
333: sipUserAuthenticationFailures OBJECT-TYPE
334: SYNTAX Counter32
335: MAX-ACCESS read-only
336: STATUS current
337: DESCRIPTION
338: "This object contains a count of the number of times the
339: user has failed authentication."
340: ::= { sipRegUserEntry 4 }
341:
342: sipUserTableRowStatus OBJECT-TYPE
343: SYNTAX RowStatus
344: MAX-ACCESS read-create
345: STATUS current
346: DESCRIPTION
347: "The row status of the entry. This object is required
348: to create or delete rows remotely by a manager."
349: ::= { sipRegUserEntry 5 }
350:
351: --
352: -- Per Contact Information
353: --
354: sipContactTable OBJECT-TYPE
355: SYNTAX SEQUENCE OF SipContactEntry
356: MAX-ACCESS not-accessible
357: STATUS current
358: DESCRIPTION
359: "This table contains information on every location where a
360: registered user (specified by sipUserIndex) wishes to be
361: found (i.e. has provided Contact information) to each SIP
362: Registrar in this system.
363:
364: The instances of SIP Registrar are uniquely identified by
365: applIndex."
366: ::= { sipRegCfg 3 }
367:
368: Lingle/Maeng/Walker 67
369: Internet Draft SIP-MIB July, 2000
370:
371:
372: sipContactEntry OBJECT-TYPE
373: SYNTAX SipContactEntry
374: MAX-ACCESS not-accessible
375: STATUS current
376: DESCRIPTION
377: "This entry contains information for a single Contact.
378: Multiple contacts may exist for a single user."
379: INDEX { applIndex, sipUserIndex, sipContactIndex }
380: ::= { sipContactTable 1 }
381:
382: SipContactEntry ::=
383: SEQUENCE {
384: sipContactIndex Unsigned32,
385: sipContactDisplayName SnmpAdminString,
386: sipContactURI SnmpAdminString,
387: sipContactLastUpdated TimeStamp,
388: sipContactExpiry DateAndTime,
389: sipContactAction SipServerActions,
390: sipContactPreference OCTET STRING,
391: sipContactRetryAfter DateAndTime
392: }
393:
394: sipContactIndex OBJECT-TYPE
395: SYNTAX Unsigned32 (1..4294967295)
396: MAX-ACCESS not-accessible
397: STATUS current
398: DESCRIPTION
399: "Along with the sipUserIndex, this object uniquely
400: identifies a conceptual row in the table."
401: ::= { sipContactEntry 1 }
402:
403: sipContactDisplayName OBJECT-TYPE
404: SYNTAX SnmpAdminString
405: MAX-ACCESS read-only
406: STATUS current
407: DESCRIPTION
408: "This object contains the display name for the Contact.
409: For example, 'Santa at Home', or 'Santa on his Sled',
410: corresponding to contact URLs of
411: sip:BigGuy@sip.northpole.ca or
412: sip:sclaus817@sip.mobile.com, respectively."
413: ::= { sipContactEntry 2 }
414:
415: sipContactURI OBJECT-TYPE
416: SYNTAX SnmpAdminString
417: MAX-ACCESS read-only
418: STATUS current
419: DESCRIPTION
420: "This object contains either a SIP URL or a URI where the
421: user can be contacted. This URI is normally returned to a
422: client from a redirect server, or is used as the
423: RequestURI in a SIP request line for requests forwarded by
424: a proxy."
425:
426: Lingle/Maeng/Walker 68
427: Internet Draft SIP-MIB July, 2000
428:
429: ::= { sipContactEntry 3 }
430:
431: sipContactLastUpdated OBJECT-TYPE
432: SYNTAX TimeStamp
433: MAX-ACCESS read-only
434: STATUS current
435: DESCRIPTION
436: "This object indicates the time when this contact
437: information was accepted. If the contact information is
438: updated via a subsequent REGISTER of the same information,
439: this object is also updated."
440: ::= { sipContactEntry 4 }
441:
442: sipContactExpiry OBJECT-TYPE
443: SYNTAX DateAndTime
444: MAX-ACCESS read-only
445: STATUS current
446: DESCRIPTION
447: "This object contains the date and time when the contact
448: information will no longer be valid. Such times may be
449: specified by the user at registration (Expires header or
450: expiry parameter in the Contact information), or a system
451: default can be applied."
452: ::= { sipContactEntry 5 }
453:
454: sipContactPreference OBJECT-TYPE
455: SYNTAX OCTET STRING (SIZE(0..255))
456: MAX-ACCESS read-only
457: STATUS current
458: DESCRIPTION
459: "This object specifies the preference for this contact
460: relative to all other active contacts for same user. A
461: registering user may provide this preference as a 'qvalue'
462: parameter in the Contact header.
463:
464: The format of this item is a decimal number between 0
465: and 1 (for example 0.9). Higher values indicate locations
466: preferred by the user."
467: REFERENCE
468: "RFC 2543, Section 6.13"
469: ::= { sipContactEntry 6 }
470:
471: sipContactAction OBJECT-TYPE
472: SYNTAX SipServerActions
473: MAX-ACCESS read-only
474: STATUS current
475: DESCRIPTION
476: "This object indicates whether the user wanted the server
477: to act as a redirect server or as a proxy server. It is
478: specified by the optional 'action' parameter in the
479: Contact header."
480: ::= { sipContactEntry 7 }
481:
482: sipContactRetryAfter OBJECT-TYPE
483:
484: Lingle/Maeng/Walker 69
485: Internet Draft SIP-MIB July, 2000
486:
487: SYNTAX DateAndTime
488: MAX-ACCESS read-only
489: STATUS current
490: DESCRIPTION
491: "This object indicates that the contact information is
492: currently inactive, and that it should only be activated
493: after the date and time specified by the object. This
494: value is provided by a user when deleting contact
495: information using a REGISTER request containing a Retry-
496: After header."
497: REFERENCE
498: "RFC 2543, Section 6.32"
499: ::= { sipContactEntry 8 }
500:
501:
502:
503:
504: --
505: -- Registrar Statistics
506: --
507: sipRegStatsTable OBJECT-TYPE
508: SYNTAX SEQUENCE OF SipRegStatsEntry
509: MAX-ACCESS not-accessible
510: STATUS current
511: DESCRIPTION
512: "This table contains the summary statistics objects
513: applicable to all SIP Registrars in this system.
514: Each row represents those objects for a particular
515: SIP Registrar. The instances of SIP Registrars are
516: uniquely identified by applIndex."
517: ::= { sipRegStats 1 }
518:
519: sipRegStatsEntry OBJECT-TYPE
520: SYNTAX SipRegStatsEntry
521: MAX-ACCESS not-accessible
522: STATUS current
523: DESCRIPTION
524: "A row of summary statistics."
525: INDEX { applIndex }
526: ::= { sipRegStatsTable 1 }
527:
528: SipRegStatsEntry ::=
529: SEQUENCE {
530: sipRegAcceptedRegistrations Counter32,
531: sipRegRejectedRegistrations Counter32
532: }
533:
534: sipRegAcceptedRegistrations OBJECT-TYPE
535: SYNTAX Counter32
536: MAX-ACCESS read-only
537: STATUS current
538: DESCRIPTION
539: "This object contains a count of the number of REGISTER
540: requests that have been accepted (status code 200) by the
541:
542: Lingle/Maeng/Walker 70
543: Internet Draft SIP-MIB July, 2000
544:
545: Registrar. This includes additions of new contact
546: information, refreshing contact information, as well as
547: requests for deletion of contact information."
548: ::= { sipRegStatsEntry 1 }
549:
550: sipRegRejectedRegistrations OBJECT-TYPE
551: SYNTAX Counter32
552: MAX-ACCESS read-only
553: STATUS current
554: DESCRIPTION
555: "This object contains a count of the number REGISTER
556: requests that have been rejected by the Registrar."
557: ::= { sipRegStatsEntry 2 }
558:
559:
560: --
561: -- Notifications
562: --
563: sipRegMIBNotif OBJECT IDENTIFIER ::= { sipRegistrarMIB 3 }
564:
565: -- none at this time
566:
567:
568:
569: --
570: -- Conformance
571: --
572: sipRegMIBConformance
573: OBJECT IDENTIFIER ::= { sipRegistrarMIB 4 }
574: sipRegMIBCompliances
575: OBJECT IDENTIFIER ::= { sipRegMIBConformance 1 }
576: sipRegMIBGroups
577: OBJECT IDENTIFIER ::= { sipRegMIBConformance 2 }
578:
579:
580: --
581: -- Compliance Statements
582: --
583: sipRegCompliance MODULE-COMPLIANCE
584: STATUS current
585: DESCRIPTION
586: "The compliance statement for SIP entities."
587:
588: MODULE -- this module
589: MANDATORY-GROUPS { sipRegistrarConfigGroup,
590: sipRegistrarStatsGroup }
591: -- sipRegistrarNotifGroup }
592:
593: ::= { sipRegMIBCompliances 1 }
594:
595:
596: sipRegistrarConfigGroup OBJECT-GROUP
597: OBJECTS {
598: sipRegAllowThirdParty,
599:
600: Lingle/Maeng/Walker 71
601: Internet Draft SIP-MIB July, 2000
602:
603: sipRegContactDfltExpiryDuration,
604: sipRegContactDfltExpiryDate,
605: sipRegMaxContactExpiryDate,
606: sipRegRespHasContacts,
607: sipRegMaxUsers,
608: sipRegCurrentUsers,
609: sipUserUri,
610: sipUserPassword,
611: sipUserAuthenticationFailures,
612: sipUserTableRowStatus,
613: sipContactDisplayName,
614: sipContactURI,
615: sipContactLastUpdated,
616: sipContactExpiry,
617: sipContactPreference,
618: sipContactAction,
619: sipContactRetryAfter
620: }
621: STATUS current
622: DESCRIPTION
623: "A collection of objects providing configuration for
624: SIP Registrars."
625: ::= { sipRegMIBGroups 1 }
626:
627: sipRegistrarStatsGroup OBJECT-GROUP
628: OBJECTS {
629: sipRegAcceptedRegistrations,
630: sipRegRejectedRegistrations
631: }
632: STATUS current
633: DESCRIPTION
634: "A collection of objects providing statistics for
635: SIP Registrars."
636: ::= { sipRegMIBGroups 2 }
637:
638: --sipRegistrarNotifGroup NOTIFICATION-GROUP
639: -- OBJECTS {
640: -- none at this time
641: -- }
642: -- STATUS current
643: -- DESCRIPTION
644: -- "A collection of notifications defined for SIP
645: -- Registrars."
646: -- ::= { sipRegMIBGroups 3 }
647:
648: END
649:
650: --
651: --
652: --
653: --
654: -- Lingle/Maeng/Walker 73
655: -- Internet Draft SIP-MIB July, 2000
656: --
657: -- Copyright(C) The Internet Society (2000). All Rights Reserved. This
658: -- document and translations of it may be copied and furnished to
659: -- others, and derivative works that comment on or otherwise explain it
660: -- or assist in its implementation may be prepared, copied, published
661: -- and distributed, in whole or in part, without restriction of any
662: -- kind, provided that the above copyright notice and this paragraph
663: -- are included on all such copies and derivative works. However, this
664: -- document itself may not be modified in any way, such as by removing
665: -- the copyright notice or references to the Internet Society or other
666: -- Internet organizations, except as needed for the purpose of
667: -- developing Internet standards in which case the procedures for
668: -- copyrights defined in the Internet Standards process must be
669: -- followed, or as required to translate it into languages other than
670: -- English.
671: --
672: -- The limited permissions granted above are perpetual and will not be
673: -- revoked by the Internet Society or its successors or assigns.
674: --
675: -- This document and the information contained herein is provided on an
676: -- "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING
677: -- TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING
678: -- BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION
679: -- HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF
680: -- MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
681: --
682: