'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-start-ephemeral 1 "Sat Apr 29 06:45:43 UTC 2017" "" ""
.SH NAME
lxc-start-ephemeral \- start an ephemeral copy of an existing container 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBlxc-start-ephemeral\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[-o] [-n] [-d] [--bdir] [--user] [--key] [--union-type] [--keep-data] [COMMAND]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBlxc-start-ephemeral\fR start an ephemeral copy of an
existing container.
.SH OPTIONS
.TP 
\*(T<\fB\-o\fR\*(T> 
Original container name
.TP 
\*(T<\fB[\-n]\fR\*(T> 
Name of the ephemeral container (defaults to a random suffix).
.TP 
\*(T<\fB[\-d]\fR\*(T> 
Start the container in background and print the name and IP.
This option can't be used if a command is passed.
.TP 
\*(T<\fB[\-\-bdir]\fR\*(T> 
Directory to bind mount into container.
Can be passed multiple times.
.TP 
\*(T<\fB[\-\-user]\fR\*(T> 
The user to connect to the container as.
Used when passing a command to lxc-start-ephemeral.
.TP 
\*(T<\fB[\-\-key]\fR\*(T> 
Copy the provided SSH public key into the container.
.TP 
\*(T<\fB[\-\-union\-type]\fR\*(T> 
Force a specific union file system.
Can be one of: overlayfs aufs
.TP 
\*(T<\fB[\-\-keep\-data]\fR\*(T> 
Use a persistent backend instead of tmpfs.
With this option, you can lxc-stop and lxc-start the no longer so
ephemeral container (it's still an overlay, but a persistent one).
.TP 
\*(T<\fB[COMMAND]\fR\*(T> 
Immediately run the provided command in the container.
This currently uses ssh (not attach) and is incompatible
with daemon mode.
.SH "SEE ALSO"
\fBlxc-start\fR(1),
.SH EXAMPLES
.TP 
lxc-start-ephemeral -o p1
Simply start an ephemeral container and attach to the console.
This container will be based on existing container "p1".
.TP 
lxc-start-ephemeral -o p1 -n p1-ephemeral -d
Start an ephemeral container based on p1 called p1-ephemeral and
print its IP and name to the console instead of attaching.
.SH "SEE ALSO"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)
.SH AUTHOR
St\('ephane Graber <\*(T<stgraber@ubuntu.com\*(T>>