From patchwork Wed Jul 13 12:57:39 2011 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Devin Nakamura X-Patchwork-Id: 104504 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.gnu.org (lists.gnu.org [140.186.70.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by ozlabs.org (Postfix) with ESMTPS id BE0E0B6F7C for ; Wed, 13 Jul 2011 23:10:00 +1000 (EST) Received: from localhost ([::1]:39738 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1QgzCO-0007jv-Nq for incoming@patchwork.ozlabs.org; Wed, 13 Jul 2011 09:09:56 -0400 Received: from eggs.gnu.org ([140.186.70.92]:47490) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qgz1d-0005pB-Ih for qemu-devel@nongnu.org; Wed, 13 Jul 2011 08:58:50 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Qgz1b-0006OA-F4 for qemu-devel@nongnu.org; Wed, 13 Jul 2011 08:58:49 -0400 Received: from mail-gw0-f45.google.com ([74.125.83.45]:58827) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Qgz1b-0006Nw-4A for qemu-devel@nongnu.org; Wed, 13 Jul 2011 08:58:47 -0400 Received: by gwb19 with SMTP id 19so2785192gwb.4 for ; Wed, 13 Jul 2011 05:58:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=from:to:cc:subject:date:message-id:x-mailer; bh=sKgDs1qUHLJ69fOy0NmvY40HhUwPl7Xq4rCkjDFKSMY=; b=OGpyMuGssQXAL6nTAVTKty+r+pGu49HSjEhMx9E43HlKmwon81TQNEKxgJsFPSuG2Q Ky12OeLAhEvYQhy3Y0JbX9HZlocYa5+ARu2KG4gQLZSkrm9Oy719v9bxph/5Hz9vK+Em HzRtpYjJcFshGj7cLp0jeBFnf6VThHbu790+Q= Received: by 10.236.9.98 with SMTP id 62mr1371155yhs.525.1310561925674; Wed, 13 Jul 2011 05:58:45 -0700 (PDT) Received: from localhost.localdomain (d72-39-252-38.home1.cgocable.net [72.39.252.38]) by mx.google.com with ESMTPS id e24sm11045864yhk.79.2011.07.13.05.58.44 (version=TLSv1/SSLv3 cipher=OTHER); Wed, 13 Jul 2011 05:58:44 -0700 (PDT) From: Devin Nakamura To: qemu-devel@nongnu.org Date: Wed, 13 Jul 2011 08:57:39 -0400 Message-Id: <1310561864-18964-1-git-send-email-devin122@gmail.com> X-Mailer: git-send-email 1.7.6.rc1 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 2) X-Received-From: 74.125.83.45 Cc: kwolf@redhat.com, Devin Nakamura Subject: [Qemu-devel] [PATCH v3 1/6] block: add basic conversion api X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org add functions to block driver interface to support inplace image conversion Signed-off-by: Devin Nakamura --- block_int.h | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 files changed, 70 insertions(+), 0 deletions(-) diff --git a/block_int.h b/block_int.h index 1e265d2..050ecf3 100644 --- a/block_int.h +++ b/block_int.h @@ -137,6 +137,76 @@ struct BlockDriver { */ int (*bdrv_has_zero_init)(BlockDriverState *bs); + /* In-place image conversion */ + + /** + * + * @param bs Basic Initialization done by bdrv_open_conversion_target() + * Still need to set + * @param options Creation options. + * @return Returns non-zero on failure. + */ + int (*bdrv_open_conversion_target)(BlockDriverState *bs, + QEMUOptionParameter *options); + + /** + * Gets a mapping in the image file. + * + * The function starts searching for a mapping at + * starting_guest_offset = guest_offset + contiguous_bytes + * @param bs[in] The image in which to find mapping. + * @param guest_offset[in,out] On function entry used to calculate + * starting search address. + * On function exit contains the staring + * guest offset of the mapping. + * @param host_offset[out] The starting image file offset for the + * mapping. + * @param contiguous_bytes[in,out] On function entry used to calculate + * starting search address. + * On function exit contains the number of + * bytes for which this mapping is valid. + * A value of 0 means there are no more + * mappings in the image. + * @return Returns non-zero on error. + */ + int (*bdrv_get_mapping)(BlockDriverState *bs, uint64_t *guest_offset, + uint64_t *host_offset, uint64_t *contiguous_bytes); + + /** + * Sets a mapping in the image file. + * + * @param bs Usualy opened with bdrv_open_conversion_target + * @param guest_offset The starting guest offset of the mapping + * (in bytes) + * @param host_offset The starting image offset of the mapping + * (in bytes) + * @param contiguous_bytes The number of bytes for which this mapping exists + * @return Returns non-zero on error + */ + int (*bdrv_map)(BlockDriverState *bs, uint64_t guest_offset, + uint64_t host_offset, uint64_t contiguous_bytes); + + /** + * Copies out the header of a conversion target + * + * Saves the current header for the image in a temporary file and overwrites + * it with the header for the new format (at the moment the header is + * assumed to be 1 sector) + * + * @param bs Usualy opened with bdrv_open_conversion_target(). + * @return Returns non-zero on failure + */ + int (*bdrv_copy_header) (BlockDriverState *bs); + + /** + * Asks the block driver what options should be used to create a conversion + * target. + * @param options[out] + */ + int (*bdrv_get_conversion_options)(BlockDriverState *bs, + QEMUOptionParameter **options); + + QLIST_ENTRY(BlockDriver) list; };