lxc-wait.sgml.in revision 7f95145833bb24f54e037f73ecc37444d6635697
7bde6e1907fc17b0083a6bcfad10bb74be6e4bcdTim Reddehaselxc: linux Container library
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning mueller(C) Copyright IBM Corp. 2007, 2008
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning muellerThis library is free software; you can redistribute it and/or
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning muellermodify it under the terms of the GNU Lesser General Public
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning muellerLicense as published by the Free Software Foundation; either
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning muellerversion 2.1 of the License, or (at your option) any later version.
2e7a48951591a6eeda9a3ab4e14cd13012cb43eaJulian KornbergerThis library is distributed in the hope that it will be useful,
2e7a48951591a6eeda9a3ab4e14cd13012cb43eaJulian Kornbergerbut WITHOUT ANY WARRANTY; without even the implied warranty of
2e7a48951591a6eeda9a3ab4e14cd13012cb43eaJulian KornbergerMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
435547b6b5df0f76cd04b09532341b07d0defeb1Tim ReddehaseLesser General Public License for more details.
2e7a48951591a6eeda9a3ab4e14cd13012cb43eaJulian KornbergerYou should have received a copy of the GNU Lesser General Public
2e7a48951591a6eeda9a3ab4e14cd13012cb43eaJulian KornbergerLicense along with this library; if not, write to the Free Software
40c5626383ebd5e8cf11a636f864023a2aafcd6bDaniel Couto ValeFoundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
2e7a48951591a6eeda9a3ab4e14cd13012cb43eaJulian Kornberger<!DOCTYPE refentry PUBLIC @docdtd@ [
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning mueller<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
a837d007b255d7a6cca7994e1e555aba95ce41cchenning mueller<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
435547b6b5df0f76cd04b09532341b07d0defeb1Tim Reddehase <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
435547b6b5df0f76cd04b09532341b07d0defeb1Tim Reddehase <refentrytitle>lxc-wait</refentrytitle>
435547b6b5df0f76cd04b09532341b07d0defeb1Tim Reddehase <manvolnum>1</manvolnum>
435547b6b5df0f76cd04b09532341b07d0defeb1Tim Reddehase <refname>lxc-wait</refname>
083f87068ffcf24df8b0154bfbca4ca5027f8ecehenning mueller wait for a specific container state
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning mueller </refpurpose>
40c5626383ebd5e8cf11a636f864023a2aafcd6bDaniel Couto Vale <refsynopsisdiv>
d1860f0434d6460259d04f8952e55df38fe517f7Tim Reddehase <cmdsynopsis>
40c5626383ebd5e8cf11a636f864023a2aafcd6bDaniel Couto Vale <command>lxc-wait</command>
d1860f0434d6460259d04f8952e55df38fe517f7Tim Reddehase <arg choice="req">-n <replaceable>name</replaceable></arg>
40c5626383ebd5e8cf11a636f864023a2aafcd6bDaniel Couto Vale <arg choice="req">-s <replaceable>states</replaceable></arg>
d1860f0434d6460259d04f8952e55df38fe517f7Tim Reddehase </cmdsynopsis>
d1860f0434d6460259d04f8952e55df38fe517f7Tim Reddehase </refsynopsisdiv>
40c5626383ebd5e8cf11a636f864023a2aafcd6bDaniel Couto Vale <title>Description</title>
d1860f0434d6460259d04f8952e55df38fe517f7Tim Reddehase <command>lxc-wait</command> waits for a specific container state
75c2a995e5c564f96cf5559145e59f89d6435ee1Tim Reddehase before exiting, this is useful for scripting.
71fdc30cc6e637d99cacb455537e7b8fbfe77395henning mueller <title>Options</title>
40c5626383ebd5e8cf11a636f864023a2aafcd6bDaniel Couto Vale <variablelist>
40c5626383ebd5e8cf11a636f864023a2aafcd6bDaniel Couto Vale <varlistentry>
a837d007b255d7a6cca7994e1e555aba95ce41cchenning mueller <option>-s <replaceable>states</replaceable></option>
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning mueller Specify the container state(s) to wait for. The container
75c2a995e5c564f96cf5559145e59f89d6435ee1Tim Reddehase states can be ORed to specify several states.
75c2a995e5c564f96cf5559145e59f89d6435ee1Tim Reddehase </varlistentry>
75c2a995e5c564f96cf5559145e59f89d6435ee1Tim Reddehase <varlistentry>
75c2a995e5c564f96cf5559145e59f89d6435ee1Tim Reddehase <option>-t <replaceable>timeout</replaceable></option>
75c2a995e5c564f96cf5559145e59f89d6435ee1Tim Reddehase Wait timeout seconds for desired state to be reached.
75c2a995e5c564f96cf5559145e59f89d6435ee1Tim Reddehase </varlistentry>
75c2a995e5c564f96cf5559145e59f89d6435ee1Tim Reddehase </variablelist>
435547b6b5df0f76cd04b09532341b07d0defeb1Tim Reddehase &commonoptions;
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning mueller <title>Examples</title>
519002bc41b20a069be1c669660e702f9bd4a593Eugen Kuksa <variablelist>
705933deb08bc4269e8c08d50143af3cb5c1c670henning mueller <varlistentry>
a274d776b3371051dcdd74b598182ce113ca5135Julian Kornberger <term>lxc-wait -n foo -s RUNNING</term>
ac2169141f0b549fc8917a4b1d778f4ba3cab0bfJulian Kornberger exits when 'RUNNING' is reached.
ac2169141f0b549fc8917a4b1d778f4ba3cab0bfJulian Kornberger </varlistentry>
519002bc41b20a069be1c669660e702f9bd4a593Eugen Kuksa <varlistentry>
519002bc41b20a069be1c669660e702f9bd4a593Eugen Kuksa <term>lxc-wait -n foo -s 'RUNNING|STOPPED'</term>
aa056a2e5efb6505701a4e4a31bf2f7e71ff1738henning mueller exits when 'RUNNING' or 'STOPPED' state is reached.
a274d776b3371051dcdd74b598182ce113ca5135Julian Kornberger </varlistentry>
705933deb08bc4269e8c08d50143af3cb5c1c670henning mueller </variablelist>
2e7a48951591a6eeda9a3ab4e14cd13012cb43eaJulian Kornberger <title>Diagnostic</title>
a274d776b3371051dcdd74b598182ce113ca5135Julian Kornberger <variablelist>
ee5342a8882c2fc7631fcffb5497e6597747887cTim Reddehase <varlistentry>
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehase <term>The container was not found</term>
a274d776b3371051dcdd74b598182ce113ca5135Julian Kornberger The specified container was not created before with
a274d776b3371051dcdd74b598182ce113ca5135Julian Kornberger the <command>lxc-create</command> command.
7ea9649883e1bbe8f2582db1a3c66af8b7206056henning mueller </varlistentry>
b5bf21df9d1d61069e6dc9e13569543d0b868bc8Daniel Couto Vale </variablelist>
ec416eab0158cfe34b77cea4a11f8b84bc194a7aDaniel Couto Vale <title>Author</title>
ec416eab0158cfe34b77cea4a11f8b84bc194a7aDaniel Couto Vale <para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehase<!-- Keep this comment at the end of the file
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim ReddehaseLocal variables:
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-omittag:t
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-shorttag:t
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-minimize-attributes:nil
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-always-quote-attributes:t
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-indent-step:2
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-indent-data:t
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-parent-document:nil
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-default-dtd-file:nil
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-exposed-tags:nil
6116d75120b5db0bcbc4a11abed8d0254ec85b8eTim Reddehasesgml-local-catalogs:nil
58721b9d3a8cd6a624269ddf507f80af4417c9bdhenning muellersgml-local-ecat-files:nil