man/systemd-hibernate-resume@.service.xml

   1 <?xml version="1.0"?>
   2 <!--*-nxml-*-->
   3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4 <!--
   5   SPDX-License-Identifier: LGPL-2.1+
   6
   7   Copyright 2014 Ivan Shapovalov
   8 -->
   9 <refentry id="systemd-hibernate-resume@.service" conditional='ENABLE_HIBERNATE'>
  10
  11   <refentryinfo>
  12     <title>systemd-hibernate-resume@.service</title>
  13     <productname>systemd</productname>
  14
  15     <authorgroup>
  16       <author>
  17         <contrib>Developer</contrib>
  18         <firstname>Ivan</firstname>
  19         <surname>Shapovalov</surname>
  20         <email>intelfx100@gmail.com</email>
  21       </author>
  22     </authorgroup>
  23   </refentryinfo>
  24
  25   <refmeta>
  26     <refentrytitle>systemd-hibernate-resume@.service</refentrytitle>
  27     <manvolnum>8</manvolnum>
  28   </refmeta>
  29
  30   <refnamediv>
  31     <refname>systemd-hibernate-resume@.service</refname>
  32     <refname>systemd-hibernate-resume</refname>
  33     <refpurpose>Resume from hibernation</refpurpose>
  34   </refnamediv>
  35
  36   <refsynopsisdiv>
  37     <para><filename>systemd-hibernate-resume@.service</filename></para>
  38     <para><filename>/usr/lib/systemd/systemd-hibernate-resume</filename></para>
  39   </refsynopsisdiv>
  40
  41   <refsect1>
  42     <title>Description</title>
  43
  44     <para><filename>systemd-hibernate-resume@.service</filename>
  45     initiates the resume from hibernation. It is instantiated with the
  46     device to resume from as the template argument.</para>
  47
  48     <para><filename>systemd-hibernate-resume</filename> only supports
  49     the in-kernel hibernation implementation, known as
  50     <ulink url="https://www.kernel.org/doc/Documentation/power/swsusp.txt">swsusp</ulink>.
  51     Internally, it works by writing the major:minor of specified
  52     device node to <filename>/sys/power/resume</filename>.</para>
  53
  54     <para>Failing to initiate a resume is not an error condition. It
  55     may mean that there was no resume image (e. g. if the system has
  56     been simply powered off and not hibernated). In such case, the
  57     boot is ordinarily continued.</para>
  58   </refsect1>
  59
  60   <refsect1>
  61     <title>See Also</title>
  62     <para>
  63       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  64       <citerefentry><refentrytitle>systemd-hibernate-resume-generator</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  65     </para>
  66   </refsect1>
  67
  68 </refentry>