3802a3d3d7af51ddff31943d5514382f01265770Lennart Poettering<?xml version='1.0'?> <!--*- Mode: nxml; nxml-child-indent: 2; indent-tabs-mode: nil -*-->
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
12b42c76672a66c2d4ea7212c14f8f1b5a62b78dTom Gundersen"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek This file is part of systemd.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek Copyright 2013 Zbigniew Jędrzejewski-Szmek
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek systemd is free software; you can redistribute it and/or modify it
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek under the terms of the GNU Lesser General Public License as published by
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek the Free Software Foundation; either version 2.1 of the License, or
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek (at your option) any later version.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek systemd is distributed in the hope that it will be useful, but
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek WITHOUT ANY WARRANTY; without even the implied warranty of
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek Lesser General Public License for more details.
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek You should have received a copy of the GNU Lesser General Public License
b975b0d514321f169b3c4599a8ea92e13741b4e4Zbigniew Jędrzejewski-Szmek along with systemd; If not, see <http://www.gnu.org/licenses/>.
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <productname>systemd</productname>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <email>lennart@poettering.net</email>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <refentrytitle>systemd.slice</refentrytitle>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <refname>systemd.slice</refname>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <refpurpose>Slice unit configuration</refpurpose>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <refsynopsisdiv>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <para><filename><replaceable>slice</replaceable>.slice</filename></para>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek </refsynopsisdiv>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <para>A unit configuration file whose name ends in
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <literal>.slice</literal> encodes information about a slice which
299a55075d1bf478b9190191caefd5c1b934340dMark Eichin is a concept for hierarchically managing resources of a group of
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek processes. This management is performed by creating a node in the
3fde5f30bda2a70d97f3dc8fa918e42e1c07cc2cLennart Poettering Linux Control Group (cgroup) tree. Units that manage processes
299a55075d1bf478b9190191caefd5c1b934340dMark Eichin (primarily scope and service units) may be assigned to a specific
299a55075d1bf478b9190191caefd5c1b934340dMark Eichin slice. For each slice, certain resource limits may be set that
3fde5f30bda2a70d97f3dc8fa918e42e1c07cc2cLennart Poettering apply to all processes of all units contained in that
299a55075d1bf478b9190191caefd5c1b934340dMark Eichin slice. Slices are organized hierarchically in a tree. The name of
3fde5f30bda2a70d97f3dc8fa918e42e1c07cc2cLennart Poettering the slice encodes the location in the tree. The name consists of a
3fde5f30bda2a70d97f3dc8fa918e42e1c07cc2cLennart Poettering dash-separated series of names, which describes the path to the
3fde5f30bda2a70d97f3dc8fa918e42e1c07cc2cLennart Poettering slice from the root slice. The root slice is named,
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <filename>foo-bar.slice</filename> is a slice that is located
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering within <filename>foo.slice</filename>, which in turn is located in
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering the root slice <filename>-.slice</filename>.
fbce11397f4d19821a9dfe66ee3ebe11cad90057Jan Engelhardt <para>By default, service and scope units are placed in
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <filename>system.slice</filename>, virtual machines and containers
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering registered with
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <citerefentry><refentrytitle>systemd-machined</refentrytitle><manvolnum>1</manvolnum></citerefentry>
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering are found in <filename>machine.slice</filename>, and user sessions
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <citerefentry><refentrytitle>systemd-logind</refentrytitle><manvolnum>1</manvolnum></citerefentry>
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>5</manvolnum></citerefentry>
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering for more information.</para>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek for the common options of all unit configuration
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek files. The common configuration items are configured
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek in the generic [Unit] and [Install] sections. The
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek slice specific configuration options are configured in
3fde5f30bda2a70d97f3dc8fa918e42e1c07cc2cLennart Poettering the [Slice] section. Currently, only generic resource control settings
c4e87748d5d3f574d335a87e3a6272276814b2fdPatrick Donnelly <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry> are allowed.
b6f011c10d30c6ba8ad732cc01465aa6a4ee17e7Evgeny Vereshchagin url="http://www.freedesktop.org/wiki/Software/systemd/ControlGroupInterface/">New
b6f011c10d30c6ba8ad732cc01465aa6a4ee17e7Evgeny Vereshchagin Control Group Interfaces</ulink> for an introduction on how to make
b6f011c10d30c6ba8ad732cc01465aa6a4ee17e7Evgeny Vereshchagin use of slice units from programs.</para>
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <para>Slice units automatically gain dependencies of type
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <varname>After=</varname> and <varname>Requires=</varname> on
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering their immediate parent slice unit.</para>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <para>Unless <varname>DefaultDependencies=false</varname>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek is used, slice units will implicitly have dependencies of
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek type <varname>Conflicts=</varname> and
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <filename>shutdown.target</filename>. These ensure
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek that slice units are removed prior to system
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek shutdown. Only slice units involved with early boot or
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek late system shutdown should disable this option.
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
3fde5f30bda2a70d97f3dc8fa918e42e1c07cc2cLennart Poettering <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.service</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <citerefentry><refentrytitle>systemd.scope</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <citerefentry><refentrytitle>systemd.special</refentrytitle><manvolnum>7</manvolnum></citerefentry>,
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>