HALF ECHO LEARN / REFERENCE COLLECTION

v262.2

man/systemd-ac-power.xml

2,740 bytesGit mode 100644Download original fileLGPL-2.1-or-later

Git blob: ca4aa4d768d8ac01878c4ec1a72ebd6b5bb45d94

Lines 1–84 of 84

<?xml version='1.0'?> <!--*-nxml-*-->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
  "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
<!-- SPDX-License-Identifier: LGPL-2.1-or-later -->
 
<refentry id="systemd-ac-power" xmlns:xi="http://www.w3.org/2001/XInclude">
 
  <refentryinfo>
    <title>systemd-ac-power</title>
    <productname>systemd</productname>
  </refentryinfo>
 
  <refmeta>
    <refentrytitle>systemd-ac-power</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>
 
  <refnamediv>
    <refname>systemd-ac-power</refname>
    <refpurpose>Report whether we are connected to an external power source</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>systemd-ac-power</command>
      <arg choice="opt" rep="repeat">OPTIONS</arg>
    </cmdsynopsis>
  </refsynopsisdiv>
 
  <refsect1>
    <title>Description</title>
 
    <para><command>systemd-ac-power</command> may be used to check whether the system
    is running on AC power or not. By default, it will simply return success (if we
    can detect that we are running on AC power) or failure, with no output.
    This can be useful for example to debug <varname>ConditionACPower=</varname> (see
    <citerefentry><refentrytitle>systemd.unit</refentrytitle><manvolnum>5</manvolnum></citerefentry>).</para>
  </refsect1>
 
  <refsect1>
    <title>Options</title>
 
    <para>The following options are understood:</para>
 
    <variablelist>
      <varlistentry>
        <term><option>-v</option></term>
        <term><option>--verbose</option></term>
 
        <listitem><para>Show result as text instead of just returning success or failure.</para>
 
        <xi:include href="version-info.xml" xpointer="v253"/></listitem>
      </varlistentry>
 
      <varlistentry>
        <term><option>--low</option></term>
 
        <listitem><para>Instead of showing AC power state, show low battery state. In this case, will return
        zero if all batteries are currently discharging and below 5% of maximum charge. Returns non-zero
        otherwise.</para>
 
        <xi:include href="version-info.xml" xpointer="v254"/></listitem>
      </varlistentry>
 
      <xi:include href="standard-options.xml" xpointer="help" />
      <xi:include href="standard-options.xml" xpointer="version" />
    </variablelist>
  </refsect1>
 
  <refsect1>
    <title>Exit status</title>
 
    <para>On success (running on AC power), 0 is returned, a non-zero failure code otherwise.</para>
  </refsect1>
 
  <refsect1>
    <title>See Also</title>
    <para><simplelist type="inline">
      <member><citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry></member>
    </simplelist></para>
  </refsect1>
 
</refentry>