1 <?xml version='1.0'?> <!--*-nxml-*-->
2 <?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
4 "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
7 This file is part of systemd.
9 Copyright 2010 Lennart Poettering
11 systemd is free software; you can redistribute it and/or modify it
12 under the terms of the GNU Lesser General Public License as published by
13 the Free Software Foundation; either version 2.1 of the License, or
14 (at your option) any later version.
16 systemd is distributed in the hope that it will be useful, but
17 WITHOUT ANY WARRANTY; without even the implied warranty of
18 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
19 Lesser General Public License for more details.
21 You should have received a copy of the GNU Lesser General Public License
22 along with systemd; If not, see <http://www.gnu.org/licenses/>.
25 <refentry id="systemd.target">
27 <title>systemd.target</title>
28 <productname>systemd</productname>
32 <contrib>Developer</contrib>
33 <firstname>Lennart</firstname>
34 <surname>Poettering</surname>
35 <email>lennart@poettering.net</email>
41 <refentrytitle>systemd.target</refentrytitle>
42 <manvolnum>5</manvolnum>
46 <refname>systemd.target</refname>
47 <refpurpose>Target unit configuration</refpurpose>
51 <para><filename><replaceable>target</replaceable>.target</filename></para>
55 <title>Description</title>
57 <para>A unit configuration file whose name ends in
58 <literal>.target</literal> encodes information about
59 a target unit of systemd, which is used for grouping
60 units and as well-known synchronization points during
63 <para>This unit type has no specific options. See
64 <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
65 for the common options of all unit configuration
66 files. The common configuration items are configured
67 in the generic [Unit] and [Install] sections. A
68 separate [Target] section does not exist, since no
69 target-specific options may be configured.</para>
71 <para>Target units do not offer any additional
72 functionality on top of the generic functionality
73 provided by units. They exist merely to group units via dependencies
74 (useful as boot targets), and to establish
75 standardized names for synchronization points used in
76 dependencies between units. Among other things, target
77 units are a more flexible replacement for SysV
78 runlevels in the classic SysV init system. (And for
79 compatibility reasons special
81 <filename>runlevel3.target</filename> exist which are used by
82 the SysV runlevel compatibility code in systemd. See
83 <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>
86 <para>Unless <varname>DefaultDependencies=</varname>
87 is set to <option>false</option>, target units will
88 implicitly complement all configured dependencies of
89 type <varname>Wants=</varname>,
90 <varname>Requires=</varname>,
91 <varname>RequiresOverridable=</varname> with
92 dependencies of type <varname>After=</varname> if the
93 units in question also have
94 <varname>DefaultDependencies=true</varname>.
99 <title>See Also</title>
101 <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
102 <citerefentry><refentrytitle>systemctl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
103 <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
104 <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
105 <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>