diff --git a/Makefile b/Makefile index 11f7915503..e55c072af3 100644 --- a/Makefile +++ b/Makefile @@ -42,7 +42,7 @@ install: all install -m 644 pc-bios/bios.bin pc-bios/vgabios.bin \ pc-bios/linux_boot.bin $(sharedir) mkdir -p $(mandir)/man1 - install qemu.1 $(mandir)/man1 + install qemu.1 qemu-mkcow.1 $(mandir)/man1 for d in $(TARGET_DIRS); do \ make -C $$d $@ || exit 1 ; \ done diff --git a/qemu-mkcow.1 b/qemu-mkcow.1 new file mode 100644 index 0000000000..5e1a6812be --- /dev/null +++ b/qemu-mkcow.1 @@ -0,0 +1,105 @@ +.\" $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! +.\" +.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