| Skip Navigation Links | |
| Exit Print View | |
 | man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
| Skip Navigation Links | |
| Exit Print View | |
| man pages section 1M: System Administration Commands Oracle Solaris 11 Information Library |
- manage power management properties
poweradm [-v] get [-a all|smf|platform|current]property ...
poweradm [-v] setproperty=value ...
poweradm [-v] list
poweradm-?
Thepoweradm program is used to display and manage the Power Managementsettings within a Solaris instance.
The Power Management properties and their values are stored in the servicemanagement facility (seesmf(5)).
All users can run thelist andget forms given in theSYNOPSIS. These commands allow all users to view the current Power Managementsettings within a Solaris instance.
Only users and roles that belong to the Maintenance and Repair RBACprofile can execute theset form ofpoweradm given in theSYNOPSIS.See also theNOTES section below.
poweradm supports the following service property:
administrative-authority
The value for this property is specified as a string and canhave the values:
smf
platform
none
...withplatform as the default value. The significance of this property isthe source of administrative control for power management within the Solaris kernel.That is, this property indicates the origin oftime-to-full-capacity andtime-to-minimum-responsiveness settingswithin the Solaris kernel. Only a Solaris user with appropriate privileges canset this property.
When theadministrative-authority is set toplatform the values oftime-to-full-capacity andtime-to-minimum-responsiveness will be taken from the platform code. Setting these values inSMF using thepoweradm command will have no effect upon the values inthe kernel, whileadministrative-authority is set toplatform. Under this condition, thepoweradm command will indicate that the kernel is currently using the platformvalues. As these values are changed by the platform administrator, so they willbe modified in kernel. Also, commands to enable or disable the powermanagement within the Solaris kernel will come from the platform code. Whentheadministrative-authority is set tosmf, the values oftime-to-full-capacity andtime-to-minimum-responsivenesswill be taken from SMF. As these values in SMF are changedby the Solaris administrator, so they will be applied to kernel. Settingthese values in the platform will have no effect upon the valuesin the kernel while administrative-authority is set tosmf. Under this condition, hepoweradm command will indicate that the kernel is currently using the valuesfrom SMF. As these values are changed by the Solaris administrator, sothey will be modified in kernel.
When theadministrative-authority is set tonone, power management within the Solariskernel will be turned off, although the power service will continue torun. Any power management instructions from the platform will be ignored, aswill the settings in SMF. Only whenadministrative-authority is set to one ofthe other values will power management within the Solaris kernel restart, usingthe settings from the specified source.
Specified in microseconds.
This parameter constrains the dynamic capacity adjustment allowed while the system is in an active state.
This parameter defines the maximum time the system is allowed to reach (re-provision and make available) its full capacity, returning from any lower-capacity/less-responsive state, while it has been using any or all of the PM features falling within this bound.
By default, this value is taken from the platform (for example,i86pc), because the default setting foradministrative-authority is set toplatform.
Alternatively, ifadministrative-authority is set tosmf, this value is taken from the definition provided by the power service (that is, SMF). At install time this value is set to beundefined. If the Solaris administrator chooses to modify this property, a value appropriate to the needs of the workload or applications must be picked.
Specified in milliseconds.
This parameter constrains the dynamic capacity adjustment allowed while the system is in an inactive state.
This parameter defines how long the system is allowed to return to its active state—that is, to provide the minimum capacity required to meet the above time-to-full-capacity constraint.
Moderate values (seconds) allow hardware components or subsystems on the platform to be placed in slower-response inactive states; larger values still (for example, 30 seconds to minutes) allow for such as whole system suspension, using techniques such as suspend-to-RAM.
By default, this value is taken from the platform (for example,i86pc), because the default setting foradministrative-authority is set toplatform.
Alternatively, ifadministrative-authority is set tosmf, this value is taken from the definition provided by the power service (that is, SMF). At install time this value is set to beundefined. If the Solaris administrator chooses to modify this property, a value appropriate to the needs of the workload or applications must be picked.
By default, only a small number of machines are allowed to suspend. Setting this property to true will permit other machines to attempt to suspend. By default this property is set tofalse, unless a machine has S3 according the the ACPI kstat module and is on the white list. If these two conditions are met, the default istrue. The value ofadministrative-authority has no effect upon this property.
The following options are supported.
Display a synopsis of available subcommands and options.
Provide verbose output. Can be used with any of the subcommands listed below.
The following subcommands are supported:
Retrieves the current value of the named property. The-a option can be used to indicate the origin of the value either: SMF (smf), the platform (platform), the current value used by the kernel (current) or all of the preceeding (all). By default, if no origin is specified thencurrent is assumed.
Theadministrative-authority andsuspend-enable properties do not have a platform value
Changes the namedproperty to the givenvalue. The propertiesadministrative-authority andsuspend-enable are automatically synchronized to the new value in the kernel. The propertiestime-to-full-capacity andtime-to-minimum-responsiveness are synchronized to the kernel if and only ifadministrative-authority is set tosmf. If the-v option is used and the kernel cannot be updated immediately becauseadministrative-authority is not set tosmf, a warning message will be issued.
Only users and roles that belong to the Maintenance and Repair RBAC profile can execute theset subcommand.
Lists all the available Power Management properties values and indicate whether power management is active.
Successful completion.
An error occurred.
Invalid command line options were specified.
Seeattributes(5) for descriptions of the following attributes:
|
attributes(5),smf(5),smf_security(5)
The power service is managed by the service management facility,smf(5), underthe service identifier:
svc:/system/power:default
The properties that can be set bypoweradm are defined in thatservice as:
active_control/administrative-authority, which is described underadministrative-authority above
active_config/time-to-full-capacity, which is described undertime-to-full-capacity above
active_config/time-to-minimum-responsiveness, which is described undertime-to-minimum-responsiveness above
suspend/suspend-enable, which is described undersuspend-enable above
If the service is disabled, no power management settings will be uploadedto the kernel in the future. Existing settings will not be undoneuntil the next reboot. Disabling all power management is best accomplished bysettingadministrative-authority tonone.
Ifadministrative-authority is set to the valuesmf before bothtime-to-full-capacity andtime-to-minimum-responsiveness have been set, the service will go into maintenance mode. Insuch a situation, setadministrative-authority to the valuenone then set bothtime-to-full-capacity andtime-to-minimum-responsiveness to the values you want, clear the service andthen set administrative-authority tosmf.
To set properties in theactive_config andsuspend property groups, thesolaris.smf.value.power_configauthorization is required. To set properties in theactive_control property group requiresthesolaris.smf.value.power_control authorization is required. Both of these authorizations are part ofthe Maintenance and Repair profile.
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.Legal Notices |   |