2012-05-05 02:34:48 +04:00
<?xml version='1.0'?> <!-- * - nxml - * -->
< !DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<!--
This file is part of systemd.
Copyright 2012 Lennart Poettering
systemd is free software; you can redistribute it and/or modify it
under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation; either version 2.1 of the License, or
(at your option) any later version.
systemd is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License
along with systemd; If not, see <http: / / w w w . g n u . o r g / l i c e n s e s /> .
-->
<refentry id= "systemd-inhibit" >
<refentryinfo >
<title > systemd-inhibit</title>
<productname > systemd</productname>
<authorgroup >
<author >
<contrib > Developer</contrib>
<firstname > Lennart</firstname>
<surname > Poettering</surname>
<email > lennart@poettering.net</email>
</author>
</authorgroup>
</refentryinfo>
<refmeta >
<refentrytitle > systemd-inhibit</refentrytitle>
<manvolnum > 1</manvolnum>
</refmeta>
<refnamediv >
<refname > systemd-inhibit</refname>
<refpurpose > Execute a program with an inhibition lock taken</refpurpose>
</refnamediv>
<refsynopsisdiv >
<cmdsynopsis >
<command > systemd-inhibit <arg choice= "opt" rep= "repeat" > OPTIONS</arg> <arg > COMMAND</arg> <arg choice= "opt" rep= "repeat" > ARGUMENTS</arg> </command>
</cmdsynopsis>
<cmdsynopsis >
<command > systemd-inhibit <arg choice= "opt" rep= "repeat" > OPTIONS</arg> --list</command>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 >
<title > Description</title>
<para > <command > systemd-inhibit</command> may be used
2012-05-05 02:46:31 +04:00
to execute a program with a shutdown, sleep or idle
2012-05-05 02:34:48 +04:00
inhibitor lock taken. The lock will be acquired before
the specified command line is executed and released
afterwards.</para>
<para > Inhibitor locks may be used to block or delay
2012-05-05 02:46:31 +04:00
system sleep and shutdown requests from the user, as well
as automatic idle handling of the OS. This is useful
2012-05-05 02:34:48 +04:00
to avoid system suspends while an optical disc is
being recorded, or similar operations that should not
be interrupted.</para>
2012-06-29 04:07:40 +04:00
<para > For more information see the <ulink
url="http://www.freedesktop.org/wiki/Software/systemd/inhibit">Inhibitor
Lock Developer Documentation</ulink> .</para>
2012-05-05 02:34:48 +04:00
</refsect1>
<refsect1 >
<title > Options</title>
<para > The following options are understood:</para>
<variablelist >
<varlistentry >
2012-06-27 12:48:13 +04:00
<term > <option > -h</option> </term>
2012-05-05 02:34:48 +04:00
<term > <option > --help</option> </term>
<listitem > <para > Prints a short help
text and exits.</para> </listitem>
</varlistentry>
<varlistentry >
<term > <option > --version</option> </term>
<listitem > <para > Prints a short version
string and exits.</para> </listitem>
</varlistentry>
<varlistentry >
<term > <option > --what=</option> </term>
<listitem > <para > Takes a colon
separated list of one or more
operations to inhibit:
<literal > shutdown</literal> ,
2012-05-05 02:46:31 +04:00
<literal > sleep</literal> ,
2012-05-05 02:34:48 +04:00
<literal > idle</literal> , for
2012-06-29 04:07:40 +04:00
inhibiting
reboot/power-off/halt/kexec,
2012-05-05 02:34:48 +04:00
suspending/hibernating, resp. the
2012-07-15 12:41:40 +04:00
automatic idle detection. If omitted
2012-06-29 04:07:40 +04:00
defaults to
<literal > idle:sleep:shutdown</literal> ,
i.e. takes all possible
locks.</para> </listitem>
2012-05-05 02:34:48 +04:00
</varlistentry>
<varlistentry >
<term > <option > --who=</option> </term>
<listitem > <para > Takes a short human
readable descriptive string for the
program taking the lock. If not passed
defaults to the command line
string.</para> </listitem>
</varlistentry>
<varlistentry >
<term > <option > --why=</option> </term>
<listitem > <para > Takes a short human
readable descriptive string for the
reason for taking the lock. Defaults
to "Unknown reason".</para> </listitem>
</varlistentry>
<varlistentry >
<term > <option > --mode=</option> </term>
<listitem > <para > Takes either
<literal > block</literal> or
<literal > delay</literal> and describes
how the lock is applied. If
<literal > block</literal> is used (the
default), the lock prohibits any of
the requested operations without time
limit, and only privileged users may
override it. If
<literal > delay</literal> is used, the
lock can only delay the requested
operations for a limited time. If the
time elapses the lock is ignored and
the operation executed. The time limit
may be specified in
<citerefentry > <refentrytitle > systemd-logind.conf</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry> .</para> </listitem>
</varlistentry>
<varlistentry >
<term > <option > --list</option> </term>
<listitem > <para > Lists all active
inhibition locks instead of acquiring
one.</para> </listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 >
<title > Exit status</title>
<para > Returns the exit status of the executed program.</para>
</refsect1>
2012-06-29 04:07:40 +04:00
<refsect1 >
<title > Example</title>
<programlisting > # systemd-inhibit wodim foobar.iso</programlisting>
<para > This burns the ISO image
<filename > foobar.iso</filename> on a CD using
<citerefentry > <refentrytitle > wodim</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> ,
and inhibits system sleeping, shutdown and idle while
doing so.</para>
</refsect1>
2012-05-05 02:34:48 +04:00
<refsect1 >
<title > See Also</title>
<para >
<citerefentry > <refentrytitle > systemd</refentrytitle> <manvolnum > 1</manvolnum> </citerefentry> ,
<citerefentry > <refentrytitle > systemd-logind.conf</refentrytitle> <manvolnum > 5</manvolnum> </citerefentry>
</para>
</refsect1>
</refentry>
