813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynlxc: linux Container library
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn(C) Copyright Canonical Inc. 2007, 2008
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynSerge Hallyn <serge.hallyn at ubuntu.com>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynThis library is free software; you can redistribute it and/or
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynmodify it under the terms of the GNU Lesser General Public
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynLicense as published by the Free Software Foundation; either
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynversion 2.1 of the License, or (at your option) any later version.
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynThis library is distributed in the hope that it will be useful,
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynbut WITHOUT ANY WARRANTY; without even the implied warranty of
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynLesser General Public License for more details.
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynYou should have received a copy of the GNU Lesser General Public
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynLicense along with this library; if not, write to the Free Software
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn<!ENTITY commonoptions SYSTEM "@builddir@/common_options.sgml">
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <refnamediv>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <refpurpose>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn Snapshot an existing container.
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </refpurpose>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </refnamediv>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <refsynopsisdiv>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <cmdsynopsis>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <arg choice="req">-n, --name <replaceable>name</replaceable></arg>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <arg choice="opt">-c, --comment <replaceable>file</replaceable></arg>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </cmdsynopsis>
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn <cmdsynopsis>
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn <arg choice="req">-n, --name <replaceable>name</replaceable></arg>
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn <arg choice="req">-d, -destroy <replaceable>snapshot-name</replaceable></arg>
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn </cmdsynopsis>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <cmdsynopsis>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <arg choice="req">-n, --name <replaceable>name</replaceable></arg>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </cmdsynopsis>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <cmdsynopsis>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <arg choice="req">-n, --name <replaceable>name</replaceable></arg>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <arg choice="req">-r, -restore <replaceable>snapshot-name</replaceable></arg>
dedd4f67711d55fde065724638fa545f578fb6ebChristian Brauner <arg choice="opt">-N, --newname <replaceable> newname</replaceable></arg>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </cmdsynopsis>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </refsynopsisdiv>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <command>lxc-snapshot</command> creates, lists, and restores
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn container snapshots.
a9b21284fceafaf57b1bb58cf59f939dcf68141aKATOH Yasufumi Snapshots are stored as snapshotted containers under the container's configuration path. For instance, if the container's configuration path is <filename>/var/lib/lxc</filename> and the container is <filename>c1</filename>, then the first snapshot will be stored as container <filename>snap0</filename> under the path <filename>/var/lib/lxc/c1/snaps</filename>.
a9b21284fceafaf57b1bb58cf59f939dcf68141aKATOH Yasufumi If <filename>/var/lib/lxcsnaps</filename>, as used by LXC 1.0, already exists, then it will continue to be used.
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <variablelist>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <term> <option>-c,--comment <replaceable>comment_file</replaceable></option> </term>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <para> Associate the comment in <replaceable>comment_file</replaceable> with the newly created snapshot.</para>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </varlistentry>
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn <varlistentry>
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn <term> <option>-d,--destroy snapshot-name</option> </term>
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn <para> Destroy the named snapshot. If the named snapshot is ALL, then all snapshots
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn will be destroyed.</para>
18aa217bb187b551206fe66075229ba382a1dbe4Serge Hallyn </varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <term> <option>-C,--showcomments </option> </term>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <para> Show snapshot comments in the snapshots listings. </para>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <term> <option>-r,--restore snapshot-name</option> </term>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <para> Restore the named snapshot, meaning a full new container is created which is a copy of the snapshot.</para>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <varlistentry>
dedd4f67711d55fde065724638fa545f578fb6ebChristian Brauner <term> <option>-N, --newname</option> </term>
dedd4f67711d55fde065724638fa545f578fb6ebChristian Brauner <para> When restoring a snapshot, the last optional argument if not given explicitly via <command>--newname</command> is the name to use for the restored container. If the newname is identical to the original name of the container, then the original container will be destroyed and the restored container will take its place. Note that deleting the original snapshot is not possible in the case of aufs, overlayfs or zfs backed snapshots.</para>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </varlistentry>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn </variablelist>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn &commonoptions;
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn <para>Serge Hallyn <email>serge.hallyn@ubuntu.com </email></para>
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallyn<!-- Keep this comment at the end of the file
813a4837659d5d7a2c0d0abe03c87196747217e9Serge HallynLocal variables:
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-omittag:t
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-shorttag:t
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-minimize-attributes:nil
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-always-quote-attributes:t
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-indent-step:2
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-indent-data:t
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-parent-document:nil
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-default-dtd-file:nil
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-exposed-tags:nil
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-local-catalogs:nil
813a4837659d5d7a2c0d0abe03c87196747217e9Serge Hallynsgml-local-ecat-files:nil