lxc-monitor.sgml.in revision d823d5b966f49d975a09a8512d084389d6d7ffc7
222N/A<!--
98N/A
98N/Alxc: linux Container library
98N/A
98N/A(C) Copyright IBM Corp. 2007, 2008
98N/A
98N/AAuthors:
98N/ADaniel Lezcano <dlezcano at fr.ibm.com>
98N/A
98N/AThis library is free software; you can redistribute it and/or
98N/Amodify it under the terms of the GNU Lesser General Public
98N/ALicense as published by the Free Software Foundation; either
98N/Aversion 2.1 of the License, or (at your option) any later version.
98N/A
98N/AThis library is distributed in the hope that it will be useful,
98N/Abut WITHOUT ANY WARRANTY; without even the implied warranty of
98N/AMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
98N/ALesser General Public License for more details.
98N/A
98N/AYou should have received a copy of the GNU Lesser General Public
98N/ALicense along with this library; if not, write to the Free Software
98N/AFoundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
98N/A
98N/A-->
98N/A
98N/A<!DOCTYPE refentry PUBLIC "-//Davenport//DTD DocBook V3.0//EN">
98N/A
98N/A<refentry>
98N/A
98N/A <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
222N/A
98N/A <refmeta>
98N/A <refentrytitle>lxc-monitor</refentrytitle>
98N/A <manvolnum>1</manvolnum>
222N/A </refmeta>
222N/A
222N/A <refnamediv>
222N/A <refname>lxc-monitor</refname>
98N/A
98N/A <refpurpose>
98N/A monitor the container state
98N/A </refpurpose>
98N/A </refnamediv>
98N/A
98N/A <refsynopsisdiv>
98N/A <cmdsynopsis>
98N/A <command>lxc-monitor <replaceable>-n name</replaceable>
98N/A </command>
98N/A </cmdsynopsis>
98N/A </refsynopsisdiv>
98N/A
98N/A <refsect1>
98N/A <title>Description</title>
98N/A
98N/A <para>
98N/A <command>lxc-monitor</command> monitors the state of the
98N/A specified containers. The <replaceable>name</replaceable> can be
98N/A a regular expression, conforming with posix2, so it is possible
98N/A to monitor all the containers, several of them or just one.
98N/A </para>
98N/A
</refsect1>
<refsect1>
<title>Options</title>
<variablelist>
<varlistentry>
<term>
<option>-n <replaceable>name</replaceable></option>
</term>
<listitem>
<para>
Specify the container name to be monitored. This option
can be a regular expression conforming POSIX2.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>Examples</title>
<variablelist>
<varlistentry>
<term>lxc-monitor -n foo</term>
<listitem>
<para>
will monitor the different states for container foo.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>lxc-monitor -n 'foo|bar'</term>
<listitem>
<para>
will monitor the different states for container foo and bar.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>lxc-monitor -n '[f|b].*'</term>
<listitem>
<para>
will monitor the different states for container with the
name beginning with letter 'f' or 'b'.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>lxc-monitor -n '.*'</term>
<listitem>
<para>
will monitor the different states for all containers.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>Diagnostic</title>
<variablelist>
<varlistentry>
<term>The container was not found</term>
<listitem>
<para>
The specified container was not created before with
the <command>lxc-create</command> command.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>See Also</title>
<simpara>
<citerefentry>
<refentrytitle>regex</refentrytitle>
<manvolnum>7</manvolnum>
</citerefentry>,
</simpara>
</refsect1>
<refsect1>
<title>Author</title>
<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->