systemd.slice.xml revision fbce11397f4d19821a9dfe66ee3ebe11cad90057
234N/A<?xml version='1.0'?> <!--*-nxml-*-->
234N/A<?xml-stylesheet type="text/xsl" href="http://docbook.sourceforge.net/release/xsl/current/xhtml/docbook.xsl"?>
234N/A<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
234N/A"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
234N/A
234N/A<!--
234N/AThis file is part of systemd.
234N/A
234N/ACopyright 2013 Zbigniew Jędrzejewski-Szmek
234N/A
234N/Asystemd is free software; you can redistribute it and/or modify it
234N/Aunder the terms of the GNU Lesser General Public License as published by
234N/Athe Free Software Foundation; either version 2.1 of the License, or
234N/A(at your option) any later version.
234N/A
234N/Asystemd is distributed in the hope that it will be useful, but
234N/AWITHOUT ANY WARRANTY; without even the implied warranty of
234N/AMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
234N/ALesser General Public License for more details.
234N/A
2790N/AYou should have received a copy of the GNU Lesser General Public License
234N/Aalong with systemd; If not, see <http://www.gnu.org/licenses/>.
2790N/A-->
2790N/A
2790N/A<refentry id="systemd.slice">
234N/A <refentryinfo>
234N/A <title>systemd.slice</title>
234N/A <productname>systemd</productname>
234N/A
618N/A <authorgroup>
234N/A <author>
234N/A <contrib>Developer</contrib>
844N/A <firstname>Lennart</firstname>
844N/A <surname>Poettering</surname>
234N/A <email>lennart@poettering.net</email>
1258N/A </author>
234N/A </authorgroup>
234N/A </refentryinfo>
234N/A
234N/A <refmeta>
234N/A <refentrytitle>systemd.slice</refentrytitle>
234N/A <manvolnum>5</manvolnum>
234N/A </refmeta>
234N/A
1938N/A <refnamediv>
1938N/A <refname>systemd.slice</refname>
2790N/A <refpurpose>Slice unit configuration</refpurpose>
2790N/A </refnamediv>
2790N/A
2790N/A <refsynopsisdiv>
2790N/A <para><filename><replaceable>slice</replaceable>.slice</filename></para>
2790N/A </refsynopsisdiv>
2790N/A
2790N/A <refsect1>
2790N/A <title>Description</title>
2790N/A
2790N/A <para>A unit configuration file whose name ends in
2790N/A <literal>.slice</literal> encodes information about a slice which
2790N/A is a concept for hierarchially managing resources of a group of
234N/A processes. This management is performed by creating a node in the
234N/A control group tree. Units that manage processes (primarilly scope
234N/A and service units) may be assigned to a specific slice. For each
234N/A slice, certain resource limits may the be set that apply to all
234N/A processes of all units contained in that slice. Slices are
2790N/A organized hierarchially in a tree. The name of the slice encodes
234N/A the location in the tree. The name consists of a dash-separated
234N/A series of names, which describes the path to the slice from the
234N/A root slice. The root slice is named,
234N/A <filename>-.slice</filename>. Example:
<filename>foo-bar.slice</filename> is a slice that is located
within <filename>foo.slice</filename>, which in turn is located in
the root slice <filename>-.slice</filename>.
</para>
<para>By default, service and scope units are placed in
<filename>system.slice</filename>, virtual machines and containers
registered with
<citerefentry><refentrytitle>systemd-machined</refentrytitle><manvolnum>1</manvolnum></citerefentry>
are found in <filename>machine.slice</filename>, and user sessions
handled by
<citerefentry><refentrytitle>systemd-logind</refentrytitle><manvolnum>1</manvolnum></citerefentry>
in <filename>user.slice</filename>. See
<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for more information.</para>
<para>See
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for the common options of all unit configuration
files. The common configuration items are configured
in the generic [Unit] and [Install] sections. The
slice specific configuration options are configured in
the [Slice] section. Currently, only generic cgroup settings
as described in
<citerefentry><refentrytitle>systemd.cgroup</refentrytitle><manvolnum>7</manvolnum></citerefentry> are allowed.
</para>
<para>Unless <varname>DefaultDependencies=false</varname>
is used, slice units will implicitly have dependencies of
type <varname>Conflicts=</varname> and
<varname>Before=</varname> on
<filename>shutdown.target</filename>. These ensure
that slice units are removed prior to system
shutdown. Only slice units involved with early boot or
late system shutdown should disable this option.
</para>
</refsect1>
<refsect1>
<title>See Also</title>
<para>
<citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.cgroup</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.scope</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
<citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>
</para>
</refsect1>
</refentry>