From mboxrd@z Thu Jan 1 00:00:00 1970 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) From: Devin Nakamura Date: Wed, 13 Jul 2011 08:57:39 -0400 Message-Id: <1310561864-18964-1-git-send-email-devin122@gmail.com> Subject: [Qemu-devel] [PATCH v3 1/6] block: add basic conversion api List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel@nongnu.org Cc: kwolf@redhat.com, Devin Nakamura 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; }; -- 1.7.6.rc1