1sys-suspend(1)                   User Commands                  sys-suspend(1)
2
3
4

NAME

6       sys-suspend - suspend or shutdown the system and power off
7

SYNOPSIS

9       /usr/bin/sys-suspend [-fnxh][-d displayname]
10
11

DESCRIPTION

13       sys-suspend provides options to suspend or shutdown the whole system.
14
15
16       A  system  can  be suspended to conserve power or to prepare the system
17       for transport. The suspend should not be used when performing any hard‐
18       ware reconfiguration or replacement.
19
20
21       In  case  of  suspend,  the current system state is preserved either by
22       keeping memory powered (Suspend to RAM), or by saving the state to non-
23       volatile  storage  (Suspend  to  Disk) until a resume operation is per‐
24       formed by power on or a wake-up event.
25
26
27       On a resume in the windows environment, the system brings up lockscreen
28       to  ensure that only the authorized person has access to the system. In
29       a non-windows environment, the user is prompted for password.
30
31
32       It is possible that when devices or processes are  performing  critical
33       or  time sensitive operations (such as real time operations) the system
34       fails to suspend. When this occurs, the system remains in  its  current
35       running state. Messages reporting the failure are displayed on the con‐
36       sole or system log. Once the  system  is  successfully  suspended,  the
37       resume  operation  always  succeed  barring external influences such as
38       hardware reconfiguration or the like.
39
40
41       In case of shutdown, the system responds as if  poweroff(1M)  was  per‐
42       formed.
43
44
45       This command enforces the solaris.system.power.suspend. authorizations.
46       On a default install these are associated with the console user.  Other
47       users  need to include these authorizations or include the Suspend pro‐
48       file.
49

OPTIONS

51       The following operands are supported:
52
53       -d displayname    Connect to the X server specified by displayname.
54
55
56       -f    Force suspend. Causes a poweroff(1M)  to  occur  if  the  suspend
57             fails. System state are not be saved, and a normal boot follows.
58
59
60       -h    Change the default from suspend to shutdown.
61
62
63       -n    Do not display messages or request user intervention.
64
65
66       -x    Disable   lockscreen.   This   flag  disables  the  execution  of
67             lockscreen at resume time.
68
69

ATTRIBUTES

71       See attributes(5) for descriptions of the following attributes:
72
73
74
75
76       ┌─────────────────────────────┬─────────────────────────────┐
77       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
78       ├─────────────────────────────┼─────────────────────────────┤
79       │Availability                 │SUNWpmowu                    │
80       ├─────────────────────────────┼─────────────────────────────┤
81       │Interface Stability          │Committed                    │
82       └─────────────────────────────┴─────────────────────────────┘
83

SEE ALSO

85       halt(1M), powerd(1M), poweroff(1M), shutdown(1M), attributes(5), cpr(7)
86
87
88
89SunOS 5.11                        10 Mar 2009                   sys-suspend(1)
Impressum