1-- *********************************************************************
2-- CISCO-CFS-MIB.my: Cisco Fabric Service MIB
3--
4-- September 2004, John Fan, Sanjeev C Joshi, H K Vivek,
5--
6-- Copyright (c) 2004, 2005, 2006 by cisco Systems, Inc.
7-- All rights reserved.
8--
9-- *********************************************************************
10
11CISCO-CFS-MIB DEFINITIONS ::= BEGIN
12
13IMPORTS
14    MODULE-IDENTITY,
15    OBJECT-TYPE,
16    NOTIFICATION-TYPE
17       FROM SNMPv2-SMI
18    MODULE-COMPLIANCE,
19    NOTIFICATION-GROUP,
20    OBJECT-GROUP
21       FROM SNMPv2-CONF
22    TEXTUAL-CONVENTION,
23    TimeStamp
24       FROM SNMPv2-TC
25    SnmpAdminString
26       FROM SNMP-FRAMEWORK-MIB
27    InetAddressType,
28    InetAddress
29       FROM INET-ADDRESS-MIB
30    ciscoMgmt
31       FROM CISCO-SMI;
32
33ciscoCFSMIB MODULE-IDENTITY
34    LAST-UPDATED        "200606130000Z"
35    ORGANIZATION        "Cisco Systems, Inc."
36    CONTACT-INFO
37        "       Cisco Systems
38                Network Management Technology Group
39
40                Postal: 170 W Tasman Drive
41                        San Jose, CA  95134
42                        USA
43
44                Tel: +1 800 553-NETS
45
46                E-mail:  cs-san@cisco.com"
47    DESCRIPTION
48        "This MIB applies to one or more of a set of devices
49         which have connectivity through some kind of 'fabric'.
50         Many features which run in such an environment require
51         the exchange of information between the peer devices
52         which participate in providing the feature. An example
53         of the type of information exchanged is configuration
54         information. It would be advantageous to have the ability
55         to have configuration for a feature done on one device
56         and propagated to all other devices in the fabric.
57         Cisco Fabric Service (CFS) is a general mechanism for
58         data distribution within the fabric that could be used
59         by most features.
60
61         A feature supported in a device may or may not be CFS
62         capable. In case a feature is CFS capable, the control
63         of the CFS operations are instrumented through this MIB.
64
65         A CFS capable feature can be enabled for data
66         distribution within the fabric by the user via SNMP.
67         When a CFS capable feature is enabled for data
68         distribution, CFS operations can then be performed for
69         that particular feature.
70
71         As part of the CFS configuration the first mandatory step
72         is to explicitly enable the feature for data distribution.
73         This enabling of distribution for a feature needs to be
74         done for those devices in the fabric where the distribution
75         is intended. Following this mandatory step, feature specific
76         configurations can be instrumented in the respective MIBs.
77
78         Once a feature is enabled for data distribution, first
79         subsequent feature specific configuration SET operation
80         results in a snapshot of current 'Running Configuration'
81         of the feature, on the local device. This snapshot is used
82         for subsequent modifications by feature specific SET
83         operations. Such modified configuration is referred to as
84         'Pending Configuration'. There can only be one 'Pending
85         Configuration' in the fabric. Additionally, such 'Pending
86         Configuration' can be maintained within the context of
87         additional scope, specific to the respective features.
88         The user who initiates the creation of the 'Pending
89         Configuration' is its owner. When a 'Pending Configuration'
90         for a feature exists in one of the devices of the fabric,
91         an attempt to create a 'Pending Configuration' for the same
92         feature and on a different device by way of feature specific
93         SET operation results in an error. This means feature
94         specific SET operations intended for distribution can only
95         be performed on the device that has the 'Pending
96         Configuration' with it. This ensures data consistency for
97         distribution.
98
99         Once the configuration of a feature is ready to be
100         distributed to all devices connected to the fabric, a
101         'commit' action performed on the local device overwrites
102         the local 'Running Configuration' and then distributes the
103         new  local 'Running Configuration' to all other devices in
104         the fabric. The successful 'commit' action also results into
105         destroying of the 'Pending Configuration' and makes the
106         feature available for new distribution. Any attempt to
107         perform 'commit' without any modification results in to an
108         error. The 'commit' action can only be performed by the
109         owner of the 'Pending Configuration'.
110
111         The 'Pending Configuration' can optionally be destroyed
112         without any distribution. This can be done by using either
113         'abort' or 'clear' action. The 'abort' action needs to
114         performed only on that device where the 'Pending
115         Configuration' exists and can only be performed by the owner
116         of the 'Pending Configuration'. The 'clear' action can be
117         initiated through any of the devices in the fabric. The
118         successful 'abort' or 'clear' operation makes the feature
119         available for new distribution.
120
121         The CFS, in addition to providing the basic distribution
122         infrastructure to the CFS capable features in a stable
123         fabric, also provides infrastructure to handle data
124         distribution when two stable fabrics merge.
125
126         This MIB module is to facilitate the global level control
127         (enabling/disabling) and actions (commit/abort/clear) over
128         the CFS capable features in the system.
129
130         Glossary of the terms used in this MIB:
131         --------------------------------------
132
133         VSAN                     - Virtual Storage Area Network,
134                                    similar to a VLAN.
135
136         CFS feature Scope        - The scope of distribution.
137                                    The scope provides the context
138                                    within which the CFS actions
139                                    are performed on a CFS capable
140                                    feature.
141
142         CFS Fabric Merge         - The merging of two stable fabrics.
143                                    The CFS provides infrastructure
144                                    to handle data distribution for
145                                    CFS distribution enabled features
146                                    when the two stable fabrics merge.
147
148         CFS control and actions :
149
150         CFS Distribution Enable  - This is to enable data distribution
151                                    for CFS capable feature.
152
153         CFS Distribution Disable - This is to disable data
154                                    distribution for CFS capable
155                                    feature.
156
157         CFS Commit               - This is to commit the 'Pending
158                                    Configuration' on the local device.
159                                    This action triggers the
160                                    distribution of the 'Pending
161                                    Configuration' to all the devices
162                                    in the fabric.
163
164         CFS Abort                - This is to Destroy the 'Pending
165                                    Configuration' on the local device
166                                    without any distribution. Once
167                                    local 'Pending Configuration' is
168                                    destroyed, creation of 'Pending
169                                    Configuration' in the local or any
170                                    other device connected to the
171                                    fabric is allowed.
172
173         CFS Clear                - This is to Destroy the 'Pending
174                                    Configuration' that exists in any
175                                    of the device in the fabric. Once
176                                    'Pending Configuration' that exists
177                                    with one of the devices in the
178                                    fabric is destroyed, creation of
179                                    'Pending Configuration' in the
180                                    local or any other device connected
181                                    to the fabric is allowed.
182
183         "
184
185    REVISION  "200606130000Z"
186    DESCRIPTION
187        "Added cfsFeatureOpExtLastActionTime object to cfsFeatureOpExtTable
188         Added cfsFeatureOpExtGroupRev1
189         Added ciscoCFSMIBComplianceRev3
190         "
191
192    REVISION  "200511300000Z"
193    DESCRIPTION
194        "Added the following:
195          - cfsDistCtrlTable table
196          - cfsFeatureOpAttribs object to cfsFeatureOpTable
197         "
198
199    REVISION  "200504270000Z"
200    DESCRIPTION
201        "Added an enumeration value of 'partialSuccess'
202         to the 'CiscoCFSFeatureActionResult' TC.
203         "
204
205    REVISION  "200412240000Z"
206    DESCRIPTION
207        "Added the cfsDistCtrl object to control
208         the CFS distribution capability.
209         "
210
211    REVISION  "200412030000Z"
212    DESCRIPTION
213        "Added the following tables:
214          - cfsMergeMembersTable
215          - cfsPeersTable
216          - cfsFeaturePeersTable
217          - cfsFeatureOpExtTable
218
219         Added the following scalar objects:
220          - cfsStartPeersDiscovery
221          - cfsPeersDiscoveryResult
222          - cfsPeersDiscoveryFailureReason
223
224         Added additional enumerations for:
225          - cfsMergeStatusValue
226
227         Added notification:
228          - ciscoCFSDiscoveryCompleteNotif
229         "
230
231    REVISION  "200409150000Z"
232    DESCRIPTION
233        "Initial version of this MIB.
234         "
235    ::= { ciscoMgmt 433 }
236
237--
238--  Objects, Notifications & Conformances
239--
240
241ciscoCFSMIBNotifs         OBJECT IDENTIFIER
242                                  ::= { ciscoCFSMIB 0 }
243ciscoCFSMIBObjects        OBJECT IDENTIFIER
244                                  ::= { ciscoCFSMIB 1 }
245ciscoCFSMIBConformance    OBJECT IDENTIFIER
246                                  ::= { ciscoCFSMIB 2 }
247cfsFeature                OBJECT IDENTIFIER
248                                  ::= { ciscoCFSMIBObjects 1 }
249cfsNotifObjects           OBJECT IDENTIFIER
250                                  ::= { ciscoCFSMIBObjects 2 }
251cfsDiscoveryObjects       OBJECT IDENTIFIER
252                                  ::= { ciscoCFSMIBObjects 3 }
253cfsDistCtrlObjects        OBJECT IDENTIFIER
254                                  ::= { ciscoCFSMIBObjects 4 }
255
256--
257-- Textual Conventions
258--
259
260CiscoCFSAction ::= TEXTUAL-CONVENTION
261    STATUS         current
262    DESCRIPTION
263        "Actions available for the CFS.
264
265            'noop'      - No operation
266
267            'enable'    - CFS Distribution Enable
268
269            'disable'   - CFS Distribution Disable
270
271            'commit'    - CFS Commit
272
273            'abort'     - CFS Abort
274
275            'clear'     - CFS Clear. This can be initiated by any
276                          user who has write access to the object
277                          of 'CiscoCFSAction' type.
278         "
279    SYNTAX         INTEGER {
280        noop(1),
281        enable(2),
282        disable(3),
283        commit(4),
284        abort(5),
285        clear(6)
286    }
287
288CiscoCFSFeatureStatus ::= TEXTUAL-CONVENTION
289    STATUS         current
290    DESCRIPTION
291        "Status of the CFS capable feature.
292
293            'unknown'  - Unknown status
294
295            'enabled'  - Feature is enabled for CFS operations
296
297            'disabled' - Feature is disabled for any CFS operations
298         "
299    SYNTAX         INTEGER {
300        unknown(1),
301        enabled(2),
302        disabled(3)
303    }
304
305CiscoCFSFeatureActionResult ::= TEXTUAL-CONVENTION
306    STATUS         current
307    DESCRIPTION
308        "Result of the action performed on a CFS capable feature.
309
310            'none'           - No previous action was performed
311
312            'success'        - Execution of the action triggered
313                               is completed Successfully
314
315            'failed'         - Execution of the action has failed
316
317            'inProgress'     - Execution of the action triggered
318                               is in progress
319
320            'partialSuccess' - Execution of the action triggered has
321                               succeeded partially in the fabric
322         "
323    SYNTAX         INTEGER {
324        none(1),
325        success(2),
326        failed(3),
327        inProgress(4),
328        partialSuccess(5)
329    }
330
331CiscoCFSScopeType ::= TEXTUAL-CONVENTION
332    STATUS         current
333    DESCRIPTION
334        "A generic value that represents the type of CFS
335         feature scope.
336
337            'none'         - No scope
338
339            'vsanID'       - VSAN scope
340         "
341    SYNTAX         INTEGER {
342        none(1),
343        vsanID(2)
344    }
345
346CiscoCFSScopeValue ::= TEXTUAL-CONVENTION
347    STATUS         current
348    DESCRIPTION
349        "Denotes a CFS  feature scope value to be used with
350         CiscoCFSScopeType. A CiscoCFSScopeValue is always
351         interpreted within the context of an CiscoCFSScopeType
352         value. Every usage of the CiscoCFSScopeValue textual
353         convention is required to specify the CiscoCFSScopeType
354         object which provides the context.
355
356         The encoding of the CiscoCFSScopeValue object for a
357         specific scope type is as below:
358
359         ScopeType    Octets   Contents             Encoding
360         ---------    ------   --------             --------
361         vsanID       1-4      VSAN ID of the VSAN  network-byte order
362
363         "
364    SYNTAX         OCTET STRING (SIZE (0..255))
365
366cfsFeatureOpTable    OBJECT-TYPE
367    SYNTAX         SEQUENCE OF CfsFeatureOpEntry
368    MAX-ACCESS     not-accessible
369    STATUS         current
370    DESCRIPTION
371        "This table lists all the CFS capable features in the local
372         device.
373
374         The table provides control, actions, current operating
375         state information and last action result information for
376         CFS capable features.
377
378         Each entry in this table represents a CFS capable feature.
379         An entry in the table is created by the agent when CFS
380         capable feature registers with CFS infrastructure. The
381         agent removes the entry from the table when the CFS
382         capable de-registers with CFS infrastructure. Management
383         application can not create new entry in this table.
384         "
385    ::= { cfsFeature 1 }
386
387cfsFeatureOpEntry    OBJECT-TYPE
388    SYNTAX         CfsFeatureOpEntry
389    MAX-ACCESS     not-accessible
390    STATUS         current
391    DESCRIPTION
392        "A conceptual row in the cfsFeatureOpTable. Each row
393         represents a CFS capable feature in the system.
394         "
395    INDEX          { cfsFeatureOpName }
396    ::= { cfsFeatureOpTable 1}
397
398CfsFeatureOpEntry ::=
399    SEQUENCE {
400        cfsFeatureOpName                SnmpAdminString,
401        cfsFeatureOpAction              CiscoCFSAction,
402        cfsFeatureOpScopeType           CiscoCFSScopeType,
403        cfsFeatureOpScopeVal            CiscoCFSScopeValue,
404        cfsFeatureOpLastAction          CiscoCFSAction,
405        cfsFeatureOpLastScopeType       CiscoCFSScopeType,
406        cfsFeatureOpLastScopeVal        CiscoCFSScopeValue,
407        cfsFeatureOpLastActionResult    CiscoCFSFeatureActionResult,
408        cfsFeatureOpLastFailureReason   SnmpAdminString,
409        cfsFeatureOpShowCfgOption       INTEGER,
410        cfsFeatureOpStatus              CiscoCFSFeatureStatus,
411        cfsFeatureOpAttribs             BITS
412}
413
414cfsFeatureOpName     OBJECT-TYPE
415    SYNTAX        SnmpAdminString (SIZE(0..32))
416    MAX-ACCESS    not-accessible
417    STATUS        current
418    DESCRIPTION
419        "A human readable string value uniquely identifying the
420         name of this feature.
421         "
422    ::= { cfsFeatureOpEntry 1 }
423
424cfsFeatureOpAction   OBJECT-TYPE
425    SYNTAX        CiscoCFSAction
426    MAX-ACCESS    read-write
427    STATUS        current
428    DESCRIPTION
429        "The CFS action to be triggered for the feature. An operator
430         should successfully enable CFS distribution of a feature
431         by issuing an 'enable' action before performing a
432         'commit' or 'abort' operation.
433
434         The value of this object and the values of corresponding
435         instance of cfsFeatureOpScopeType and cfsFeatureOpScopeVal
436         are interpreted and applied together as single CFS action
437         trigger on the feature. The scope type and values provide
438         the context/scope within which the this action is applied.
439
440         Setting of this object will fail with 'inconsistentValue',
441         if the value of the corresponding instance of
442         cfsFeatureOpLastActionResult is 'inProgress'. However, the
443         value of this object can be set to 'clear' regardless of
444         the value of the corresponding instance of
445         cfsFeatureOpLastActionResult.
446
447         Retrieving the value of this object via SNMP will always
448         return 'noop'.
449         "
450    ::= { cfsFeatureOpEntry 2 }
451
452cfsFeatureOpScopeType OBJECT-TYPE
453    SYNTAX        CiscoCFSScopeType
454    MAX-ACCESS    read-write
455    STATUS        current
456    DESCRIPTION
457        "The value of this object  specifies the type of the value
458         of the corresponding instance of cfsFeatureOpScopeVal.
459
460         The agent is not required to retain the modified value of
461         this object across the agent restart.
462         "
463    DEFVAL        { none }
464    ::= { cfsFeatureOpEntry 3 }
465
466cfsFeatureOpScopeVal OBJECT-TYPE
467    SYNTAX        CiscoCFSScopeValue (SIZE(0..32))
468    MAX-ACCESS    read-write
469    STATUS        current
470    DESCRIPTION
471        "The CFS feature scope value to be used with
472         cfsFeatureOpScopeType.
473
474         The value of this object may not be relevant when the value
475         of the corresponding instance of cfsFeatureOpAction is SET
476         to 'enable' or 'disable'.
477
478         The agent is not required to retain the modified value of
479         this  object across the agent restart.
480         "
481    DEFVAL        { ''H }
482    ::= { cfsFeatureOpEntry 4 }
483
484cfsFeatureOpLastAction OBJECT-TYPE
485    SYNTAX         CiscoCFSAction
486    MAX-ACCESS     read-only
487    STATUS         current
488    DESCRIPTION
489        "The last action performed on this feature. If no action
490         has been triggered for the feature since the last reboot
491         of the system, then retrieving the value of this object
492         will return 'noop'.
493         "
494    ::= { cfsFeatureOpEntry 5 }
495
496cfsFeatureOpLastScopeType OBJECT-TYPE
497    SYNTAX        CiscoCFSScopeType
498    MAX-ACCESS    read-only
499    STATUS        current
500    DESCRIPTION
501        "The last CFS feature scope type used for
502         cfsFeatureOpLastAction. If no action has been triggered
503         for the feature since the last reboot of the system, then
504         retrieving the value of this object will return 'none'.
505         "
506    ::= { cfsFeatureOpEntry 6 }
507
508cfsFeatureOpLastScopeVal OBJECT-TYPE
509    SYNTAX        CiscoCFSScopeValue (SIZE(0..32))
510    MAX-ACCESS    read-only
511    STATUS        current
512    DESCRIPTION
513        "The last CFS feature scope value used for
514         cfsFeatureOpLastScopeType. If no action has been triggered
515         for the feature since the last reboot of the system, then
516         retrieving the value of this object will return zero-length
517         string.
518         "
519    ::= { cfsFeatureOpEntry 7 }
520
521cfsFeatureOpLastActionResult  OBJECT-TYPE
522    SYNTAX         CiscoCFSFeatureActionResult
523    MAX-ACCESS     read-only
524    STATUS         current
525    DESCRIPTION
526        "The result of the execution of the last action (represented
527         by the value of cfsFeatureOpLastAction) for the feature.
528         When the value of this object is 'actionInProgress', the
529         value of the corresponding instance of cfsFeatureOpAction
530         can not be modified.
531         "
532    ::= { cfsFeatureOpEntry 8 }
533
534cfsFeatureOpLastFailureReason  OBJECT-TYPE
535    SYNTAX         SnmpAdminString
536    MAX-ACCESS     read-only
537    STATUS         current
538    DESCRIPTION
539        "The failure reason description for the failed execution
540         of last action performed on this feature.
541
542         If the corresponding instance of
543         cfsFeatureOpLastActionResult has the value
544         'actionFailed', then this object contains the reason
545         as to why it failed.  Otherwise, the value of this
546         object is the zero-length string.
547         "
548    ::= { cfsFeatureOpEntry 9 }
549
550cfsFeatureOpShowCfgOption  OBJECT-TYPE
551    SYNTAX         INTEGER {
552         runningConfig(1),
553         pendingConfig(2)
554    }
555    MAX-ACCESS     read-write
556    STATUS         deprecated
557    DESCRIPTION
558        "This object provides a means for management
559         applications to either view the contents of 'Running
560         Configuration' or 'Pending Configuration'.
561
562         When the value of this object is 'runningConfig', all the
563         subsequent configuration retrieval for this feature will be
564         from 'Running Configuration' on the local device.
565
566         When the value of this object is 'pendingConfig', all the
567         subsequent configuration retrieval for this feature will be
568         from 'Pending Configuration' on the local device.
569
570         The value of this object is meaningful only when the value
571         of the corresponding instance of 'cfsFeatureOpStatus' is
572         'enabled'.
573
574         The agent is not required to retain the modified value of
575         this  object across the agent restart.
576         "
577    DEFVAL { runningConfig }
578    ::= { cfsFeatureOpEntry 10 }
579
580cfsFeatureOpStatus OBJECT-TYPE
581    SYNTAX        CiscoCFSFeatureStatus
582    MAX-ACCESS    read-only
583    STATUS        current
584    DESCRIPTION
585        "The current operating status of the feature.
586         "
587    ::= { cfsFeatureOpEntry 11 }
588
589cfsFeatureOpAttribs OBJECT-TYPE
590    SYNTAX         BITS {
591         fcFabric(0),
592         ipNetwork(1),
593         vsanScope(2)
594    }
595    MAX-ACCESS    read-only
596    STATUS        current
597    DESCRIPTION
598        "The value of this object represents the attributes of
599         a CFS capable feature as registered with the CFS
600         infrastructure.
601
602         'fcFabric'           - indicates that the CFS based
603                                distribution for a feature spans the
604                                entire FC (Fibre Channel) fabric
605
606         'ipNetwork'          - indicates that the CFS based
607                                distribution for a feature spans the
608                                entire IP network
609
610         'vsanScope'          - indicates that the CFS based
611                                distribution for a feature is done
612                                on per VSAN basis and restricted to a
613                                specific VSAN in a FC (Fibre Channel)
614                                fabric
615         "
616    ::= { cfsFeatureOpEntry 12 }
617
618cfsPendingConfOwnerTable    OBJECT-TYPE
619    SYNTAX         SEQUENCE OF CfsPendingConfOwnerEntry
620    MAX-ACCESS     not-accessible
621    STATUS         current
622    DESCRIPTION
623        "This table contains per-feature 'Pending Configuration'
624         owner information. This table will have entries only
625         for those features for which 'Pending Configuration'
626         exists in one of the devices in the fabric. This table
627         provides the 'Pending Configuration' owner (type and name)
628         information and Device address where the 'Pending
629         Configuration' exists in the fabric.
630
631         The 'Pending Configuration' owner details are per CFS
632         capable feature within a specific scope.
633         "
634    ::= { cfsFeature 2 }
635
636cfsPendingConfOwnerEntry    OBJECT-TYPE
637    SYNTAX         CfsPendingConfOwnerEntry
638    MAX-ACCESS     not-accessible
639    STATUS         current
640    DESCRIPTION
641        "A conceptual row in the 'cfsPendingConfOwnerTable'.
642         Each row represents a CFS capable feature within the
643         context of the combination of scope type and scope value
644         in the system.
645         "
646    INDEX          { cfsFeatureOpName,
647                     cfsPendingConfOwnerScopeType,
648                     cfsPendingConfOwnerScopeVal }
649    ::= { cfsPendingConfOwnerTable 1}
650
651CfsPendingConfOwnerEntry ::=
652    SEQUENCE {
653        cfsPendingConfOwnerScopeType           CiscoCFSScopeType,
654        cfsPendingConfOwnerScopeVal            CiscoCFSScopeValue,
655        cfsPendingConfOwnerAddrType            InetAddressType,
656        cfsPendingConfOwnerAddr                InetAddress,
657        cfsPendingConfOwnerIDType              BITS,
658        cfsPendingConfOwnerID                  SnmpAdminString
659}
660
661cfsPendingConfOwnerScopeType OBJECT-TYPE
662    SYNTAX        CiscoCFSScopeType
663    MAX-ACCESS    not-accessible
664    STATUS        current
665    DESCRIPTION
666        "This indicates the type of the cfsPendingConfOwnerScopeVal.
667         "
668    ::= { cfsPendingConfOwnerEntry 1 }
669
670cfsPendingConfOwnerScopeVal OBJECT-TYPE
671    SYNTAX        CiscoCFSScopeValue (SIZE(0..32))
672    MAX-ACCESS    not-accessible
673    STATUS        current
674    DESCRIPTION
675        "The CFS scope value used with cfsPendingConfOwnerScopeType.
676         This indicates the scope of the feature within which
677         the 'Pending Configuration' for the feature exists.
678         "
679    ::= { cfsPendingConfOwnerEntry 2 }
680
681cfsPendingConfOwnerAddrType OBJECT-TYPE
682    SYNTAX        InetAddressType
683    MAX-ACCESS    read-only
684    STATUS        current
685    DESCRIPTION
686        "The type of address of the device in the fabric where the
687         'Pending Configuration' exists for the feature within this
688         scope.
689         "
690    ::= { cfsPendingConfOwnerEntry 3 }
691
692cfsPendingConfOwnerAddr OBJECT-TYPE
693    SYNTAX        InetAddress
694    MAX-ACCESS    read-only
695    STATUS        current
696    DESCRIPTION
697        "The address of the device in the fabric where the 'Pending
698         Configuration' exists for the feature within this scope.
699
700         The type of address of an instance of this object is
701         determined by the value of the corresponding instance of
702         cfsPendingConfOwnerAddrType.
703         "
704    ::= { cfsPendingConfOwnerEntry 4 }
705
706cfsPendingConfOwnerIDType OBJECT-TYPE
707    SYNTAX         BITS {
708         other(0),
709         snmpCommunityName(1),
710         snmpv3SecurityName(2),
711         cliLoginName(3)
712    }
713    MAX-ACCESS    read-only
714    STATUS        current
715    DESCRIPTION
716        "The value of this object indicates the type of the value
717         of the corresponding instance of 'cfsPendingConfOwnerID':
718
719         'other'              - indicates that the value of
720                                'cfsPendingConfOwnerID' is
721                                other than any of the enumerations
722                                defined
723
724         'snmpCommunityName'  - indicates that the value of
725                                'cfsPendingConfOwnerID' is
726                                'snmpCommunityName' of SNMPv1/
727                                SNMPv2c
728
729         'snmpv3SecurityName' - indicate that the value of
730                                'cfsPendingConfOwnerID' is
731                                'securityName' of SNMPv3 user
732
733         'cliLoginName'       - indicates that the value of
734                                'cfsPendingConfOwnerID' is
735                                CLI 'User Login Name' of CLI user
736         "
737    REFERENCE
738        " - 'securityName' is defined in RFC 3411, section 3.2.2
739          - 'snmpCommunityName' as defined in RFC3584
740         "
741    ::= { cfsPendingConfOwnerEntry 5 }
742
743cfsPendingConfOwnerID     OBJECT-TYPE
744    SYNTAX        SnmpAdminString
745    MAX-ACCESS    read-only
746    STATUS        current
747    DESCRIPTION
748        "A human readable string representing the identity of the
749         owner of the 'Pending Configuration' that exists in the
750         device represented by the values of corresponding instance
751         of cfsPendingConfOwnerAddrType and cfsPendingConfOwnerAddr.
752         The value of the corresponding instance of
753         cfsPendingConfOwnerIDType indicates the type of the value
754         of this object.
755         "
756    ::= { cfsPendingConfOwnerEntry 6 }
757
758cfsMergeStatusTable    OBJECT-TYPE
759    SYNTAX         SEQUENCE OF CfsMergeStatusEntry
760    MAX-ACCESS     not-accessible
761    STATUS         current
762    DESCRIPTION
763        "This table provides status of the 'Fabric Merge' on
764         the CFS capable features within the context of a
765         scope.
766
767         This table will have entries only for those features
768         for which CFS fabric distribution is enabled and
769         'Fabric Merge' is supported.
770         "
771    ::= { cfsFeature 3 }
772
773cfsMergeStatusEntry    OBJECT-TYPE
774    SYNTAX         CfsMergeStatusEntry
775    MAX-ACCESS     not-accessible
776    STATUS         current
777    DESCRIPTION
778        "A conceptual row in the cfsMergeStatusTable.
779         Each row represents a CFS capable feature within the
780         context of the combination of scope type and scope value
781         in the system.
782         "
783    INDEX          { cfsFeatureOpName,
784                     cfsMergeStatusScopeType,
785                     cfsMergeStatusScopeVal }
786    ::= { cfsMergeStatusTable 1}
787
788CfsMergeStatusEntry ::=
789    SEQUENCE {
790        cfsMergeStatusScopeType           CiscoCFSScopeType,
791        cfsMergeStatusScopeVal            CiscoCFSScopeValue,
792        cfsMergeStatusValue               INTEGER
793    }
794
795cfsMergeStatusScopeType OBJECT-TYPE
796    SYNTAX        CiscoCFSScopeType
797    MAX-ACCESS    not-accessible
798    STATUS        current
799    DESCRIPTION
800        "This indicates the type of the cfsMergeStatusScopeVal.
801         "
802    ::= { cfsMergeStatusEntry 1 }
803
804cfsMergeStatusScopeVal OBJECT-TYPE
805    SYNTAX        CiscoCFSScopeValue (SIZE(0..32))
806    MAX-ACCESS    not-accessible
807    STATUS        current
808    DESCRIPTION
809        "The CFS scope value used with cfsMergeStatusScopeType.
810         This indicates the scope of the feature within which
811         the 'Fabric Merge' for the feature has occurred.
812         "
813    ::= { cfsMergeStatusEntry 2 }
814
815cfsMergeStatusValue OBJECT-TYPE
816    SYNTAX        INTEGER {
817         success(1),
818         inProgress(2),
819         failure(3),
820         waiting(4),
821         other(5)
822    }
823    MAX-ACCESS    read-only
824    STATUS        current
825    DESCRIPTION
826        "The result of the last 'Fabric Merge' for the feature
827         within the context of the combination of
828         'cfsMergeStatusScopeType' and 'cfsMergeStatusScopeVal'
829         in the system:
830
831         'success'              - Fabric Merge successfully
832                                  completed
833
834         'inProgress'           - Fabric Merge in progress
835
836         'failure'              - Fabric Merge failed
837
838         'waiting'              - Waiting for existing Merge
839                                  conflict to be cleared
840
841         'other'                - None of the other values of
842                                  this enumeration
843
844         The value of this object is 'inProgress' when the local
845         device is part of a fabric that is in the process of
846         merging with another fabric.
847
848         The value of this object is 'waiting' when this local
849         device is waiting for any existing 'Fabric Merge
850         Conflict' to be resolved before it initiates the new
851         instance of 'Fabric Merge'.
852         "
853    ::= { cfsMergeStatusEntry 3 }
854
855cfsMergeMembersTable    OBJECT-TYPE
856    SYNTAX         SEQUENCE OF CfsMergeMembersEntry
857    MAX-ACCESS     not-accessible
858    STATUS         current
859    DESCRIPTION
860        "This table provides a list of devices in the local/
861         remote fabric after 'Fabric Merge' on a per CFS capable
862         feature basis within the context of a scope.
863
864         This table will have entries only for those features
865         for which CFS fabric distribution is enabled and
866         'Fabric Merge' is supported.
867         "
868    ::= { cfsFeature 4 }
869
870cfsMergeMembersEntry    OBJECT-TYPE
871    SYNTAX         CfsMergeMembersEntry
872    MAX-ACCESS     not-accessible
873    STATUS         current
874    DESCRIPTION
875        "A conceptual row in the 'cfsMergeMembersTable'.
876         Each row represents a device in the local/remote
877         fabric supporting CFS capable feature within the
878         context of a scope in the system.
879         "
880    INDEX          { cfsFeatureOpName,
881                     cfsMergeStatusScopeType,
882                     cfsMergeStatusScopeVal,
883                     cfsMergeMemberAddrType,
884                     cfsMergeMemberAddr }
885    ::= { cfsMergeMembersTable 1}
886
887CfsMergeMembersEntry ::=
888    SEQUENCE {
889        cfsMergeMemberAddrType            InetAddressType,
890        cfsMergeMemberAddr                InetAddress,
891        cfsMergeMemberFabricType          INTEGER,
892        cfsMergeMemberRole                INTEGER
893}
894
895cfsMergeMemberAddrType OBJECT-TYPE
896    SYNTAX        InetAddressType
897    MAX-ACCESS    not-accessible
898    STATUS        current
899    DESCRIPTION
900        "The type of the address of the device in the fabric
901         which has participated in the 'Fabric Merge' within
902         the context of a CFS feature and scope.
903         "
904    ::= { cfsMergeMembersEntry 1 }
905
906cfsMergeMemberAddr OBJECT-TYPE
907    SYNTAX        InetAddress (SIZE(0..32))
908    MAX-ACCESS    not-accessible
909    STATUS        current
910    DESCRIPTION
911        "The address of the device in the fabric which has
912         participated in the 'Fabric Merge' within the context
913         of a CFS feature and scope.
914
915         The type of address of an instance of this object is
916         determined by the value of the corresponding instance
917         of cfsMergeMemberAddrType.
918         "
919    ::= { cfsMergeMembersEntry 2 }
920
921cfsMergeMemberFabricType OBJECT-TYPE
922    SYNTAX        INTEGER {
923                     unknown(1),
924                     local(2),
925                     remote(3)
926                  }
927    MAX-ACCESS    read-only
928    STATUS        current
929    DESCRIPTION
930        "The type of the fabric to which the device belongs to,
931         during/after the 'Fabric Merge'.
932
933         The fabric to which the local device is attached to is
934         referred to as 'local fabric'. The fabric which attempted
935         to merge with the local fabric is referred to as 'remote
936         fabric'.
937
938         When the value of the corresponding instance of
939         cfsMergeStatusValue is 'successful' or 'waiting', all
940         the devices will be in a single 'CFS fabric' and belong
941         to the 'local' fabric.
942
943         When the value of the corresponding instance of
944         cfsMergeStatusValue is 'failure' or 'inProgress', the
945         devices in the other fabric which attempted 'Fabric Merge'
946         are marked as 'remote'.
947         "
948    ::= { cfsMergeMembersEntry 3 }
949
950cfsMergeMemberRole OBJECT-TYPE
951    SYNTAX        INTEGER {
952                     unknown(1),
953                     master(2),
954                     peer(3)
955                  }
956    MAX-ACCESS    read-only
957    STATUS        current
958    DESCRIPTION
959        "The role of the device during the 'Fabric Merge'.
960         In case of a successful fabric merge/stable fabric
961         only one device can be a 'master'. In case of a
962         fabric merge failure, there can be multiple 'master'
963         devices, corresponding to each of the fabric fragments.
964         All other devices which are not 'master' assume the role
965         of a 'peer'.
966
967         The algorithm for the selection of the 'Merge Master'
968         device within a stable fabric is platform specific.
969         "
970    ::= { cfsMergeMembersEntry 4 }
971
972cfsStartPeersDiscovery  OBJECT-TYPE
973    SYNTAX        INTEGER {
974                     startDiscovery(1),
975                     noOp(2)
976                  }
977    MAX-ACCESS    read-write
978    STATUS        current
979    DESCRIPTION
980        "This object specifies whether a discovery cycle
981         should be started by the CFS to discover all the
982         'peers' in the fabric.
983
984         When the value of this object is set to 'startDiscovery',
985         the discovery of the CFS capable devices in the fabric
986         is started by the CFS. On successful completion of the
987         discovery, the entries in the 'cfsPeersTable' will be
988         populated.
989
990         When the value of cfsPeersDiscoveryResult is
991         'inProgress', setting the value of this object to
992         'startDiscovery' results in an error.
993
994         No action is taken if this object is set to 'noOp'.
995         The value of this object when read is always 'noOp'.
996         "
997        ::= { cfsDiscoveryObjects 1 }
998
999cfsPeersDiscoveryResult  OBJECT-TYPE
1000    SYNTAX        INTEGER {
1001                     notInitiated(1),
1002                     inProgress(2),
1003                     successful(3),
1004                     failed(4)
1005                  }
1006    MAX-ACCESS    read-only
1007    STATUS        current
1008    DESCRIPTION
1009        "This object represents the result of the last discovery
1010         command issued by way of setting the value of
1011         cfsStartPeersDiscovery to 'startDiscovery'.
1012
1013         When the CFS discovery was never initiated using the
1014         cfsStartPeersDiscovery, the value of this object is
1015         'notInitiated'.
1016
1017         When the value of this object is 'notInitiated', the
1018         management station needs initiate the discovery cycle by
1019         setting the value of cfsStartPeersDiscovery to
1020         'startDiscovery'.
1021
1022         If the value of this object is 'successful', then the
1023         cfsPeersTable is appropriately populated.
1024         "
1025        ::= { cfsDiscoveryObjects 2 }
1026
1027cfsPeersDiscoveryFailureReason  OBJECT-TYPE
1028    SYNTAX         SnmpAdminString
1029    MAX-ACCESS     read-only
1030    STATUS         current
1031    DESCRIPTION
1032        "The failure reason description for the last failed CFS
1033         peers discovery.
1034
1035         If the value of cfsPeersDiscoveryResult object has the
1036         value 'failed', then the value of this object contains
1037         the reason as to why it failed. Otherwise, the value
1038         of this object is a zero-length string.
1039         "
1040    ::= { cfsDiscoveryObjects 3 }
1041
1042cfsPeersTable    OBJECT-TYPE
1043    SYNTAX         SEQUENCE OF CfsPeersEntry
1044    MAX-ACCESS     not-accessible
1045    STATUS         current
1046    DESCRIPTION
1047        "This table provides list of devices in a stable fabric.
1048         This table is populated with the entries only when the
1049         CFS discovery cycle is successfully completed.
1050         "
1051    ::= { cfsFeature 5 }
1052
1053cfsPeersEntry    OBJECT-TYPE
1054    SYNTAX         CfsPeersEntry
1055    MAX-ACCESS     not-accessible
1056    STATUS         current
1057    DESCRIPTION
1058        "A conceptual row in the 'cfsPeersTable'. Each row
1059         represents a device in a stable fabric supporting
1060         CFS capability.
1061         "
1062    INDEX          { cfsPeerAddrType,
1063                     cfsPeerAddr }
1064    ::= { cfsPeersTable 1}
1065
1066CfsPeersEntry ::=
1067    SEQUENCE {
1068        cfsPeerAddrType                   InetAddressType,
1069        cfsPeerAddr                       InetAddress
1070}
1071
1072cfsPeerAddrType OBJECT-TYPE
1073    SYNTAX        InetAddressType
1074    MAX-ACCESS    not-accessible
1075    STATUS        current
1076    DESCRIPTION
1077        "The type of the address of the CFS capable device
1078         in the fabric.
1079         "
1080    ::= { cfsPeersEntry 1 }
1081
1082cfsPeerAddr OBJECT-TYPE
1083    SYNTAX        InetAddress (SIZE(0..32))
1084    MAX-ACCESS    read-only
1085    STATUS        current
1086    DESCRIPTION
1087        "The address of a CFS capable device in the fabric.
1088
1089         The type of address of an instance of this object is
1090         determined by the value of the corresponding instance of
1091         cfsPeerAddrType.
1092         "
1093    ::= { cfsPeersEntry 2 }
1094
1095cfsFeaturePeersTable    OBJECT-TYPE
1096    SYNTAX         SEQUENCE OF CfsFeaturePeersEntry
1097    MAX-ACCESS     not-accessible
1098    STATUS         current
1099    DESCRIPTION
1100        "This table provides list of devices in a stable
1101         fabric on per CFS capable feature basis.
1102         "
1103    ::= { cfsFeature 6 }
1104
1105cfsFeaturePeersEntry    OBJECT-TYPE
1106    SYNTAX         CfsFeaturePeersEntry
1107    MAX-ACCESS     not-accessible
1108    STATUS         current
1109    DESCRIPTION
1110        "A conceptual row in the 'cfsMergeMembersTable'.
1111         Each row represents a device in a stable fabric
1112         supporting CFS capable feature within the context
1113         of a scope in the system.
1114         "
1115    INDEX          { cfsFeatureOpName,
1116                     cfsFeaturePeersScopeType,
1117                     cfsFeaturePeersScopeVal,
1118                     cfsFeaturePeersAddrType,
1119                     cfsFeaturePeersAddr }
1120    ::= { cfsFeaturePeersTable 1}
1121
1122CfsFeaturePeersEntry ::=
1123    SEQUENCE {
1124        cfsFeaturePeersScopeType           CiscoCFSScopeType,
1125        cfsFeaturePeersScopeVal            CiscoCFSScopeValue,
1126        cfsFeaturePeersAddrType            InetAddressType,
1127        cfsFeaturePeersAddr                InetAddress
1128}
1129
1130cfsFeaturePeersScopeType OBJECT-TYPE
1131    SYNTAX        CiscoCFSScopeType
1132    MAX-ACCESS    not-accessible
1133    STATUS        current
1134    DESCRIPTION
1135        "This indicates the type of the cfsFeaturePeersScopeVal.
1136         "
1137    ::= { cfsFeaturePeersEntry 1 }
1138
1139cfsFeaturePeersScopeVal OBJECT-TYPE
1140    SYNTAX        CiscoCFSScopeValue (SIZE(0..32))
1141    MAX-ACCESS    not-accessible
1142    STATUS        current
1143    DESCRIPTION
1144        "The CFS scope value used with cfsFeaturePeersScopeType.
1145         This indicates the scope of the feature within which
1146         the device exists in the fabric.
1147         "
1148    ::= { cfsFeaturePeersEntry 2 }
1149
1150cfsFeaturePeersAddrType OBJECT-TYPE
1151    SYNTAX        InetAddressType
1152    MAX-ACCESS    not-accessible
1153    STATUS        current
1154    DESCRIPTION
1155        "The type of the address of a peer device in the
1156         fabric for a CFS capable feature within the context
1157         of a scope.
1158         "
1159    ::= { cfsFeaturePeersEntry 3 }
1160
1161cfsFeaturePeersAddr OBJECT-TYPE
1162    SYNTAX        InetAddress (SIZE(0..32))
1163    MAX-ACCESS    read-only
1164    STATUS        current
1165    DESCRIPTION
1166        "The address of a peer device in the fabric for a CFS
1167         capable feature within the context of a scope.
1168
1169         The type of address of an instance of this object is
1170         determined by the value of the corresponding instance of
1171         cfsFeaturePeersAddrType.
1172         "
1173    ::= { cfsFeaturePeersEntry 4 }
1174
1175cfsFeatureOpExtTable    OBJECT-TYPE
1176    SYNTAX         SEQUENCE OF CfsFeatureOpExtEntry
1177    MAX-ACCESS     not-accessible
1178    STATUS         current
1179    DESCRIPTION
1180        "This table lists all the CFS capable features in the local
1181         device and provides:
1182
1183          - the information of the result of the last CFS action
1184            triggered on the CFS capable feature within the context
1185            of a scope
1186
1187          - control flag to specify the source of 'configuration
1188            view', within the context of a scope of the CFS capable
1189            feature
1190
1191         The last action corresponds to the action triggered on a
1192         CFS capable feature using the cfsFeatureOpAction of the
1193         cfsFeatureOpTable.
1194         "
1195    ::= { cfsFeature 7 }
1196
1197cfsFeatureOpExtEntry    OBJECT-TYPE
1198    SYNTAX         CfsFeatureOpExtEntry
1199    MAX-ACCESS     not-accessible
1200    STATUS         current
1201    DESCRIPTION
1202        "A conceptual row in the cfsFeatureOpExtTable. Each row
1203         represents a CFS capable feature within the context of
1204         the combination of scope type and scope value in the
1205         system.
1206
1207         The combination of cfsFeatureOpExtScopeType and
1208         cfsFeatureOpExtScopeVal forms a scope context within
1209         which a CFS operation was performed on CFS capable
1210         feature using the cfsFeatureOpScopeType and
1211         cfsFeatureOpScopeVal of cfsFeatureOpTable.
1212         "
1213    INDEX          { cfsFeatureOpName,
1214                     cfsFeatureOpExtScopeType,
1215                     cfsFeatureOpExtScopeVal }
1216    ::= { cfsFeatureOpExtTable 1}
1217
1218CfsFeatureOpExtEntry ::=
1219    SEQUENCE {
1220        cfsFeatureOpExtScopeType         CiscoCFSScopeType,
1221        cfsFeatureOpExtScopeVal          CiscoCFSScopeValue,
1222        cfsFeatureOpExtLastAction        CiscoCFSAction,
1223        cfsFeatureOpExtLastActionResult  CiscoCFSFeatureActionResult,
1224        cfsFeatureOpExtLastFailureReason SnmpAdminString,
1225        cfsFeatureOpExtShowCfgOption     INTEGER,
1226        cfsFeatureOpExtLastActionTime    TimeStamp
1227}
1228
1229cfsFeatureOpExtScopeType OBJECT-TYPE
1230    SYNTAX        CiscoCFSScopeType
1231    MAX-ACCESS    not-accessible
1232    STATUS        current
1233    DESCRIPTION
1234        "This indicates the type of the cfsFeatureOpExtScopeVal.
1235         "
1236    ::= { cfsFeatureOpExtEntry 1 }
1237
1238cfsFeatureOpExtScopeVal OBJECT-TYPE
1239    SYNTAX        CiscoCFSScopeValue (SIZE(0..32))
1240    MAX-ACCESS    not-accessible
1241    STATUS        current
1242    DESCRIPTION
1243        "The CFS feature scope value to be used with
1244         cfsFeatureOpExtScopeType.
1245         "
1246    ::= { cfsFeatureOpExtEntry 2 }
1247
1248cfsFeatureOpExtLastAction OBJECT-TYPE
1249    SYNTAX         CiscoCFSAction
1250    MAX-ACCESS     read-only
1251    STATUS         current
1252    DESCRIPTION
1253        "The last action performed on this feature within the
1254         context of a scope. If no action has been triggered
1255         for the feature since the last reboot of the system,
1256         then retrieving the value of this object will return
1257         'noop'.
1258         "
1259    ::= { cfsFeatureOpExtEntry 3 }
1260
1261cfsFeatureOpExtLastActionResult  OBJECT-TYPE
1262    SYNTAX         CiscoCFSFeatureActionResult
1263    MAX-ACCESS     read-only
1264    STATUS         current
1265    DESCRIPTION
1266        "The result of the execution of the last action (represented
1267         by the value of cfsFeatureOpExtLastAction) for the feature.
1268         "
1269    ::= { cfsFeatureOpExtEntry 4 }
1270
1271cfsFeatureOpExtLastFailureReason  OBJECT-TYPE
1272    SYNTAX         SnmpAdminString
1273    MAX-ACCESS     read-only
1274    STATUS         current
1275    DESCRIPTION
1276        "The failure reason description for the failed execution
1277         of last action performed on this feature.
1278
1279         If the corresponding instance of
1280         cfsFeatureOpExtLastActionResult has the value
1281         'actionFailed', then this object contains the reason
1282         as to why it failed.  Otherwise, the value of this
1283         object is a zero-length string.
1284         "
1285    ::= { cfsFeatureOpExtEntry 5 }
1286
1287cfsFeatureOpExtShowCfgOption  OBJECT-TYPE
1288    SYNTAX         INTEGER {
1289         runningConfig(1),
1290         pendingConfig(2)
1291    }
1292    MAX-ACCESS     read-write
1293    STATUS         current
1294    DESCRIPTION
1295        "This object provides a means for management
1296         applications to either view the contents of 'Running
1297         Configuration' or 'Pending Configuration'.
1298
1299         When the value of this object is 'runningConfig', all the
1300         subsequent configuration retrieval for this feature within
1301         the specified context of the scope will be from 'Running
1302         Configuration' on the local device.
1303
1304         When the value of this object is 'pendingConfig', all the
1305         subsequent configuration retrieval for this feature within
1306         the specified context of the scope will be from 'Pending
1307         Configuration' on the local device.
1308
1309         The value of this object is meaningful only when the value
1310         of the corresponding instance of 'cfsFeatureOpStatus' is
1311         'enabled'.
1312
1313         The agent is not required to retain the modified value of
1314         this  object across the agent restart.
1315         "
1316    DEFVAL { runningConfig }
1317    ::= { cfsFeatureOpExtEntry 6 }
1318
1319cfsFeatureOpExtLastActionTime OBJECT-TYPE
1320    SYNTAX         TimeStamp
1321    MAX-ACCESS     read-only
1322    STATUS         current
1323    DESCRIPTION
1324        "Time stamp of the last action performed. If no action
1325         has been triggered for the feature (i.e cfsFeatureOpExtLastAction
1326         equal to one '1')  since the last reboot of the system, the value
1327         zero will be returned.
1328        "
1329    ::= { cfsFeatureOpExtEntry 7 }
1330
1331cfsDistCtrl OBJECT-TYPE
1332    SYNTAX         INTEGER {
1333         enable(1),
1334         disable(2)
1335    }
1336    MAX-ACCESS     read-write
1337    STATUS         current
1338    DESCRIPTION
1339        "The object to control CFS for distribution.
1340
1341         On setting the value of this object to 'enable', CFS will
1342         be ready for distribution of the data across the fabric.
1343
1344         On setting the value of this object to 'disable', CFS will
1345         disable its capability to distribute the data across the
1346         fabric. The CFS continues to honour distribution requests
1347         from the CFS capable features of the local device, with the
1348         scope of the distribution limited only to the local device
1349         and not fabric wide.
1350
1351         The value of the object when read, reflects the current
1352         operating state of the CFS.
1353         "
1354    ::= { cfsDistCtrlObjects 1 }
1355
1356cfsDistCtrlTable    OBJECT-TYPE
1357    SYNTAX         SEQUENCE OF CfsDistCtrlEntry
1358    MAX-ACCESS     not-accessible
1359    STATUS         current
1360    DESCRIPTION
1361        "The table to control CFS for distribution over IP.
1362        "
1363    ::= { cfsDistCtrlObjects 2 }
1364
1365cfsDistCtrlEntry    OBJECT-TYPE
1366    SYNTAX         CfsDistCtrlEntry
1367    MAX-ACCESS     not-accessible
1368    STATUS         current
1369    DESCRIPTION
1370        "An entry (conceptual row) in the cfsDistCtrlTable. Each row
1371        represents a configuration set required to control CFS for
1372        distribution over IP on each of the address families.
1373        "
1374    INDEX          { cfsDistCtrlAddrType }
1375    ::= { cfsDistCtrlTable 1 }
1376
1377CfsDistCtrlEntry ::=
1378    SEQUENCE {
1379        cfsDistCtrlAddrType         InetAddressType,
1380        cfsDistCtrlAddr             InetAddress,
1381        cfsDistCtrlAction           INTEGER
1382}
1383
1384cfsDistCtrlAddrType  OBJECT-TYPE
1385    SYNTAX        InetAddressType
1386    MAX-ACCESS    not-accessible
1387    STATUS        current
1388    DESCRIPTION
1389        "The type of multicast address to which the CFS distribution
1390         is restricted. Only the entries corresponding to the 'ipv4'
1391         and 'ipv6' internet address types exist in this table.
1392        "
1393    ::= { cfsDistCtrlEntry  1 }
1394
1395cfsDistCtrlAddr   OBJECT-TYPE
1396    SYNTAX        InetAddress
1397    MAX-ACCESS    read-write
1398    STATUS        current
1399    DESCRIPTION
1400        "The multicast address domain to which the CFS distribution
1401        is restricted.
1402
1403        The type of this address is determined by the instance
1404        identifier value of the cfsDistCtrlAddrType.
1405
1406        There is a default multicast address for both IPv4 and IPv6
1407        through which the Keep-alive messages are sent and received
1408        to discover the CFS capable switches over IP. All switches
1409        with similar multicast address form one CFS-over-IP fabric.
1410
1411        The default multicast address for IPv4 is 239.255.70.83 and
1412        range supported is [239.255.0.0 - 239.255.255.255]
1413
1414        The default multicast address for IPv6 is ff13::7743:4653 and
1415        the supported range is [ff13::0000:0000 - ff13::ffff:ffff]
1416
1417        The value of this object can only be modified when the
1418        value of the corresponding instance of cfsDistCtrlAction is
1419        'disable'.
1420        "
1421    ::= { cfsDistCtrlEntry  2 }
1422
1423cfsDistCtrlAction OBJECT-TYPE
1424    SYNTAX         INTEGER { enable(1), disable(2) }
1425    MAX-ACCESS     read-write
1426    STATUS         current
1427    DESCRIPTION
1428        "This object specifies the current operating
1429         mode employed in CFS for distribution over the
1430         corresponding type of Internet address.
1431
1432         By setting the value of this object to 'enable', CFS will
1433         enable its capability to distribute the application data
1434         across the fabric over the corresponding type of Internet
1435         address.
1436
1437         By setting the value of this object to 'disable', CFS will
1438         disable its capability to distribute the data across the
1439         fabric over the corresponding type of Internet address.
1440
1441         Only one instance of this object can have the value of
1442         'enable' among all the conceptual rows.
1443         "
1444    DEFVAL { disable }
1445    ::= { cfsDistCtrlEntry  3 }
1446
1447--
1448-- Objects for Notification only
1449--
1450
1451cfsMergeFailFeatureName     OBJECT-TYPE
1452    SYNTAX        SnmpAdminString (SIZE(0..32))
1453    MAX-ACCESS    accessible-for-notify
1454    STATUS        current
1455    DESCRIPTION
1456        "A human readable string value uniquely identifying the
1457         name of this feature for which the 'Merge Failure' occurred.
1458         "
1459    ::= { cfsNotifObjects 1 }
1460
1461cfsMergeFailScopeType OBJECT-TYPE
1462    SYNTAX        CiscoCFSScopeType
1463    MAX-ACCESS    accessible-for-notify
1464    STATUS        current
1465    DESCRIPTION
1466        "The value of this object indicates the type of the value
1467         of 'cfsMergeFailScopeVal'.
1468         "
1469    ::= { cfsNotifObjects 2 }
1470
1471cfsMergeFailScopeVal OBJECT-TYPE
1472    SYNTAX        CiscoCFSScopeValue (SIZE(0..32))
1473    MAX-ACCESS    accessible-for-notify
1474    STATUS        current
1475    DESCRIPTION
1476        "The value of this object indicates the scope of the
1477         feature ('cfsMergeFailFeatureName') within which the
1478         'Merge Failure' occurred.
1479         "
1480    ::= { cfsNotifObjects 3 }
1481
1482cfsMergeFailReasonDescription  OBJECT-TYPE
1483    SYNTAX        SnmpAdminString
1484    MAX-ACCESS    accessible-for-notify
1485    STATUS        current
1486    DESCRIPTION
1487        "The failure reason description for the 'Merge Failure'"
1488    ::= { cfsNotifObjects 4 }
1489
1490--
1491-- Notifications
1492--
1493
1494ciscoCFSFeatureActionNotif NOTIFICATION-TYPE
1495        OBJECTS        { cfsFeatureOpLastAction,
1496                         cfsFeatureOpLastScopeType,
1497                         cfsFeatureOpLastScopeVal,
1498                         cfsFeatureOpLastActionResult }
1499        STATUS         current
1500        DESCRIPTION
1501           "Notification to covey the information of the action
1502            performed on a CFS capable feature.
1503
1504            This notification gets generated when :
1505
1506             - a CFS operation action is triggered on CFS capable
1507               feature
1508
1509             - the result of last action performed on the CFS
1510               capable feature changes.
1511
1512            The 'cfsFeatureOpLastActionResult' indicates the new
1513            value of the last action result performed on the feature.
1514            "
1515        ::= { ciscoCFSMIBNotifs 1 }
1516
1517ciscoCFSMergeFailNotif NOTIFICATION-TYPE
1518        OBJECTS        { cfsMergeFailFeatureName,
1519                         cfsMergeFailScopeType,
1520                         cfsMergeFailScopeVal,
1521                         cfsMergeFailReasonDescription }
1522        STATUS         current
1523        DESCRIPTION
1524           "Notification to convey the information of the 'Merge
1525            Failure' occurred in the fabric. This notification gets
1526            generated when the merge of the two fabrics fail for a
1527            CFS capable feature.
1528            "
1529        ::= { ciscoCFSMIBNotifs 2 }
1530
1531ciscoCFSDiscoveryCompleteNotif NOTIFICATION-TYPE
1532        OBJECTS        { cfsPeersDiscoveryResult,
1533                         cfsPeersDiscoveryFailureReason }
1534        STATUS         current
1535        DESCRIPTION
1536           "Notification to indicate that the CFS has completed
1537            discovering the CFS capable devices in the fabric.
1538
1539            If the value of cfsPeersDiscoveryResult is 'successful',
1540            then the cfsPeersTable is appropriately populated.
1541            "
1542        ::= { ciscoCFSMIBNotifs 3 }
1543
1544--
1545-- Conformance
1546--
1547
1548ciscoCFSMIBCompliances    OBJECT IDENTIFIER
1549                                ::= { ciscoCFSMIBConformance 1 }
1550ciscoCFSMIBGroups         OBJECT IDENTIFIER
1551                                ::= { ciscoCFSMIBConformance 2 }
1552
1553ciscoCFSMIBCompliance     MODULE-COMPLIANCE
1554    STATUS         deprecated  -- superseded by
1555                               -- ciscoCFSMIBComplianceRev1
1556    DESCRIPTION
1557        "The compliance statement for entities which implement the
1558         CISCO-CFS-MIB.
1559         "
1560    MODULE
1561       MANDATORY-GROUPS {
1562           cfsFeatureOpGroup,
1563           cfsPendingConfOwnerGroup,
1564           cfsFeatureActionNotifGroup
1565       }
1566    GROUP          cfsFeatureNotifObjectsGroup
1567    DESCRIPTION
1568        "This group is conditionally mandatory and must be
1569         implemented by the agent of the managed entity only
1570         if the CFS implementation on the managed entity
1571         supports notifications as defined in the
1572         'cfsMergeFailNotifGroup'.
1573         "
1574    GROUP          cfsMergeFailNotifGroup
1575    DESCRIPTION
1576        "This group is conditionally mandatory and must be
1577         implemented by the agent of the managed entity only
1578         if the CFS implementation on the managed entity
1579         supports fabric merge.
1580         "
1581
1582    ::= { ciscoCFSMIBCompliances 1 }
1583
1584ciscoCFSMIBComplianceRev1     MODULE-COMPLIANCE
1585    STATUS         deprecated --Superseded by ciscoCFSMIBComplianceRev2
1586    DESCRIPTION
1587        "The compliance statement for entities which implement the
1588         CISCO-CFS-MIB.
1589         "
1590    MODULE
1591       MANDATORY-GROUPS {
1592           cfsFeatureOpGroupRev1,
1593           cfsPendingConfOwnerGroup,
1594           cfsFeatureActionNotifGroup,
1595           cfsMembersGroup,
1596           cfsPeerDiscoveryNotifGroup,
1597           cfsFeatureOpExtGroup
1598       }
1599    GROUP          cfsFeatureNotifObjectsGroup
1600    DESCRIPTION
1601        "This group is conditionally mandatory and must be
1602         implemented by the agent of the managed entity only
1603         if the CFS implementation on the managed entity
1604         supports notifications as defined in the
1605         'cfsMergeFailNotifGroup'.
1606         "
1607
1608    GROUP          cfsMergeFailNotifGroup
1609    DESCRIPTION
1610        "This group is conditionally mandatory and must be
1611         implemented by the agent of the managed entity only
1612         if the CFS implementation on the managed entity
1613         supports fabric merge.
1614         "
1615
1616    GROUP          cfsDistCtrlGroup
1617    DESCRIPTION
1618        "This group is conditionally mandatory and must be
1619         implemented by the agent of the managed entity only
1620         if the CFS implementation on the managed entity
1621         supports CFS distribution control.
1622         "
1623
1624    ::= { ciscoCFSMIBCompliances 2 }
1625
1626ciscoCFSMIBComplianceRev2     MODULE-COMPLIANCE
1627    STATUS         deprecated --Superseded by ciscoCFSMIBComplianceRev3
1628    DESCRIPTION
1629        "The compliance statement for entities which implement the
1630         CISCO-CFS-MIB.
1631         "
1632    MODULE
1633       MANDATORY-GROUPS {
1634           cfsFeatureOpGroupRev2,
1635           cfsPendingConfOwnerGroup,
1636           cfsFeatureActionNotifGroup,
1637           cfsMembersGroup,
1638           cfsPeerDiscoveryNotifGroup,
1639           cfsFeatureOpExtGroup
1640       }
1641    GROUP          cfsFeatureNotifObjectsGroup
1642    DESCRIPTION
1643        "This group is conditionally mandatory and must be
1644         implemented by the agent of the managed entity only
1645         if the CFS implementation on the managed entity
1646         supports notifications as defined in the
1647         'cfsMergeFailNotifGroup'.
1648         "
1649
1650    GROUP          cfsMergeFailNotifGroup
1651    DESCRIPTION
1652        "This group is conditionally mandatory and must be
1653         implemented by the agent of the managed entity only
1654         if the CFS implementation on the managed entity
1655         supports fabric merge.
1656         "
1657
1658    GROUP          cfsDistCtrlGroup
1659    DESCRIPTION
1660        "This group is conditionally mandatory and must be
1661         implemented by the agent of the managed entity only
1662         if the CFS implementation on the managed entity
1663         supports CFS distribution control.
1664         "
1665
1666    GROUP          cfsDistCtrlInetGroup
1667    DESCRIPTION
1668        "This group is conditionally mandatory and must be
1669         implemented by the agent of the managed entity only
1670         if the CFS implementation on the managed entity
1671         supports per Internet address type CFS distribution
1672         control.
1673         "
1674    ::= { ciscoCFSMIBCompliances 3 }
1675
1676ciscoCFSMIBComplianceRev3     MODULE-COMPLIANCE
1677    STATUS         current
1678    DESCRIPTION
1679        "The compliance statement for entities which implement the
1680         CISCO-CFS-MIB.
1681         "
1682    MODULE
1683       MANDATORY-GROUPS {
1684           cfsFeatureOpGroupRev2,
1685           cfsPendingConfOwnerGroup,
1686           cfsFeatureActionNotifGroup,
1687           cfsMembersGroup,
1688           cfsPeerDiscoveryNotifGroup,
1689           cfsFeatureOpExtGroupRev1
1690       }
1691    GROUP          cfsFeatureNotifObjectsGroup
1692    DESCRIPTION
1693        "This group is conditionally mandatory and must be
1694         implemented by the agent of the managed entity only
1695         if the CFS implementation on the managed entity
1696         supports notifications as defined in the
1697         'cfsMergeFailNotifGroup'.
1698         "
1699
1700    GROUP          cfsMergeFailNotifGroup
1701    DESCRIPTION
1702        "This group is conditionally mandatory and must be
1703         implemented by the agent of the managed entity only
1704         if the CFS implementation on the managed entity
1705         supports fabric merge.
1706         "
1707
1708    GROUP          cfsDistCtrlGroup
1709    DESCRIPTION
1710        "This group is conditionally mandatory and must be
1711         implemented by the agent of the managed entity only
1712         if the CFS implementation on the managed entity
1713         supports CFS distribution control.
1714         "
1715
1716    GROUP          cfsDistCtrlInetGroup
1717    DESCRIPTION
1718        "This group is conditionally mandatory and must be
1719         implemented by the agent of the managed entity only
1720         if the CFS implementation on the managed entity
1721         supports per Internet address type CFS distribution
1722         control.
1723         "
1724    ::= { ciscoCFSMIBCompliances 4 }
1725
1726--
1727-- Units of Conformance
1728--
1729
1730cfsFeatureOpGroup  OBJECT-GROUP
1731    OBJECTS {
1732        cfsFeatureOpAction,
1733        cfsFeatureOpScopeType,
1734        cfsFeatureOpScopeVal,
1735        cfsFeatureOpLastAction,
1736        cfsFeatureOpLastScopeType,
1737        cfsFeatureOpLastScopeVal,
1738        cfsFeatureOpLastActionResult,
1739        cfsFeatureOpLastFailureReason,
1740        cfsFeatureOpShowCfgOption,
1741        cfsFeatureOpStatus,
1742        cfsMergeStatusValue
1743    }
1744    STATUS         deprecated  -- superseded by cfsFeatureOpGroupRev1
1745    DESCRIPTION
1746        "A collection of objects for configurations of the CFS capable
1747         features.
1748        "
1749    ::= { ciscoCFSMIBGroups 1 }
1750
1751cfsPendingConfOwnerGroup  OBJECT-GROUP
1752    OBJECTS {
1753        cfsPendingConfOwnerAddrType,
1754        cfsPendingConfOwnerAddr,
1755        cfsPendingConfOwnerIDType,
1756        cfsPendingConfOwnerID
1757    }
1758    STATUS         current
1759    DESCRIPTION
1760        "A collection of objects for the 'Pending Configuration'
1761         owner details of the CFS capable features.
1762        "
1763    ::= { ciscoCFSMIBGroups 2 }
1764
1765cfsFeatureNotifObjectsGroup  OBJECT-GROUP
1766    OBJECTS {
1767        cfsMergeFailFeatureName,
1768        cfsMergeFailScopeType,
1769        cfsMergeFailScopeVal,
1770        cfsMergeFailReasonDescription
1771    }
1772    STATUS         current
1773    DESCRIPTION
1774        "A collection of objects required for CFS notifications."
1775    ::= { ciscoCFSMIBGroups 3 }
1776
1777cfsFeatureActionNotifGroup  NOTIFICATION-GROUP
1778    NOTIFICATIONS  {ciscoCFSFeatureActionNotif}
1779    STATUS         current
1780    DESCRIPTION
1781        "A collection of notifications for the CFS actions on the
1782         CFS capable features.
1783         "
1784    ::= { ciscoCFSMIBGroups 4 }
1785
1786cfsMergeFailNotifGroup  NOTIFICATION-GROUP
1787    NOTIFICATIONS  { ciscoCFSMergeFailNotif }
1788    STATUS         current
1789    DESCRIPTION
1790        "A collection of notifications for CFS fabric merge
1791         failures.
1792         "
1793    ::= { ciscoCFSMIBGroups 5 }
1794
1795cfsMembersGroup  OBJECT-GROUP
1796    OBJECTS {
1797        cfsMergeMemberFabricType,
1798        cfsMergeMemberRole,
1799        cfsStartPeersDiscovery,
1800        cfsPeersDiscoveryResult,
1801        cfsPeersDiscoveryFailureReason,
1802        cfsPeerAddr,
1803        cfsFeaturePeersAddr
1804    }
1805    STATUS         current
1806    DESCRIPTION
1807        "A collection of objects for discovering list of devices in
1808         the fabric.
1809        "
1810    ::= { ciscoCFSMIBGroups 6 }
1811
1812cfsFeatureOpExtGroup  OBJECT-GROUP
1813    OBJECTS {
1814        cfsFeatureOpExtLastAction,
1815        cfsFeatureOpExtLastActionResult,
1816        cfsFeatureOpExtLastFailureReason,
1817        cfsFeatureOpExtShowCfgOption
1818    }
1819    STATUS          deprecated  -- superseded by cfsFeatureOpExtGroupRev1
1820    DESCRIPTION
1821        "A collection of objects for CFS action results.
1822        "
1823    ::= { ciscoCFSMIBGroups 7 }
1824
1825cfsPeerDiscoveryNotifGroup  NOTIFICATION-GROUP
1826    NOTIFICATIONS  { ciscoCFSDiscoveryCompleteNotif }
1827    STATUS         current
1828    DESCRIPTION
1829        "A collection of notifications for CFS peer discovery.
1830         "
1831    ::= { ciscoCFSMIBGroups 8 }
1832
1833cfsFeatureOpGroupRev1  OBJECT-GROUP
1834    OBJECTS {
1835        cfsFeatureOpAction,
1836        cfsFeatureOpScopeType,
1837        cfsFeatureOpScopeVal,
1838        cfsFeatureOpLastAction,
1839        cfsFeatureOpLastScopeType,
1840        cfsFeatureOpLastScopeVal,
1841        cfsFeatureOpLastActionResult,
1842        cfsFeatureOpLastFailureReason,
1843        cfsFeatureOpStatus,
1844        cfsMergeStatusValue
1845    }
1846    STATUS         deprecated  -- superseded by cfsFeatureOpGroupRev2
1847    DESCRIPTION
1848        "A collection of objects for configurations of the CFS capable
1849         features.
1850        "
1851    ::= { ciscoCFSMIBGroups 9 }
1852
1853cfsDistCtrlGroup  OBJECT-GROUP
1854    OBJECTS { cfsDistCtrl }
1855    STATUS         current
1856    DESCRIPTION
1857        "A collection of objects for controlling the distribution
1858         capabilities of CFS.
1859        "
1860    ::= { ciscoCFSMIBGroups 10 }
1861
1862cfsDistCtrlInetGroup  OBJECT-GROUP
1863    OBJECTS {
1864        cfsDistCtrlAddr,
1865        cfsDistCtrlAction
1866    }
1867    STATUS         current
1868    DESCRIPTION
1869        "A collection of objects for controlling the per Internet
1870         address type distribution capabilities of CFS.
1871        "
1872    ::= { ciscoCFSMIBGroups 11 }
1873
1874cfsFeatureOpGroupRev2  OBJECT-GROUP
1875    OBJECTS {
1876        cfsFeatureOpAction,
1877        cfsFeatureOpScopeType,
1878        cfsFeatureOpScopeVal,
1879        cfsFeatureOpLastAction,
1880        cfsFeatureOpLastScopeType,
1881        cfsFeatureOpLastScopeVal,
1882        cfsFeatureOpLastActionResult,
1883        cfsFeatureOpLastFailureReason,
1884        cfsFeatureOpStatus,
1885        cfsMergeStatusValue,
1886        cfsFeatureOpAttribs
1887    }
1888    STATUS         current
1889    DESCRIPTION
1890        "A collection of objects for configurations of the CFS capable
1891         features.
1892        "
1893    ::= { ciscoCFSMIBGroups 12 }
1894
1895cfsFeatureOpExtGroupRev1  OBJECT-GROUP
1896    OBJECTS {
1897        cfsFeatureOpExtLastAction,
1898        cfsFeatureOpExtLastActionTime,
1899        cfsFeatureOpExtLastActionResult,
1900        cfsFeatureOpExtLastFailureReason,
1901        cfsFeatureOpExtShowCfgOption
1902    }
1903    STATUS         current
1904    DESCRIPTION
1905        "A collection of objects for CFS action results.
1906        "
1907    ::= { ciscoCFSMIBGroups 13 }
1908
1909END
1910
1911