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">
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek This file is part of systemd.
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek Copyright 2013 Zbigniew Jędrzejewski-Szmek
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek systemd is free software; you can redistribute it and/or modify it
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek under the terms of the GNU Lesser General Public License as published by
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek the Free Software Foundation; either version 2.1 of the License, or
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek (at your option) any later version.
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek systemd is distributed in the hope that it will be useful, but
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek WITHOUT ANY WARRANTY; without even the implied warranty of
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek Lesser General Public License for more details.
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew Jędrzejewski-Szmek You should have received a copy of the GNU Lesser General Public License
5de0ccffcc4a5a946102a14e0b0e681d964e3225Zbigniew 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.scope</refentrytitle>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <refname>systemd.scope</refname>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <refpurpose>Scope unit configuration</refpurpose>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <refsynopsisdiv>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <para><filename><replaceable>scope</replaceable>.scope</filename></para>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek </refsynopsisdiv>
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering <para>Scope units are not configured via unit configuration files,
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering but are only created programmatically using the bus interfaces of
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering systemd. They are named similar to filenames. A unit whose name
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering ends in <literal>.scope</literal> refers to a scope unit. Scopes
fbce11397f4d19821a9dfe66ee3ebe11cad90057Jan Engelhardt units manage a set of system processes. Unlike service units, scope
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering units manage externally created processes, and do not fork off
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering processes on its own.</para>
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering <para>The main purpose of scope units is grouping worker processes
847ae0ae7f29e7bfb245d692409fc2948eab7d1dLennart Poettering of a system service for organization and for managing resources.</para>
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering <para><command>systemd-run <option>--scope</option></command> may
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering be used to easily launch a command in a new scope unit from the
9365b048c0c9f62ef7f696216ba049e6b4c2f2e5Lennart Poettering command line.</para>
ea021cc3ea7082786e764734bb344eebbd6f2caaLennart Poettering url="http://www.freedesktop.org/wiki/Software/systemd/ControlGroupInterface/">New
72f4d9669c253d5bd7c126bf2e7a0db0198cf2ebJan Engelhardt Control Group Interfaces</ulink> for an introduction on how to make
ea021cc3ea7082786e764734bb344eebbd6f2caaLennart Poettering use of scope units from programs.</para>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <para>Unless <varname>DefaultDependencies=false</varname>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek is used, scope 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 scope units are removed prior to system
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek shutdown. Only scope units involved with early boot or
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek late system shutdown should disable this option.
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <para>Additional implicit dependencies may be added as result of
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering resource control parameters as documented in
c129bd5df3ca08eb352cf69d01d2f374552624aeLennart Poettering <citerefentry><refentrytitle>systemd.resource-control</refentrytitle><manvolnum>5</manvolnum></citerefentry>.</para>
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd-run</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>,
d868475ad62547f0a034dfaf038aff31b3d05372Zbigniew Jędrzejewski-Szmek <citerefentry><refentrytitle>systemd.directives</refentrytitle><manvolnum>7</manvolnum></citerefentry>.