Print this page
12144 Convert Intro(7) to mandoc
12145 Convert cpr(7) to mandoc
12146 Convert ibmf(7) to mandoc
12147 Convert FSS(7) to mandoc
Reviewed by: Peter Tribble <peter.tribble@gmail.com>
@@ -1,96 +1,73 @@
CPR(7) Device and Network Interfaces CPR(7)
-
-
NAME
cpr - Suspend and resume module
SYNOPSIS
- /platform/'uname -m'/kernel/misc/cpr
+ /platform/i86pc/kernel/misc/amd64/cpr
+ /platform/sun4u/kernel/misc/sparcv9/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
- reconfiguration 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.
+ 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 reconfiguration 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.
-
pmconfig(1M) and 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 processes
- can use SIGTHAW to restore the state prior to suspend. For example, X
- can refresh the screen in response to SIGTHAW.
+ processing because of suspend-resume, but some specialized processes 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.
+ 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 reconfiguration.
- 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
- reconfiguration.
-
-
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.
+ transparently on a resume operation; those applications that do not will
+ likely fail.
-ATTRIBUTES
- See attributes(5) for descriptions of the following attributes:
+INTERFACE STABILITY
+ Unstable
-
-
-
- +---------------------+-----------------+
- | ATTRIBUTE TYPE | ATTRIBUTE VALUE |
- +---------------------+-----------------+
- |Interface stability | Unstable |
- +---------------------+-----------------+
-
SEE ALSO
pmconfig(1M), uadmin(1M), uadmin(2), power.conf(4), attributes(5)
-
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
+ 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.
-
-
- May 13, 2017 CPR(7)
+illumos January 12, 2020 illumos