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