← Back to branch summary

~serge-hallyn/ubuntu/natty/lxc/fix-restart

« back to all changes in this revision

Viewing changes to doc/lxc-start.1

  • Committer: Bazaar Package Importer
  • Author(s): Serge Hallyn
  • Date: 2011-01-23 17:28:55 UTC
  • mfrom: (1.1.7 upstream)
  • Revision ID: james.westby@ubuntu.com-20110123172855-1vpaxel9kwocx7qz
Tags: 0.7.3.1-0ubuntu1
* Base on new upstream git tree with new maverick and natty templates,
  and able to run without ns cgroup.
* Send a 'container=lxc' variable to upstart.  The upstream git has
  the same patch, though this tree has it as a quilt patch.
* Add lxcguest package which converts a system into one which can
  boot upstart both as a container and a (kvm or bare-metal) host.
* Add a MIRROR default in /etc/default/lxc, and use that in the
  debootstrap command in the lucid, maverick and natty templates.
* Remove 0004-restore-lxc.mount-lxc.mount.entry-functionality.patch
  which prevents containers from starting.

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/lxc-start.1
1
 
.\" This manpage has been automatically generated by docbook2man 
2
 
.\" from a DocBook document.  This tool can be found at:
3
 
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
4
 
.\" Please send any bug reports, improvements, comments, patches, 
5
 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
6
 
.TH "LXC-START" "1" "26 October 2010" "" ""
7
 
 
8
 
.SH NAME
9
 
lxc-start \- run an application inside a container.
10
 
.SH SYNOPSIS
11
 
 
12
 
\fBlxc-start \fI-n
13
 
name\fB [-f
14
 
config_file] [-s KEY=VAL]
15
 
[command]\fR
16
 
 
17
 
.SH "DESCRIPTION"
18
 
.PP
19
 
\fBlxc-start\fR runs the specified
20
 
\fIcommand\fR inside the container
21
 
specified by \fIname\fR\&.
22
 
.PP
23
 
It will setup the container
24
 
according to the configuration previously defined with the
25
 
lxc-create command or with the configuration file parameter.
26
 
If no configuration is
27
 
defined, the default isolation is used.
28
 
.PP
29
 
The orphan process group
30
 
and daemon are not supported by this command, use
31
 
the \fBlxc-execute\fR command instead.
32
 
.PP
33
 
If no command is specified, \fBlxc-start\fR will
34
 
use the default
35
 
\fB"/sbin/init"\fR command to run a system
36
 
container.
37
 
.SH "OPTIONS"
38
 
.TP
39
 
\fB   -d, --daemon \fR
40
 
Run the container as a daemon. As the container has no
41
 
more tty, if an error occurs nothing will be displayed,
42
 
the log file can be used to check the error.
43
 
.TP
44
 
\fB   -f, --rcfile \fIconfig_file\fB \fR
45
 
Specify the configuration file to configure the virtualization
46
 
and isolation functionalities for the container.
47
 
 
48
 
This configuration file if present will be used even if there is
49
 
already a configuration file present in the previously created
50
 
container (via lxc-create).
51
 
.TP
52
 
\fB   -s, --define \fIKEY=VAL\fB \fR
53
 
Assign value \fIVAL\fR to configuration
54
 
variable \fIKEY\fR\&. This overrides any
55
 
assignment done in \fIconfig_file\fR\&.
56
 
.SH "COMMON OPTIONS"
57
 
.PP
58
 
These options are common to most of lxc commands.
59
 
.TP
60
 
\fB-?, -h, --help\fR
61
 
Print a longer usage message than normal.
62
 
.TP
63
 
\fB--usage\fR
64
 
Give the usage message
65
 
.TP
66
 
\fB-q, --quiet\fR
67
 
mute on
68
 
.TP
69
 
\fB-o, --logfile=\fIFILE\fB\fR
70
 
Output to an alternate log
71
 
\fIFILE\fR\&. The default is no log.
72
 
.TP
73
 
\fB-l, --logpriority=\fILEVEL\fB\fR
74
 
Set log priority to
75
 
\fILEVEL\fR\&. The default log
76
 
priority is ERROR\&. Possible values are :
77
 
FATAL, CRIT,
78
 
WARN, ERROR,
79
 
NOTICE, INFO,
80
 
DEBUG\&.
81
 
 
82
 
Note that this option is setting the priority of the events
83
 
log in the alternate log file. It do not have effect on the
84
 
ERROR events log on stderr.
85
 
.TP
86
 
\fB-n, --name=\fINAME\fB\fR
87
 
Use container identifier \fINAME\fR\&.
88
 
The container identifier format is an alphanumeric string.
89
 
.SH "DIAGNOSTIC"
90
 
.TP
91
 
\fBThe container is busy\fR
92
 
The specified container is already running an
93
 
application. You should stop it before reuse this
94
 
container or create a new one.
95
 
.SH "SEE ALSO"
96
 
.PP
97
 
\fBlxc\fR(1),
98
 
\fBlxc-create\fR(1),
99
 
\fBlxc-destroy\fR(1),
100
 
\fBlxc-start\fR(1),
101
 
\fBlxc-stop\fR(1),
102
 
\fBlxc-execute\fR(1),
103
 
\fBlxc-kill\fR(1),
104
 
\fBlxc-console\fR(1),
105
 
\fBlxc-monitor\fR(1),
106
 
\fBlxc-wait\fR(1),
107
 
\fBlxc-cgroup\fR(1),
108
 
\fBlxc-ls\fR(1),
109
 
\fBlxc-ps\fR(1),
110
 
\fBlxc-info\fR(1),
111
 
\fBlxc-freeze\fR(1),
112
 
\fBlxc-unfreeze\fR(1),
113
 
\fBlxc.conf\fR(5)
114
 
.SH "AUTHOR"
115
 
.PP
116
 
Daniel Lezcano <daniel.lezcano@free.fr>