1
1
mirror of https://github.com/systemd/systemd-stable.git synced 2024-12-23 17:34:00 +03:00

man: additional documentation

This commit is contained in:
Lennart Poettering 2010-06-24 17:22:52 +02:00
parent c61fbdfcb9
commit 771610b04d
2 changed files with 103 additions and 32 deletions

View File

@ -66,6 +66,12 @@
<para><command>systemd-install</command> enables or
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>

View File

@ -55,67 +55,132 @@
<para><filename>systemd.automount</filename></para>
<para><filename>systemd.swap</filename></para>
<para><filename>systemd.target</filename></para>
<para><filename>systemd.path</filename></para>
<para><filename>systemd.timer</filename></para>
</refsynopsisdiv>
<refsect1>
<title>Description</title>
<para>A unit configuration file encodes information
about a service, a socket, a mount point, an automount
point, a swap file or patition, or a start-up target
controlled and supervised by systemd. The syntax is
inspired by XDG <filename>.desktop</filename> files,
which are in turn inspired by Windows
<filename>.ini</filename> files.</para>
about a service, a socket, a device, a mount point, an
automount point, a swap file or patition, a start-up
target, a file system path or a timer controlled and
supervised by <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>. The syntax is inspired by XDG
<filename>.desktop</filename> files, which are in turn
inspired by Microsoft Windows <filename>.ini</filename>
files.</para>
<para>This man pages lists the common configuration
options of the various unit types.</para>
options of the all unit types. These options need to
be configured either in the [Unit] resp. [Install]
section of the unit files.</para>
</refsect1>
<refsect1>
<title>Options</title>
<para>Unit file may include a [Unit] section, which
carries generic information about the unit that is not
dependent on the type of unit:</para>
<variablelist>
<varlistentry>
<term><varname>Names=</varname></term>
<listitem>
<para>Additional names for this unit. The names
listed here mus have the same suffix (i.e. type)
as the identifier name. This option may be
specified more than once.</para>
<listitem><para>Additional names for
this unit. The names listed here must
have the same suffix (i.e. type) as
the unit file name. This option may be
specified more than once, in which
case all listed names are used. Note
that this option is different from the
<varname>Alias=</varname> option from
the [Install] section mentioned
below. See below for details</para>
</listitem>
</varlistentry>
<varlistentry>
<term><varname>Requires=</varname></term>
<listitem>
<para>Dependencies on other
units. If this units get
activated the units listed
here will be activated as
well. If one of the other
units gets deactivated or its
activation fails, this unit
will be deactivated. This
option may be specified more
than once.</para>
<listitem><para>Requirement
dependencies on other units. If this
units get activated the units listed
here will be activated as well. If one
of the other units gets deactivated or
its activation fails, this unit will
be deactivated. This option may be
specified more than once, in which
case requirement dependencies for all
listed names are created.</para>
</listitem>
</varlistentry>
</variablelist>
<para>Unit file may include a [Install] section, which
carries installation information for the unit. This
section is not interpreted by
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>
during runtime. It is used exclusively by the
<citerefentry><refentrytitle>systemd-install</refentrytitle><manvolnum>1</manvolnum></citerefentry>
during installation of a unit:</para>
<variablelist>
<varlistentry>
<term><varname>Alias=</varname></term>
<listitem><para>Additional names this
unit shall be installed under. The
names listed here must have the same
suffix (i.e. type) as the unit file
name. This option may be specified
more than once, in which case all
listed names are used. At installation
time
<command>systemd-install</command>
will create symlinks from these names
to the unit file name. Note that this
is different from the
<varname>Names=</varname> option from
the [Unit] section mentioned above:
The names from
<varname>Names=</varname> apply
unconditionally if the unit is
loaded. The names from
<varname>Alias=</varname> apply only
if the unit is actually installed with
the <command>systemd-install</command>
tool. Also, if systemd searches for a
unit, it will discover symlinked alias
names, but not names configured only
with <varname>Names=</varname>. It is
a common pattern to list a name in both
options. In this case, a unit will be
active under all names if installed,
but also if not installed but
requested
explicitly.</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>8</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd.device</refentrytitle><manvolnum>5</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd.automount</refentrytitle><manvolnum>5</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd.swap</refentrytitle><manvolnum>5</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemd.target</refentrytitle><manvolnum>5</manvolnum></citerefentry>
<citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd-install</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.socket</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.device</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.mount</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.automount</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.swap</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.target</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.path</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.timer</refentrytitle><manvolnum>5</manvolnum></citerefentry>
</para>
</refsect1>