[mirror_qemu.git] / qemu-mkcow.1

.\" $Header: /home/paul/qemu/svnmerge/qemu-cvs/qemu/qemu-mkcow.1,v 1.1 2004-03-26 22:42:54 bellard Exp $
.\"
.\"	transcript compatibility for postscript use.
.\"
.\"	synopsis:  .P! <file.ps>
.\"
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \a\\*(f1\a\a .ds f1 \\n(.f
.el .ie \a\\*(f2\a\a .ds f2 \\n(.f
.el .ie \a\\*(f3\a\a .ds f3 \\n(.f
.el .ie \a\\*(f4\a\a .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\a\\*(f4\a\a \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\a\\*(f3\a\a \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\a\\*(f2\a\a \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\a\\*(f1\a\a \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
'\" t 
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n  
.TH "QEMU" "8" 
.SH "NAME" 
qemu-mkcow \(em create a copy-on-write file for qemu 
.SH "SYNOPSIS" 
.PP 
\fBqemu-mkcow\fR [\fB-h\fP]  [\fB-f \fImaster_disk_image\fR\fP]  [\fIcow_image\fR]  [\fB\fIcow_size\fR\fP]  
.SH "DESCRIPTION" 
.PP 
The \fBqemu-mkcow\fR command creates a 
persistent copy-on-write file for \fBqemu\fR. 
 
.PP 
\fBqemu\fR can be used in a "copy-on-write" mode, 
where changes made by \fBqemu\fR do not actually 
change the disk image file.  One way is to invoke 
\fBqemu\fR with -snapshot: these changes 
are stored in a temporary file, which is discarded when  
\fBqemu\fR exits. 
 
.PP 
\fBqemu-mkcow\fR creates an explicit copy-on-write 
file where changes are to be stored: this way, changes made 
inside \fBqemu\fR will still be there next time you 
run it, although the master disk image isn't ever changed. 
 
.PP 
The usual method is to create the master image, then create a 
copy-on-write file using \fBqemu-mkcow\fR with 
\fB-f\fP.  The filename of the master image is stored 
inside the generated copy-on-write file: it must not be modified 
after this is run! 
 
.PP 
If no master file is specified, the effect is that of a 
blank master of size \fIcow_size\fR. 
 
.SH "SEE ALSO" 
.PP 
qemu(1), qemu-fast(1). 
.SH "AUTHOR" 
.PP 
This manual page was written by Paul Russell prussell@debian.org for 
the \fBDebian\fP system (but may be used by others).  Permission is 
granted to copy, distribute and/or modify this document under 
the terms of the GNU General Public License, Version 2 any  
later version published by the Free Software Foundation. 
 
.PP 
On Debian systems, the complete text of the GNU General Public 
License can be found in /usr/share/common-licenses/GPL. 
 
.\" created by instant / docbook-to-man, Fri 12 Mar 2004, 05:58
Commit	Line	Data
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"
	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