Commands                                         sys-suspend(1)



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

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

AVAILABILITY
     SUNWpmowu

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

     A system may 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  will  be
     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 will be prompted for password.

     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 con-
     sole  or  system  log.   Once  the  system  is  successfully
     suspended, the resume operation will always succeed  barring
     external influences such as hardware reconfiguration  or the
     like.

     In case of shutdown, the system will respond as if poweroff(1m)
     was performed.

OPTIONS
     -f   Force suspend.  Causes a poweroff(1m) to occur if the
          suspend fails.  System state will not be saved, and a
          normal boot will follow.

     -n   Do not display messages or request user intervention.

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

     -h   Change the default from suspend to shutdown.

     -d <displayname>
          Connect to the X server specified by displayname.  For-
          mat of displayname has been described in X11(7).

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


SEE ALSO
     cpr(7), powerd(1M), xlock(1), X11(7), shutdown(1M)