Archipelago » qemu

.\" $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     \\*(f1 .ds f1 \\n(.f

.el .ie \\*(f2 .ds f2 \\n(.f

.el .ie \\*(f3 .ds f3 \\n(.f

.el .ie \\*(f4 .ds f4 \\n(.f

.el .tm ? font overflow

.ft \\$1

..

.de fP

.ie     !\\*(f4 \{\

.	ft \\*(f4

.	ds f4\"

'	br \}

.el .ie !\\*(f3 \{\

.	ft \\*(f3

.	ds f3\"

'	br \}

.el .ie !\\*(f2 \{\

.	ft \\*(f2

.	ds f2\"

'	br \}

.el .ie !\\*(f1 \{\

.	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