along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->
-<refentry id="systemd">
+<refentry id="systemd-install">
<refentryinfo>
<title>systemd-install</title>
<refsynopsisdiv>
<cmdsynopsis>
- <command>systemd-install <arg choice="opt" rep="repeat">options</arg> <option>enable</option> <arg choice="opt" rep="repeat">name</arg></command>
+ <command>systemd-install <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="plain">enable</arg> <arg choice="opt" rep="repeat">NAME</arg></command>
</cmdsynopsis>
<cmdsynopsis>
- <command>systemd-install <arg choice="opt" rep="repeat">options</arg> <option>disable</option> <arg choice="opt" rep="repeat">name</arg></command>
+ <command>systemd-install <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="plain">disable</arg> <arg choice="opt" rep="repeat">NAME</arg></command>
</cmdsynopsis>
<cmdsynopsis>
- <command>systemd-install <arg choice="opt" rep="repeat">options</arg> <option>test</option> <arg choice="opt" rep="repeat">name</arg></command>
+ <command>systemd-install <arg choice="opt" rep="repeat">OPTIONS</arg> <arg choice="plain">test</arg> <arg choice="opt" rep="repeat">NAME</arg></command>
</cmdsynopsis>
</refsynopsisdiv>
disables systemd units, or checks whether they are
enabled.</para>
+ <para>This command is useful to apply or undo the
+ installation instructions encoded in the [Install]
+ section of unit files. See
+ <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
+ for more information.</para>
+ </refsect1>
+
+ <refsect1>
+ <title>Options</title>
+
<para>The following options are understood:</para>
<variablelist>
<varlistentry>
- <term>--help</term>
+ <term><option>--help</option></term>
<listitem><para>Prints a short help
text and exits.</para></listitem>
</varlistentry>
<varlistentry>
- <term>--force</term>
+ <term><option>--force</option></term>
<listitem><para>Enable/disable a
service even if it conflicts
</varlistentry>
<varlistentry>
- <term>--system</term>
+ <term><option>--system</option></term>
<listitem><para>Enable/disable a
system service.</para></listitem>
</varlistentry>
<varlistentry>
- <term>--session</term>
+ <term><option>--session</option></term>
<listitem><para>Enable/disable a
session service for the calling
</varlistentry>
<varlistentry>
- <term>--global</term>
+ <term><option>--global</option></term>
<listitem><para>Enable/disable a
session service for all
</varlistentry>
</variablelist>
- <para>The following verbs are understood:</para>
+ <para>The following commands are understood:</para>
<variablelist>
<varlistentry>
- <term>enable</term>
+ <term><command>enable</command></term>
<listitem><para>Enable a unit. This
will create a number of symlinks as
</varlistentry>
<varlistentry>
- <term>disable</term>
+ <term><command>disable</command></term>
<listitem><para>Disable a unit. This
will removed a number of symlinks as
</varlistentry>
<varlistentry>
- <term>test</term>
+ <term><command>test</command></term>
<listitem><para>Checks whether any of
the units specified are
installed. This will check for the
- existance of a number of symlinks as
+ existence of a number of symlinks as
encoded in the [Install] section of a
unit file.</para></listitem>
</varlistentry>
<refsect1>
<title>See Also</title>
<para>
+ <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>