added qemu-mkcow man page

git-svn-id: svn://svn.savannah.nongnu.org/qemu/trunk@684 c046a42c-6fe2-441c-8c8c-71466251a162
This commit is contained in:
bellard 2004-03-26 22:42:54 +00:00
parent 4bb2fcc7c9
commit c101c49c54
2 changed files with 106 additions and 1 deletions

View File

@ -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

105
qemu-mkcow.1 Normal file
View File

@ -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! <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