MAN Solaris - gnome-sys-suspend (1)



gnome-sys-suspend - suspend or shut down the system and power off



gnome-sys-suspend [--force-suspend] [--display=displayname] [--default-shutdown] [--disable-selection] [---disable-lockscreen]




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, depending on the system type (see NOTES section below). 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 or wake event.

During a resume in the windows environment, the system invokes lockscreen to ensure that only the authorized person has access to the system. 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 system 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 hardware 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.


The following options are supported:

-d, --display=displayname Connect to the X server specified by displayname. The format of displayname is described in X11(7).

-f, --force-suspend 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, --default-shutdown Change the default operation from suspend to shutdown.

-n, --disable-selection Disable selection. This option disables the selection popup dialog at invocation time.

-x, --disable-lockscreen Disable lockscreen. This option disables the execution of lockscreen at resume time.



Executable for the command.


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.


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

Interface stabilityVolatile


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


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 .Xdefaults or .OWdefaultsfile:

Syssuspend*xlockmode:      <xlockmode>

There are two types of suspend, suspend to disk (CPR or ACPI S4 sleep), and suspend to memory (ACPI S3 sleep). If the system in question only supports one of these, then that one will be done. A system which is suspended to memory will not be able to resume successfully if power is removed from the system.

Currently Sun SPARC desktop systems only support suspend to disk (CPR), and Sun X86 Solaris only supports suspend to memory (ACPI S3).

Support for suspend is dependent on hardware and firmware support. Some systems may not support either type of suspend.

This man page is based on sys-suspend(1M).

Updated by Narayana Pattipati for Sun Microsystems Inc., 2004. Updated by Brian Cameron for Sun Microsystems Inc, 2007.

Jump to page    or go to Top of page |  Section 1 |  Main Solaris Index.

SunOS 5.11 gnome-sys-suspend (1) 25 October 2007
Generated by Open Solaris Forum from /usr/share/man/man1/gnome-sys-suspend.1 using man macros with tbl support.