~ubuntu-branches/ubuntu/precise/virtinst/precise-updates

« back to all changes in this revision

Viewing changes to man/en/virt-image.1

  • Committer: Package Import Robot
  • Author(s): Marc Deslauriers
  • Date: 2012-02-11 11:47:53 UTC
  • mfrom: (1.6.6 sid)
  • Revision ID: package-import@ubuntu.com-20120211114753-sq9f3xayrma8px2h
Tags: 0.600.1-1ubuntu1
* Merge from debian unstable. Remaining changes:
  - debian/patches/9003-fix-path-to-hvmloader-in-testsuite.patch: adjust
    testsuite for 0001-fix-path-to-hvmloader.patch and
    0002-Fix-path-to-pygrub.patch.
  - debian/patches/9004_ubuntu_fix_tree_support.patch: Fix tree detection
    for all ISO/HTTP source, to not longer fail with cobbler/koan.
  - debian/patches/9005_ubuntu_precise.patch: Add Ubuntu precise as a
    supported distro.
  - debian/{control,rules,pyversions}: Build using dh_python2, use
    debhelper v8 instead of cdbs; for some reason the package build an
    empty binary package when using dh_python2.
  - debian/control: added acl package to depends.
  - debian/control: added libvirt-bin to recommends

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14)
 
1
.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
2
2
.\"
3
3
.\" Standard preamble:
4
4
.\" ========================================================================
124
124
.\" ========================================================================
125
125
.\"
126
126
.IX Title "VIRT-IMAGE 1"
127
 
.TH VIRT-IMAGE 1 "2011-06-09" "" "Virtual Machine Install Tools"
 
127
.TH VIRT-IMAGE 1 "2012-01-24" "" "Virtual Machine Install Tools"
128
128
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
129
129
.\" way too many mistakes in technical documents.
130
130
.if n .ad l
205
205
Parameters specific only to fully virtualized guest installs.
206
206
.IP "\-\-noapic" 2
207
207
.IX Item "--noapic"
208
 
Disables \s-1APIC\s0 for fully virtualized guest (overrides value in \s-1XML\s0 descriptor)
 
208
Force disable \s-1APIC\s0 for the guest.
209
209
.IP "\-\-noacpi" 2
210
210
.IX Item "--noacpi"
211
 
Disables \s-1ACPI\s0 for fully virtualized guest (overrides value in \s-1XML\s0 descriptor)
 
211
Force disable \s-1ACPI\s0 for the guest.
212
212
.SS "Networking Configuration"
213
213
.IX Subsection "Networking Configuration"
 
214
.IP "\-w \s-1NETWORK\s0, \-\-network=NETWORK" 2
 
215
.IX Item "-w NETWORK, --network=NETWORK"
 
216
Connect the guest to the host network. See \fIvirt\-install\fR\|(1) for details
214
217
.IP "\-m \s-1MAC\s0, \-\-mac=MAC" 2
215
218
.IX Item "-m MAC, --mac=MAC"
216
219
This is deprecated in favor of \f(CW\*(C`\-\-network ...,mac=MAC,...\*(C'\fR
217
220
.IP "\-b \s-1BRIDGE\s0, \-\-bridge=BRIDGE" 2
218
221
.IX Item "-b BRIDGE, --bridge=BRIDGE"
219
222
This is deprecated in favor of \f(CW\*(C`\-\-network bridge=BRIDGE\*(C'\fR
220
 
.IP "\-w \s-1NETWORK\s0, \-\-network=NETWORK" 2
221
 
.IX Item "-w NETWORK, --network=NETWORK"
222
 
Connect the guest to the host network. See \fIvirt\-install\fR\|(1) for details
223
223
.SS "Graphics Configuration"
224
224
.IX Subsection "Graphics Configuration"
225
 
If no graphics option is specified, \f(CW\*(C`virt\-install\*(C'\fR will default to \-\-vnc
226
 
if the \s-1DISPLAY\s0 environment variable is set, otherwise \-\-nographics is used.
 
225
If no graphics option is specified, \f(CW\*(C`virt\-image\*(C'\fR will default to
 
226
\&'\-\-graphics vnc' if the \s-1DISPLAY\s0 environment variable is set, otherwise
 
227
\&'\-\-graphics none' is used.
 
228
.IP "\-\-graphics \s-1TYPE\s0,opt1=arg1,opt2=arg2,..." 2
 
229
.IX Item "--graphics TYPE,opt1=arg1,opt2=arg2,..."
 
230
Specifies the graphical display configuration. This does not configure any
 
231
virtual hardware, just how the guest's graphical display can be accessed.
 
232
See \fIvirt\-install\fR\|(1) for details usage info.
227
233
.IP "\-\-vnc" 2
228
234
.IX Item "--vnc"
229
 
Setup a virtual console in the guest and export it as a \s-1VNC\s0 server in
230
 
the host. See \fIvirt\-install\fR\|(1) for details
 
235
This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,...\*(C'\fR
231
236
.IP "\-\-vncport=VNCPORT" 2
232
237
.IX Item "--vncport=VNCPORT"
233
 
Request a permanent, statically assigned port number for the guest \s-1VNC\s0
234
 
console. See \fIvirt\-install\fR\|(1) for details
 
238
This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,port=PORT,...\*(C'\fR
235
239
.IP "\-\-vnclisten=VNCLISTEN" 2
236
240
.IX Item "--vnclisten=VNCLISTEN"
237
 
Address to listen on for \s-1VNC\s0 connections. See \fIvirt\-install\fR\|(1) for details.
 
241
This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,listen=LISTEN,...\*(C'\fR
238
242
.IP "\-k \s-1KEYMAP\s0, \-\-keymap=KEYMAP" 2
239
243
.IX Item "-k KEYMAP, --keymap=KEYMAP"
240
 
Request that the virtual \s-1VNC\s0 console be configured to run with a non-English
241
 
keyboard layout.
 
244
This option is deprecated in favor of \f(CW\*(C`\-\-graphics vnc,keymap=KEYMAP,...\*(C'\fR
242
245
.IP "\-\-sdl" 2
243
246
.IX Item "--sdl"
244
 
Setup a virtual console in the guest and display an \s-1SDL\s0 window in the
245
 
host to render the output. See \fIvirt\-install\fR\|(1) for details
 
247
This option is deprecated in favor of \f(CW\*(C`\-\-graphics sdl,...\*(C'\fR
246
248
.IP "\-\-nographics" 2
247
249
.IX Item "--nographics"
248
 
Do not attach a graphical device to the guest. See
249
 
\&\fIvirt\-install\fR\|(1) for details
 
250
This option is deprecated in favor of \f(CW\*(C`\-\-graphics none\*(C'\fR
250
251
.SS "Miscellaneous Options"
251
252
.IX Subsection "Miscellaneous Options"
252
253
.IP "\-p, \-\-print" 2
264
265
installing from the image.
265
266
.IP "\-\-noreboot" 2
266
267
.IX Item "--noreboot"
267
 
Prevent the domain from automatically rebooting after the install has
268
 
completed.
 
268
Prevent the domain automatatically booting after importing the image.
269
269
.IP "\-\-skip\-checksum" 2
270
270
.IX Item "--skip-checksum"
271
271
Do not check disk images against checksums (if they are listed in the
272
272
image xml).
273
273
.IP "\-d, \-\-debug" 2
274
274
.IX Item "-d, --debug"
275
 
Print debugging information
276
 
.IP "\-\-force" 2
277
 
.IX Item "--force"
278
 
Prevent interactive prompts. If the intended prompt was a yes/no prompt, always
279
 
say yes. For any other prompts, the application will exit.
 
275
Print debugging information.
280
276
.SH "EXAMPLES"
281
277
.IX Header "EXAMPLES"
282
278
Create and start a guest called \f(CW\*(C`example\*(C'\fR with a \s-1VNC\s0 console from