systemd-sysv-generator.xml revision a8eaaee72a2f06e0fb64fb71de3b71ecba31dafb
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger<?xml version="1.0"?>
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger<!--*-nxml-*-->
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger<!--
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger This file is part of systemd.
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger Copyright 2014 Zbigniew Jędrzejewski-Szmek
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger systemd is free software; you can redistribute it and/or modify it
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger under the terms of the GNU Lesser General Public License as published by
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger the Free Software Foundation; either version 2.1 of the License, or
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger (at your option) any later version.
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger systemd is distributed in the hope that it will be useful, but
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger WITHOUT ANY WARRANTY; without even the implied warranty of
b9fe3a5d4206480e6222c436da55c7409140b83fKryštof Tulinger MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->
<refentry id="systemd-sysv-generator" conditional="HAVE_SYSV_COMPAT">
<refentryinfo>
<title>systemd-sysv-generator</title>
<productname>systemd</productname>
<authorgroup>
<author>
<contrib>Documentation</contrib>
<firstname>Zbigniew</firstname>
<surname>Jędrzejewski-Szmek</surname>
<email>zbyszek@in.waw.pl</email>
</author>
</authorgroup>
</refentryinfo>
<refmeta>
<refentrytitle>systemd-sysv-generator</refentrytitle>
<manvolnum>8</manvolnum>
</refmeta>
<refnamediv>
<refname>systemd-sysv-generator</refname>
<refpurpose>Unit generator for SysV init scripts</refpurpose>
</refnamediv>
<refsynopsisdiv>
<para><filename>/usr/lib/systemd/system-generators/systemd-sysv-generator</filename></para>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para><filename>systemd-sysv-generator</filename> is a generator
that creates wrapper .service units for
<ulink url="https://savannah.nongnu.org/projects/sysvinit">SysV init</ulink>
scripts in <filename>/etc/init.d/*</filename> at boot and when
configuration of the system manager is reloaded. This will allow
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
to support them similarly to native units.</para>
<para><ulink url="http://refspecs.linuxbase.org/LSB_3.1.1/LSB-Core-generic/LSB-Core-generic/iniscrptact.html">LSB headers</ulink>
in SysV init scripts are interpreted, and the ordering specified
in the header is turned into dependencies between the generated
unit and other units. The LSB facilities
<literal>$remote_fs</literal>, <literal>$network</literal>,
<literal>$named</literal>, <literal>$portmap</literal>,
<literal>$time</literal> are supported and will be turned into
dependencies on specific native systemd targets. See
<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for more details.</para>
<para>SysV runlevels have corresponding systemd targets
(<filename>runlevel<replaceable>X</replaceable>.target</filename>).
The wrapper unit that is generated will be wanted by those targets
which correspond to runlevels for which the script is
enabled.</para>
<para><command>systemd</command> does not supports SysV scripts as
part of early boot, so all wrapper units are ordered after
<filename>basic.target</filename>.</para>
<para><filename>systemd-sysv-generator</filename> implements
<citerefentry><refentrytitle>systemd.generator</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para>
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.target</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>
</refentry>