man/systemd-boot-check-no-failures.service.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
   4 <!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
   5
   6 <refentry id="systemd-boot-check-no-failures.service"
   7           xmlns:xi="http://www.w3.org/2001/XInclude">
   8
   9   <refentryinfo>
  10     <title>systemd-boot-check-no-failures.service</title>
  11     <productname>systemd</productname>
  12   </refentryinfo>
  13
  14   <refmeta>
  15     <refentrytitle>systemd-boot-check-no-failures.service</refentrytitle>
  16     <manvolnum>8</manvolnum>
  17   </refmeta>
  18
  19   <refnamediv>
  20     <refname>systemd-boot-check-no-failures.service</refname>
  21     <refname>systemd-boot-check-no-failures</refname>
  22     <refpurpose>verify that the system booted up cleanly</refpurpose>
  23   </refnamediv>
  24
  25   <refsynopsisdiv>
  26     <para><filename>systemd-boot-check-no-failures.service</filename></para>
  27     <para><filename>/usr/lib/systemd/system-boot-check-no-failures</filename></para>
  28   </refsynopsisdiv>
  29
  30   <refsect1>
  31     <title>Description</title>
  32
  33     <para><filename>systemd-boot-check-no-failures.service</filename> is a system service that checks whether the
  34     system booted up successfully. This service implements a very minimal test only: whether there are any failed units on
  35     the system. This service is disabled by default. When enabled, it is ordered before
  36     <filename>boot-complete.target</filename>, thus ensuring the target cannot be reached when the system booted up
  37     with failed services.</para>
  38
  39     <para>Note that due the simple nature of this check this service is probably not suitable for deployment in most
  40     scenarios. It is primarily useful only as example for developing more fine-grained checks to order before
  41     <filename>boot-complete.target</filename>.</para>
  42   </refsect1>
  43
  44   <refsect1>
  45     <title>See Also</title>
  46     <para><simplelist type="inline">
  47       <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
  48       <member><citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry></member>
  49     </simplelist></para>
  50   </refsect1>
  51
  52 </refentry>