Commit c101c49c546f407466a672dcb2c8dda6bf3cbf7f

Authored by bellard
1 parent 4bb2fcc7

added qemu-mkcow man page


git-svn-id: svn://svn.savannah.nongnu.org/qemu/trunk@684 c046a42c-6fe2-441c-8c8c-71466251a162
Showing 2 changed files with 106 additions and 1 deletions
Makefile
... ... @@ -42,7 +42,7 @@ install: all
42 42 install -m 644 pc-bios/bios.bin pc-bios/vgabios.bin \
43 43 pc-bios/linux_boot.bin $(sharedir)
44 44 mkdir -p $(mandir)/man1
45   - install qemu.1 $(mandir)/man1
  45 + install qemu.1 qemu-mkcow.1 $(mandir)/man1
46 46 for d in $(TARGET_DIRS); do \
47 47 make -C $$d $@ || exit 1 ; \
48 48 done
... ...
qemu-mkcow.1 0 → 100644
  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 \\*(f1 .ds f1 \\n(.f
  23 +.el .ie \\*(f2 .ds f2 \\n(.f
  24 +.el .ie \\*(f3 .ds f3 \\n(.f
  25 +.el .ie \\*(f4 .ds f4 \\n(.f
  26 +.el .tm ? font overflow
  27 +.ft \\$1
  28 +..
  29 +.de fP
  30 +.ie !\\*(f4 \{\
  31 +. ft \\*(f4
  32 +. ds f4\"
  33 +' br \}
  34 +.el .ie !\\*(f3 \{\
  35 +. ft \\*(f3
  36 +. ds f3\"
  37 +' br \}
  38 +.el .ie !\\*(f2 \{\
  39 +. ft \\*(f2
  40 +. ds f2\"
  41 +' br \}
  42 +.el .ie !\\*(f1 \{\
  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
... ...