|
1 |
.\" $Header: /home/paul/qemu/svnmerge/qemu-cvs/qemu/qemu-mkcow.1,v 1.1 2004-03-26 22:42:54 bellard Exp $
|
|
2 |
.\"
|
|
3 |
.\" transcript compatibility for postscript use.
|
|
4 |
.\"
|
|
5 |
.\" synopsis: .P! <file.ps>
|
|
6 |
.\"
|
|
7 |
.de P!
|
|
8 |
.fl
|
|
9 |
\!!1 setgray
|
|
10 |
.fl
|
|
11 |
\\&.\"
|
|
12 |
.fl
|
|
13 |
\!!0 setgray
|
|
14 |
.fl \" force out current output buffer
|
|
15 |
\!!save /psv exch def currentpoint translate 0 0 moveto
|
|
16 |
\!!/showpage{}def
|
|
17 |
.fl \" prolog
|
|
18 |
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
|
|
19 |
\!!psv restore
|
|
20 |
.
|
|
21 |
.de pF
|
|
22 |
.ie \\*(f1 .ds f1 \\n(.f
|
|
23 |
.el .ie \\*(f2 .ds f2 \\n(.f
|
|
24 |
.el .ie \\*(f3 .ds f3 \\n(.f
|
|
25 |
.el .ie \\*(f4 .ds f4 \\n(.f
|
|
26 |
.el .tm ? font overflow
|
|
27 |
.ft \\$1
|
|
28 |
..
|
|
29 |
.de fP
|
|
30 |
.ie !\\*(f4 \{\
|
|
31 |
. ft \\*(f4
|
|
32 |
. ds f4\"
|
|
33 |
' br \}
|
|
34 |
.el .ie !\\*(f3 \{\
|
|
35 |
. ft \\*(f3
|
|
36 |
. ds f3\"
|
|
37 |
' br \}
|
|
38 |
.el .ie !\\*(f2 \{\
|
|
39 |
. ft \\*(f2
|
|
40 |
. ds f2\"
|
|
41 |
' br \}
|
|
42 |
.el .ie !\\*(f1 \{\
|
|
43 |
. ft \\*(f1
|
|
44 |
. ds f1\"
|
|
45 |
' br \}
|
|
46 |
.el .tm ? font underflow
|
|
47 |
..
|
|
48 |
.ds f1\"
|
|
49 |
.ds f2\"
|
|
50 |
.ds f3\"
|
|
51 |
.ds f4\"
|
|
52 |
'\" t
|
|
53 |
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n
|
|
54 |
.TH "QEMU" "8"
|
|
55 |
.SH "NAME"
|
|
56 |
qemu-mkcow \(em create a copy-on-write file for qemu
|
|
57 |
.SH "SYNOPSIS"
|
|
58 |
.PP
|
|
59 |
\fBqemu-mkcow\fR [\fB-h\fP] [\fB-f \fImaster_disk_image\fR\fP] [\fIcow_image\fR] [\fB\fIcow_size\fR\fP]
|
|
60 |
.SH "DESCRIPTION"
|
|
61 |
.PP
|
|
62 |
The \fBqemu-mkcow\fR command creates a
|
|
63 |
persistent copy-on-write file for \fBqemu\fR.
|
|
64 |
|
|
65 |
.PP
|
|
66 |
\fBqemu\fR can be used in a "copy-on-write" mode,
|
|
67 |
where changes made by \fBqemu\fR do not actually
|
|
68 |
change the disk image file. One way is to invoke
|
|
69 |
\fBqemu\fR with -snapshot: these changes
|
|
70 |
are stored in a temporary file, which is discarded when
|
|
71 |
\fBqemu\fR exits.
|
|
72 |
|
|
73 |
.PP
|
|
74 |
\fBqemu-mkcow\fR creates an explicit copy-on-write
|
|
75 |
file where changes are to be stored: this way, changes made
|
|
76 |
inside \fBqemu\fR will still be there next time you
|
|
77 |
run it, although the master disk image isn't ever changed.
|
|
78 |
|
|
79 |
.PP
|
|
80 |
The usual method is to create the master image, then create a
|
|
81 |
copy-on-write file using \fBqemu-mkcow\fR with
|
|
82 |
\fB-f\fP. The filename of the master image is stored
|
|
83 |
inside the generated copy-on-write file: it must not be modified
|
|
84 |
after this is run!
|
|
85 |
|
|
86 |
.PP
|
|
87 |
If no master file is specified, the effect is that of a
|
|
88 |
blank master of size \fIcow_size\fR.
|
|
89 |
|
|
90 |
.SH "SEE ALSO"
|
|
91 |
.PP
|
|
92 |
qemu(1), qemu-fast(1).
|
|
93 |
.SH "AUTHOR"
|
|
94 |
.PP
|
|
95 |
This manual page was written by Paul Russell prussell@debian.org for
|
|
96 |
the \fBDebian\fP system (but may be used by others). Permission is
|
|
97 |
granted to copy, distribute and/or modify this document under
|
|
98 |
the terms of the GNU General Public License, Version 2 any
|
|
99 |
later version published by the Free Software Foundation.
|
|
100 |
|
|
101 |
.PP
|
|
102 |
On Debian systems, the complete text of the GNU General Public
|
|
103 |
License can be found in /usr/share/common-licenses/GPL.
|
|
104 |
|
|
105 |
.\" created by instant / docbook-to-man, Fri 12 Mar 2004, 05:58
|