Bug 676484

Summary:	There is no indication of full preallocation mode in qemu-img man page
Product:	Red Hat Enterprise Linux 6	Reporter:	Shirley Zhou <szhou>
Component:	qemu-kvm	Assignee:	Kevin Wolf <kwolf>
Status:	CLOSED ERRATA	QA Contact:	Virtualization Bugs <virt-bugs>
Severity:	medium	Docs Contact:
Priority:	medium
Version:	6.1	CC:	juzhang, mkenneth, mshao, pschiffe, tburke, virt-maint, wdai
Target Milestone:	rc	Keywords:	ManPageChange, Triaged
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	qemu-kvm-0.12.1.2-2.238.el6	Doc Type:	Bug Fix
Doc Text:	No documentation needed	Story Points:	---
Clone Of:		Environment:
Last Closed:	2012-06-20 11:32:48 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Bug Depends On:
Bug Blocks:	580953

Description Shirley Zhou 2011-02-10 02:16:22 UTC

Description of problem:
Check man page of qemu-img, there is no indication of "full" preallocation mode.

Version-Release number of selected component (if applicable):
qemu-kvm-0.12.1.2-2.144.el6.x86_64

How reproducible:
100%

Steps to Reproduce:
1. #man qemu-img , search preallocation mode,get 

"preallocation"
Preallocation mode (allowed values: off, metadata). An image with preallocated metadata is initially larger but can improve performance when the image needs to grow.

  
Actual results:
no full mode indicate.

Expected results:
There should be indicated full preallocation mode.

Additional info:

Comment 2 Dor Laor 2011-02-13 12:52:08 UTC

Kevin, it seems like a nice to have

Comment 7 juzhang 2012-03-09 09:05:16 UTC

Verified with qemu-kvm-0.12.1.2-2.240.el6.x86_64

 "preallocation"
               Preallocation mode (allowed values: off, metadata, full). An image with preallocated metadata is initially larger but can
               improve performance when the image needs to grow. Full preallocation additionally writes zeros to the whole image in order to
               preallocate lower layers (e.g. the file system containing the image file) as well. Note that full preallocation writes to
               every byte of the virtual disk, so it can take a long time for large images

Comment 9 Dor Laor 2012-04-22 11:32:36 UTC

    Technical note added. If any revisions are required, please edit the "Technical Notes" field
    accordingly. All revisions will be proofread by the Engineering Content Services team.
    
    New Contents:
No documentation needed

Comment 10 errata-xmlrpc 2012-06-20 11:32:48 UTC

Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory, and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

http://rhn.redhat.com/errata/RHBA-2012-0746.html