gnome-sys-suspend(1) [sunos man page]
gnome-sys-suspend(1) User Commands gnome-sys-suspend(1) NAME
gnome-sys-suspend - suspend or shut down the system and power off SYNOPSIS
gnome-sys-suspend [-fnxh] [-d displayname] DESCRIPTION
gnome-sys-suspend provides options to suspend or shut down the whole system. A system may be suspended to conserve power or to prepare the system for transport. Do not use the suspend operation when performing any hardware reconfiguration or replacement. During a suspend operation, the current system state is preserved until a resume operation is performed at the next power on. During a resume in the windows environment, the system invokes lockscreen to ensure that only the authorized person has access to the sys- tem. In a non-windows environment, the user is prompted for a password. It is possible that when devices or processes are performing critical or time-sensitive operations (such as real-time operations), the sys- tem might fail to suspend. When this occurs, the system remains in its current running state. Messages reporting the failure are displayed on the console. Once the system is successfully suspended, the resume operation always succeeds, barring external influences such as hard- ware reconfiguration. During a shutdown operation, rc0 scripts are run, processes are killed, pending data is written to the disks, and the system is powered off. OPTIONS
The following options are supported: -d displayname Connect to the X server specified by displayname. The format of displayname is described in X11(7). -f Force suspend. Use this option with care. Using this option causes the system to force all processes to stop. Do not use this option during unattended operations. -h Change the default operation from suspend to shutdown. -n Disable selection. This option disables the selection popup dialog at invocation time. -x Disable lockscreen. This option disables the execution of lockscreen at resume time. FILES
/usr/bin/gnome-sys-suspend Executable for the command. /etc/default/sys-suspend File that sets a default value for the PERMS variable. PERMS determines who is allowed to use the gnome- sys-suspend command. Valid values are: all Any user can use the command. - Only superuser can use the command. user1, user2, ... Any user in this user list, and superuser, can use the command. console-owner A user who owns the system console device node, and superuser, can use the command. This is the default value. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWgnome-sys-suspend | +-----------------------------+-----------------------------+ |Interface stability |External | +-----------------------------+-----------------------------+ SEE ALSO
X11(7), cpr(7), powerd(1M), shutdown(1M), xlock(1) NOTES
Lockscreen on resume can be disabled by default. Add the following line to the user's .Xdefaults or .OWdefaults file: Syssuspend*xlock: False If xlock(1) is used for lockscreen functionality, its mode defaults to life. To change this, add the following line to the user's .Xde- faults or .OWdefaultsfile: Syssuspend*xlockmode: <xlockmode> This man page is based on sys-suspend(1M). Updated by Narayana Pattipati for Sun Microsystems Inc., 2004. SunOS 5.10 27 May 2004 gnome-sys-suspend(1)
Check Out this Related Man Page
cpr(7) Device and Network Interfaces cpr(7) NAME
cpr - Suspend and resume module SYNOPSIS
/platform/'uname -m'/kernel/misc/cpr DESCRIPTION
The cpr module is a loadable module used to suspend and resume the entire system. You may wish to suspend a system to save power or to power off temporarily for transport. The cpr module should not be used in place of a normal shutdown when performing any hardware reconfig- uration or replacement. In order for the resume operation to succeed, it is important that the hardware configuration remain the same. When the system is suspended, the entire system state is preserved in non-volatile storage until a resume operation is conducted. dtpower(1M) or power.conf(4) are used to configure the suspend-resume feature. The speed of suspend and resume operations can range from 15 seconds to several minutes, depending on the system speed, memory size, and load. During resume operation, the SIGTHAW signal is sent to all processes to allow them to do any special processing in response to suspend- resume operation. Normally applications are not required to do any special processing because of suspend-resume, but some specialized pro- cesses can use SIGTHAW to restore the state prior to suspend. For example, X can refresh the screen in response to SIGTHAW. In some cases the cpr module may be unable to perform the suspend operation. If a system contains additional devices outside the standard shipped configuration, it is possible that device drivers for these additional devices might not support suspend-resume operations. In this case, the suspend fails and an error message is displayed. These devices must be removed or their device drivers unloaded for the suspend operation to succeed. Contact the device manufacturer to obtain a new version of device driver that supports suspend-resume. A suspend may also fail when devices or processes are performing critical or time-sensitive operations (such as realtime operations). The system will remain in its current running state. Messages reporting the failure will be displayed on the console and status returned to the caller. Once the system is successfully suspended the resume operation will succeed, barring external influences such as a hardware recon- figuration. Some network-based applications may fail across a suspend and resume cycle. This largely depends on the underlying network protocol and the applications involved. In general, applications that retry and automatically reestablish connections will continue to operate transparently on a resume operation; those applications that do not will likely fail. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWcpr | +-----------------------------+-----------------------------+ |Interface stability |Unstable | +-----------------------------+-----------------------------+ SEE ALSO
dtpower(1M) (OpenWindows Reference Manual), pmconfig(1M), uadmin(1M), uadmin(2), power.conf(4), attributes(5) Using Power Management Writing Device Drivers NOTES
Certain device operations such as tape and floppy disk activities are not resumable due to the nature of removable media. These activities are detected at suspend time, and must be stopped before the suspend operation will complete successfully. Suspend-resume is currently supported only on a limited set of hardware platforms. Please see the book Using Power Management for a com- plete list of platforms that support system Power Management. See uname(2) to programatically determine if the machine supports suspend- resume. SunOS 5.10 7 May 2001 cpr(7)