~ubuntu-branches/ubuntu/quantal/lxc/quantal-201206191543

« back to all changes in this revision

Viewing changes to doc/lxc-start.1

  • Committer: Bazaar Package Importer
  • Author(s): Guido Trotter
  • Date: 2010-06-28 10:15:48 UTC
  • mfrom: (1.2.4 upstream)
  • mto: (3.1.15 sid)
  • mto: This revision was merged to the branch mainline in revision 7.
  • Revision ID: james.westby@ubuntu.com-20100628101548-lmqvw55ypaxtbhhh
Tags: upstream-0.7.1
ImportĀ upstreamĀ versionĀ 0.7.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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" "24 June 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>