winsat cpu

 

Applies To: Windows Vista, Windows Server 2008, Windows 7, Windows Server 2008 R2, Windows Server 2012, Windows 8

Assesses the performance of the processor(s) using encryption and decryption or compression and decompression.

For examples of how to use this command, see Examples.

Syntax

winsat cpu <[encryption|encryption2]|[compression|compression2]> [optional parameters]

Parameters

Important

Only one of the four required parameters is required to run the assessment.

Required Parameter

Description

-encryption

Run the encryption and decryption sub-assessment using 256-bit AES cryptographic algorithms.

-encryption2

Run the encryption and decryption sub-assessment computing a SHA1 hash.

-compression

Run the compression and decompression sub-assessment using a Lempel-Zev algorithm.

-compression2

Run the compression and decompression sub-assessment using an internal Microsoft compression algorithm. This is the same algorithm used to compress the hibernation file and with ReadyBoost and ReadyDrive technologies.

Optional Parameter

Description

-buffersize <n>

Define the buffer size for the assessment. The minimum is 4 K. The maximum is 2 MB. The default is 16 KB.

-data <file name>

Specify a file to be loaded into the buffer for use in the assessment. The default file used if none is specified is %SystemRoot%\system32\shell32.dll.

-nbr <n>

Specify the number of buffer regions used in the assessment. The default is 16 regions.

-brs <n>

Specify the size of buffer regions used in the assessment.

-v

Send verbose output to STDOUT, including status and progress information. Any errors will also be written to the command window.

-xml <file name>

Save the output of the assessment as the specified XML file. If the specified file exists, it will be overwritten.

-idiskinfo

Save information about physical volumes and logical disks as part of the <SystemConfig> section in the XML output.

-iguid

Create a globally unique identifier (GUID) in the XML output file.

-note "note text"

Add the note text to the <note> section in the XML output file.

-icn

Include the local computer name in the XML output file.

-eef

Enumerate extra system information in the XML output file.

Note

A combination of -buffersize, -nbr, and -brs can be specified, but only two can be used simultaneously.

  • When -buffersize and -nbr are used together, the region size is determined by dividing the number of regions into the buffer sizes.

  • When -buffersize and -brs are used together, the number of regions is determined by dividing the region size into the buffer sizes.

  • When -nbr and -brs are used together, the buffer size is determined by multiplying the values for -nbr and -brs together.

Additional considerations

The -buffersize value defaults to bytes unless a suffix is used with the number supplied. The following suffixes can be used to specify other magnitudes:

  • B or BYTES for bytes (assessments that do not permit values this small will default to the smallest allowed value)

  • K or KB for kilobytes

  • M or MB for megabytes

  • G or GB for gigabytes (assessments that do not permit values this large will default to the largest allowed value)

Examples:

  • -buffersize 1K

  • -buffersize 256BYTES

Examples

  • The following example assesses CPU performance using 256-bit AES cryptographic algorithms:

    winsat cpu -encryption
    
  • The following example assesses CPU performance using the same compression algorithms that Windows Vista uses internally:

    winsat cpu -compression2
    

Remarks

  • Membership in the local Administrators group, or equivalent, is the minimum required to use winsat. The command must be executed from an elevated Command Prompt window.

  • To open an elevated Command Prompt window, click Start, click All Programs, click Accessories, right-click Command Prompt, and click Run as administrator.

Additional references

Winsat