qemu-mkcow.1

   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