dtpower (1M)

Name

dtpower -- Desk-top power manager, system and device power management tool.

Synopsis

dtpower [generic-tool-arguments] [-sampleTime n | -st n]
       [-warnTime1 n | -wt1 n] [-warnTime2 n | -wt2 n] [-nobell]

Availability

SUNWpmow

Description

dtpower provides a graphical user interface (GUI) to the power management system (see pm(7)). It allows the user to configure certain power manageable devices to shutdown after a specified period of inactivity. Different hardware platforms support different devices. Most platforms allow power management of display(s). Some platforms allow power management of disk drives. The set of power configurations for all devices is called a power profile.

dtpower also displays the current autoshutdown settings (see powerd(1M)). If dtpower is run as root, these settings may be changed. These settings are not included in a power profile.

If a battery is present, dtpower monitors the battery level. If the system is running from the battery, dtpower displays low power warnings when the battery charge is running low. dtpower maintains two device power profiles: One for use on AC and one for use with the battery. This enables you to customize your device power settings, depending on your power source. dtpower switches profiles automatically when the machine's power supply changes. There may be a small delay (about 30 seconds) before dtpower notices a change in power source.

You must be console owner or root to run dtpower.

Options

generic-tool-arguments

dtpower accepts the generic tool arguments described in xview(7).

-sampleTime n
-st n

dtpower continually checks the battery capacity, if a battery is present. This option sets the period of this check. The default is 10 seconds.

-warntime1 n
-wt1 n
-warntime2 n
-wt2 n

dtpower displays two warnings of low battery power. These options set the time before battery exhaustion at which the warnings will occur. The default warning times are at 10 and 5 minutes. Note that powerd(1M) will shut the system down when the battery is exhausted.

-nobell

By default, whenever dtpower displays a warning dialog, it sounds a bell. This option disables the bell.

Usage

dtpower operates via a set of pull-down menus, slider(s), and buttons in a control panel. From the control panel you may access one other panel, the autoshutdown panel.

The Control Panel

Menu Bar File

Exit

Exits the application. If you have pending changes, you will be prompted to apply or discard them before exiting.

Help

Help

Displays an overview of the dtpower application.

Information With Battery

The charge level of the battery is displayed. If the battery is the connected power source, then the estimated battery life is displayed below the charge gauge.

You can select which device power profile to edit using the toggle buttons above the slider(s). Note that the active profile is determined by your power source, not the toggle buttons.

Without battery

The power profile displayed is for an AC power supply. There is no access to the battery power profile.

Slider(s) Screen

This slider shows the amount of time the keyboard and mouse will be unused before the screen turns off. To change this time, move the slider and select apply. To turn the screen on, move the mouse or press a key.

Disk

This slider shows the amount of time the disk will be idle before spinning down. This is not available on all platforms. The disk will automatically spin up the next time it is needed.

Buttons Apply

This applies any changes to you active power profile and saves all settings in to $HOME/.pmrc so they are remembered the next time the application is started.

Reset to Standard

This resets the active power profile to its default values and saves these into $HOME/.pmrc.

Set Autoshutdown...

This brings up the autoshutdown panel.

The Autoshutdown Panel

As root This panel allows you to view and edit the parameters governing autoshutdown. The first box adjusts the amount of time the console keyboard and mouse must be unused before the system will autoshutdown.

The toggle buttons beneath determine the times when autoshutdown is in effect at all.

OK

This applies any changes made and saves them to power.conf(4) as the default settings.

Cancel

Dismisses the window and discards any changes.

Help

Displays a brief overview text.

As a regular user This panel allows you to view the current settings. Changes are not permitted.

OK

Disabled.

Cancel

Dismisses window.

Help

Displays a brief overview text.

Files

$HOME/.pmrc

Per user customized power profile.

/etc/power.conf

System-wide power configuration profile.

/usr/openwin/lib/app-defaults/Dtpower

Text messages file

See Also

cpr(7), pm(7), power.conf(4), pmconfig(1M), powerd(1M)

Modified

23 Oct 1994

pmconfig (1M)

Name

pmconfig - Configure the power management system

Synopsis

/usr/sbin/pmconfig
/usr/sbin/pmconfig [-r]

Availability

SUNWpmu

Description

pmconfig enables the current system autoshutdown information to be viewed and/or the power management configuration modified. pmconfig reads in the configuration file power.conf(4) and issues commands to make this power configuration active. This may involve commands to the power management pseudo driver (pm(7) or a signal to the power daemon (powerd(1M)). If no daemon is present and autoshutdown information is present, a daemon will be started.

Errors

If the program cannot open either the pseudo driver or the configuration file it prints an error message to standard error. If the program encounters a syntax error in the configuration file, it prints an error message and the line number of the error in the configuration file. It then skips the rest of the information on that line and processes the next line. Any configuration information already processed on the line containing the error is used.

All error messages start with "pmconfig (line n):", and may be followed by:

Can't find device name :

The first field is not a device name.

Can't find threshold value :

The field following the device name is not an integer.

Too many threshold values :

More idle times than the device supports were given.

Unrecognizable dependent name :

The dependent field is not a device name.

A standard error message

Returned from the pm driver.

Options

-r

Reset all power managed devices to unconfigured

Files

/etc/power.conf

System power management configuration file

See Also

pm(7), power.conf(4), powerd(1M)

Modified

5 Jul 1994

powerd (1M)

Name

powerd -- Power manager daemon

Synopsis

/usr/lib/power/powerd [-n]

Availability

SUNWpmu

Description

This daemon manages two types of system shutdown. The two types of shutdown are automatic shutdown, set on a daily basis, and low power shutdown on systems which support battery operation. If the system suspend module, cpr(7), is present, it will be used to shut the system down, otherwise the poweroff(1M) utility will be used. The autoshutdown information is read from the file /etc/power.conf by the daemon. It is reread whenever the daemon receives a hangup signal, SIGHUP.

Automatic shutdown can occur when two conditions are met. The current time is between the start and finish times, and the system has been idle for at least the set time period. System idleness is determined by inactivity on the console keyboard and mouse.

The start and finish times are specified in the file in 24-hour time notation, measured since the start of the day (12:00 am). If the finish time is less than or equal to the start time, the active period of the daemon will span from midnight to the finish time and from the start time to the following midnight. Thus to specify continuous operation, the finish time may be set equal to the start time. Specifying a negative idle time disables automatic shutdowns from occurring.

Low power shutdown will occur if the system is running from battery and the daemon monitors that the charge in the battery is too low to reliably continue operation.

Immediately prior to system shutdown, the daemon notifies syslogd(1M) of the shutdown, which broadcasts the notification.

Options

-n

No broadcast mode. The daemon will shutdown the system silently without notifying syslogd(1M).

Files

/etc/power.conf

Used to obtain the current daemon autoshutdown settings.

Notes

The daemon uses shared memory IPC, which may increase the system image size if the shared memory module has not already been loaded.

The daemon ensures that only one daemon is running. If another daemon is running, then the new daemon will exit with and error. if the daemon dies unexpectedly (non-maskable signal) then residual shared memory state will remain. Starting a new daemon will remove this residual state.

See Also

crp(7), pm(7), pmconfig(1M), power.conf(4), poweroff(1M0, syslogd(1M)

Modified

8 Jul 1994

sys-suspend (1M)

Name

sys-suspend -- Suspend the system and power off

speckeysd -- Detects special keys on Type 4 or Compact 1 keyboard.

Synopsis

/usr/openwin/bin/sys-suspend [-fnx]
/usr/openwin/bin/speckeysd

Availability

SUNWpmow

Description

sys-suspend(1M) invokes the uadmin(1M) system call with the right options to syspend the whole system. A system can be suspended to conserve power or to prepare the system for transport. It should not be used in place of a shutdown when performing any hardware reconfiguration or replacement.

The current system state will be preserved until a resume operation is performed (the next power on).

On a resume from a manually initiated suspend in the windows environment, the system brings up xlock(1) to make certain that only the same person who suspended the system can have access to the system. In a non-windows environment, the user will be prompted for a password. If the suspend was initiated by the powerd(1M)--also known as AutoShutdown--mechanism, no additional security measure is initiated. It is the user's responsibility to secure his/her work session before AutoShutdown takes place.

It is possible that when devices or processes are performing critical or time sensitive operations (such as real time operations), the system may fail to suspend. When this occurs, the system will remain in tis current running state.

Messages reporting the failure will be displayed on the console. Once the system is successfully suspended, the resume operation will always succeed barring external influences such as hardware reconfiguration or the like.

speckeysd(1M) is a daemon that is started at OpenWIndows start time to pick up the power and contrast key strokes from Type 5 and COmpact 1 keyboards.

The Power key is the initiator of a manual suspend in sys-suspend fashion. There are several different ways of using the Power key.

Power key

Displays a confirmation popup, prompting the user to confirm the suspend request.

Shift+Power keys

Initiates an immediate suspend.

The contrast keys (which are next to the Power key) control the screen contrast on some systems. To change screen contrast, use the Shift key and the appropriate contrast key: The Contrast+ for increasing the screen contrast and Contrast- for decreasing the screen contrast.

Options

-f

Force suspend. This should be used with care. Using this options causes the system to force stops all processes that does not through the default mechanism. This option should be used only during unattended operations.

-n

Disable confirmation. This flag disables the confirmation popup dialog at suspend time.

-x

Disable lockscreen. This flag disables the execution of lockscreen at resume time.

Files

/kernel/misc/cpr

  Loadable module for cpr

/cprboot

  Special bootstrapper for cpr

/.CPR

  System state file

/.cpr_generic_info

  sys-suspend control file

/.cpr_defaultboot_info

sys-suspend control file

Notes

xlock(1) on resume can be disabled by default. The following line needs to be added to the user's .Xdefaults or .OWdefaults file:

  Speckeysd*xlock:    False

The xlock mode defaults to life. This can be changed by adding the following line to the user's .Xdefaults or .OWdefaults file:

Speckeysd*xlockmode:<xlockmode>

See Also

uadmin(2), cpr(7)

Modified

8 Aug 1994

tcxconfig (1M)

Name

tcxconfig -- Configure the default linearity of the 24-bit TrueColor Visual for OpenWindows on TCX.

Synopsis

/usr/sbin/tcxconfig [linear | nonlinear]

Availability

SUNWtcxow

Description

The tcxconfig script changes the default linearity of a 24-bit TrueColor Visual for OpenWindows on TCX. When the TCX driver for OpenWindows is installed, the default 24-bit TrueColor Visual is nonlinear. You can run tcxconfig with an argument that specifies the setting you want.

OpenWindows should not be running when you run the tcxconfig script. Start OpenWindows after tcxconfig has set the linearity you desire.

Options

Entering tcxconfig without options displays the current default setting

linear

Set linear visual to be the default 24-bit TrueColor Visual. This means color will be gamma-corrected.

nonlinear

Set nonlinear visual to be the default 24-bit TrueColor Visual.

Modified

23 Aug 1994