<refentry id="gnome-session-inhibit" lang="en">

<refentryinfo>
<title>gnome-session-inhibit</title>
<productname>gnome-session</productname>
</refentryinfo>

<refmeta>
<refentrytitle>gnome-session-inhibit</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="manual">User Commands</refmiscinfo>
</refmeta>

<refnamediv>
<refname>gnome-session-inhibit</refname>
<refpurpose>inhibit gnome-session functionality</refpurpose>
</refnamediv>

<refsynopsisdiv>
<cmdsynopsis>
<command>gnome-session-inhibit</command>
<arg choice="opt" rep="repeat">OPTION</arg>
<arg choice="opt">COMMAND</arg>
</cmdsynopsis>
</refsynopsisdiv>

<refsect1><title>Description</title>
<para><command>gnome-session-inhibit</command> can inhibit certain
gnome-session functionality while executing the given COMMAND. To
achieve this, it calls the Inhibit() method of the gnome-session
D-Bus API and creates an inhibitor. The inhibitor is automatically
removed when gnome-session-inhibit exits.
</para>
<para>
A typical use case is to prevent the session from going idle (and
thus locking the screen) while a movie player is running.
</para>

</refsect1>

<refsect1><title>Options</title>
<variablelist>

<varlistentry>
<term><option>-h</option>, <option>--help</option></term>
<listitem><para>
print help and exit
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--version</option></term>
<listitem><para>
print version information and exit
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--app-id</option> ID</term>
<listitem><para>
The application id to use when calling the gnome-session Inhibit() method.
If this option is not specified, "unknown" is used.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--reason</option> REASON</term>
<listitem><para>
A human-readable reason to pass along when calling the gnome-session
Inhibit() method. If this option is not specified, "not specified" is used.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--inhibit</option> ARG</term>
<listitem><para>
ARG specifies the things to inhibit, as a colon-separated list. The
possible values are logout, switch-user, suspend, idle, automount.
If this option is used more than once, the values are combined.
If this option is not specified, "idle" is assumed.
</para></listitem>
</varlistentry>

<varlistentry>
<term><option>--inhibit-only</option></term>
<listitem><para>
Do not launch COMMAND and wait forever instead
</para></listitem>
</varlistentry>

</variablelist>
</refsect1>

<refsect1><title>See also</title>
<para>
<citerefentry><refentrytitle>systemd-inhibit</refentrytitle><manvolnum>1</manvolnum></citerefentry>
</para>
</refsect1>
</refentry>
