man/systemd-hibernate-resume.service.xml


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

<?xml version="1.0"?>
<!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
<refentry id="systemd-hibernate-resume.service" conditional='ENABLE_HIBERNATE'>

  <refentryinfo>
    <title>systemd-hibernate-resume.service</title>
    <productname>systemd</productname>
  </refentryinfo>

  <refmeta>
    <refentrytitle>systemd-hibernate-resume.service</refentrytitle>
    <manvolnum>8</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>systemd-hibernate-resume.service</refname>
    <refname>systemd-hibernate-resume</refname>
    <refpurpose>Resume from hibernation</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <para><filename>systemd-hibernate-resume.service</filename></para>
    <para><filename>/usr/lib/systemd/systemd-hibernate-resume</filename></para>
  </refsynopsisdiv>

  <refsect1>
    <title>Description</title>

    <para><filename>systemd-hibernate-resume.service</filename> initiates the resume from hibernation.</para>

    <para><command>systemd-hibernate-resume</command> only supports the in-kernel hibernation
    implementation, see <ulink url="https://docs.kernel.org/power/swsusp.html">Swap suspend</ulink>.
    Internally, it works by writing the major:minor of specified device node to
    <filename>/sys/power/resume</filename>, along with the offset in memory pages
    (<filename>/sys/power/resume_offset</filename>) if supported.</para>

    <para>Failing to initiate a resume is not an error condition. It may mean that there was
    no resume image (e. g. if the system has been simply powered off and not hibernated).
    In such cases, the boot is ordinarily continued.</para>
  </refsect1>

  <refsect1>
    <title>See Also</title>
    <para><simplelist type="inline">
      <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
      <member><citerefentry><refentrytitle>systemd-hibernate-resume-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry></member>
    </simplelist></para>
  </refsect1>

</refentry>