summaryrefslogtreecommitdiff
path: root/man/on_ac_power.xml
blob: d798f45e0b63bf81ba9fa074ad12bd1703c2dcb0 (plain)
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
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [

  <!ENTITY date        "<date>05 June, 2006</date>">
  <!ENTITY package     "on_ac_power">
  <!ENTITY gnu         "<acronym>GNU</acronym>">
  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
]>

<refentry>
  <refentryinfo>
    <address>
      <email>richard@hughsie.com</email>;
    </address>
    <author>
      <firstname>Richard</firstname>
      <surname>Hughes</surname>
    </author>
    <copyright>
      <year>2006</year>
      <holder>Richard Hughes</holder>
    </copyright>
    &date;
  </refentryinfo>
  <refmeta>
    <refentrytitle>&package;</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>
  <refnamediv>
    <refname>&package;</refname>
    <refpurpose>test whether the computer is running on line power</refpurpose>
  </refnamediv>
  <refsynopsisdiv>
    <cmdsynopsis>
      <command>&package;</command>
    </cmdsynopsis>
  </refsynopsisdiv>
  <refsect1>
    <title>DESCRIPTION</title>
    <para>This manual page documents briefly the
      <command>&package;</command> command.</para>
    <para><command>&package;</command> is a command line program to test whether the computer is running on line power</para>
  </refsect1>
  <refsect1>
    <title>EXIT CODES</title>
    <para>
      The command succeeds (status 0) if the system is using line power
      and fails (status other than 0) otherwise.
      It is designed to be easy to use in shell scripts.
    </para>
    <variablelist>
      <varlistentry>
        <term>
          <option>0 (true)</option>
        </term>
        <listitem>
          <para>System is on line power.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <option>1 (false)</option>
        </term>
        <listitem>
          <para>System is not on line power.</para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>
  <refsect1>
    <title>SEE ALSO</title>
    <para>
      <citerefentry>
        <refentrytitle>pm-suspend</refentrytitle>
        <manvolnum>8</manvolnum>
      </citerefentry>
    </para>
  </refsect1>
  <refsect1>
    <title>AUTHOR</title>
    <para>This manual page was written by Richard Hughes <email>richard@hughsie.com</email>.
    </para>
  </refsect1>
</refentry>