4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber(C) Copyright Canonical Ltd. 2013
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberStéphane Graber <stgraber@ubuntu.com>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberThis library is free software; you can redistribute it and/or
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabermodify it under the terms of the GNU Lesser General Public
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberLicense as published by the Free Software Foundation; either
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graberversion 2.1 of the License, or (at your option) any later version.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberThis library is distributed in the hope that it will be useful,
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graberbut WITHOUT ANY WARRANTY; without even the implied warranty of
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberLesser General Public License for more details.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberYou should have received a copy of the GNU Lesser General Public
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberLicense along with this library; if not, write to the Free Software
250b1eec71b074acdff1c5f6b5a1f0d7d2c20b77Stéphane GraberFoundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
7f95145833bb24f54e037f73ecc37444d6635697Dwight Engen<!DOCTYPE refentry PUBLIC @docdtd@ [
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber<!ENTITY seealso SYSTEM "@builddir@/see_also.sgml">
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <docinfo><date>@LXC_GENERATE_DATE@</date></docinfo>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <refentrytitle>lxc-start-ephemeral</refentrytitle>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <manvolnum>1</manvolnum>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <refname>lxc-start-ephemeral</refname>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber start an ephemeral copy of an existing container
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </refpurpose>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </refnamediv>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <refsynopsisdiv>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <cmdsynopsis>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <command>lxc-start-ephemeral</command>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">-o</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">-n</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">-d</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">--bdir</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">--user</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">--key</arg>
8128cf421081b683bca4610aa2db3e3ed851ab92KATOH Yasufumi <arg choice="opt">--storage-type</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">--union-type</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">--keep-data</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <arg choice="opt">COMMAND</arg>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </cmdsynopsis>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </refsynopsisdiv>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <title>Description</title>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <command>lxc-start-ephemeral</command> start an ephemeral copy of an
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber existing container.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <title>Options</title>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <variablelist>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-o, --orig <replaceable>orig</replaceable></option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Original container name
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-n, --name <replaceable>name</replaceable></option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Name of the ephemeral container (defaults to a random suffix).
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-d, --daemon</option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Start the container in background and print the name and IP.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber This option can't be used if a command is passed.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-b, --bdir <replaceable>bdir</replaceable></option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Directory to bind mount into container.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Can be passed multiple times.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-u, --user <replaceable>user</replaceable></option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber The user to connect to the container as.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Used when passing a command to lxc-start-ephemeral.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-S, --key <replaceable>key</replaceable></option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Copy the provided SSH public key into the container.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
8128cf421081b683bca4610aa2db3e3ed851ab92KATOH Yasufumi <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-s, --storage-type <replaceable>storage type</replaceable></option>
8128cf421081b683bca4610aa2db3e3ed851ab92KATOH Yasufumi Specify the type of storage used by the container. Valid types are tmpfs or dir.
8128cf421081b683bca4610aa2db3e3ed851ab92KATOH Yasufumi </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-U, --union-type <replaceable>union type</replaceable></option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Force a specific union file system.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Can be one of: overlayfs aufs
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>-k, --keep-data</option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Use a persistent backend instead of tmpfs.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber With this option, you can lxc-stop and lxc-start the no longer so
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber ephemeral container (it's still an overlay, but a persistent one).
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
1bc07a5b8dbaef4b6eb6d30a260e9c2153ed368bKATOH Yasufumi <option>COMMAND</option>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Immediately run the provided command in the container.
56e4a18564f8ab3d93c0f2b5f91aa5cff4f171c9KATOH Yasufumi This uses attach if the kernel supports it, otherwise uses ssh.
56e4a18564f8ab3d93c0f2b5f91aa5cff4f171c9KATOH Yasufumi This is incompatible with daemon mode.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </variablelist>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <title>See Also</title>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <citerefentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <refentrytitle>lxc-start</refentrytitle>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <manvolnum>1</manvolnum>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </citerefentry>,
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <title>Examples</title>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <variablelist>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <term>lxc-start-ephemeral -o p1</term>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Simply start an ephemeral container and attach to the console.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber This container will be based on existing container "p1".
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <term>lxc-start-ephemeral -o p1 -n p1-ephemeral -d</term>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber Start an ephemeral container based on p1 called p1-ephemeral and
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber print its IP and name to the console instead of attaching.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </varlistentry>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber </variablelist>
02e5d92b70562457a963f0803f0069053ce3292bChristian Brauner <title>Notes</title>
2ae6732f6b351ddbd299678fec2c43d02faef5e0Christian Brauner <command>lxc-start-ephemeral</command> is deprecated in favor of
02e5d92b70562457a963f0803f0069053ce3292bChristian Brauner <command>lxc-copy</command>.
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <title>Author</title>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber <para>Stéphane Graber <email>stgraber@ubuntu.com</email></para>
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Graber<!-- Keep this comment at the end of the file
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane GraberLocal variables:
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-omittag:t
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-shorttag:t
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-minimize-attributes:nil
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-always-quote-attributes:t
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-indent-step:2
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-indent-data:t
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-parent-document:nil
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-default-dtd-file:nil
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-exposed-tags:nil
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-local-catalogs:nil
4019712d198a7d50b08b326ade17f5ff1666efbbStéphane Grabersgml-local-ecat-files:nil