← Back to branch summary

~ubuntu-branches/ubuntu/utopic/xfce4-power-manager/utopic-proposed

« back to all changes in this revision

Viewing changes to doc/C/xfce4-power-manager.html

  • Committer: Package Import Robot
  • Author(s): Lionel Le Folgoc
  • Date: 2012-04-03 22:15:05 UTC
  • mfrom: (2.3.8)
  • Revision ID: package-import@ubuntu.com-20120403221505-2dvza7w2d97zb7qn
Tags: 1.0.11-0ubuntu1
* New upstream bugfix release.
* debian/patches:
  - 0001-Solaris-specific-code-for-determining-the-start-time.patch,
    02_fix-notify-detect.patch,
    07_fix_broken_empty_icon_battery.patch: dropped, included upstream.
  - xubuntu_fix-status-icon-other-devices.patch: refreshed to apply cleanly.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/C/xfce4-power-manager.html
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Xfce 4 Power Manager</title><link rel="stylesheet" href="../xfce.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="#xfce4-power-manager" title="Xfce 4 Power Manager"><link rel="next" href="#xfpm-intro" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="article" lang="en"><div class="titlepage"><div><div><h2 class="title"><a name="xfce4-power-manager"></a>Xfce 4 Power Manager</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Ali</span> <span class="surname">Abdallah</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:aliov@xfce.org">aliov@xfce.org</a>&gt;</code></p></div></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" class="releaseinfo">This manual describes <strong xmlns="" class="application"><code>xfce4-power-manager</code></strong> version 0.8.3.1
 
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Xfce 4 Power Manager</title><link rel="stylesheet" type="text/css" href="../xfce.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1"><link rel="home" href="#xfce4-power-manager" title="Xfce 4 Power Manager"><link rel="next" href="#xfpm-intro" title="Introduction"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div lang="en" class="article" title="Xfce 4 Power Manager"><div class="titlepage"><div><div><h2 class="title"><a name="xfce4-power-manager"></a>Xfce 4 Power Manager</h2></div><div><div class="authorgroup"><div class="author"><h3 class="author"><span class="firstname">Ali</span> <span class="surname">Abdallah</span></h3><div class="affiliation"><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:aliov@xfce.org">aliov@xfce.org</a>&gt;</code></p></div></div></div></div></div><div><span xmlns="http://www.w3.org/TR/xhtml1/transitional" class="releaseinfo">This manual describes <strong xmlns="" class="application"><code>xfce4-power-manager</code></strong> version 1.0.11
2
2
<br></br></span></div><div><p class="copyright">Copyright � 2008 Ali Abdallah</p></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="#xfpm-intro">Introduction</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfpm-started">Getting Started</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfpm">Power Manager</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfpm-command-line">Command line options</a></span></dt><dt><span class="sect2"><a href="#xfpm-menu">Context menu</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfpm-configuration">Power Manager Configuration</a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfpm-general">General options</a></span></dt><dt><span class="sect2"><a href="#xfpm-on-ac">Running on  AC power</a></span></dt><dt><span class="sect2"><a href="#xfpm-on-battery">Running on battery power</a></span></dt><dt><span class="sect2"><a href="#xfpm-extended">Extended options</a></span></dt><dt><span class="sect2"><a href="#xfpm-hidden-options">Hidden options</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfpm-plugins"> Panel plugins </a></span></dt><dt><span class="sect1"><a href="#xfpm-faq">FAQ</a></span></dt><dt><span class="sect1"><a href="#xfpm-technical">
3
3
 Technical information
4
 
 </a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfpm-dbus">DBus interfaces</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfpm-about">About <strong class="application"><code>xfce4-power-manager</code></strong></a></span></dt></dl></div><p>�</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-intro"></a>Introduction</h2></div></div></div>
 
4
 </a></span></dt><dd><dl><dt><span class="sect2"><a href="#xfpm-dbus">DBus interfaces</a></span></dt></dl></dd><dt><span class="sect1"><a href="#xfpm-about">About <strong class="application"><code>xfce4-power-manager</code></strong></a></span></dt></dl></div><p>�</p><div class="sect1" title="Introduction"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-intro"></a>Introduction</h2></div></div></div>
5
5
 This software is a power manager for the Xfce desktop, Xfce power manager manages the power sources on the computer and the devices that can 
6
6
 be controlled to reduce their power consumption (such as LCD brightness level, monitor sleep, CPU frequency scaling). 
7
7
 In addition, xfce4-power-manager provides a set of freedesktop-compliant DBus interfaces to inform other applications about current power level so that 
8
8
 they can adjust their power consumption, and it provides the inhibit interface which allows applications to prevent automatic sleep actions via the power manager; 
9
9
 as an example, the operating system&#8217;s package manager should make use of this interface while it is performing update operations.
10
10
  
11
 
  <div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-started"></a>Getting Started</h3></div></div></div><p>If your distribution doesn't come with a default installation of <strong class="application"><code>xfce4-power-manager</code></strong> usually when you install it, it will be started next time you log into your Xfce desktop.
 
11
  <div class="sect2" title="Getting Started"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-started"></a>Getting Started</h3></div></div></div><p>If your distribution doesn't come with a default installation of <strong class="application"><code>xfce4-power-manager</code></strong> usually when you install it, it will be started next time you log into your Xfce desktop.
12
12
  In order to start it manually you just need to run  the following command <strong class="application"><code>xfce4-power-manager</code></strong> from your terminal emulator. Please note that running this <strong class="application"><code>xfce4-power-manager</code></strong> command 
13
13
  will cause the power manager to run in daemon mode. You can optionally add --no-daemon as a command line argument to disable this behaviour, 
14
14
  This can be useful if you want to see debugging outputs from your terminal emulator.
15
 
  </p></div></div><p>�</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm"></a>Power Manager</h2></div></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-command-line"></a>Command line options</h3></div></div></div><div class="variablelist"><p class="title"><b></b></p><dl><dt><span class="term"><span class="keycap"><strong>--no-daemon</strong></span></span></dt><dd><p>
 
15
  </p></div></div><p>�</p><div class="sect1" title="Power Manager"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm"></a>Power Manager</h2></div></div></div><div class="sect2" title="Command line options"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-command-line"></a>Command line options</h3></div></div></div><div class="variablelist"><p class="title"><b></b></p><dl><dt><span class="term"><span class="keycap"><strong>--no-daemon</strong></span></span></dt><dd><p>
16
16
        Starts the power manager in non-daemon mode: useful for debugging.
17
17
        </p></dd><dt><span class="term"><span class="keycap"><strong>--restart</strong></span></span></dt><dd><p>
18
18
        Restarts the power manager.
19
19
        </p></dd><dt><span class="term"><span class="keycap"><strong>--quit</strong></span></span></dt><dd><p>
20
20
        Causes any running instance of the power manager to exit.
21
 
        </p></dd></dl></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-menu"></a>Context menu</h3></div></div></div><div class="figure"><a name="id2615335"></a><p class="title"><b>Figure�1.�Context menu</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/xfpm-context-menu.png" alt="Context menu"></div></div></div></div><p><br class="figure-break"></p><p>
 
21
        </p></dd></dl></div></div><div class="sect2" title="Context menu"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-menu"></a>Context menu</h3></div></div></div><div class="figure"><a name="idp3739792"></a><p class="title"><b>Figure�1.�Context menu</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/xfpm-context-menu.png" alt="Context menu"></div></div></div></div><p><br class="figure-break"></p><p>
22
22
The context menu pops up when you click on the icon placed in your notification area for example a battery or an adapter icon. It contains some useful options like suspend/hibernate,
23
23
display information of the battery device and open the settings dialog. It contains as well option to inhibit the power manager. If enabled, the power manager will not attempt
24
24
to dim the screen or switch off the monitor.
25
25
 
26
 
</p><div class="note" style="text-align: left;"><h3 class="title">Note</h3><p>If the inhibit option is selected and the computer is in idle for a long time the power manager will not put the system in suspend or hibernate, even
 
26
</p><div class="note" title="Note" style="text-align: left;"><h3 class="title">Note</h3><p>If the inhibit option is selected and the computer is in idle for a long time the power manager will not put the system in suspend or hibernate, even
27
27
if it is enabled in the settings dialog. Only critical actions are processed.</p></div><p>
28
28
 
29
 
</p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-configuration"></a>Power Manager Configuration</h2></div></div></div><p>
 
29
</p></div></div><div class="sect1" title="Power Manager Configuration"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-configuration"></a>Power Manager Configuration</h2></div></div></div><p>
30
30
  In this section we will explain in details the possible configuration of the power manager running on laptop computer. Please note that the configurations are different when 
31
31
  the power manager is running on a desktop computer, for example you will not have LCD brightness etc.
32
 
  </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-general"></a>General options</h3></div></div></div><div class="figure"><a name="id2620267"></a><p class="title"><b>Figure�2.�General settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/xfpm-general-settings.png" alt="General settings"></div></div></div></div><p><br class="figure-break"></p><p>
 
32
  </p><div class="sect2" title="General options"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-general"></a>General options</h3></div></div></div><div class="figure"><a name="idp3748112"></a><p class="title"><b>Figure�2.�General settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/xfpm-general-settings.png" alt="General settings"></div></div></div></div><p><br class="figure-break"></p><p>
33
33
 
34
34
</p><div class="variablelist"><p class="title"><b></b></p><dl><dt><span class="term"><span class="keycap"><strong>Notification area:</strong></span></span></dt><dd><p>The notification area settings allow you to control the behaviour of the icon placed in your notification area. You can set it to be always visible. For battery devices,
35
35
        you can select the icon to be visible only when your are running on battery for example.</p></dd><dt><span class="term"><span class="keycap"><strong>Keyboard special keys:</strong></span></span></dt><dd><p>
39
39
        </p></dd><dt><span class="term"><span class="keycap"><strong>Monitor power management control:</strong></span></span></dt><dd><p>Enable/Disable the Display Power Management Signaling (DPMS).</p></dd><dt><span class="term"><span class="keycap"><strong>Power manager Notification:</strong></span></span></dt><dd><p>If the notification of a battery status change are annoying you, you can always disable them by unselecting the checkbox. Please note this
40
40
        doesn't apply on the notification that the power manager sends notifying the user of errors or that the system is running out of power.
41
41
         </p></dd></dl></div><p>
42
 
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-on-ac"></a>Running on  AC power</h3></div></div></div><p>
 
42
</p></div><div class="sect2" title="Running on AC power"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-on-ac"></a>Running on  AC power</h3></div></div></div><p>
43
43
  The on AC power tab contains self explanatory options such as lid close, system idle and monitor sleep configurations.   
44
 
  </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-on-battery"></a>Running on battery power</h3></div></div></div><p>
 
44
  </p></div><div class="sect2" title="Running on battery power"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-on-battery"></a>Running on battery power</h3></div></div></div><p>
45
45
The on battery tab is only shown on systems that have battery devices. It contains the same options as the AC power tabs plus two other important options:
46
46
 
47
47
</p><div class="variablelist"><p class="title"><b></b></p><dl><dt><span class="term"><span class="keycap"><strong>Power is critical</strong></span></span></dt><dd><p>
51
51
        This is the power profile when running on battery. With this option your battery will last more when running on battery power.
52
52
        Enabling this option is always a good idea.
53
53
        </p></dd></dl></div><p>
54
 
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-extended"></a>Extended options</h3></div></div></div><div class="figure"><a name="id2615631"></a><p class="title"><b>Figure�3.�Extended settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/xfpm-extended-settings.png" alt="Extended settings"></div></div></div></div><p><br class="figure-break"></p><p>
 
54
</p></div><div class="sect2" title="Extended options"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-extended"></a>Extended options</h3></div></div></div><div class="figure"><a name="idp87184"></a><p class="title"><b>Figure�3.�Extended settings</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/xfpm-extended-settings.png" alt="Extended settings"></div></div></div></div><p><br class="figure-break"></p><p>
55
55
</p><div class="variablelist"><p class="title"><b></b></p><dl><dt><span class="term"><span class="keycap"><strong>Inactivity sleep mode:</strong></span></span></dt><dd><p>You can select the inactivity sleep action to be taken by the power manger when the system is idle for a interval of  time set by you
56
56
        either on ac power or on battery power. Of course if you disable idle timeout those settings will have no effects.</p></dd><dt><span class="term"><span class="keycap"><strong>Monitor sleep mode:</strong></span></span></dt><dd><p>
57
57
        DPMS sleep modes before switching off the monitor are either standby or suspend. They are technically different and provided for convenience.
58
58
        </p></dd><dt><span class="term"><span class="keycap"><strong>Computer on low power level:</strong></span></span></dt><dd><p>
59
59
        Ideally when the battery giving the main power to the computer reaches 10 percent of charge, the computer can be considered on low power. However, for some broken or old
60
60
        batteries the interval of time between 10 percent and a power cut is a matter of minutes if not seconds. You can adjust the level at which your computer will be considered on low power.
61
 
        </p><div class="note" style="text-align: left;"><h3 class="title">Note</h3><p>This option might disappear in future releases.</p></div><p>
 
61
        </p><div class="note" title="Note" style="text-align: left;"><h3 class="title">Note</h3><p>This option might disappear in future releases.</p></div><p>
62
62
 
63
63
        </p></dd><dt><span class="term"><span class="keycap"><strong>CPU Frequency control:</strong></span></span></dt><dd><p>
64
64
        Unselecting this checkbox, the power manager don't attempt to play with the CPU frequency.
66
66
        Just tell your power manager if it should lock the screen before suspending or hibernating the computer. It is enabled by default.
67
67
        </p></dd></dl></div><p>
68
68
        
69
 
</p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-hidden-options"></a>Hidden options</h3></div></div></div><p>
 
69
</p></div><div class="sect2" title="Hidden options"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-hidden-options"></a>Hidden options</h3></div></div></div><p>
70
70
Hidden options are the options that in normal situations one should not be changed, but these options are provided in case of misbehaviour of the backend
71
71
that the power manager is relying on.
72
72
</p><p>
84
84
         
85
85
        </p><pre class="programlisting">xfconf-query -c <strong class="application"><code>xfce4-power-manager</code></strong> -n -p "/<strong class="application"><code>xfce4-power-manager</code></strong>/show-brightness-popup" -t bool -s false</pre><p>
86
86
         
87
 
        </p></dd></dl></div></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-plugins"></a> Panel plugins </h2></div></div></div><div class="figure"><a name="id2619839"></a><p class="title"><b>Figure�4.�Brightness plugin</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/xfpm-brightness-plugin.png" alt="Brightness plugin"></div></div></div></div><p><br class="figure-break"></p><p>
88
 
<strong class="application"><code>xfce4-power-manager</code></strong> version 0.8.3.1 includes one panel plugin for LCD brightness control (possible other plugins might be added for future releases). The usage of the brightness plugin
 
87
        </p></dd></dl></div></div></div><div class="sect1" title="Panel plugins"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-plugins"></a> Panel plugins </h2></div></div></div><div class="figure"><a name="idp4780464"></a><p class="title"><b>Figure�4.�Brightness plugin</b></p><div class="figure-contents"><div class="screenshot"><div class="mediaobject"><img src="images/xfpm-brightness-plugin.png" alt="Brightness plugin"></div></div></div></div><p><br class="figure-break"></p><p>
 
88
<strong class="application"><code>xfce4-power-manager</code></strong> version 1.0.11 includes one panel plugin for LCD brightness control (possible other plugins might be added for future releases). The usage of the brightness plugin
89
89
is simple; just add the plugin to the panel same way  as the one used to add any other plugin; then click on the plugin; a slider will pop up that you move/scroll on it to change
90
90
the brightness level of your screen. Of course the plugin will not work on a system with no back light panel. 
91
 
</p></div><p>�</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-faq"></a>FAQ</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">Q: Why the icons look very similar to the icon of gnome power manager?</span></dt><dd><p>A: No, they are not similar; they are the same. Just there is no point of re-drawing icons.
 
91
</p></div><p>�</p><div class="sect1" title="FAQ"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-faq"></a>FAQ</h2></div></div></div><div class="variablelist"><dl><dt><span class="term">Q: Why the icons look very similar to the icon of gnome power manager?</span></dt><dd><p>A: No, they are not similar; they are the same. Just there is no point of re-drawing icons.
92
92
        gnome power manager icons are good enough. Not all the gnome power manager icons are used. Please note that 
93
 
        for version 0.8.3.1 the icons are renamed to avoid possible conflicts with a gnome power manager installation.   
 
93
        for version 1.0.11 the icons are renamed to avoid possible conflicts with a gnome power manager installation.   
94
94
        </p></dd><dt><span class="term">Q: What is the difference between suspend and hibernate?</span></dt><dd><p>A: Suspend is a power save feature. When suspending, the computer is still using power,
95
95
        since the running applications are kept in the memory, but it is the lowest power level that the computer
96
96
        can use. While Hibernate saves the system state on the hard drive and turns off the power, when you start up your 
104
104
        command:  
105
105
        </p><pre class="programlisting">lshal &gt; output.txt</pre><p>
106
106
        then search in output.txt for "laptop_panel", if you don't find this key this means a driver problem, but in the other hand if you find it then come to us complaining.
107
 
        </p></dd></dl></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-technical"></a>
 
107
        </p></dd></dl></div></div><div class="sect1" title="Technical information"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-technical"></a>
108
108
 Technical information
109
109
 </h2></div></div></div><p>
110
110
Ideally these details should go in a technical guide not the user guide, but we need someplace to keep this information, please
111
111
 ignore if these is not what you are looking for.
112
 
</p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-dbus"></a>DBus interfaces</h3></div></div></div><p>
 
112
</p><div class="sect2" title="DBus interfaces"><div class="titlepage"><div><div><h3 class="title"><a name="xfpm-dbus"></a>DBus interfaces</h3></div></div></div><p>
113
113
 in this section the DBus interfaces provided by <strong class="application"><code>xfce4-power-manager</code></strong> are expanded, those interfaces listed here are freedesktop compliant power
114
114
 management interfaces. This section might be useful if you are developing an application and wishing to use these interfaces, or they
115
115
 can be useful for debugging purpose.
116
116
 
117
117
 </p><span class="keycap"><strong>Power management DBus interface.</strong></span><p>
118
118
 
119
 
</p><div class="table"><a name="id2620060"></a><p class="title"><b>Table�1.�Standard methods (org.freedesktop.PowerManagement):</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Standard methods (org.freedesktop.PowerManagement):" border="1"><colgroup><col xmlns="" align="left"><col xmlns="" align="left"><col xmlns="" align="left"><col xmlns=""><col xmlns="" align="left"></colgroup><thead xmlns=""><tr><th colspan="2" align="center">Name</th><th align="left">Input parameter</th><th align="left">Return Values</th><th align="left">Errors</th><th align="left">Description</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">CanHibernate</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is able to hibernate</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">CanSuspend</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is able to suspend</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">CanReboot</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is able to reboot</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">CanShutdown</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is able to shutdown</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">GetOnBattery</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is running on battery</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">GetLowBattery</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is running on low battery</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">GetPowerSaveStatus</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is running in power save mode.</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Hibernate</th><th align="left">�</th><th align="left">�</th><th align="left">PermissionDenied, NoHardwareSupport</th><th align="left">�</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Suspend</th><th align="left">�</th><th align="left">�</th><th align="left">PermissionDenied, NoHardwareSupport</th><th align="left">�</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Reboot</th><th align="left">�</th><th align="left">�</th><th align="left">PermissionDenied, NoHardwareSupport</th><th align="left">�</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Shutdown</th><th align="left">�</th><th align="left">�</th><th align="left">PermissionDenied, NoHardwareSupport</th><th align="left">�</th></tr></thead></table></div></div><p><br class="table-break">
120
 
 
121
 
 
122
 
    </p><div class="table"><a name="id2663544"></a><p class="title"><b>Table�2.�Standard signals (org.freedesktop.PowerManagement):</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Standard signals (org.freedesktop.PowerManagement):" border="1"><colgroup><col xmlns="" align="left"><col xmlns="" align="left"><col xmlns="" align="left"></colgroup><thead xmlns=""><tr><th colspan="2" align="center">Name</th><th align="left">Values</th><th align="left">Description</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">OnBatteryChanged</th><th align="left">bool</th><th align="left">whether on battery status changed</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">LowBatteryChanged</th><th align="left">bool</th><th align="left">whether on low battery status changed</th></tr></thead></table></div></div><p><br class="table-break">
 
119
</p><div class="table"><a name="idp4802528"></a><p class="title"><b>Table�1.�Standard methods (org.freedesktop.PowerManagement):</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Standard methods (org.freedesktop.PowerManagement):" border="1"><colgroup><col xmlns="" align="left" class="c1"><col xmlns="" align="left" class="c2"><col xmlns="" align="left" class="c3"><col xmlns=""><col xmlns="" align="left" class="c5"></colgroup><thead xmlns=""><tr><th colspan="2" align="center">Name</th><th align="left">Input parameter</th><th align="left">Return Values</th><th align="left">Errors</th><th align="left">Description</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">CanHibernate</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is able to hibernate</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">CanSuspend</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is able to suspend</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">CanReboot</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is able to reboot</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">CanShutdown</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is able to shutdown</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">GetOnBattery</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is running on battery</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">GetLowBattery</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is running on low battery</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">GetPowerSaveStatus</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">whether the system is running in power save mode.</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Hibernate</th><th align="left">�</th><th align="left">�</th><th align="left">PermissionDenied, NoHardwareSupport</th><th align="left">�</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Suspend</th><th align="left">�</th><th align="left">�</th><th align="left">PermissionDenied, NoHardwareSupport</th><th align="left">�</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Reboot</th><th align="left">�</th><th align="left">�</th><th align="left">PermissionDenied, NoHardwareSupport</th><th align="left">�</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Shutdown</th><th align="left">�</th><th align="left">�</th><th align="left">PermissionDenied, NoHardwareSupport</th><th align="left">�</th></tr></thead></table></div></div><p><br class="table-break">
 
120
 
 
121
 
 
122
    </p><div class="table"><a name="idp4844800"></a><p class="title"><b>Table�2.�Standard signals (org.freedesktop.PowerManagement):</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Standard signals (org.freedesktop.PowerManagement):" border="1"><colgroup><col xmlns="" align="left" class="c1"><col xmlns="" align="left" class="c2"><col xmlns="" align="left" class="c3"></colgroup><thead xmlns=""><tr><th colspan="2" align="center">Name</th><th align="left">Values</th><th align="left">Description</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">OnBatteryChanged</th><th align="left">bool</th><th align="left">whether on battery status changed</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">LowBatteryChanged</th><th align="left">bool</th><th align="left">whether on low battery status changed</th></tr></thead></table></div></div><p><br class="table-break">
123
123
 
124
124
</p><span class="keycap"><strong>Power management DBus inhibit interface.</strong></span><p>
125
125
 
126
 
</p><div class="table"><a name="id2663653"></a><p class="title"><b>Table�3.�Standard methods (org.freedesktop.PowerManagement.Inhibit):</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Standard methods (org.freedesktop.PowerManagement.Inhibit):" border="1"><colgroup><col xmlns="" align="left"><col xmlns="" align="left"><col xmlns="" align="left"><col xmlns=""><col xmlns="" align="left"></colgroup><thead xmlns=""><tr><th colspan="2" align="center">Name</th><th align="left">Input parameter</th><th align="left">Return Values</th><th align="left">Errors</th><th align="left">Description</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Inhibit</th><th align="left">string application name, string reason</th><th align="left">uint32 (random cookie)</th><th align="left">�</th><th align="left">Inhibit the power manager.</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">UnInhibit</th><th align="left">uint32 cookie</th><th align="left">�</th><th align="left">InvalidCookie</th><th align="left">Unihibit the power manager.</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">HasInhibit</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">Whether the power manager is currently inhibited or not.</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">GetInhibitors</th><th align="left">�</th><th align="left">Array of strings</th><th align="left">�</th><th align="left">List all the applications currently inhibiting the power manager (Not standard, use just for debugging)</th></tr></thead></table></div></div><p><br class="table-break">
127
 
 
128
 
 
129
 
    </p><div class="table"><a name="id2663833"></a><p class="title"><b>Table�4.�Standard signals (org.freedesktop.PowerManagement.Inhibit):</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Standard signals (org.freedesktop.PowerManagement.Inhibit):" border="1"><colgroup><col xmlns="" align="left"><col xmlns="" align="left"><col xmlns="" align="left"></colgroup><thead xmlns=""><tr><th colspan="2" align="center">Name</th><th align="left">Values</th><th align="left">Description</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">HasInhibitChanged</th><th align="left">bool</th><th align="left">whether the inhibit status changed.</th></tr></thead></table></div></div><p><br class="table-break">
 
126
</p><div class="table"><a name="idp4857440"></a><p class="title"><b>Table�3.�Standard methods (org.freedesktop.PowerManagement.Inhibit):</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Standard methods (org.freedesktop.PowerManagement.Inhibit):" border="1"><colgroup><col xmlns="" align="left" class="c1"><col xmlns="" align="left" class="c2"><col xmlns="" align="left" class="c3"><col xmlns=""><col xmlns="" align="left" class="c5"></colgroup><thead xmlns=""><tr><th colspan="2" align="center">Name</th><th align="left">Input parameter</th><th align="left">Return Values</th><th align="left">Errors</th><th align="left">Description</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">Inhibit</th><th align="left">string application name, string reason</th><th align="left">uint32 (random cookie)</th><th align="left">�</th><th align="left">Inhibit the power manager.</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">UnInhibit</th><th align="left">uint32 cookie</th><th align="left">�</th><th align="left">InvalidCookie</th><th align="left">Unihibit the power manager.</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">HasInhibit</th><th align="left">�</th><th align="left">bool</th><th align="left">�</th><th align="left">Whether the power manager is currently inhibited or not.</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">GetInhibitors</th><th align="left">�</th><th align="left">Array of strings</th><th align="left">�</th><th align="left">List all the applications currently inhibiting the power manager (Not standard, use just for debugging)</th></tr></thead></table></div></div><p><br class="table-break">
 
127
 
 
128
 
 
129
    </p><div class="table"><a name="idp4878528"></a><p class="title"><b>Table�4.�Standard signals (org.freedesktop.PowerManagement.Inhibit):</b></p><div class="table-contents"><table xmlns="http://www.w3.org/TR/xhtml1/transitional" bgcolor="#F8F9FD" cellspacing="0" cellpadding="4" summary="Standard signals (org.freedesktop.PowerManagement.Inhibit):" border="1"><colgroup><col xmlns="" align="left" class="c1"><col xmlns="" align="left" class="c2"><col xmlns="" align="left" class="c3"></colgroup><thead xmlns=""><tr><th colspan="2" align="center">Name</th><th align="left">Values</th><th align="left">Description</th></tr></thead><thead xmlns=""><tr><th colspan="2" align="center">HasInhibitChanged</th><th align="left">bool</th><th align="left">whether the inhibit status changed.</th></tr></thead></table></div></div><p><br class="table-break">
130
130
 
131
131
</p><p>
132
132
In addition, <strong class="application"><code>xfce4-power-manager</code></strong> has other interfaces, but those interfaces are mainly used internally, for example the settings application uses such interface to
133
133
get information about the current status of the running instance of the power manager.
134
 
</p></div></div><p>�</p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-about"></a>About <strong class="application"><code>xfce4-power-manager</code></strong></h2></div></div></div><p>
 
134
</p></div></div><p>�</p><div class="sect1" title="About xfce4-power-manager"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="xfpm-about"></a>About <strong class="application"><code>xfce4-power-manager</code></strong></h2></div></div></div><p>
135
135
        This power manager was written following the philosophy of Xfce, having light weight application that does
136
136
        what the user is expecting from it.
137
137
        </p><p>To report a bug or make a suggestion regarding this application or