mibs/ietf/DIFFSERV-CONFIG-MIB

   1 DIFFSERV-CONFIG-MIB DEFINITIONS ::= BEGIN
   2     IMPORTS
   3
   4     OBJECT-TYPE, MODULE-IDENTITY,
   5     zeroDotZero, mib-2            FROM SNMPv2-SMI          -- [RFC2578]
   6
   7     RowStatus, StorageType,
   8     RowPointer, DateAndTime       FROM SNMPv2-TC           -- [RFC2579]
   9
  10     MODULE-COMPLIANCE,
  11     OBJECT-GROUP                  FROM SNMPv2-CONF         -- [RFC2580]
  12
  13
  14
  15
  16     SnmpAdminString               FROM SNMP-FRAMEWORK-MIB; -- [RFC3411]
  17
  18 diffServConfigMib MODULE-IDENTITY
  19     LAST-UPDATED "200401220000Z" -- 22 January 2004
  20     ORGANIZATION "SNMPCONF WG"
  21     CONTACT-INFO
  22        "SNMPCONF Working Group
  23         http://www.ietf.org/html.charters/snmpconf-charter.html
  24         WG mailing list: snmpconf@snmp.com
  25
  26         Editors:
  27         Harrie Hazewinkel
  28         I.Net
  29         via Darwin 85
  30         20019 - Settimo Milanese (MI)
  31         Italy
  32         EMail: harrie@inet.it
  33
  34         David Partain
  35         Ericsson AB
  36         P.O. Box 1248
  37         SE-581 12 Linkoping
  38         Sweden
  39         E-mail: David.Partain@ericsson.com"
  40     DESCRIPTION
  41         "This MIB module contains differentiated services
  42         specific managed objects to perform higher-level
  43         configuration management.  This MIB allows policies
  44         to use 'templates' to instantiate Differentiated
  45         Services functional datapath configurations to
  46         be assigned (associated with an interface and
  47         direction) when a policy is activated.
  48
  49         Copyright (C) The Internet Society (2004).  This version
  50         of this MIB module is part of RFC 3747;  see the RFC
  51         itself for full legal notices."
  52     REVISION "200401220000Z" -- 22 January 2004
  53     DESCRIPTION
  54         "Initial version published as RFC 3747"
  55     ::= { mib-2 108 }
  56
  57 diffServConfigMIBObjects OBJECT IDENTIFIER ::= { diffServConfigMib 1 }
  58 diffServConfigMIBConformance OBJECT IDENTIFIER ::=
  59                                                { diffServConfigMib 2 }
  60
  61 --
  62 -- The Differentiated Services configuration objects
  63 --
  64
  65
  66
  67 diffServConfigTable OBJECT-TYPE
  68     SYNTAX       SEQUENCE OF DiffServConfigEntry
  69     MAX-ACCESS   not-accessible
  70     STATUS       current
  71     DESCRIPTION
  72        "A table which defines the various per-hop-behaviors
  73        for which the system has default 'templates'."
  74     ::= { diffServConfigMIBObjects 2 }
  75
  76 diffServConfigEntry OBJECT-TYPE
  77     SYNTAX       DiffServConfigEntry
  78     MAX-ACCESS   not-accessible
  79     STATUS       current
  80     DESCRIPTION
  81        "An entry defining a per-hop-behavior.  Each entry in
  82        this table combines the various parameters (entries)
  83        into a specific per-hop-behavior.  Entries in this
  84        table might be defined by a vendor (pre-configured)
  85        or defined by a management application."
  86     INDEX { diffServConfigId }
  87     ::= { diffServConfigTable 1 }
  88
  89 DiffServConfigEntry ::= SEQUENCE {
  90     diffServConfigId           SnmpAdminString,
  91     diffServConfigDescr        SnmpAdminString,
  92     diffServConfigOwner        SnmpAdminString,
  93     diffServConfigLastChange   DateAndTime,
  94     diffServConfigStart        RowPointer,
  95     diffServConfigStorage      StorageType,
  96     diffServConfigStatus       RowStatus
  97 }
  98
  99 diffServConfigId OBJECT-TYPE
 100     SYNTAX         SnmpAdminString (SIZE(1..116))
 101     MAX-ACCESS     not-accessible
 102     STATUS         current
 103     DESCRIPTION
 104       "A unique id for the per-hop-behavior policy for at
 105        least the SNMP agent.  For ease of administration the
 106        value may be unique within an administrative domain,
 107        but this is not required.
 108
 109        The range of up to 116 octets is chosen to stay within
 110        the SMI limit of 128 sub-identifiers in an object
 111        identifier."
 112     ::= { diffServConfigEntry 1 }
 113
 114 diffServConfigDescr OBJECT-TYPE
 115
 116
 117
 118     SYNTAX         SnmpAdminString
 119     MAX-ACCESS     read-create
 120     STATUS         current
 121     DESCRIPTION
 122        "A human-readable description to identify this defined
 123        per-hop-behavior.  Note that this is an SnmpAdminString,
 124        which permits UTF-8 strings.  An administratively assigned
 125        identifier for a template that would be unique within
 126        an administrative domain.  It is up to the management
 127        applications to agree how these are assigned within the
 128        administrative domain.  Once a description, such as
 129        'EF' is assigned, that has a certain set of parameters
 130        that achieve 'EF' from box to box. Management
 131        application code or script code can then scan
 132        the table to find the proper template and then
 133        assign it."
 134     ::= { diffServConfigEntry 2 }
 135
 136 diffServConfigOwner OBJECT-TYPE
 137     SYNTAX         SnmpAdminString
 138     MAX-ACCESS     read-create
 139     STATUS         current
 140     DESCRIPTION
 141        "The owner who created this entry."
 142     ::= { diffServConfigEntry 3 }
 143
 144 diffServConfigLastChange OBJECT-TYPE
 145     SYNTAX         DateAndTime
 146     MAX-ACCESS     read-only
 147     STATUS         current
 148     DESCRIPTION
 149        "The date and time when this entry was last changed."
 150     ::= { diffServConfigEntry 4 }
 151
 152 diffServConfigStart OBJECT-TYPE
 153     SYNTAX         RowPointer
 154     MAX-ACCESS     read-create
 155     STATUS         current
 156     DESCRIPTION
 157        "The pointer to a functional datapath configuration template as
 158        set up in the DIFFSERV-MIB.  This RowPointer should
 159        point to an instance of one of:
 160          diffServClfrEntry
 161          diffServMeterEntry
 162          diffServActionEntry
 163          diffServAlgDropEntry
 164          diffServQEntry
 165
 166
 167
 168
 169        A value of zeroDotZero in this attribute indicates no
 170        further Diffserv treatment is performed on traffic of
 171        this functional datapath.  This also means that the
 172        template described by this row is not defined.
 173
 174        If the row pointed to does not exist, the treatment
 175        is as if this attribute contains a value of zeroDotZero."
 176     REFERENCE
 177        "Differentiated Services MIB module"
 178     DEFVAL { zeroDotZero }
 179     ::= { diffServConfigEntry 5 }
 180
 181 diffServConfigStorage OBJECT-TYPE
 182     SYNTAX         StorageType
 183     MAX-ACCESS     read-create
 184     STATUS         current
 185     DESCRIPTION
 186        "The type of storage used for this row.
 187
 188        Since an entry in this table serves as a starting
 189        point for a configuration, it is recommended that
 190        all entries comprising the configuration started by
 191        diffServConfigStart follow the storage type of this
 192        entry.  Otherwise, after agent reboots a configuration
 193        may differ.  It may very well be that the agent is
 194        not capable of detecting such changes and therefore,
 195        the management application should verify the correct
 196        configuration after a reboot.  Rows with a StorageType
 197        of 'permanent' do not need to allow write access to
 198        any of the columnar objects in that row."
 199     DEFVAL { nonVolatile }
 200     ::= { diffServConfigEntry 6 }
 201
 202 diffServConfigStatus OBJECT-TYPE
 203     SYNTAX         RowStatus
 204     MAX-ACCESS     read-create
 205     STATUS         current
 206     DESCRIPTION
 207        "RowStatus object used for creation and deletion of
 208        rows in this table.  All writable objects in this row
 209        may be modified at any time."
 210     DEFVAL { notInService }
 211     ::= { diffServConfigEntry 7 }
 212
 213 --
 214 -- MIB Compliance statements.
 215 --
 216
 217
 218
 219
 220 diffServConfigMIBCompliances
 221    OBJECT IDENTIFIER ::= { diffServConfigMIBConformance 1 }
 222 diffServConfigMIBGroups
 223    OBJECT IDENTIFIER ::= { diffServConfigMIBConformance 2 }
 224
 225 diffServConfigMIBFullCompliance MODULE-COMPLIANCE
 226     STATUS       current
 227     DESCRIPTION
 228        "The full compliance for this MIB module.
 229
 230        For this compliance level the 'diffServMIBFullCompliance'
 231        must be met, since this MIB module depends on it in order
 232        to provide the configuration entries.
 233        "
 234     MODULE  -- This module
 235     MANDATORY-GROUPS {  diffServConfigMIBConfigGroup }
 236
 237     OBJECT diffServConfigStatus
 238     SYNTAX RowStatus { active(1) }
 239     WRITE-SYNTAX RowStatus { createAndGo(4), destroy(6) }
 240     DESCRIPTION
 241        "Support for createAndWait and notInService is not required."
 242
 243     ::= { diffServConfigMIBCompliances 1 }
 244
 245 diffServConfigMIBConfigGroup OBJECT-GROUP
 246     OBJECTS {  diffServConfigDescr,
 247                diffServConfigOwner,
 248                diffServConfigLastChange,
 249                diffServConfigStart,
 250                diffServConfigStorage,
 251                diffServConfigStatus
 252     }
 253     STATUS current
 254     DESCRIPTION
 255        "The per-hop-behavior Group defines the MIB objects that
 256        describe the configuration template for the per-hop-behavior."
 257     ::= { diffServConfigMIBGroups 1 }
 258 END