1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
|
<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>
<varlistentry>
<term><option>-l</option>, <option>--list</option></term>
<listitem><para>
list the existing inhibitions and exit
</para></listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1><title>See also</title>
<para>
<citerefentry><refentrytitle>systemd-inhibit</refentrytitle><manvolnum>1</manvolnum></citerefentry>
</para>
</refsect1>
</refentry>
|
