opensolaris man page for sys-suspend

sys-suspend(1)							   User Commands						    sys-suspend(1)

NAME
       sys-suspend - suspend or shutdown the system and power off

SYNOPSIS
       /usr/bin/sys-suspend [-fnxh][-d displayname]

DESCRIPTION
       sys-suspend provides options to suspend or shutdown the whole system.

       A  system  can  be  suspended  to conserve power or to prepare the system for transport. The suspend should not be used when performing any
       hardware reconfiguration or replacement.

       In case of suspend, the current system state is preserved either by keeping memory powered (Suspend to RAM), or by saving the state to non-
       volatile storage (Suspend to Disk) until a resume operation is performed by power on or a wake-up event.

       On a resume in the windows environment, the system brings up lockscreen to ensure that only the authorized person has access to the system.
       In a non-windows environment, the user is prompted for password.

       It is possible that when devices or processes are performing critical or time sensitive operations (such as real time operations) the  sys-
       tem  fails  to  suspend. When this occurs, the system remains in its current running state. Messages reporting the failure are displayed on
       the console or system log. Once the system is successfully suspended, the resume operation always succeed barring external influences  such
       as hardware reconfiguration or the like.

       In case of shutdown, the system responds as if poweroff(1M) was performed.

       This  command  enforces	the solaris.system.power.suspend. authorizations. On a default install these are associated with the console user.
       Other users need to include these authorizations or include the Suspend profile.

OPTIONS
       The following operands are supported:

       -d displayname	 Connect to the X server specified by displayname.

       -f    Force suspend. Causes a poweroff(1M) to occur if the suspend fails. System state are not be saved, and a normal boot follows.

       -h    Change the default from suspend to shutdown.

       -n    Do not display messages or request user intervention.

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

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWpmowu 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+

SEE ALSO
       halt(1M), powerd(1M), poweroff(1M), shutdown(1M), attributes(5), cpr(7)

SunOS 5.11							    10 Mar 2009 						    sys-suspend(1)