lxc-wait(1)

lxc-wait1

Wait for a specific container state

Usage

lxc-wait -n name -s states

Overview

lxc-wait waits for a specific container state before exiting, this is useful for scripting.

Options

FC-s, --state F[0]states

Specify the container state(s) to wait for. The container states can be ORed to specify several states.

FC-t, --timeout F[0]timeout

Wait timeout seconds for desired state to be reached.

Options

These options are common to most of lxc commands.

FC-?, -h, --helpF[0]

Print a longer usage message than normal.

FC--usageF[0]

Give the usage message

FC-q, --quietF[0]

mute on

FC-P, --lxcpath=F[0]PATH

Use an alternate container path. The default is /var/lib/lxc.

FC-o, --logfile=F[0]FILE

Output to an alternate log FILE. The default is no log.

FC-l, --logpriority=F[0]LEVEL

Set log priority to LEVEL. The default log priority is FCERRORF[0]. Possible values are : FCFATALF[0], FCALERTF[0], FCCRITF[0], FCWARNF[0], FCERRORF[0], FCNOTICEF[0], FCINFOF[0], FCDEBUGF[0], FCTRACEF[0].

Note that this option is setting the priority of the events log in the alternate log file. It do not have effect on the ERROR events log on stderr.

FC-n, --name=F[0]NAME

Use container identifier NAME. The container identifier format is an alphanumeric string.

FC--rcfile=F[0]FILE

Specify the configuration file to configure the virtualization and isolation functionalities for the container.

This configuration file if present will be used even if there is already a configuration file present in the previously created container (via lxc-create).

FC--versionF[0]

Show the version number.

Examples

lxc-wait -n foo -s RUNNING

exits when 'RUNNING' is reached.

lxc-wait -n foo -s 'RUNNING|STOPPED'

exits when 'RUNNING' or 'STOPPED' state is reached.

Diagnostic

The container was not found

The specified container was not created before with the lxc-create command.

Releases

9 releases since Debian 6.0 (Squeeze); the text changed 8 times.

  1. 6.0
  2. 7
  3. 8
  4. 9
  5. 10
  6. 11
  7. 12
  8. 13
  9. Arch

--help until Debian 7 (Wheezy); --logfile until Debian 7 (Wheezy); --logpriority until Debian 7 (Wheezy); --name until Debian 7 (Wheezy); --quiet until Debian 7 (Wheezy); --usage until Debian 7 (Wheezy); -? until Debian 7 (Wheezy); -h until Debian 7 (Wheezy); -l until Debian 7 (Wheezy); -n until Debian 7 (Wheezy); -o until Debian 7 (Wheezy); -q until Debian 7 (Wheezy); -s until Debian 7 (Wheezy).

From lxc 1:7.0.0-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.