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