pstatectl.1m (2010 09)

p
pstatectl(1M)
(Itanium(R)-based Systems Only)
pstatectl(1M)
NAME
pstatectl - control processor performance states
SYNOPSIS
/usr/sbin/pstatectl
[-v][-c cpu][
enable|disable|static pstate | dynamic min max
|
status|info|getmaxpstate|
update interval ]
DESCRIPTION
The
pstatectl command is used to control processor performance states (P-states). On systems with
supported processors and firmware, processor performance states can reduce power consumption.
A supported processor implements a series of performance states, numbered from P0 to Pn, where n is
implementation dependent. Each subsequent P-state consumes less power but offers less performance
than the previous state.
pstatectl provides access to both static and dynamic performance state usage modes. In static mode,
the system remains in a specified P-state, where power consumption and performance are reduced by a
fixed amount. In dynamic mode, HP-UX will adjust the processors’ P-states individually, in response to
the workload running on the system.
Enabling dynamic processor performance states will generally have a negligible effect on system perfor-
mance, while at the same time reducing power consumption when the system is not fully loaded.
Options
pstatectl recognizes the following options:
-c cpu The operation will apply to the specified processor only. If -c cpu is not specified,
the operation applies to the whole system.
-v The "status" operation will report detailed status for each processor. Otherwise, a
summary of the system state is reported.
Operands
pstatectl recognizes the following operands; only one operand at a time can be specified on the com-
mand line:
enable Enable the dynamic P-states mode (processors will adjust performance to match the
workload).
disable Disable the P-states (processors will always be at maximum performance).
static pstate Enable static mode (processors will always be in the specified P-state). If the
specified state is higher than is supported, the highest supported state is used
instead. The state may be specified as a number, or in P-state notation (for exam-
ple, P0).
dynamic min max
Enable dynamic P-states mode within the range of states specified. min and max
should be supplied as specified under the static option.
status Report information about the system’s P-state capabilities, the current P-state mode
(static or dynamic), and whether HP-UX has control over processor P-states. If -v
was specified, each processor’s current P-state and operating mode are displayed.
info Display a table listing the power consumption and relative performance of each
P-state.
getmaxpstate
Print the number of the highest implemented P-state on the system. If the system
does not support P-states, the number is 0.
update interval
Change the time interval between dynamic mode state changes to the specified
duration. The minimum is 0.01 seconds, and the maximum is 600 seconds.
EXTERNAL INFLUENCES
On some systems, the Onboard Administrator may take control of P-states away from the operating sys-
tem (for instance, when iLO is used to place the system in Static High Performance or Static Low Power
mode).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1