.. _CIM-Processor:

CIM_Processor
-------------

Subclass of :ref:`CIM_LogicalDevice <CIM-LogicalDevice>`

Capabilities and management of the Processor LogicalDevice.


Key properties
^^^^^^^^^^^^^^

| :ref:`SystemName <CIM-LogicalDevice-SystemName>`
| :ref:`DeviceID <CIM-LogicalDevice-DeviceID>`
| :ref:`CreationClassName <CIM-LogicalDevice-CreationClassName>`
| :ref:`SystemCreationClassName <CIM-LogicalDevice-SystemCreationClassName>`

Local properties
^^^^^^^^^^^^^^^^

.. _CIM-Processor-LoadPercentage:

``uint16`` **LoadPercentage**

    Loading of this Processor, averaged over the last minute, in Percent.

    
.. _CIM-Processor-ExternalBusClockSpeed:

``uint32`` **ExternalBusClockSpeed**

    The speed (in MHz) of the external bus interface (also known as the front side bus).

    
.. _CIM-Processor-MaxClockSpeed:

``uint32`` **MaxClockSpeed**

    The maximum speed (in MHz) of this Processor.

    
.. _CIM-Processor-UniqueID:

``string`` **UniqueID**

    A globally unique identifier for the Processor. This identifier can be unique only within a Processor Family.

    
.. _CIM-Processor-AddressWidth:

``uint16`` **AddressWidth**

    Processor address width in bits.

    
.. _CIM-Processor-CurrentClockSpeed:

``uint32`` **CurrentClockSpeed**

    The current speed (in MHz) of this Processor.

    
.. _CIM-Processor-Stepping:

``string`` **Stepping**

    Stepping is a free-form string that indicates the revision level of the Processor within the Processor.Family.

    
.. _CIM-Processor-DataWidth:

``uint16`` **DataWidth**

    Processor data width in bits.

    
.. _CIM-Processor-NumberOfEnabledCores:

``uint16`` **NumberOfEnabledCores**

    Number of processor cores enabled for processor.

    
.. _CIM-Processor-OtherFamilyDescription:

``string`` **OtherFamilyDescription**

    A string that describes the Processor Family type. It is used when the Family property is set to 1 ("Other"). This string should be set to NULL when the Family property is any value other than 1.

    
.. _CIM-Processor-Family:

``uint16`` **Family**

    The Processor family type. For example, values include "Pentium(R) processor with MMX(TM) technology" (value=14) and "68040" (value=96).

    
.. _CIM-Processor-Characteristics:

``uint16[]`` **Characteristics**

    Array of enumerated values that describes the characteristics of the processor. The characteristics include certain features of the processor such as 64 bit support for data width of the processor. Note that if this property does not contain the value corresponding to a feature of the processor, than the feature either is not that some of the features of the processor may exist but may not be enabled. To find the the currently enabled features the processor, reffer to the EnabledProcessorCharacteristics property. Values specified in the enumeration may be obtained from SMBIOS v2.5 Type 4 offset 26h (Processor Characteristics Word). 32-bit Capable - describes whether the processor has the capability for 32 bits data width. 64-bit Capable - describes whether the processor has the capability for 64 bits data width. Enhanced Virtualization - describes whether the processor has the capability for executing enhanced virtualization instructions. Hardware Thread - indicates that the processor is capable of the hardware threading. NX-bit - describes whether the processor has capability to utilize non-execute bit and can differentiate the memory marked strictly for storage. Power/Performance Control - describes whether the processor has capability for load based power savings. Core Frequency Boosting - describes whether the processor has a capability for one processor core to increase its frequency whenever the other core has gone into an idle state.

    
    ============ =========================
    ValueMap     Values                   
    ============ =========================
    0            Unknown                  
    1            DMTF Reserved            
    2            64-bit Capable           
    3            32-bit Capable           
    4            Enhanced Virtualization  
    5            Hardware Thread          
    6            NX-bit                   
    7            Power/Performance Control
    8            Core Frequency Boosting  
    9..32567     DMTF Reserved            
    32568..65535 Vendor Reserved          
    ============ =========================
    
.. _CIM-Processor-UpgradeMethod:

``uint16`` **UpgradeMethod**

    CPU socket information that includes data on how this Processor can be upgraded (if upgrades are supported). This property is an integer enumeration.

    
    ======== ======================
    ValueMap Values                
    ======== ======================
    1        Other                 
    2        Unknown               
    3        Daughter Board        
    4        ZIF Socket            
    5        Replacement/Piggy Back
    6        None                  
    7        LIF Socket            
    8        Slot 1                
    9        Slot 2                
    10       370 Pin Socket        
    11       Slot A                
    12       Slot M                
    13       Socket 423            
    14       Socket A (Socket 462) 
    15       Socket 478            
    16       Socket 754            
    17       Socket 940            
    18       Socket 939            
    19       Socket mPGA604        
    20       Socket LGA771         
    21       Socket LGA775         
    22       Socket S1             
    23       Socket AM2            
    24       Socket F (1207)       
    25       Socket LGA1366        
    26       Socket G34            
    27       Socket AM3            
    28       Socket C32            
    29       Socket LGA1156        
    30       Socket LGA1567        
    31       Socket PGA988A        
    32       Socket BGA1288        
    33       rPGA988B              
    34       BGA1023               
    35       BGA1224               
    36       LGA1155               
    37       LGA1356               
    38       LGA2011               
    39       Socket FS1            
    40       Socket FS2            
    41       Socket FM1            
    42       Socket FM2            
    43       Socket LGA2011-3      
    44       Socket LGA1356-3      
    45       Socket LGA1150        
    46       Socket BGA1168        
    47       Socket BGA1234        
    48       Socket BGA1364        
    ======== ======================
    
.. _CIM-Processor-EnabledProcessorCharacteristics:

``uint16[]`` **EnabledProcessorCharacteristics**

    This property indicates the enabled states of the corresponding processor characteristics. The property array is indexed with ProcessorCharacteristics property array of the associated CIM_ProcessorCapabilities instance through the CIM_ElementCapabilities association. Each of the values in the ProcessorCharacteristics array property shall have its enabled state indicated in the corresponding element of this property array. For example; if the ProcessorCharacteristics array has value - NX-bit - for the first element of the array, then the first element of this property will contain the value for the enabled state of the NX-bit feature of the processor: whether the processor currently differentiates the dedicated storage memory based on the non-execute bit. Unknown - the processor feature is in unknown state. Enabled - the processor feature is enabled and could be used. Disabled - the processor feature is disabled and cannot be used. Not Applicable - the processor feature does not have state context.

    
    ============ ===============
    ValueMap     Values         
    ============ ===============
    0            Unknown        
    2            Enabled        
    3            Disabled       
    4            Not Applicable 
    5..32767     DMTF Reserved  
    32768..65535 Vendor Reserved
    ============ ===============
    
.. _CIM-Processor-Role:

``string`` **Role**

    A free-form string that describes the role of the Processor, for example, "Central Processor" or "Math Processor".

    
.. _CIM-Processor-CPUStatus:

``uint16`` **CPUStatus**

    The CPUStatus property that indicates the current status of the Processor. For example, the Processor might be disabled by the user (value=2), or disabled due to a POST error (value=3). Information in this property can be obtained from SMBIOS, the Type 4 structure, and the Status attribute.

    
    ======== =================================
    ValueMap Values                           
    ======== =================================
    0        Unknown                          
    1        CPU Enabled                      
    2        CPU Disabled by User             
    3        CPU Disabled By BIOS (POST Error)
    4        CPU Is Idle                      
    7        Other                            
    ======== =================================
    

Local methods
^^^^^^^^^^^^^

*None*

Inherited properties
^^^^^^^^^^^^^^^^^^^^

| ``uint16`` :ref:`RequestedState <CIM-EnabledLogicalElement-RequestedState>`
| ``uint16`` :ref:`HealthState <CIM-ManagedSystemElement-HealthState>`
| ``string[]`` :ref:`StatusDescriptions <CIM-ManagedSystemElement-StatusDescriptions>`
| ``boolean`` :ref:`PowerManagementSupported <CIM-LogicalDevice-PowerManagementSupported>`
| ``datetime`` :ref:`TimeOfLastStateChange <CIM-EnabledLogicalElement-TimeOfLastStateChange>`
| ``instance`` :ref:`AllocationState <CIM-LogicalDevice-AllocationState>`
| ``uint16`` :ref:`CommunicationStatus <CIM-ManagedSystemElement-CommunicationStatus>`
| ``string`` :ref:`CreationClassName <CIM-LogicalDevice-CreationClassName>`
| ``uint64`` :ref:`PowerOnHours <CIM-LogicalDevice-PowerOnHours>`
| ``string`` :ref:`Status <CIM-ManagedSystemElement-Status>`
| ``string`` :ref:`ElementName <CIM-ManagedElement-ElementName>`
| ``string`` :ref:`Description <CIM-ManagedElement-Description>`
| ``uint16`` :ref:`TransitioningToState <CIM-EnabledLogicalElement-TransitioningToState>`
| ``string[]`` :ref:`IdentifyingDescriptions <CIM-LogicalDevice-IdentifyingDescriptions>`
| ``uint64`` :ref:`Generation <CIM-ManagedElement-Generation>`
| ``boolean`` :ref:`ErrorCleared <CIM-LogicalDevice-ErrorCleared>`
| ``uint16`` :ref:`PrimaryStatus <CIM-ManagedSystemElement-PrimaryStatus>`
| ``string`` :ref:`InstanceID <CIM-ManagedElement-InstanceID>`
| ``string`` :ref:`DeviceID <CIM-LogicalDevice-DeviceID>`
| ``uint16`` :ref:`LocationIndicator <CIM-LogicalDevice-LocationIndicator>`
| ``uint16`` :ref:`DetailedStatus <CIM-ManagedSystemElement-DetailedStatus>`
| ``string[]`` :ref:`OtherIdentifyingInfo <CIM-LogicalDevice-OtherIdentifyingInfo>`
| ``datetime`` :ref:`InstallDate <CIM-ManagedSystemElement-InstallDate>`
| ``uint16`` :ref:`EnabledDefault <CIM-EnabledLogicalElement-EnabledDefault>`
| ``uint16`` :ref:`EnabledState <CIM-EnabledLogicalElement-EnabledState>`
| ``uint16[]`` :ref:`AdditionalAvailability <CIM-LogicalDevice-AdditionalAvailability>`
| ``uint16`` :ref:`OperatingStatus <CIM-ManagedSystemElement-OperatingStatus>`
| ``uint16`` :ref:`StatusInfo <CIM-LogicalDevice-StatusInfo>`
| ``uint16[]`` :ref:`PowerManagementCapabilities <CIM-LogicalDevice-PowerManagementCapabilities>`
| ``uint16[]`` :ref:`AvailableRequestedStates <CIM-EnabledLogicalElement-AvailableRequestedStates>`
| ``uint64`` :ref:`MaxQuiesceTime <CIM-LogicalDevice-MaxQuiesceTime>`
| ``uint64`` :ref:`TotalPowerOnHours <CIM-LogicalDevice-TotalPowerOnHours>`
| ``string`` :ref:`Caption <CIM-ManagedElement-Caption>`
| ``string`` :ref:`ErrorDescription <CIM-LogicalDevice-ErrorDescription>`
| ``string`` :ref:`SystemName <CIM-LogicalDevice-SystemName>`
| ``string`` :ref:`OtherEnabledState <CIM-EnabledLogicalElement-OtherEnabledState>`
| ``uint16[]`` :ref:`OperationalStatus <CIM-ManagedSystemElement-OperationalStatus>`
| ``uint32`` :ref:`LastErrorCode <CIM-LogicalDevice-LastErrorCode>`
| ``string`` :ref:`Name <CIM-ManagedSystemElement-Name>`
| ``uint16`` :ref:`Availability <CIM-LogicalDevice-Availability>`
| ``string`` :ref:`SystemCreationClassName <CIM-LogicalDevice-SystemCreationClassName>`

Inherited methods
^^^^^^^^^^^^^^^^^

| :ref:`Reset <CIM-LogicalDevice-Reset>`
| :ref:`RequestStateChange <CIM-EnabledLogicalElement-RequestStateChange>`
| :ref:`SetPowerState <CIM-LogicalDevice-SetPowerState>`
| :ref:`QuiesceDevice <CIM-LogicalDevice-QuiesceDevice>`
| :ref:`EnableDevice <CIM-LogicalDevice-EnableDevice>`
| :ref:`OnlineDevice <CIM-LogicalDevice-OnlineDevice>`
| :ref:`SaveProperties <CIM-LogicalDevice-SaveProperties>`
| :ref:`RestoreProperties <CIM-LogicalDevice-RestoreProperties>`

