<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [

<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">

<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">

]>

<refentry>

<docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>

<refmeta>

<refentrytitle>lxc-destroy</refentrytitle>

<manvolnum>1</manvolnum>

</refmeta>

<refnamediv>

<refname>lxc-destroy</refname>

<refpurpose>

destroy a container.

</refpurpose>

</refnamediv>

<refsynopsisdiv>

<cmdsynopsis>

<command>lxc-destroy</command>

<arg choice="req">-n <replaceable>name</replaceable></arg>

<arg choice="opt">-f</arg>

</cmdsynopsis>

</refsynopsisdiv>

<refsect1>

<title>Description</title>

<para>

<command>lxc-destroy</command> destroys the system object

previously created by the <command>lxc-create</command> command.

</para>

</refsect1>

<refsect1>

<title>Options</title>

<variablelist>

<varlistentry>

<term>

<option>-f</option>

</term>

<listitem>

<para>

If a container is running, stop it first. If this option is

not specified and the container is running, then

<command>lxc-destroy</command> will be aborted.

</para>

</listitem>

</varlistentry>

</variablelist>

<varlistentry>

<term><option>-P, --lxcpath=<replaceable>PATH</replaceable></option></term>

<listitem>

<para>

Use an alternate container path. The default is @LXCPATH@.

</para>

</listitem>

</varlistentry>

</refsect1>

<refsect1>

<title>Diagnostic</title>

<variablelist>

<varlistentry>

<term>The container was not found</term>

<listitem>

<para>

The specified container for destruction was not found. It

is probable it does not exists and was already

destroyed.You can use the <command>lxc-ls -l</command>

command to list the available containers on the system.

</para>

</listitem>

</varlistentry>

</variablelist>

</refsect1>

&seealso;

<refsect1>

<title>Author</title>

<para>Daniel Lezcano <email>daniel.lezcano@free.fr</email></para>

</refsect1>

</refentry>