1 tony 1.1 // ===================================================================
2 // Title: Device Ports 2.8
3 // Filename: Device28_Ports.mof
4 // Version: 2.8
5 // Status: Final
6 // Date: Jan 26, 2004
7 // ===================================================================
8 // Copyright 2000-2003 Distributed Management Task Force, Inc. (DMTF).
9 // All rights reserved.
10 // DMTF is a not-for-profit association of industry members dedicated
11 // to promoting enterprise and systems management and interoperability.
12 // DMTF specifications and documents may be reproduced for uses
13 // consistent with this purpose by members and non-members,
14 // provided that correct attribution is given.
15 // As DMTF specifications may be revised from time to time,
16 // the particular version and release date should always be noted.
17 //
18 // Implementation of certain elements of this standard or proposed
19 // standard may be subject to third party patent rights, including
20 // provisional patent rights (herein "patent rights"). DMTF makes
21 // no representations to users of the standard as to the existence
22 tony 1.1 // of such rights, and is not responsible to recognize, disclose, or
23 // identify any or all such third party patent right, owners or
24 // claimants, nor for any incomplete or inaccurate identification or
25 // disclosure of such rights, owners or claimants. DMTF shall have no
26 // liability to any party, in any manner or circumstance, under any
27 // legal theory whatsoever, for failure to recognize, disclose, or
28 // identify any such third party patent rights, or for such party's
29 // reliance on the standard or incorporation thereof in its product,
30 // protocols or testing procedures. DMTF shall have no liability to
31 // any party implementing such standard, whether such implementation
32 // is foreseeable or not, nor to any patent owner or claimant, and shall
33 // have no liability or responsibility for costs or losses incurred if
34 // a standard is withdrawn or modified after publication, and shall be
35 // indemnified and held harmless by any party implementing the
36 // standard from any and all claims of infringement by a patent owner
37 // for such implementations.
38 //
39 // For information about patents held by third-parties which have
40 // notified the DMTF that, in their opinion, such patent may relate to
41 // or impact implementations of DMTF standards, visit
42 // http://www.dmtf.org/about/policies/disclosures.php.
43 tony 1.1 // ===================================================================
44 // Description: The Device Model extends the management concepts that
45 // are related to LogicalDevices. This file defines the
46 // concepts and classes needed to manage port devices,
47 // connecting to communications media and networks.
48 //
49 // The object classes below are listed in an order that
50 // avoids forward references. Required objects, defined
51 // by other working groups, are omitted.
52 // ==================================================================
53 // Change Log for v2.8 Final
54 // CR1202 - Remove Experimental Qualifier
55 //
56 // Change Log for v2.8 Preliminary
57 // CR1003 - Add wireless to NetworkPort.LinkTechnology,
58 // add WirelessPort
59 // CR1055 - add UsageRestriction to LogicalPort
60 // CR1071 - Return LogicalModule, ModulePort, and PortActiveConnection
61 // CR1027 - Add LogicalPort.RequestedSpeed
62 // CR1034 - Add Name property to LogicalPortGroup
63 // CR1101 - Fix description for LogicalPortGroup
64 tony 1.1 // CR1096 - Addition of SCSIport
65 // CR1128 - Addition of HostedDependency
66 //
67 // Change Log for v2.7 Final
68 // CR971 - Removal of the Experimental qualifier
69 // - Remove LogicalModule, ModulePort, and PortActiveConnection
70 // so they can be experimental in 2.8
71 //
72 // Change Log for v2.7
73 // CR630 - Remove NetworkAdapterStatistics and Add NetworkPortStatistics
74 // - Add Port
75 // CR632 - Add LogicalModule and ModulePort
76 // CR639 - Add LogicalPortGroup
77 // CR783 - Remove Port and Add NetworkPort
78 // - Add EthernetPort, EthernetPortStatistics, TokenRingPort,
79 // TokenRingStatistics, OOBAlertServiceOnNetworkPort and
80 // WakeUpServiceOnNetworkPort
81 // - Modify ModulePort Ref from Port to NetworkPort
82 // - Add NetworkVirtualPort
83 // CR845 - Add PortActiveConnection
84 // - Remove NetworkVirtualPort
85 tony 1.1 // CR852 - Change the superclass of NetworkPortStatistics to
86 // StatisticalData
87 // CR896 - Clarify the meaning of Speed in LogicalPort and its
88 // subclass NetworkPort
89 // ==================================================================
90
91 #pragma locale ("en_US")
92
93
94 // ===================================================================
95 // LogicalPort
96 // ===================================================================
97 [Version ( "2.8.0" ), Description (
98 "The abstraction of a port or connection point of a Device. "
99 "This object should be instantiated when the Port has "
100 "independent management characteristics from the Device that "
101 "includes it. Examples are a Fibre Channel Port and a USB Port.")]
102 class CIM_LogicalPort : CIM_LogicalDevice {
103
104 [Description (
105 "The bandwidth of the Port in Bits per Second."),
106 tony 1.1 Units ( "Bits per Second" )]
107 uint64 Speed;
108
109 [Description (
110 "The maximum bandwidth of the Port in Bits per Second."),
111 Units ( "Bits per Second" )]
112 uint64 MaxSpeed;
113
114 [Write, Description (
115 "The requested bandwidth of the Port in Bits per Second. The "
116 "actual bandwidth is reported in LogicalPort.Speed."),
117 Units ( "Bits per Second" ),
118 ModelCorrespondence { "CIM_LogicalPort.Speed" }]
119 uint64 RequestedSpeed;
120
121 [Description (
122 "In some circumstances, a LogicalPort may be identifiable as "
123 "a front end or back end port. An example of this would be a "
124 "storage array which might have back end ports to "
125 "communicate with disk drives and front end ports to "
126 "communicate with hosts. If there is no restriction on the "
127 tony 1.1 "use of the port, then the value should be set to 'not "
128 "restricted'."),
129 ValueMap { "0", "2", "3", "4" },
130 Values { "Unknown", "Front-end only", "Back-end only",
131 "Not restricted" }]
132 uint16 UsageRestriction;
133 };
134
135
136 // ===================================================================
137 // PortOnDevice
138 // ===================================================================
139 [Association, Version ( "2.8.0" ), Description (
140 "PortOnDevice associates a Port or connection point with its "
141 "Device.")]
142 class CIM_PortOnDevice : CIM_HostedDependency {
143
144 [Override ( "Antecedent" ), Description (
145 "The Device that includes the Port.")]
146 CIM_LogicalDevice REF Antecedent;
147
148 tony 1.1 [Override ( "Dependent" ), Description (
149 "The Port on the Device.")]
150 CIM_LogicalPort REF Dependent;
151 };
152
153
154 // ==================================================================
155 // LogicalPortGroup
156 // ==================================================================
157 [Version ( "2.8.0" ), Description (
158 "A collection of one or more ports logically grouped for "
159 "administrative and discovery/topology purposes. "
160 "LogicalPortGroups define port collections for access control, "
161 "or for use in routing policy or other management tasks. For "
162 "example, in Fibre Channel and Infiniband, a LogicalPortGroup "
163 "represents the concept of a 'node'.")]
164 class CIM_LogicalPortGroup : CIM_SystemSpecificCollection {
165
166 [Description (
167 "The Name property defines the identity by which the "
168 "LogicalPortGroup is known."),
169 tony 1.1 MaxLen ( 256 ),
170 ModelCorrespondence { "CIM_LogicalPortGroup.NameFormat" }]
171 string Name;
172
173 [Description (
174 "The NameFormat property identifies how the Name of the "
175 "LogicalPortGroup is generated."),
176 ValueMap { "Unknown", "Other", "WWN", "GUID" }, MaxLen ( 64 ),
177 ModelCorrespondence { "CIM_LogicalPortGroup.Name",
178 "CIM_LogicalPortGroup.OtherNameFormat" }]
179 string NameFormat;
180
181 [Description (
182 "A string describing how the LogicalPortGroup is identified "
183 "when the NameFormat is \"Other\"."),
184 ModelCorrespondence { "CIM_LogicalPortGroup.Name" }]
185 string OtherNameFormat;
186 };
187
188
189 // ==================================================================
190 tony 1.1 // NetworkPort
191 // ==================================================================
192 [Version ( "2.8.0" ), Description (
193 "NetworkPort is the logical representation of network "
194 "communications hardware - a physical connector and the "
195 "setup/operation of the network chips, at the lowest layers of "
196 "a network stack.")]
197 class CIM_NetworkPort : CIM_LogicalPort {
198
199 [Override ( "Speed" ), Description (
200 "The current bandwidth of the Port in Bits per Second. For "
201 "ports that vary in bandwidth or for those where no accurate "
202 "estimation can be made, this property should contain the "
203 "nominal bandwidth."),
204 Units ( "Bits per Second" ),
205 MappingStrings { "MIB.IETF|MIB-II.ifSpeed",
206 "MIF.DMTF|Network Adapter 802 Port|001.5" }]
207 uint64 Speed;
208
209 [Description (
210 "PortType is defined to force consistent naming of the "
211 tony 1.1 "'type' property in subclasses and to guarantee unique enum "
212 "values for all instances of NetworkPort. When set to 1 "
213 "(\"Other\"), related property OtherPortType contains a "
214 "string description the of the port's type. A range of "
215 "values, DMTF_Reserved, has been defined that allows "
216 "subclasses to override and define their specific port "
217 "types."),
218 ValueMap { "0", "1", "2", "3..15999", "16000..65535" },
219 Values { "Unknown", "Other", "Not Applicable", "DMTF Reserved",
220 "Vendor Reserved" },
221 ModelCorrespondence { "CIM_NetworkPort.OtherNetworkPortType" }]
222 uint16 PortType;
223
224 [Description (
225 "Describes the type of module, when PortType is set to 1 "
226 "(\"Other\")."),
227 ModelCorrespondence { "CIM_NetworkPort.PortType" }]
228 string OtherNetworkPortType;
229
230 [Description (
231 "NetworkPorts are often numbered relative to either a "
232 tony 1.1 "logical modules or a network element.")]
233 uint16 PortNumber;
234
235 [Description (
236 "An enumeration of the types of links. When set to 1 "
237 "(\"Other\"), the related property OtherLinkTechnology "
238 "contains a string description of the link's type."),
239 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
240 "10", "11" },
241 Values { "Unknown", "Other", "Ethernet", "IB", "FC", "FDDI",
242 "ATM", "Token Ring", "Frame Relay", "Infrared", "BlueTooth",
243 "Wireless LAN" },
244 ModelCorrespondence { "CIM_NetworkPort.OtherLinkTechnology" }]
245 uint16 LinkTechnology;
246
247 [Description (
248 "A string value describing LinkTechnology when it is set to "
249 "1, \"Other\"."),
250 ModelCorrespondence { "CIM_NetworkPort.LinkTechnology" }]
251 string OtherLinkTechnology;
252
253 tony 1.1 [Description (
254 "PermanentAddress defines the network address hardcoded into "
255 "a port. This 'hardcoded' address may be changed via "
256 "firmware upgrade or software configuration. If so, this "
257 "field should be updated when the change is made. "
258 "PermanentAddress should be left blank if no 'hardcoded' "
259 "address exists for the NetworkAdapter."),
260 MaxLen ( 64 ),
261 MappingStrings { "MIF.DMTF|Network Adapter 802 Port|001.2" }]
262 string PermanentAddress;
263
264 [Description (
265 "An array of strings indicating the network addresses for "
266 "the port."),
267 MaxLen ( 64 ),
268 MappingStrings { "MIF.DMTF|Network Adapter 802 Port|001.3" }]
269 string NetworkAddresses[];
270
271 [Description (
272 "Boolean indicating that the port is operating in full "
273 "duplex mode.")]
274 tony 1.1 boolean FullDuplex;
275
276 [Description (
277 "A boolean indicating whether the NetworkPort is capable of "
278 "automatically determining the speed or other communications "
279 "characteristics of the attached network media.")]
280 boolean AutoSense;
281
282 [Description (
283 "The maximum transmission unit (MTU) that can be supported."),
284 Units ( "Bytes" )]
285 uint64 SupportedMaximumTransmissionUnit;
286
287 [Description (
288 "The active or negotiated maximum transmission unit (MTU) "
289 "that can be supported."),
290 Units ( "Bytes" )]
291 uint64 ActiveMaximumTransmissionUnit;
292 };
293
294
295 tony 1.1 // ===================================================================
296 // EthernetPort
297 // ===================================================================
298 [Version ( "2.7.0" ), Description (
299 "Capabilities and management of an EthernetPort.")]
300 class CIM_EthernetPort : CIM_NetworkPort {
301
302 [Override ( "PortType" ), Description (
303 "The specific mode currently enabled for the Port. When set "
304 "to 1 (\"Other\"), the related property OtherPortType "
305 "contains a string description of the port's type."),
306 ValueMap { "0", "1", "50", "51", "52", "53", "16000..65535" },
307 Values { "Unknown", "Other", "10BaseT", "10-100BaseT",
308 "100BaseT", "1000BaseT", "Vendor Reserved" }]
309 uint16 PortType;
310
311 [Override ( "NetworkAddresses" ), Description (
312 "Ethernet/802.3 MAC addresses formatted as twelve "
313 "hexadecimal digits (e.g. \"010203040506\"), with each pair "
314 "representing one of the six octets of the MAC address in "
315 "\"canonical\" bit order. (Thus, the Group address bit is "
316 tony 1.1 "found in the low order bit of the first character of the "
317 "string.)")]
318 string NetworkAddresses[];
319
320 [Description (
321 "The maximum size of the INFO (non-MAC) field that will be "
322 "received or transmitted."),
323 MappingStrings { "MIB.IETF|BRIDGE-MIB.dot1dTpPortMaxInfo" }]
324 uint32 MaxDataSize;
325
326 [Description (
327 "Capabilities of the EthernetPort. For example, the Device "
328 "may support AlertOnLan, WakeOnLan, Load Balancing and/or "
329 "FailOver. If failover or load balancing capabilities are "
330 "listed, a SpareGroup (failover) or ExtraCapacityGroup (load "
331 "balancing) should also be defined to completely describe "
332 "the capability."),
333 ValueMap { "0", "1", "2", "3", "4", "5" },
334 Values { "Unknown", "Other", "AlertOnLan", "WakeOnLan",
335 "FailOver", "LoadBalancing" }, ArrayType ( "Indexed" ),
336 ModelCorrespondence { "CIM_EthernetPort.CapabilityDescriptions"
337 tony 1.1 }]
338 uint16 Capabilities[];
339
340 [Description (
341 "An array of free-form strings providing more detailed "
342 "explanations for any of the EthernetPort features indicated "
343 "in the Capabilities array. Note, each entry of this array "
344 "is related to the entry in the Capabilities array that is "
345 "located at the same index."),
346 ArrayType ( "Indexed" ),
347 ModelCorrespondence { "CIM_EthernetPort.Capabilities" }]
348 string CapabilityDescriptions[];
349
350 [Description (
351 "Specifies which capabilities are enabled from the list of "
352 "all supported ones, defined in the Capabilities array."),
353 ValueMap { "0", "1", "2", "3", "4", "5" },
354 Values { "Unknown", "Other", "AlertOnLan", "WakeOnLan",
355 "FailOver", "LoadBalancing" }, ArrayType ( "Indexed" ),
356 ModelCorrespondence { "CIM_EthernetPort.Capabilities",
357 "CIM_EthernetPort.OtherEnabledCapabilities" }]
358 tony 1.1 uint16 EnabledCapabilities[];
359
360 [Description (
361 "An array of free-form strings providing more detailed "
362 "explanations for any of the enabled capabilities that are "
363 "specified as 'Other'."),
364 ArrayType ( "Indexed" ),
365 ModelCorrespondence { "CIM_EthernetPort.EnabledCapabilities" }]
366 string OtherEnabledCapabilities[];
367 };
368
369
370 // ===================================================================
371 // TokenRingPort
372 // ===================================================================
373 [Version ( "2.7.0" ), Description (
374 "Capabilities and management of a TokenRingPort.")]
375 class CIM_TokenRingPort : CIM_NetworkPort {
376
377 [Override ( "NetworkAddresses" ), Description (
378 "Token Ring/802.5 MAC addresses formatted as twelve "
379 tony 1.1 "hexadecimal digits (e.g. \"010203040506\"), with each pair "
380 "representing one of the six octets of the MAC address in "
381 "\"canonical\" bit order. (Thus, the Group address bit is "
382 "found in the low order bit of the first character of the "
383 "string.)")]
384 string NetworkAddresses[];
385
386 [Description (
387 "The maximum size of the INFO (non-MAC) field that will be "
388 "received or transmitted."),
389 MappingStrings { "MIB.IETF|BRIDGE-MIB.dot1dTpPortMaxInfo" }]
390 uint32 MaxDataSize;
391
392 [Description (
393 "Capabilities of the TokenRingPort. For example, the Device "
394 "may support AlertOnLan, WakeOnLan, Load Balancing and/or "
395 "Failover. If failover or load balancing capabilities are "
396 "listed, a SpareGroup (failover) or ExtraCapacityGroup (load "
397 "balancing) should also be defined to completely describe "
398 "the capability."),
399 ValueMap { "0", "1", "2", "3", "4", "5" },
400 tony 1.1 Values { "Unknown", "Other", "AlertOnLan", "WakeOnLan",
401 "FailOver", "LoadBalancing" }, ArrayType ( "Indexed" ),
402 ModelCorrespondence { "CIM_TokenRingPort.CapabilityDescriptions"
403 }]
404 uint16 Capabilities[];
405
406 [Description (
407 "An array of free-form strings providing more detailed "
408 "explanations for any of the TokenRingAPort features "
409 "indicated in the Capabilities array. Note, each entry of "
410 "this array is related to the entry in the Capabilities "
411 "array that is located at the same index."),
412 ArrayType ( "Indexed" ),
413 ModelCorrespondence { "CIM_TokenRingPort.Capabilities" }]
414 string CapabilityDescriptions[];
415
416 [Description (
417 "Specifies which of the capabilities from the "
418 "\"Capabilities\" property are currently enabled."),
419 ValueMap { "0", "1", "2", "3", "4", "5" },
420 Values { "Unknown", "Other", "AlertOnLan", "WakeOnLan",
421 tony 1.1 "FailOver", "LoadBalancing" }, ArrayType ( "Indexed" ),
422 ModelCorrespondence { "CIM_TokenRingPort.Capabilities",
423 "CIM_TokenRingPort.OtherEnabledCapabilities" }]
424 uint16 EnabledCapabilities[];
425
426 [Description (
427 "An array of free-form strings providing more detailed "
428 "explanations for any of the enabled capabilities that are "
429 "specified as 'Other'."),
430 ArrayType ( "Indexed" ),
431 ModelCorrespondence { "CIM_TokenRingPort.EnabledCapabilities" }]
432 string OtherEnabledCapabilities[];
433
434 [Description (
435 "The current status which can be used to diagnose "
436 "fluctuating problems that can occur on token rings, after a "
437 "station has successfully been added to the ring. Before an "
438 "open is completed, this object contains the value "
439 "indicating \"no status\" (131072). (The RingState and "
440 "RingOpenStatus properties are also provided for debugging "
441 "problems when the station can not even enter the ring.) The "
442 tony 1.1 "property's value is a sum of values, one for each currently "
443 "applicable condition. The following values are defined for "
444 "various conditions: \n"
445 "0 = No Problems Detected, 32 = Ring Recovery, 64 = Single "
446 "Station, 256 = Remove Received, 512 = Reserved, 1024 = "
447 "Auto-Removal Error, 2048 = Lobe Wire Fault, 4096 = Transmit "
448 "Beacon, 8192 = Soft Error, 16384 = Hard Error, 32768 = "
449 "Signal Loss, 131072 = No Status, Open Not Completed."),
450 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
451 "MIB.dot5RingStatus" }]
452 uint32 RingStatus;
453
454 [Description (
455 "The current Device state with respect to entering or "
456 "leaving the ring."),
457 ValueMap { "0", "1", "2", "3", "4", "5" },
458 Values { "Opened", "Closed", "Opening", "Closing",
459 "Open Failure", "Ring Failure" },
460 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
461 "MIB.dot5RingState" }]
462 uint16 RingState;
463 tony 1.1
464 [Description (
465 "This property indicates the success, or the reason for "
466 "failure, of the station's most recent attempt to enter the "
467 "ring."),
468 ValueMap { "0", "1", "2", "3", "4", "5", "6", "7", "8", "9",
469 "10" },
470 Values { "No Open Attempted", "Bad Parameter", "Lobe Failed",
471 "Signal Loss", "Insertion Timeout", "Ring Failed",
472 "Beaconing", "Duplicate MAC", "Request Failed",
473 "Remove Received",
474 // 10
475 "Last Open Successful" },
476 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
477 "MIB.dot5RingOpenStatus" }]
478 uint16 RingOpenStatus;
479
480 [Description (
481 "The ring's bandwidth."),
482 ValueMap { "0", "1", "2", "3", "4" },
483 Values { "Unknown", "Other", "One Megabit", "Four Megabit",
484 tony 1.1 "Sixteen Megabit" },
485 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
486 "MIB.dot5RingSpeed" }]
487 uint16 RingSpeed;
488 };
489
490
491 // ===================================================================
492 // OOBAlertServiceOnNetworkPort
493 // ===================================================================
494 [Association, Version ( "2.7.0" ), Description (
495 "OOBAlertServiceOnNetworkPort defines where the out of band "
496 "alerting Service is implemented. Currently, the Service can "
497 "either employ a Modem or a NetworkPort to send alerts.")]
498 class CIM_OOBAlertServiceOnNetworkPort : CIM_DeviceServiceImplementation {
499
500 [Override ( "Antecedent" ), Max ( 1 ), Description (
501 "The NetworkPort which implements the Service.")]
502 CIM_NetworkPort REF Antecedent;
503
504 [Override ( "Dependent" ), Description (
505 tony 1.1 "The alerting Service provided on the NetworkPort.")]
506 CIM_OOBAlertService REF Dependent;
507 };
508
509
510 // ===================================================================
511 // WakeUpServiceOnNetworkPort
512 // ===================================================================
513 [Association, Version ( "2.7.0" ), Description (
514 "WakeUpServiceOnNetworkPort defines where the WakeUpService is "
515 "implemented. Currently, the Service can either employ a Modem "
516 "or a NetworkPort for wakeup.")]
517 class CIM_WakeUpServiceOnNetworkPort : CIM_DeviceServiceImplementation {
518
519 [Override ( "Antecedent" ), Max ( 1 ), Description (
520 "The NetworkPort which implements the Service.")]
521 CIM_NetworkPort REF Antecedent;
522
523 [Override ( "Dependent" ), Description (
524 "The wakeup Service provided on the NetworkPort.")]
525 CIM_WakeUpService REF Dependent;
526 tony 1.1 };
527
528
529 // ===================================================================
530 // PortImplementsEndpoint
531 // ===================================================================
532 [Association, Version ( "2.6.0" ), Description (
533 "PortImplementsEndpoint associates a LogicalPort with one or "
534 "more ProtocolEndpoints that are implemented on it. This class "
535 "specializes the DeviceSAPImplementation association. It "
536 "indicates that the referenced Endpoint is dependent on the "
537 "operations of the Port Device.")]
538 class CIM_PortImplementsEndpoint : CIM_DeviceSAPImplementation {
539
540 [Override ( "Antecedent" ), Description (
541 "The LogicalPort that represents the Device behind the "
542 "ProtocolEndpoint.")]
543 CIM_LogicalPort REF Antecedent;
544
545 [Override ( "Dependent" ), Description (
546 "The ProtocolEndpoint implemented on the LogicalPort.")]
547 tony 1.1 CIM_ProtocolEndpoint REF Dependent;
548 };
549
550
551 // ==================================================================
552 // NetworkPortStatistics
553 // ==================================================================
554 [Version ( "2.7.0" ), Description (
555 "The NetworkPortStatistics class describes the statistics for "
556 "the NetworkPort.")]
557 class CIM_NetworkPortStatistics : CIM_StatisticalData {
558
559 [Description (
560 "The total number of bytes transmitted, including framing "
561 "characters."),
562 Units ( "Bytes" ), Counter,
563 MappingStrings { "MIB.IETF|MIB-II.ifOutOctets",
564 "MIF.DMTF|Network Adapter 802 Port|001.7" }]
565 uint64 BytesTransmitted;
566
567 [Description (
568 tony 1.1 "The total number of bytes received, including framing "
569 "characters."),
570 Units ( "Bytes" ), Counter,
571 MappingStrings { "MIB.IETF|MIB-II.ifInOctets",
572 "MIF.DMTF|Network Adapter 802 Port|001.9" }]
573 uint64 BytesReceived;
574
575 [Description (
576 "The total number of packets transmitted."),
577 Counter]
578 uint64 PacketsTransmitted;
579
580 [Description (
581 "The total number of packets received."),
582 Counter]
583 uint64 PacketsReceived;
584 };
585
586
587 // ==================================================================
588 // EthernetPortStatistics
589 tony 1.1 // ==================================================================
590 [Version ( "2.7.0" ), Description (
591 "The EthernetPortStatistics class describes the statistics for "
592 "the EthernetPort.")]
593 class CIM_EthernetPortStatistics : CIM_NetworkPortStatistics {
594
595 [Override ( "PacketsTransmitted" ), Description (
596 "The total number of packets transmitted."),
597 Counter,
598 MappingStrings { "MIF.DMTF|Network Adapter 802 Port|001.6" }]
599 uint64 PacketsTransmitted;
600
601 [Override ( "PacketsReceived" ), Description (
602 "The total number of packets received."),
603 Counter,
604 MappingStrings { "MIF.DMTF|Network Adapter 802 Port|001.8" }]
605 uint64 PacketsReceived;
606
607 [Description (
608 "The number of times there was an invalid data symbol when a "
609 "valid carrier was present. The count is incremented at most "
610 tony 1.1 "once per carrier event, even if multiple symbol errors "
611 "occur during the carrier event."),
612 Counter,
613 MappingStrings { "MIB.IETF|EtherLike-MIB.dot3StatsSymbolErrors"
614 }]
615 uint32 SymbolErrors;
616
617 [Description (
618 "A count of frames received on a particular interface that "
619 "are not an integral number of octets in length and do not "
620 "pass the FCS check. The count represented by an instance of "
621 "this object is incremented when the alignment error status "
622 "is returned by the MAC layer to the LLC (or other MAC "
623 "user). Received frames for which multiple error conditions "
624 "obtain are, according to the conventions of IEEE 802.3 "
625 "Layer Management, counted exclusively according to the "
626 "error status presented to the LLC."),
627 Counter,
628 MappingStrings {
629 "MIB.IETF|EtherLike-MIB.dot3StatsAlignmentErrors" }]
630 uint32 AlignmentErrors;
631 tony 1.1
632 [Description (
633 "A count of frames received on a particular interface that "
634 "are an integral number of octets in length but do not pass "
635 "the FCS check. The count represented by an instance of this "
636 "object is incremented when the frame check error status is "
637 "returned by the MAC layer to the LLC (or other MAC user). "
638 "Received frames for which multiple error conditions obtain "
639 "are, according to the conventions of IEEE 802.3 Layer "
640 "Management, counted exclusively according to the error "
641 "status presented to the LLC."),
642 Counter,
643 MappingStrings { "MIB.IETF|EtherLike-MIB.dot3StatsFCSErrors" }]
644 uint32 FCSErrors;
645
646 [Description (
647 "A count of successfully transmitted frames on a particular "
648 "interface for which transmission is inhibited by exactly "
649 "one collision. A frame that is counted by an instance of "
650 "this object is not counted by the corresponding instance of "
651 "the MultipleCollisionFrames property."),
652 tony 1.1 Counter,
653 MappingStrings {
654 "MIB.IETF|EtherLike-MIB.dot3StatsSingleCollisionFrames" }]
655 uint32 SingleCollisionFrames;
656
657 [Description (
658 "A count of successfully transmitted frames on a particular "
659 "interface for which transmission is inhibited by more than "
660 "one collision. A frame that is counted by an instance of "
661 "this object is not counted by the corresponding instance of "
662 "the SingleCollisionFrames property."),
663 Counter,
664 MappingStrings {
665 "MIB.IETF|EtherLike-MIB.dot3StatsMultipleCollisionFrames" }]
666 uint32 MultipleCollisionFrames;
667
668 [Description (
669 "A count of times that the SQE TEST ERROR message is "
670 "generated by the PLS sublayer for a particular interface. "
671 "The SQE TEST ERROR message is defined in section 7.2.2.2.4 "
672 "of ANSI/IEEE 802.3-1985 and its generation is described in "
673 tony 1.1 "section 7.2.4.6 of the same document."),
674 Counter,
675 MappingStrings { "MIB.IETF|EtherLike-MIB.dot3StatsSQETestErrors"
676 }]
677 uint32 SQETestErrors;
678
679 [Description (
680 "A count of frames for which the first transmission attempt "
681 "on a particular interface is delayed because the medium is "
682 "busy. The count represented by an instance of this object "
683 "does not include frames involved in collisions."),
684 Counter,
685 MappingStrings {
686 "MIB.IETF|EtherLike-MIB.dot3StatsDeferredTransmissions" }]
687 uint32 DeferredTransmissions;
688
689 [Description (
690 "The number of times that a collision is detected on a "
691 "particular interface later than 512 bit-times into the "
692 "transmission of a packet. Five hundred and twelve bit- "
693 "times corresponds to 51.2 microseconds on a 10 Mbit/s "
694 tony 1.1 "system. A (late) collision included in a count represented "
695 "by an instance of this object is also considered as a "
696 "(generic) collision for purposes of other collision-related "
697 "statistics."),
698 Counter,
699 MappingStrings {
700 "MIB.IETF|EtherLike-MIB.dot3StatsLateCollisions" }]
701 uint32 LateCollisions;
702
703 [Description (
704 "A count of frames for which transmission on a particular "
705 "interface fails due to excessive collisions."),
706 Counter,
707 MappingStrings {
708 "MIB.IETF|EtherLike-MIB.dot3StatsExcessiveCollisions" }]
709 uint32 ExcessiveCollisions;
710
711 [Description (
712 "A count of frames for which transmission on a particular "
713 "interface fails due to an internal MAC sublayer transmit "
714 "error. A frame is only counted by an instance of this "
715 tony 1.1 "object if it is not counted by the corresponding instance "
716 "of either the LateCollisions property, the Excessive "
717 "Collisions property, or the CarrierSenseErrors property. "
718 "The precise meaning of the count represented by an instance "
719 "of this object is implementation-specific. In particular, "
720 "an instance of this object may represent a count of "
721 "transmission errors on a particular interface that are not "
722 "otherwise counted."),
723 Counter,
724 MappingStrings { "MIB.IETF|EtherLike-MIB."
725 "dot3StatsInternalMacTransmitErrors" }]
726 uint32 InternalMACTransmitErrors;
727
728 [Description (
729 "A count of frames for which reception on a particular "
730 "interface fails due to an internal MAC sublayer receive "
731 "error. A frame is only counted by an instance of this "
732 "object if it is not counted by the corresponding instance "
733 "of either the FrameTooLongs property, the AlignmentErrors "
734 "property, or the FCSErrors property. The precise meaning of "
735 "the count represented by an instance of this object is "
736 tony 1.1 "implementation-specific. In particular, an instance of this "
737 "object may represent a count of receive errors on a "
738 "particular interface that are not otherwise counted."),
739 Counter,
740 MappingStrings {
741 "MIB.IETF|EtherLike-MIB.dot3StatsInternalMacReceiveErrors" }]
742 uint32 InternalMACReceiveErrors;
743
744 [Description (
745 "The number of times that the carrier sense condition was "
746 "lost or never asserted when attempting to transmit a frame "
747 "on a particular interface. The count represented by an "
748 "instance of this object is incremented at most once per "
749 "transmission attempt, even if the carrier sense condition "
750 "fluctuates during a transmission attempt."),
751 Counter,
752 MappingStrings {
753 "MIB.IETF|EtherLike-MIB.dot3StatsCarrierSenseErrors" }]
754 uint32 CarrierSenseErrors;
755
756 [Description (
757 tony 1.1 "A count of frames received on a particular interface that "
758 "exceed the maximum permitted frame size. The count "
759 "represented by an instance of this object is incremented "
760 "when the FrameTooLong status is returned by the MAC layer "
761 "to the LLC (or other MAC user). Received frames for which "
762 "multiple error conditions obtain are, according to the "
763 "conventions of IEEE 802.3 Layer Management, counted "
764 "exclusively according to the error status presented to the "
765 "LLC."),
766 Counter,
767 MappingStrings { "MIB.IETF|EtherLike-MIB.dot3StatsFrameTooLongs"
768 }]
769 uint32 FrameTooLongs;
770 };
771
772
773 // ==================================================================
774 // TokenRingPortStatistics
775 // ==================================================================
776 [Version ( "2.7.0" ), Description (
777 "The TokenRingPortStatistics class describes the statistics for "
778 tony 1.1 "the TokenRingPort.")]
779 class CIM_TokenRingPortStatistics : CIM_NetworkPortStatistics {
780
781 [Description (
782 "This counter is incremented when a station detects the "
783 "absence of transitions for five half-bit timers (burst-five "
784 "errors)."),
785 Counter,
786 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
787 "MIB.dot5StatsBurstErrors" }]
788 uint32 BurstErrors;
789
790 [Description (
791 "This counter is incremented when a station receives an AMP "
792 "or SMP frame in which A is equal to C is equal to 0, and "
793 "then receives another SMP frame with A equal to C equal to "
794 "0 without first receiving an AMP frame. It denotes a "
795 "station that cannot set the AC bits properly."),
796 Counter,
797 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
798 "MIB.dot5StatsACErrors" }]
799 tony 1.1 uint32 ACErrors;
800
801 [Description (
802 "This counter is incremented when a station transmits an "
803 "abort delimiter while transmitting data."),
804 Counter,
805 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
806 "MIB.dot5StatsAbortTransErrors" }]
807 uint32 AbortTransErrors;
808
809 [Description (
810 "This counter is incremented when a station recognizes an "
811 "internal error."),
812 Counter,
813 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
814 "MIB.dot5StatsInternalErrors" }]
815 uint32 InternalErrors;
816
817 [Description (
818 "This counter is incremented when a station is transmitting "
819 "and its TRR timer expires. This denotes a condition where a "
820 tony 1.1 "transmitting station in strip mode does not receive the "
821 "trailer of the frame before the TRR timer goes off."),
822 Counter,
823 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
824 "MIB.dot5StatsLostFrameErrors" }]
825 uint32 LostFrameErrors;
826
827 [Description (
828 "This counter is incremented when a station recognizes a "
829 "frame addressed to its specific address, but has no "
830 "available buffer space - indicating that the station is "
831 "congested."),
832 Counter,
833 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
834 "MIB.dot5StatsReceiveCongestions" }]
835 uint32 ReceiveCongestions;
836
837 [Description (
838 "This counter is incremented when a station recognizes a "
839 "frame addressed to its specific address and detects that "
840 "the FS field A bits are set to 1 indicating a possible line "
841 tony 1.1 "hit or duplicate address."),
842 Counter,
843 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
844 "MIB.dot5StatsFrameCopiedErrors" }]
845 uint32 FrameCopiedErrors;
846
847 [Description (
848 "This counter is incremented when a station acting as the "
849 "active monitor recognizes an error condition that needs a "
850 "token transmitted."),
851 Counter,
852 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
853 "MIB.dot5StatsTokenErrors" }]
854 uint32 TokenErrors;
855
856 [Description (
857 "The number of Soft Errors that the Device has detected. It "
858 "directly corresponds to the number of Report Error MAC "
859 "frames that this Device has transmitted. Soft Errors are "
860 "those which are recoverable by the MAC layer protocols."),
861 Counter,
862 tony 1.1 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
863 "MIB.dot5StatsSoftErrors" }]
864 uint32 SoftErrors;
865
866 [Description (
867 "The number of times this Device has detected an immediately "
868 "recoverable fatal error. It denotes the number of times "
869 "this Device is either transmitting or receiving beacon MAC "
870 "frames."),
871 Counter,
872 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
873 "MIB.dot5StatsHardErrors" }]
874 uint32 HardErrors;
875
876 [Description (
877 "The number of times this Device has detected the loss of "
878 "signal condition from the ring."),
879 Counter,
880 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
881 "MIB.dot5StatsSignalLoss" }]
882 uint32 SignalLossCount;
883 tony 1.1
884 [Description (
885 "The number of times this Device has transmitted a beacon "
886 "frame."),
887 Counter,
888 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
889 "MIB.dot5StatsTransmitBeacons" }]
890 uint32 TransmittedBeacons;
891
892 [Description (
893 "The number of Claim Token MAC frames received or "
894 "transmitted after the Device has received a Ring Purge MAC "
895 "frame. This counter signifies the number of times the ring "
896 "has been purged and is being recovered back into a normal "
897 "operating state."),
898 Counter,
899 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
900 "MIB.dot5StatsRecoverys" }]
901 uint32 Recoverys;
902
903 [Description (
904 tony 1.1 "The number of times the Device has detected an open or "
905 "short circuit in the lobe data path. The port will be "
906 "closed and RingState will signify this condition."),
907 Counter,
908 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
909 "MIB.dot5StatsLobeWires" }]
910 uint32 LobeWires;
911
912 [Description (
913 "The number of times the Device has received a Remove Ring "
914 "Station MAC frame request. When this frame is received, the "
915 "Device will enter the close state and RingState will "
916 "signify this condition."),
917 Counter,
918 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
919 "MIB.dot5StatsRemoves" }]
920 uint32 Removes;
921
922 [Description (
923 "The number of times the Device has sensed that it is the "
924 "only station on the ring. This will happen if the Device is "
925 tony 1.1 "the first one up on a ring, or if there is a hardware "
926 "problem."),
927 Counter,
928 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
929 "MIB.dot5StatsSingles" }]
930 uint32 Singles;
931
932 [Description (
933 "The number of times the Device has detected that the "
934 "frequency of the incoming signal differs from the expected "
935 "frequency by more than that specified by the IEEE 802.5 "
936 "standard."),
937 Counter,
938 MappingStrings { "MIB.IETF|IEEE 802.5 Token Ring "
939 "MIB.dot5StatsFreqErrors" }]
940 uint32 FrequencyErrors;
941 };
942
943
944 // ==================================================================
945 // LogicalModule
946 tony 1.1 // ==================================================================
947 [Version ( "2.8.0" ), Description (
948 "LogicalModule is the logical device corresponding to a line "
949 "card/blade in a device. For example, a line card in a switch "
950 "is an instance of LogicalModule, associated with the the "
951 "switch itself. A logical module is not necessarily "
952 "independently managed.")]
953 class CIM_LogicalModule : CIM_LogicalDevice {
954
955 [Description (
956 "Logical modules are often named by the physical or logical "
957 "slot that they occupy within the containing device. "
958 "ModuleNumber is the number assigned to the module by its "
959 "parent.")]
960 uint16 ModuleNumber;
961 };
962
963
964 // ==================================================================
965 // ModulePort
966 // ==================================================================
967 tony 1.1 [Association, Aggregation, Version ( "2.8.0" ), Description (
968 "ModulePort associates ports with their hosting modules.")]
969 class CIM_ModulePort : CIM_Component {
970
971 [Aggregate, Override ( "GroupComponent" ), Max ( 1 ),
972 Description (
973 "A module that has ports.")]
974 CIM_LogicalModule REF GroupComponent;
975
976 [Override ( "PartComponent" ), Description (
977 "A Port that is associated with a module.")]
978 CIM_NetworkPort REF PartComponent;
979 };
980
981
982 // ===================================================================
983 // PortActiveConnection
984 // ===================================================================
985 [Association, Version ( "2.8.0" ), Description (
986 "The PortActiveConnection relationship indicates that a "
987 "NetworkPort is using the referenced PhysicalConnector to "
988 tony 1.1 "output to the network. This relationship is important when the "
989 "port can choose to output from one of several connectors. The "
990 "connectors may be associated with the NetworkPort in a "
991 "Realizes relationship - but this is not required. This "
992 "association provides additional information (i.e., 'in use for "
993 "communication') different than Realizes.")]
994 class CIM_PortActiveConnection : CIM_Dependency {
995
996 [Override ( "Antecedent" ), Description (
997 "The PhysicalConnector.")]
998 CIM_PhysicalConnector REF Antecedent;
999
1000 [Override ( "Dependent" ), Description (
1001 "The NetworkPort that transmits using the Connector.")]
1002 CIM_NetworkPort REF Dependent;
1003 };
1004
1005 // ===================================================================
1006 // end of file
1007 // ===================================================================
|