mibs/tubs/POLICY-DEVICE-AUX-MIB-orig

   1 POLICY-DEVICE-AUX-MIB DEFINITIONS ::= BEGIN
   2
   3
   4 IMPORTS
   5         MODULE-IDENTITY, OBJECT-TYPE, experimental
   6                                              FROM SNMPv2-SMI
   7         MODULE-COMPLIANCE, OBJECT-GROUP      FROM SNMPv2-CONF
   8         TEXTUAL-CONVENTION, RowStatus, StorageType
   9                                              FROM SNMPv2-TC
  10         SnmpAdminString                      FROM SNMP-FRAMEWORK-MIB
  11         InterfaceIndex                       FROM IF-MIB;
  12
  13
  14 policyDeviceAuxMib MODULE-IDENTITY
  15         LAST-UPDATED    "200007121800Z" -- 12 July 2000
  16         ORGANIZATION    "IETF RAP WG"
  17         CONTACT-INFO
  18                  "Kwok Ho Chan
  19                   Nortel Networks, Inc.
  20                   600 Technology Park Drive
  21                   Billerica, MA 01821 USA
  22                   Phone: +1 978 288 8175
  23                   Email: khchan@nortelnetworks.com
  24
  25                   John Seligson
  26                   Nortel Networks, Inc.
  27                   4401 Great America Parkway
  28                   Santa Clara, CA USA 95054
  29                   Phone: +1 408 495-2992
  30                   Email: jseligso@nortelnetworks.com
  31
  32                   Keith McCloghrie
  33                   Cisco Systems, Inc.
  34                   170 West Tasman Drive,
  35                   San Jose, CA 95134-1706 USA
  36                   Phone: +1 408 526 5260
  37                   Email: kzm@cisco.com"
  38         DESCRIPTION
  39             "This module defines an infrastructure used
  40             for support of policy-based provisioning of
  41             a network device."
  42         ::= { experimental 999 }
  43
  44
  45
  46 policyDeviceAuxObjects     OBJECT IDENTIFIER ::= { policyDeviceAuxMib 1 }
  47 policyDeviceAuxConformance OBJECT IDENTIFIER ::= { policyDeviceAuxMib 2 }
  48
  49
  50 policyDeviceConfig    OBJECT IDENTIFIER ::= { policyDeviceAuxObjects 1 }
  51
  52 Role ::= TEXTUAL-CONVENTION
  53     STATUS       current
  54     DESCRIPTION
  55         "A role represents a functionality characteristic or
  56         capability of a resource to which policies are applied.
  57         Examples of roles include Backbone interface, Frame Relay
  58         interface, BGP-capable router, web server, firewall, etc.
  59
  60         Valid characters are a-z, A-Z, 0-9, period, hyphen and
  61         underscore.  A role must not start with an underscore."
  62     REFERENCE
  63         "Policy Core Information Model,
  64         draft-ietf-policy-core-info-model-06.txt"
  65     SYNTAX SnmpAdminString  (SIZE (1..31))
  66
  67 RoleCombination ::= TEXTUAL-CONVENTION
  68     STATUS       current
  69     DESCRIPTION
  70         "A Display string consisting of a set of roles concatenated
  71         with a '+' character where the roles are in lexicographic
  72         order from minimum to maximum.
  73
  74         For example, a+b and b+a are NOT different role-combinations;
  75         rather, they are different formating of the same (one) role-
  76         combination.
  77
  78         Notice the roles within a role-combination are in lexicographic
  79         order from minimum to maximum, hence, we declare:
  80           a+b is the valid formating of the role-combination,
  81           b+a is an invalid formating of the role-combination.
  82
  83         Notice the need of zero-length role-combination as the role-
  84         combination of interfaces to which no roles have been assigned.
  85         This role-combination is also known as the null role-combination.
  86         (Note the deliberate use of lower case leters to avoid confusion
  87         with the ASCII NULL character which has a value of zero but length
  88         of one.)"
  89     SYNTAX SnmpAdminString  (SIZE (0..255))
  90
  91 -- The Policy Interface Table supports
  92 -- associating an interface with a specific role combination.
  93
  94 -- This table satisfy the need to monitor the configuration of
  95 -- roles on a per interface basis, and is no less scalable as
  96 -- other required per interface parameters.
  97 -- This does not preclude roles being associated with some less
  98 -- granular entities, and should be addressed when such need arise.
  99
 100 policyInterfaceTable OBJECT-TYPE
 101     SYNTAX      SEQUENCE OF PolicyInterfaceEntry
 102     MAX-ACCESS  not-accessible
 103     STATUS      current
 104     DESCRIPTION
 105             "Policy information about a device's interfaces."
 106     ::= { policyDeviceConfig 1 }
 107
 108
 109 policyInterfaceEntry OBJECT-TYPE
 110     SYNTAX      PolicyInterfaceEntry
 111     MAX-ACCESS  not-accessible
 112     STATUS      current
 113     DESCRIPTION
 114             "A conceptual row in the policyInterfaceTable.
 115             Each row identifies policy infromation about a
 116             particular interface."
 117     INDEX { policyInterfaceIfIndex }
 118     ::= { policyInterfaceTable 1 }
 119
 120
 121 PolicyInterfaceEntry ::= SEQUENCE {
 122     policyInterfaceIfIndex    InterfaceIndex,
 123     policyInterfaceRoleCombo  RoleCombination,
 124     policyInterfaceStorage    StorageType,
 125     policyInterfaceStatus     RowStatus
 126 }
 127
 128
 129 policyInterfaceIfIndex OBJECT-TYPE
 130     SYNTAX      InterfaceIndex
 131     MAX-ACCESS  not-accessible
 132     STATUS      current
 133     DESCRIPTION
 134             "The ifIndex value for which this conceptual row provides
 135             policy information."
 136
 137     ::= { policyInterfaceEntry 1 }
 138
 139
 140 policyInterfaceRoleCombo OBJECT-TYPE
 141     SYNTAX      RoleCombination
 142     MAX-ACCESS  read-create
 143     STATUS      current
 144     DESCRIPTION
 145             "The role combination that is associated with this interface
 146             for the purpose of assigning policies to this interface."
 147     ::= { policyInterfaceEntry 2 }
 148
 149
 150 policyInterfaceStorage OBJECT-TYPE
 151     SYNTAX      StorageType
 152     MAX-ACCESS  read-create
 153     STATUS      current
 154     DESCRIPTION
 155             "The storage type for this conceptual row.
 156
 157
 158             Conceptual rows having the value permanent(4) need not
 159             allow write-access to any columnar objects in the row.
 160
 161
 162             This object may not be modified if the associated
 163             policyInterfaceStatus object is equal to active(1)."
 164     DEFVAL  { volatile }
 165     ::= { policyInterfaceEntry 3 }
 166
 167
 168 policyInterfaceStatus OBJECT-TYPE
 169     SYNTAX      RowStatus
 170     MAX-ACCESS  read-create
 171     STATUS      current
 172     DESCRIPTION
 173             "The status of this row.
 174
 175
 176             An entry may not exist in the active state unless all
 177             objects in the entry have an appropriate value. Row
 178             creation using only default values is supported."
 179     ::= { policyInterfaceEntry 4 }
 180
 181 --
 182 -- Conformance Section
 183 --
 184
 185
 186 policyDeviceCompliances
 187                    OBJECT IDENTIFIER ::= { policyDeviceAuxConformance 1 }
 188 policyDeviceGroups OBJECT IDENTIFIER ::= { policyDeviceAuxConformance 2 }
 189
 190
 191 policyDeviceCompliance MODULE-COMPLIANCE
 192     STATUS  current
 193     DESCRIPTION
 194             "Describes the requirements for conformance to the
 195             Policy  Auxiliary MIB."
 196
 197
 198     MODULE  -- this module
 199         MANDATORY-GROUPS { policyInterfaceGroup }
 200
 201
 202         OBJECT        policyInterfaceRoleCombo
 203         MIN-ACCESS    read-only
 204         DESCRIPTION  "Write access is not required."
 205
 206
 207         OBJECT        policyInterfaceStorage
 208         MIN-ACCESS    read-only
 209         DESCRIPTION  "Write access is not required, nor is
 210                       support for the nonVolatile(2) enumeration."
 211
 212
 213         OBJECT        policyInterfaceStatus
 214         MIN-ACCESS    read-only
 215         DESCRIPTION  "Write access is not required."
 216     ::= { policyDeviceCompliances 1 }
 217
 218
 219 policyInterfaceGroup OBJECT-GROUP
 220     OBJECTS {
 221              policyInterfaceRoleCombo,
 222              policyInterfaceStorage,
 223              policyInterfaceStatus
 224     }
 225     STATUS  current
 226
 227     DESCRIPTION
 228             "Objects used to define interface to role combination
 229              mappings."
 230     ::= { policyDeviceGroups 1 }
 231
 232
 233 END