← Back to branch summary

~ubuntu-branches/ubuntu/raring/virtinst/raring-proposed

« back to all changes in this revision

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

  • Committer: Bazaar Package Importer
  • Author(s): Guido Günther
  • Date: 2008-11-19 09:19:29 UTC
  • mto: (1.4.1 sid)
  • mto: This revision was merged to the branch mainline in revision 16.
  • Revision ID: james.westby@ubuntu.com-20081119091929-vwksujnqzo1utdln
Tags: upstream-0.400.0
Import upstream version 0.400.0

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/en/virt-image.1
1
 
.\" Automatically generated by Pod::Man v1.37, Pod::Parser v1.32
 
1
.\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05)
2
2
.\"
3
3
.\" Standard preamble:
4
4
.\" ========================================================================
25
25
..
26
26
.\" Set up some character translations and predefined strings.  \*(-- will
27
27
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
28
 
.\" double quote, and \*(R" will give a right double quote.  | will give a
29
 
.\" real vertical bar.  \*(C+ will give a nicer C++.  Capital omega is used to
30
 
.\" do unbreakable dashes and therefore won't be available.  \*(C` and \*(C'
31
 
.\" expand to `' in nroff, nothing in troff, for use with C<>.
32
 
.tr \(*W-|\(bv\*(Tr
 
28
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
 
29
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
 
30
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
 
31
.\" nothing in troff, for use with C<>.
 
32
.tr \(*W-
33
33
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
34
34
.ie n \{\
35
35
.    ds -- \(*W-
48
48
.    ds R" ''
49
49
'br\}
50
50
.\"
 
51
.\" Escape single quotes in literal strings from groff's Unicode transform.
 
52
.ie \n(.g .ds Aq \(aq
 
53
.el       .ds Aq '
 
54
.\"
51
55
.\" If the F register is turned on, we'll generate index entries on stderr for
52
56
.\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index
53
57
.\" entries marked with X<> in POD.  Of course, you'll have to process the
54
58
.\" output yourself in some meaningful fashion.
55
 
.if \nF \{\
 
59
.ie \nF \{\
56
60
.    de IX
57
61
.    tm Index:\\$1\t\\n%\t"\\$2"
58
62
..
59
63
.    nr % 0
60
64
.    rr F
61
65
.\}
62
 
.\"
63
 
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
64
 
.\" way too many mistakes in technical documents.
65
 
.hy 0
66
 
.if n .na
 
66
.el \{\
 
67
.    de IX
 
68
..
 
69
.\}
67
70
.\"
68
71
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
69
72
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
129
132
.\" ========================================================================
130
133
.\"
131
134
.IX Title "VIRT-IMAGE 1"
132
 
.TH VIRT-IMAGE 1 "2007-08-24" "perl v5.8.8" "Virtual Machine Install Tools"
 
135
.TH VIRT-IMAGE 1 "2008-07-29" "perl v5.10.0" "Virtual Machine Install Tools"
 
136
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 
137
.\" way too many mistakes in technical documents.
 
138
.if n .ad l
 
139
.nh
133
140
.SH "NAME"
134
141
virt\-image \- create virtual machines from an image descriptor
135
142
.SH "SYNOPSIS"
225
232
contain multiple \f(CW\*(C`/image/domain/boot\*(C'\fR elements for use on different
226
233
hypervisors. By default, the one that is most appropriate for the current
227
234
hypervisor is selected.
 
235
.IP "\-\-force" 4
 
236
.IX Item "--force"
 
237
Prevent interactive prompts. If the intended prompt was a yes/no prompt, always
 
238
say yes. For any other prompts, the application will exit.
228
239
.SH "EXAMPLES"
229
240
.IX Header "EXAMPLES"
230
241
Create and start a guest called \f(CW\*(C`example\*(C'\fR with a \s-1VNC\s0 console from
231
242
\&\f(CW\*(C`image.xml\*(C'\fR:
232
 
.Sp
 
243
.PP
233
244
.Vb 1
234
 
\&  # virt-image --name example --vnc -i image.xml
 
245
\&  # virt\-image \-\-name example \-\-vnc \-i image.xml
235
246
.Ve
236
 
.Sp
 
247
.PP
237
248
Print the libvirt \s-1XML\s0 for a guest called \f(CW\*(C`example\*(C'\fR without graphics, but
238
249
do not create or start a virtual machine:
239
 
.Sp
 
250
.PP
240
251
.Vb 1
241
 
\&  # virt-image --print --name example --nographics --image image.xml
 
252
\&  # virt\-image \-\-print \-\-name example \-\-nographics \-\-image image.xml
242
253
.Ve
243
254
.SH "AUTHOR"
244
255
.IX Header "AUTHOR"
259
270
.IX Header "SEE ALSO"
260
271
\&\fIvirt\-image\fR\|(5), \fIvirt\-install\fR\|(1), the project website
261
272
\&\f(CW\*(C`http://virt\-manager.org\*(C'\fR
 
273
.SH "POD ERRORS"
 
274
.IX Header "POD ERRORS"
 
275
Hey! \fBThe above document had some coding errors, which are explained below:\fR
 
276
.IP "Around line 130:" 4
 
277
.IX Item "Around line 130:"
 
278
You forgot a '=back' before '=head1'