man/systemd-sysv-generator.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   This file is part of systemd.
   6
   7   Copyright 2014 Zbigniew Jędrzejewski-Szmek
   8
   9   systemd is free software; you can redistribute it and/or modify it
  10   under the terms of the GNU Lesser General Public License as published by
  11   the Free Software Foundation; either version 2.1 of the License, or
  12   (at your option) any later version.
  13
  14   systemd is distributed in the hope that it will be useful, but
  15   WITHOUT ANY WARRANTY; without even the implied warranty of
  16   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  17   Lesser General Public License for more details.
  18
  19   You should have received a copy of the GNU Lesser General Public License
  20   along with systemd; If not, see <http://www.gnu.org/licenses/>.
  21 -->
  22 <refentry id="systemd-sysv-generator" conditional="HAVE_SYSV_COMPAT">
  23
  24   <refentryinfo>
  25     <title>systemd-sysv-generator</title>
  26     <productname>systemd</productname>
  27
  28     <authorgroup>
  29       <author>
  30         <contrib>Documentation</contrib>
  31         <firstname>Zbigniew</firstname>
  32         <surname>Jędrzejewski-Szmek</surname>
  33         <email>zbyszek@in.waw.pl</email>
  34       </author>
  35     </authorgroup>
  36   </refentryinfo>
  37
  38   <refmeta>
  39     <refentrytitle>systemd-sysv-generator</refentrytitle>
  40     <manvolnum>8</manvolnum>
  41   </refmeta>
  42
  43   <refnamediv>
  44     <refname>systemd-sysv-generator</refname>
  45     <refpurpose>Unit generator for SysV init scripts</refpurpose>
  46   </refnamediv>
  47
  48   <refsynopsisdiv>
  49     <para><filename>/usr/lib/systemd/system-generators/systemd-sysv-generator</filename></para>
  50   </refsynopsisdiv>
  51
  52   <refsect1>
  53     <title>Description</title>
  54
  55     <para><filename>systemd-sysv-generator</filename> is a generator
  56     that creates wrapper .service units for
  57     <ulink url="https://savannah.nongnu.org/projects/sysvinit">SysV init</ulink>
  58     scripts in <filename>/etc/init.d/*</filename> at boot and when
  59     configuration of the system manager is reloaded. This will allow
  60     <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  61     to support them similarly to native units.</para>
  62
  63     <para><ulink url="http://refspecs.linuxbase.org/LSB_3.1.1/LSB-Core-generic/LSB-Core-generic/iniscrptact.html">LSB headers</ulink>
  64     in SysV init scripts are interpreted, and the ordering specified
  65     in the header is turned into dependencies between the generated
  66     unit and other units. LSB facilities
  67     <literal>$remote_fs</literal>, <literal>$network</literal>,
  68     <literal>$named</literal>, <literal>$portmap</literal>,
  69     <literal>$time</literal> are supported and will be turned into
  70     dependencies on specific native systemd targets.  See
  71     <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>5</manvolnum></citerefentry>
  72     for more details.</para>
  73
  74     <para>SysV runlevels have corresponding systemd targets
  75     (<filename>runlevel<replaceable>X</replaceable>.target</filename>).
  76     Wrapper unit that is generated will be wanted by those targets
  77     which correspond to runlevels for which the script is
  78     enabled.</para>
  79
  80     <para><command>systemd</command> does not supports SysV scripts as
  81     part of early boot, so all wrapper units are ordered after
  82     <filename>basic.target</filename>.</para>
  83
  84     <para><filename>systemd-sysv-generator</filename>
  85     implements the <ulink
  86     url="http://www.freedesktop.org/wiki/Software/systemd/Generators">generator
  87     specification</ulink>.</para>
  88   </refsect1>
  89
  90   <refsect1>
  91     <title>See Also</title>
  92     <para>
  93       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  94       <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
  95       <citerefentry><refentrytitle>systemd.target</refentrytitle><manvolnum>5</manvolnum></citerefentry>
  96     </para>
  97   </refsect1>
  98
  99 </refentry>