NAME

sys-suspend - Suspend the system and power off

SYNOPSIS

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

AVAILABILITY

SUNWpmow

DESCRIPTION

sys-suspend(1M) invokes the uadmin(1M) system call with the right options to suspend 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 password. If the suspend was initiated by the powerd (1M),a. k. a. AutoShutdown, mechanism, no additional security measure is initated. 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 its 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.

OPTIONS

-f

Force suspend. This should be used with care. Using this option causes the system to force stops all processes that does not through the default mechnism. 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

/etc/default/sys-suspend

file for setting a default value for the PERM environment

variable. PERM determines who are allowed to use this

command. Allowed values are:

all

everybody can use this command (default)

-

nobody can use this command

<user1, user2, etc.>

a user in this user list can use this command

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:

        Syssuspend* 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:
        Syssuspend* xlockmode:          <xlockmode>

SEE ALSO

uadmin(2), cpr(7)