upower/doc/man/upower.xml
Benjamin Berg 9058d45685 Remove Wakeups API
The API relied on /proc/timer_stats which has been removed from the
kernel in 2017. Since then, the API has been non-functional (yet
incorrectly reporting support because the support test was buggy).

Just remove it completely. The debian codesearch does not uncover any
API users. Also, I doubt that any new API (based on tracing scheduler
events as perf would do) would map well to what exists now. i.e. if
something like this is re-implemented in UPower or elsewhere, then the
API should likely look different.

And, realistically, if this does need root privileges (i.e. can't be
moved to use BPF programs or so on user units), then we can also create
a new small daemon that is launched on-demand just for that.
2022-03-24 17:02:27 +01:00

102 lines
2.8 KiB
XML

<refentry id="upower.1">
<refentryinfo>
<title>upower</title>
<date>April 2008</date>
<productname>upower</productname>
</refentryinfo>
<refmeta>
<refentrytitle>upower</refentrytitle>
<manvolnum>1</manvolnum>
<refmiscinfo class="version"></refmiscinfo>
</refmeta>
<refnamediv>
<refname>upower</refname>
<refpurpose>UPower command line tool</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>upower</command>
<arg><option>--dump</option></arg>
<arg><option>--enumerate</option></arg>
<arg><option>--monitor-detail</option></arg>
<arg><option>--monitor</option></arg>
<arg><option>--show-info</option></arg>
<arg><option>--version</option></arg>
<arg><option>--help</option></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1><title>DESCRIPTION</title>
<para>
<emphasis><refentrytitle>upower</refentrytitle></emphasis> is a
simple command line client for the
<citerefentry><refentrytitle>UPower</refentrytitle><manvolnum>7</manvolnum></citerefentry>
daemon. TODO: not fully documented.
</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<variablelist>
<varlistentry>
<term><option>--monitor</option></term>
<listitem>
<para>
Connect to the UPower daemon and print a line
every time a power source is added, removed or changed.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--monitor-detail</option></term>
<listitem>
<para>
Like <option>--monitor</option> but prints the full
details of the power source whenever an event happens.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--help</option></term>
<listitem>
<para>
Show help options.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1><title>AUTHOR</title>
<para>
Written by David Zeuthen <email>davidz@redhat.com</email> with
a lot of help from many others.
</para>
</refsect1>
<refsect1>
<title>BUGS</title>
<para>
Please send bug reports to either the distribution or the
DeviceKit mailing list,
see <ulink url="http://lists.freedesktop.org/mailman/listinfo/devkit-devel"/>
on how to subscribe.
</para>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>
<citerefentry>
<refentrytitle>upowerd</refentrytitle><manvolnum>8</manvolnum>
</citerefentry>,
<citerefentry>
<refentrytitle>UPower</refentrytitle><manvolnum>7</manvolnum>
</citerefentry>,
</para>
</refsect1>
</refentry>