]> git.proxmox.com Git - mirror_qemu.git/blame - qemu-mkcow.1
avoid rounding problems
[mirror_qemu.git] / qemu-mkcow.1
CommitLineData
c101c49c
FB
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 \a\\*(f1\a\a .ds f1 \\n(.f
23.el .ie \a\\*(f2\a\a .ds f2 \\n(.f
24.el .ie \a\\*(f3\a\a .ds f3 \\n(.f
25.el .ie \a\\*(f4\a\a .ds f4 \\n(.f
26.el .tm ? font overflow
27.ft \\$1
28..
29.de fP
30.ie !\a\\*(f4\a\a \{\
31. ft \\*(f4
32. ds f4\"
33' br \}
34.el .ie !\a\\*(f3\a\a \{\
35. ft \\*(f3
36. ds f3\"
37' br \}
38.el .ie !\a\\*(f2\a\a \{\
39. ft \\*(f2
40. ds f2\"
41' br \}
42.el .ie !\a\\*(f1\a\a \{\
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"
56qemu-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
62The \fBqemu-mkcow\fR command creates a
63persistent copy-on-write file for \fBqemu\fR.
64
65.PP
66\fBqemu\fR can be used in a "copy-on-write" mode,
67where changes made by \fBqemu\fR do not actually
68change the disk image file. One way is to invoke
69\fBqemu\fR with -snapshot: these changes
70are 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
75file where changes are to be stored: this way, changes made
76inside \fBqemu\fR will still be there next time you
77run it, although the master disk image isn't ever changed.
78
79.PP
80The usual method is to create the master image, then create a
81copy-on-write file using \fBqemu-mkcow\fR with
82\fB-f\fP. The filename of the master image is stored
83inside the generated copy-on-write file: it must not be modified
84after this is run!
85
86.PP
87If no master file is specified, the effect is that of a
88blank master of size \fIcow_size\fR.
89
90.SH "SEE ALSO"
91.PP
92qemu(1), qemu-fast(1).
93.SH "AUTHOR"
94.PP
95This manual page was written by Paul Russell prussell@debian.org for
96the \fBDebian\fP system (but may be used by others). Permission is
97granted to copy, distribute and/or modify this document under
98the terms of the GNU General Public License, Version 2 any
99later version published by the Free Software Foundation.
100
101.PP
102On Debian systems, the complete text of the GNU General Public
103License can be found in /usr/share/common-licenses/GPL.
104
105.\" created by instant / docbook-to-man, Fri 12 Mar 2004, 05:58