1903cb1bfSPhilippe Mathieu-Daudé#!/usr/bin/env python3 29dd003a9SVladimir Sementsov-Ogievskiy# group: rw auto backing 337ce63ebSStefan Hajnoczi# 437ce63ebSStefan Hajnoczi# Tests for image streaming. 537ce63ebSStefan Hajnoczi# 637ce63ebSStefan Hajnoczi# Copyright (C) 2012 IBM Corp. 737ce63ebSStefan Hajnoczi# 837ce63ebSStefan Hajnoczi# This program is free software; you can redistribute it and/or modify 937ce63ebSStefan Hajnoczi# it under the terms of the GNU General Public License as published by 1037ce63ebSStefan Hajnoczi# the Free Software Foundation; either version 2 of the License, or 1137ce63ebSStefan Hajnoczi# (at your option) any later version. 1237ce63ebSStefan Hajnoczi# 1337ce63ebSStefan Hajnoczi# This program is distributed in the hope that it will be useful, 1437ce63ebSStefan Hajnoczi# but WITHOUT ANY WARRANTY; without even the implied warranty of 1537ce63ebSStefan Hajnoczi# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 1637ce63ebSStefan Hajnoczi# GNU General Public License for more details. 1737ce63ebSStefan Hajnoczi# 1837ce63ebSStefan Hajnoczi# You should have received a copy of the GNU General Public License 1937ce63ebSStefan Hajnoczi# along with this program. If not, see <http://www.gnu.org/licenses/>. 2037ce63ebSStefan Hajnoczi# 2137ce63ebSStefan Hajnoczi 220c817347SPaolo Bonziniimport time 2337ce63ebSStefan Hajnocziimport os 2437ce63ebSStefan Hajnocziimport iotests 2533fe08fcSThomas Huthimport unittest 2637ce63ebSStefan Hajnoczifrom iotests import qemu_img, qemu_io 2737ce63ebSStefan Hajnoczi 2837ce63ebSStefan Hajnoczibacking_img = os.path.join(iotests.test_dir, 'backing.img') 296e343609SPaolo Bonzinimid_img = os.path.join(iotests.test_dir, 'mid.img') 3037ce63ebSStefan Hajnoczitest_img = os.path.join(iotests.test_dir, 'test.img') 3137ce63ebSStefan Hajnoczi 322499a096SStefan Hajnocziclass TestSingleDrive(iotests.QMPTestCase): 3337ce63ebSStefan Hajnoczi image_len = 1 * 1024 * 1024 # MB 3437ce63ebSStefan Hajnoczi 3537ce63ebSStefan Hajnoczi def setUp(self): 362499a096SStefan Hajnoczi iotests.create_image(backing_img, TestSingleDrive.image_len) 37b66ff2c2SEric Blake qemu_img('create', '-f', iotests.imgfmt, 38b66ff2c2SEric Blake '-o', 'backing_file=%s' % backing_img, 39b66ff2c2SEric Blake '-F', 'raw', mid_img) 40b66ff2c2SEric Blake qemu_img('create', '-f', iotests.imgfmt, 41b66ff2c2SEric Blake '-o', 'backing_file=%s' % mid_img, 42b66ff2c2SEric Blake '-F', iotests.imgfmt, test_img) 4390c9b167SKevin Wolf qemu_io('-f', 'raw', '-c', 'write -P 0x1 0 512', backing_img) 445e302a7dSAlberto Garcia qemu_io('-f', iotests.imgfmt, '-c', 'write -P 0x1 524288 512', mid_img) 450e4a0644SMax Reitz self.vm = iotests.VM().add_drive("blkdebug::" + test_img, 460e4a0644SMax Reitz "backing.node-name=mid," + 470e4a0644SMax Reitz "backing.backing.node-name=base") 4837ce63ebSStefan Hajnoczi self.vm.launch() 4937ce63ebSStefan Hajnoczi 5037ce63ebSStefan Hajnoczi def tearDown(self): 5137ce63ebSStefan Hajnoczi self.vm.shutdown() 5237ce63ebSStefan Hajnoczi os.remove(test_img) 536e343609SPaolo Bonzini os.remove(mid_img) 5437ce63ebSStefan Hajnoczi os.remove(backing_img) 5537ce63ebSStefan Hajnoczi 5637ce63ebSStefan Hajnoczi def test_stream(self): 57ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 5837ce63ebSStefan Hajnoczi 59db58f9c0SStefan Hajnoczi result = self.vm.qmp('block-stream', device='drive0') 6037ce63ebSStefan Hajnoczi self.assert_qmp(result, 'return', {}) 6137ce63ebSStefan Hajnoczi 629974ad40SFam Zheng self.wait_until_completed() 6337ce63ebSStefan Hajnoczi 64ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 65863a5d04SPaolo Bonzini self.vm.shutdown() 6637ce63ebSStefan Hajnoczi 6790c9b167SKevin Wolf self.assertEqual(qemu_io('-f', 'raw', '-c', 'map', backing_img), 6890c9b167SKevin Wolf qemu_io('-f', iotests.imgfmt, '-c', 'map', test_img), 69efcc7a23SPaolo Bonzini 'image file map does not match backing file after streaming') 7037ce63ebSStefan Hajnoczi 717b8a9e5aSAlberto Garcia def test_stream_intermediate(self): 727b8a9e5aSAlberto Garcia self.assert_no_active_block_jobs() 737b8a9e5aSAlberto Garcia 74aca7063aSFam Zheng self.assertNotEqual(qemu_io('-f', 'raw', '-rU', '-c', 'map', backing_img), 75aca7063aSFam Zheng qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', mid_img), 767b8a9e5aSAlberto Garcia 'image file map matches backing file before streaming') 777b8a9e5aSAlberto Garcia 787b8a9e5aSAlberto Garcia result = self.vm.qmp('block-stream', device='mid', job_id='stream-mid') 797b8a9e5aSAlberto Garcia self.assert_qmp(result, 'return', {}) 807b8a9e5aSAlberto Garcia 817b8a9e5aSAlberto Garcia self.wait_until_completed(drive='stream-mid') 827b8a9e5aSAlberto Garcia 837b8a9e5aSAlberto Garcia self.assert_no_active_block_jobs() 847b8a9e5aSAlberto Garcia self.vm.shutdown() 857b8a9e5aSAlberto Garcia 867b8a9e5aSAlberto Garcia self.assertEqual(qemu_io('-f', 'raw', '-c', 'map', backing_img), 877b8a9e5aSAlberto Garcia qemu_io('-f', iotests.imgfmt, '-c', 'map', mid_img), 887b8a9e5aSAlberto Garcia 'image file map does not match backing file after streaming') 897b8a9e5aSAlberto Garcia 900c817347SPaolo Bonzini def test_stream_pause(self): 91ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 920c817347SPaolo Bonzini 93b59b3d57SFam Zheng self.vm.pause_drive('drive0') 940c817347SPaolo Bonzini result = self.vm.qmp('block-stream', device='drive0') 950c817347SPaolo Bonzini self.assert_qmp(result, 'return', {}) 960c817347SPaolo Bonzini 97f03d9d24SJohn Snow self.pause_job('drive0', wait=False) 982c93c5cbSKevin Wolf self.vm.resume_drive('drive0') 99f03d9d24SJohn Snow self.pause_wait('drive0') 1002c93c5cbSKevin Wolf 1010c817347SPaolo Bonzini result = self.vm.qmp('query-block-jobs') 1020c817347SPaolo Bonzini offset = self.dictpath(result, 'return[0]/offset') 1030c817347SPaolo Bonzini 1042c93c5cbSKevin Wolf time.sleep(0.5) 1050c817347SPaolo Bonzini result = self.vm.qmp('query-block-jobs') 1060c817347SPaolo Bonzini self.assert_qmp(result, 'return[0]/offset', offset) 1070c817347SPaolo Bonzini 1080c817347SPaolo Bonzini result = self.vm.qmp('block-job-resume', device='drive0') 1090c817347SPaolo Bonzini self.assert_qmp(result, 'return', {}) 1100c817347SPaolo Bonzini 1119974ad40SFam Zheng self.wait_until_completed() 1120c817347SPaolo Bonzini 113ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 1140c817347SPaolo Bonzini self.vm.shutdown() 1150c817347SPaolo Bonzini 11690c9b167SKevin Wolf self.assertEqual(qemu_io('-f', 'raw', '-c', 'map', backing_img), 11790c9b167SKevin Wolf qemu_io('-f', iotests.imgfmt, '-c', 'map', test_img), 1180c817347SPaolo Bonzini 'image file map does not match backing file after streaming') 1190c817347SPaolo Bonzini 120409d5498SAlberto Garcia def test_stream_no_op(self): 121409d5498SAlberto Garcia self.assert_no_active_block_jobs() 122409d5498SAlberto Garcia 123409d5498SAlberto Garcia # The image map is empty before the operation 124aca7063aSFam Zheng empty_map = qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', test_img) 125409d5498SAlberto Garcia 126409d5498SAlberto Garcia # This is a no-op: no data should ever be copied from the base image 127409d5498SAlberto Garcia result = self.vm.qmp('block-stream', device='drive0', base=mid_img) 128409d5498SAlberto Garcia self.assert_qmp(result, 'return', {}) 129409d5498SAlberto Garcia 130409d5498SAlberto Garcia self.wait_until_completed() 131409d5498SAlberto Garcia 132409d5498SAlberto Garcia self.assert_no_active_block_jobs() 133409d5498SAlberto Garcia self.vm.shutdown() 134409d5498SAlberto Garcia 135409d5498SAlberto Garcia self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', test_img), 136409d5498SAlberto Garcia empty_map, 'image file map changed after a no-op') 137409d5498SAlberto Garcia 1386e343609SPaolo Bonzini def test_stream_partial(self): 139ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 1406e343609SPaolo Bonzini 1415e302a7dSAlberto Garcia result = self.vm.qmp('block-stream', device='drive0', base=backing_img) 1426e343609SPaolo Bonzini self.assert_qmp(result, 'return', {}) 1436e343609SPaolo Bonzini 1449974ad40SFam Zheng self.wait_until_completed() 1456e343609SPaolo Bonzini 146ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 1476e343609SPaolo Bonzini self.vm.shutdown() 1486e343609SPaolo Bonzini 14990c9b167SKevin Wolf self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', mid_img), 15090c9b167SKevin Wolf qemu_io('-f', iotests.imgfmt, '-c', 'map', test_img), 1516e343609SPaolo Bonzini 'image file map does not match backing file after streaming') 1526e343609SPaolo Bonzini 15337ce63ebSStefan Hajnoczi def test_device_not_found(self): 154db58f9c0SStefan Hajnoczi result = self.vm.qmp('block-stream', device='nonexistent') 1553f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 1563f92d54cSMax Reitz 'Cannot find device=nonexistent nor node_name=nonexistent') 15737ce63ebSStefan Hajnoczi 1580bb0aea4SKevin Wolf def test_job_id_missing(self): 1590bb0aea4SKevin Wolf result = self.vm.qmp('block-stream', device='mid') 1603f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', "Invalid job ID ''") 1610bb0aea4SKevin Wolf 1620e4a0644SMax Reitz def test_read_only(self): 1630e4a0644SMax Reitz # Create a new file that we can attach (we need a read-only top) 1640e4a0644SMax Reitz with iotests.FilePath('ro-top.img') as ro_top_path: 1650e4a0644SMax Reitz qemu_img('create', '-f', iotests.imgfmt, ro_top_path, 1660e4a0644SMax Reitz str(self.image_len)) 1670e4a0644SMax Reitz 1680e4a0644SMax Reitz result = self.vm.qmp('blockdev-add', 1690e4a0644SMax Reitz node_name='ro-top', 1700e4a0644SMax Reitz driver=iotests.imgfmt, 1710e4a0644SMax Reitz read_only=True, 1720e4a0644SMax Reitz file={ 1730e4a0644SMax Reitz 'driver': 'file', 1740e4a0644SMax Reitz 'filename': ro_top_path, 1750e4a0644SMax Reitz 'read-only': True 1760e4a0644SMax Reitz }, 1770e4a0644SMax Reitz backing='mid') 1780e4a0644SMax Reitz self.assert_qmp(result, 'return', {}) 1790e4a0644SMax Reitz 1800e4a0644SMax Reitz result = self.vm.qmp('block-stream', job_id='stream', 1810e4a0644SMax Reitz device='ro-top', base_node='base') 1820e4a0644SMax Reitz self.assert_qmp(result, 'error/desc', 'Block node is read-only') 1830e4a0644SMax Reitz 1840e4a0644SMax Reitz result = self.vm.qmp('blockdev-del', node_name='ro-top') 1850e4a0644SMax Reitz self.assert_qmp(result, 'return', {}) 1860e4a0644SMax Reitz 187774a8850SStefan Hajnoczi 188c1a34322SAlberto Garciaclass TestParallelOps(iotests.QMPTestCase): 189c1a34322SAlberto Garcia num_ops = 4 # Number of parallel block-stream operations 190c1a34322SAlberto Garcia num_imgs = num_ops * 2 + 1 1917229e121SMax Reitz image_len = num_ops * 4 * 1024 * 1024 192c1a34322SAlberto Garcia imgs = [] 193c1a34322SAlberto Garcia 194c1a34322SAlberto Garcia def setUp(self): 195c1a34322SAlberto Garcia opts = [] 196c1a34322SAlberto Garcia self.imgs = [] 197c1a34322SAlberto Garcia 198c1a34322SAlberto Garcia # Initialize file names and command-line options 199c1a34322SAlberto Garcia for i in range(self.num_imgs): 200c1a34322SAlberto Garcia img_depth = self.num_imgs - i - 1 201c1a34322SAlberto Garcia opts.append("backing." * img_depth + "node-name=node%d" % i) 202c1a34322SAlberto Garcia self.imgs.append(os.path.join(iotests.test_dir, 'img-%d.img' % i)) 203c1a34322SAlberto Garcia 204c1a34322SAlberto Garcia # Create all images 205c1a34322SAlberto Garcia iotests.create_image(self.imgs[0], self.image_len) 206c1a34322SAlberto Garcia for i in range(1, self.num_imgs): 207c1a34322SAlberto Garcia qemu_img('create', '-f', iotests.imgfmt, 208b66ff2c2SEric Blake '-o', 'backing_file=%s' % self.imgs[i-1], 209b66ff2c2SEric Blake '-F', 'raw' if i == 1 else iotests.imgfmt, self.imgs[i]) 210c1a34322SAlberto Garcia 211c1a34322SAlberto Garcia # Put data into the images we are copying data from 21239eaefceSAlberto Garcia odd_img_indexes = [x for x in reversed(range(self.num_imgs)) if x % 2 == 1] 21339eaefceSAlberto Garcia for i in range(len(odd_img_indexes)): 2147229e121SMax Reitz # Alternate between 2MB and 4MB. 215c1a34322SAlberto Garcia # This way jobs will not finish in the same order they were created 2167229e121SMax Reitz num_mb = 2 + 2 * (i % 2) 217c1a34322SAlberto Garcia qemu_io('-f', iotests.imgfmt, 2187229e121SMax Reitz '-c', 'write -P 0xFF %dM %dM' % (i * 4, num_mb), 21939eaefceSAlberto Garcia self.imgs[odd_img_indexes[i]]) 220c1a34322SAlberto Garcia 221c1a34322SAlberto Garcia # Attach the drive to the VM 222c1a34322SAlberto Garcia self.vm = iotests.VM() 223c1a34322SAlberto Garcia self.vm.add_drive(self.imgs[-1], ','.join(opts)) 224c1a34322SAlberto Garcia self.vm.launch() 225c1a34322SAlberto Garcia 226c1a34322SAlberto Garcia def tearDown(self): 227c1a34322SAlberto Garcia self.vm.shutdown() 228c1a34322SAlberto Garcia for img in self.imgs: 229c1a34322SAlberto Garcia os.remove(img) 230c1a34322SAlberto Garcia 231c1a34322SAlberto Garcia # Test that it's possible to run several block-stream operations 232c1a34322SAlberto Garcia # in parallel in the same snapshot chain 23333fe08fcSThomas Huth @unittest.skipIf(os.environ.get('QEMU_CHECK_BLOCK_AUTO'), 'disabled in CI') 234c1a34322SAlberto Garcia def test_stream_parallel(self): 235c1a34322SAlberto Garcia self.assert_no_active_block_jobs() 236c1a34322SAlberto Garcia 237c1a34322SAlberto Garcia # Check that the maps don't match before the streaming operations 238c1a34322SAlberto Garcia for i in range(2, self.num_imgs, 2): 239aca7063aSFam Zheng self.assertNotEqual(qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.imgs[i]), 240aca7063aSFam Zheng qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.imgs[i-1]), 241c1a34322SAlberto Garcia 'image file map matches backing file before streaming') 242c1a34322SAlberto Garcia 243c1a34322SAlberto Garcia # Create all streaming jobs 244c1a34322SAlberto Garcia pending_jobs = [] 245c1a34322SAlberto Garcia for i in range(2, self.num_imgs, 2): 246c1a34322SAlberto Garcia node_name = 'node%d' % i 247c1a34322SAlberto Garcia job_id = 'stream-%s' % node_name 248c1a34322SAlberto Garcia pending_jobs.append(job_id) 249*9126a2dcSVladimir Sementsov-Ogievskiy result = self.vm.qmp('block-stream', device=node_name, 250*9126a2dcSVladimir Sementsov-Ogievskiy job_id=job_id, bottom=f'node{i-1}', 251*9126a2dcSVladimir Sementsov-Ogievskiy speed=1024) 252c1a34322SAlberto Garcia self.assert_qmp(result, 'return', {}) 253c1a34322SAlberto Garcia 2547229e121SMax Reitz for job in pending_jobs: 2557229e121SMax Reitz result = self.vm.qmp('block-job-set-speed', device=job, speed=0) 2567229e121SMax Reitz self.assert_qmp(result, 'return', {}) 2577229e121SMax Reitz 258c1a34322SAlberto Garcia # Wait for all jobs to be finished. 259c1a34322SAlberto Garcia while len(pending_jobs) > 0: 260c1a34322SAlberto Garcia for event in self.vm.get_qmp_events(wait=True): 261c1a34322SAlberto Garcia if event['event'] == 'BLOCK_JOB_COMPLETED': 262c1a34322SAlberto Garcia job_id = self.dictpath(event, 'data/device') 263c1a34322SAlberto Garcia self.assertTrue(job_id in pending_jobs) 264c1a34322SAlberto Garcia self.assert_qmp_absent(event, 'data/error') 265c1a34322SAlberto Garcia pending_jobs.remove(job_id) 266c1a34322SAlberto Garcia 267c1a34322SAlberto Garcia self.assert_no_active_block_jobs() 268c1a34322SAlberto Garcia self.vm.shutdown() 269c1a34322SAlberto Garcia 270c1a34322SAlberto Garcia # Check that all maps match now 271c1a34322SAlberto Garcia for i in range(2, self.num_imgs, 2): 272c1a34322SAlberto Garcia self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', self.imgs[i]), 273c1a34322SAlberto Garcia qemu_io('-f', iotests.imgfmt, '-c', 'map', self.imgs[i-1]), 274c1a34322SAlberto Garcia 'image file map does not match backing file after streaming') 275c1a34322SAlberto Garcia 276eb290b78SAlberto Garcia # Test that it's not possible to perform two block-stream 277eb290b78SAlberto Garcia # operations if there are nodes involved in both. 278eb290b78SAlberto Garcia def test_overlapping_1(self): 279eb290b78SAlberto Garcia self.assert_no_active_block_jobs() 280eb290b78SAlberto Garcia 281eb290b78SAlberto Garcia # Set a speed limit to make sure that this job blocks the rest 282eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node4', job_id='stream-node4', base=self.imgs[1], speed=1024*1024) 283eb290b78SAlberto Garcia self.assert_qmp(result, 'return', {}) 284eb290b78SAlberto Garcia 285eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node5', job_id='stream-node5', base=self.imgs[2]) 2863f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 2873f92d54cSMax Reitz "Node 'node4' is busy: block device is in use by block job: stream") 288eb290b78SAlberto Garcia 289eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node3', job_id='stream-node3', base=self.imgs[2]) 2903f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 2913f92d54cSMax Reitz "Node 'node3' is busy: block device is in use by block job: stream") 292eb290b78SAlberto Garcia 293eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node4', job_id='stream-node4-v2') 2943f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 2953f92d54cSMax Reitz "Node 'node4' is busy: block device is in use by block job: stream") 296eb290b78SAlberto Garcia 297eb290b78SAlberto Garcia # block-commit should also fail if it touches nodes used by the stream job 298eb290b78SAlberto Garcia result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[4], job_id='commit-node4') 2993f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3003f92d54cSMax Reitz "Node 'node4' is busy: block device is in use by block job: stream") 301eb290b78SAlberto Garcia 302eb290b78SAlberto Garcia result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[1], top=self.imgs[3], job_id='commit-node1') 3033f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3043f92d54cSMax Reitz "Node 'node3' is busy: block device is in use by block job: stream") 305eb290b78SAlberto Garcia 306eb290b78SAlberto Garcia # This fails because it needs to modify the backing string in node2, which is blocked 307eb290b78SAlberto Garcia result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[0], top=self.imgs[1], job_id='commit-node0') 3083f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3093f92d54cSMax Reitz "Node 'node2' is busy: block device is in use by block job: stream") 310eb290b78SAlberto Garcia 3117229e121SMax Reitz result = self.vm.qmp('block-job-set-speed', device='stream-node4', speed=0) 3127229e121SMax Reitz self.assert_qmp(result, 'return', {}) 3137229e121SMax Reitz 314eb290b78SAlberto Garcia self.wait_until_completed(drive='stream-node4') 315eb290b78SAlberto Garcia self.assert_no_active_block_jobs() 316eb290b78SAlberto Garcia 317eb290b78SAlberto Garcia # Similar to test_overlapping_1, but with block-commit 318eb290b78SAlberto Garcia # blocking the other jobs 319eb290b78SAlberto Garcia def test_overlapping_2(self): 320eb290b78SAlberto Garcia self.assertLessEqual(9, self.num_imgs) 321eb290b78SAlberto Garcia self.assert_no_active_block_jobs() 322eb290b78SAlberto Garcia 323eb290b78SAlberto Garcia # Set a speed limit to make sure that this job blocks the rest 324eb290b78SAlberto Garcia result = self.vm.qmp('block-commit', device='drive0', top=self.imgs[5], base=self.imgs[3], job_id='commit-node3', speed=1024*1024) 325eb290b78SAlberto Garcia self.assert_qmp(result, 'return', {}) 326eb290b78SAlberto Garcia 327eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node3', job_id='stream-node3') 3283f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3293f92d54cSMax Reitz "Node 'node3' is busy: block device is in use by block job: commit") 330eb290b78SAlberto Garcia 331eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node6', base=self.imgs[2], job_id='stream-node6') 3323f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3333f92d54cSMax Reitz "Node 'node5' is busy: block device is in use by block job: commit") 334eb290b78SAlberto Garcia 335eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node4', base=self.imgs[2], job_id='stream-node4') 3363f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3373f92d54cSMax Reitz "Node 'node4' is busy: block device is in use by block job: commit") 338eb290b78SAlberto Garcia 339eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node6', base=self.imgs[4], job_id='stream-node6-v2') 3403f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3413f92d54cSMax Reitz "Node 'node5' is busy: block device is in use by block job: commit") 342eb290b78SAlberto Garcia 343eb290b78SAlberto Garcia # This fails because block-commit currently blocks the active layer even if it's not used 344eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='drive0', base=self.imgs[5], job_id='stream-drive0') 3453f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3463f92d54cSMax Reitz "Node 'drive0' is busy: block device is in use by block job: commit") 347eb290b78SAlberto Garcia 3487229e121SMax Reitz result = self.vm.qmp('block-job-set-speed', device='commit-node3', speed=0) 3497229e121SMax Reitz self.assert_qmp(result, 'return', {}) 3507229e121SMax Reitz 351eb290b78SAlberto Garcia self.wait_until_completed(drive='commit-node3') 352eb290b78SAlberto Garcia 353eb290b78SAlberto Garcia # Similar to test_overlapping_2, but here block-commit doesn't use the 'top' parameter. 354eb290b78SAlberto Garcia # Internally this uses a mirror block job, hence the separate test case. 355eb290b78SAlberto Garcia def test_overlapping_3(self): 356eb290b78SAlberto Garcia self.assertLessEqual(8, self.num_imgs) 357eb290b78SAlberto Garcia self.assert_no_active_block_jobs() 358eb290b78SAlberto Garcia 359eb290b78SAlberto Garcia # Set a speed limit to make sure that this job blocks the rest 360eb290b78SAlberto Garcia result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[3], job_id='commit-drive0', speed=1024*1024) 361eb290b78SAlberto Garcia self.assert_qmp(result, 'return', {}) 362eb290b78SAlberto Garcia 363eb290b78SAlberto Garcia result = self.vm.qmp('block-stream', device='node5', base=self.imgs[3], job_id='stream-node6') 3643f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3653f92d54cSMax Reitz "Node 'node5' is busy: block device is in use by block job: commit") 366eb290b78SAlberto Garcia 367b1b30ff4SKevin Wolf result = self.vm.qmp('block-job-set-speed', device='commit-drive0', speed=0) 368b1b30ff4SKevin Wolf self.assert_qmp(result, 'return', {}) 369b1b30ff4SKevin Wolf 3701dac83f1SKevin Wolf event = self.vm.event_wait(name='BLOCK_JOB_READY') 371eb290b78SAlberto Garcia self.assert_qmp(event, 'data/device', 'commit-drive0') 372eb290b78SAlberto Garcia self.assert_qmp(event, 'data/type', 'commit') 373eb290b78SAlberto Garcia self.assert_qmp_absent(event, 'data/error') 374eb290b78SAlberto Garcia 375eb290b78SAlberto Garcia result = self.vm.qmp('block-job-complete', device='commit-drive0') 376eb290b78SAlberto Garcia self.assert_qmp(result, 'return', {}) 377eb290b78SAlberto Garcia 378eb290b78SAlberto Garcia self.wait_until_completed(drive='commit-drive0') 379704d59f1SAlberto Garcia 380d20ba603SAlberto Garcia # In this case the base node of the stream job is the same as the 3813f92d54cSMax Reitz # top node of commit job. Since this results in the commit filter 3823f92d54cSMax Reitz # node being part of the stream chain, this is not allowed. 383d20ba603SAlberto Garcia def test_overlapping_4(self): 384d20ba603SAlberto Garcia self.assert_no_active_block_jobs() 385d20ba603SAlberto Garcia 386d20ba603SAlberto Garcia # Commit from node2 into node0 3877229e121SMax Reitz result = self.vm.qmp('block-commit', device='drive0', 3887229e121SMax Reitz top=self.imgs[2], base=self.imgs[0], 3893f92d54cSMax Reitz filter_node_name='commit-filter', speed=1024*1024) 390d20ba603SAlberto Garcia self.assert_qmp(result, 'return', {}) 391d20ba603SAlberto Garcia 392d20ba603SAlberto Garcia # Stream from node2 into node4 393d20ba603SAlberto Garcia result = self.vm.qmp('block-stream', device='node4', base_node='node2', job_id='node4') 3943f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 3953f92d54cSMax Reitz "Cannot freeze 'backing' link to 'commit-filter'") 396d20ba603SAlberto Garcia 3977229e121SMax Reitz result = self.vm.qmp('block-job-set-speed', device='drive0', speed=0) 3987229e121SMax Reitz self.assert_qmp(result, 'return', {}) 3997229e121SMax Reitz 400d20ba603SAlberto Garcia self.wait_until_completed() 401d20ba603SAlberto Garcia self.assert_no_active_block_jobs() 402d20ba603SAlberto Garcia 40313658cd7SMax Reitz # In this case the base node of the stream job is the commit job's 40413658cd7SMax Reitz # filter node. stream does not have a real dependency on its base 40513658cd7SMax Reitz # node, so even though commit removes it when it is done, there is 40613658cd7SMax Reitz # no conflict. 40713658cd7SMax Reitz def test_overlapping_5(self): 40813658cd7SMax Reitz self.assert_no_active_block_jobs() 40913658cd7SMax Reitz 41013658cd7SMax Reitz # Commit from node2 into node0 41113658cd7SMax Reitz result = self.vm.qmp('block-commit', device='drive0', 41213658cd7SMax Reitz top_node='node2', base_node='node0', 41313658cd7SMax Reitz filter_node_name='commit-filter', speed=1024*1024) 41413658cd7SMax Reitz self.assert_qmp(result, 'return', {}) 41513658cd7SMax Reitz 41613658cd7SMax Reitz # Stream from node2 into node4 41713658cd7SMax Reitz result = self.vm.qmp('block-stream', device='node4', 41813658cd7SMax Reitz base_node='commit-filter', job_id='node4') 41913658cd7SMax Reitz self.assert_qmp(result, 'return', {}) 42013658cd7SMax Reitz 42113658cd7SMax Reitz result = self.vm.qmp('block-job-set-speed', device='drive0', speed=0) 42213658cd7SMax Reitz self.assert_qmp(result, 'return', {}) 42313658cd7SMax Reitz 42452ea799eSJohn Snow self.vm.run_job(job='drive0', auto_dismiss=True) 42552ea799eSJohn Snow self.vm.run_job(job='node4', auto_dismiss=True) 42613658cd7SMax Reitz self.assert_no_active_block_jobs() 42713658cd7SMax Reitz 428704d59f1SAlberto Garcia # Test a block-stream and a block-commit job in parallel 42939eaefceSAlberto Garcia # Here the stream job is supposed to finish quickly in order to reproduce 43039eaefceSAlberto Garcia # the scenario that triggers the bug fixed in 3d5d319e1221 and 1a63a907507 43139eaefceSAlberto Garcia def test_stream_commit_1(self): 432704d59f1SAlberto Garcia self.assertLessEqual(8, self.num_imgs) 433704d59f1SAlberto Garcia self.assert_no_active_block_jobs() 434704d59f1SAlberto Garcia 435704d59f1SAlberto Garcia # Stream from node0 into node2 43639eaefceSAlberto Garcia result = self.vm.qmp('block-stream', device='node2', base_node='node0', job_id='node2') 437704d59f1SAlberto Garcia self.assert_qmp(result, 'return', {}) 438704d59f1SAlberto Garcia 439704d59f1SAlberto Garcia # Commit from the active layer into node3 440704d59f1SAlberto Garcia result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[3]) 441704d59f1SAlberto Garcia self.assert_qmp(result, 'return', {}) 442704d59f1SAlberto Garcia 443704d59f1SAlberto Garcia # Wait for all jobs to be finished. 444704d59f1SAlberto Garcia pending_jobs = ['node2', 'drive0'] 445704d59f1SAlberto Garcia while len(pending_jobs) > 0: 446704d59f1SAlberto Garcia for event in self.vm.get_qmp_events(wait=True): 447704d59f1SAlberto Garcia if event['event'] == 'BLOCK_JOB_COMPLETED': 448704d59f1SAlberto Garcia node_name = self.dictpath(event, 'data/device') 449704d59f1SAlberto Garcia self.assertTrue(node_name in pending_jobs) 450704d59f1SAlberto Garcia self.assert_qmp_absent(event, 'data/error') 451704d59f1SAlberto Garcia pending_jobs.remove(node_name) 452704d59f1SAlberto Garcia if event['event'] == 'BLOCK_JOB_READY': 453704d59f1SAlberto Garcia self.assert_qmp(event, 'data/device', 'drive0') 454704d59f1SAlberto Garcia self.assert_qmp(event, 'data/type', 'commit') 455704d59f1SAlberto Garcia self.assert_qmp_absent(event, 'data/error') 456704d59f1SAlberto Garcia self.assertTrue('drive0' in pending_jobs) 457704d59f1SAlberto Garcia self.vm.qmp('block-job-complete', device='drive0') 458704d59f1SAlberto Garcia 459eb290b78SAlberto Garcia self.assert_no_active_block_jobs() 460eb290b78SAlberto Garcia 46139eaefceSAlberto Garcia # This is similar to test_stream_commit_1 but both jobs are slowed 46239eaefceSAlberto Garcia # down so they can run in parallel for a little while. 46339eaefceSAlberto Garcia def test_stream_commit_2(self): 46439eaefceSAlberto Garcia self.assertLessEqual(8, self.num_imgs) 46539eaefceSAlberto Garcia self.assert_no_active_block_jobs() 46639eaefceSAlberto Garcia 46739eaefceSAlberto Garcia # Stream from node0 into node4 46839eaefceSAlberto Garcia result = self.vm.qmp('block-stream', device='node4', base_node='node0', job_id='node4', speed=1024*1024) 46939eaefceSAlberto Garcia self.assert_qmp(result, 'return', {}) 47039eaefceSAlberto Garcia 47139eaefceSAlberto Garcia # Commit from the active layer into node5 47239eaefceSAlberto Garcia result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[5], speed=1024*1024) 47339eaefceSAlberto Garcia self.assert_qmp(result, 'return', {}) 47439eaefceSAlberto Garcia 4757229e121SMax Reitz for job in ['drive0', 'node4']: 4767229e121SMax Reitz result = self.vm.qmp('block-job-set-speed', device=job, speed=0) 4777229e121SMax Reitz self.assert_qmp(result, 'return', {}) 4787229e121SMax Reitz 47939eaefceSAlberto Garcia # Wait for all jobs to be finished. 48039eaefceSAlberto Garcia pending_jobs = ['node4', 'drive0'] 48139eaefceSAlberto Garcia while len(pending_jobs) > 0: 48239eaefceSAlberto Garcia for event in self.vm.get_qmp_events(wait=True): 48339eaefceSAlberto Garcia if event['event'] == 'BLOCK_JOB_COMPLETED': 48439eaefceSAlberto Garcia node_name = self.dictpath(event, 'data/device') 48539eaefceSAlberto Garcia self.assertTrue(node_name in pending_jobs) 48639eaefceSAlberto Garcia self.assert_qmp_absent(event, 'data/error') 48739eaefceSAlberto Garcia pending_jobs.remove(node_name) 48839eaefceSAlberto Garcia if event['event'] == 'BLOCK_JOB_READY': 48939eaefceSAlberto Garcia self.assert_qmp(event, 'data/device', 'drive0') 49039eaefceSAlberto Garcia self.assert_qmp(event, 'data/type', 'commit') 49139eaefceSAlberto Garcia self.assert_qmp_absent(event, 'data/error') 49239eaefceSAlberto Garcia self.assertTrue('drive0' in pending_jobs) 49339eaefceSAlberto Garcia self.vm.qmp('block-job-complete', device='drive0') 49439eaefceSAlberto Garcia 49539eaefceSAlberto Garcia self.assert_no_active_block_jobs() 49639eaefceSAlberto Garcia 4977eb13c9dSAlberto Garcia # Test the base_node parameter 4987eb13c9dSAlberto Garcia def test_stream_base_node_name(self): 4997eb13c9dSAlberto Garcia self.assert_no_active_block_jobs() 5007eb13c9dSAlberto Garcia 501aca7063aSFam Zheng self.assertNotEqual(qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.imgs[4]), 502aca7063aSFam Zheng qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.imgs[3]), 5037eb13c9dSAlberto Garcia 'image file map matches backing file before streaming') 5047eb13c9dSAlberto Garcia 5057eb13c9dSAlberto Garcia # Error: the base node does not exist 5067eb13c9dSAlberto Garcia result = self.vm.qmp('block-stream', device='node4', base_node='none', job_id='stream') 5073f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 5083f92d54cSMax Reitz 'Cannot find device= nor node_name=none') 5097eb13c9dSAlberto Garcia 5107eb13c9dSAlberto Garcia # Error: the base node is not a backing file of the top node 5117eb13c9dSAlberto Garcia result = self.vm.qmp('block-stream', device='node4', base_node='node6', job_id='stream') 5123f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 5133f92d54cSMax Reitz "Node 'node6' is not a backing image of 'node4'") 5147eb13c9dSAlberto Garcia 5157eb13c9dSAlberto Garcia # Error: the base node is the same as the top node 5167eb13c9dSAlberto Garcia result = self.vm.qmp('block-stream', device='node4', base_node='node4', job_id='stream') 5173f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 5183f92d54cSMax Reitz "Node 'node4' is not a backing image of 'node4'") 5197eb13c9dSAlberto Garcia 5207eb13c9dSAlberto Garcia # Error: cannot specify 'base' and 'base-node' at the same time 5217eb13c9dSAlberto Garcia result = self.vm.qmp('block-stream', device='node4', base=self.imgs[2], base_node='node2', job_id='stream') 5223f92d54cSMax Reitz self.assert_qmp(result, 'error/desc', 5233f92d54cSMax Reitz "'base' and 'base-node' cannot be specified at the same time") 5247eb13c9dSAlberto Garcia 5257eb13c9dSAlberto Garcia # Success: the base node is a backing file of the top node 5267eb13c9dSAlberto Garcia result = self.vm.qmp('block-stream', device='node4', base_node='node2', job_id='stream') 5277eb13c9dSAlberto Garcia self.assert_qmp(result, 'return', {}) 5287eb13c9dSAlberto Garcia 5297eb13c9dSAlberto Garcia self.wait_until_completed(drive='stream') 5307eb13c9dSAlberto Garcia 5317eb13c9dSAlberto Garcia self.assert_no_active_block_jobs() 5327eb13c9dSAlberto Garcia self.vm.shutdown() 5337eb13c9dSAlberto Garcia 5347eb13c9dSAlberto Garcia self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', self.imgs[4]), 5357eb13c9dSAlberto Garcia qemu_io('-f', iotests.imgfmt, '-c', 'map', self.imgs[3]), 5367eb13c9dSAlberto Garcia 'image file map matches backing file after streaming') 5377eb13c9dSAlberto Garcia 53848361afbSAlberto Garciaclass TestQuorum(iotests.QMPTestCase): 53948361afbSAlberto Garcia num_children = 3 54048361afbSAlberto Garcia children = [] 54148361afbSAlberto Garcia backing = [] 54248361afbSAlberto Garcia 5439442bebeSThomas Huth @iotests.skip_if_unsupported(['quorum']) 54448361afbSAlberto Garcia def setUp(self): 54548361afbSAlberto Garcia opts = ['driver=quorum', 'vote-threshold=2'] 54648361afbSAlberto Garcia 54748361afbSAlberto Garcia # Initialize file names and command-line options 54848361afbSAlberto Garcia for i in range(self.num_children): 54948361afbSAlberto Garcia child_img = os.path.join(iotests.test_dir, 'img-%d.img' % i) 55048361afbSAlberto Garcia backing_img = os.path.join(iotests.test_dir, 'backing-%d.img' % i) 55148361afbSAlberto Garcia self.children.append(child_img) 55248361afbSAlberto Garcia self.backing.append(backing_img) 55348361afbSAlberto Garcia qemu_img('create', '-f', iotests.imgfmt, backing_img, '1M') 55448361afbSAlberto Garcia qemu_io('-f', iotests.imgfmt, 55548361afbSAlberto Garcia '-c', 'write -P 0x55 0 1024', backing_img) 55648361afbSAlberto Garcia qemu_img('create', '-f', iotests.imgfmt, 557b66ff2c2SEric Blake '-o', 'backing_file=%s' % backing_img, 558b66ff2c2SEric Blake '-F', iotests.imgfmt, child_img) 55948361afbSAlberto Garcia opts.append("children.%d.file.filename=%s" % (i, child_img)) 56048361afbSAlberto Garcia opts.append("children.%d.node-name=node%d" % (i, i)) 56148361afbSAlberto Garcia 56248361afbSAlberto Garcia # Attach the drive to the VM 56348361afbSAlberto Garcia self.vm = iotests.VM() 56448361afbSAlberto Garcia self.vm.add_drive(path = None, opts = ','.join(opts)) 56548361afbSAlberto Garcia self.vm.launch() 56648361afbSAlberto Garcia 56748361afbSAlberto Garcia def tearDown(self): 56848361afbSAlberto Garcia self.vm.shutdown() 56948361afbSAlberto Garcia for img in self.children: 57048361afbSAlberto Garcia os.remove(img) 57148361afbSAlberto Garcia for img in self.backing: 57248361afbSAlberto Garcia os.remove(img) 57348361afbSAlberto Garcia 57448361afbSAlberto Garcia def test_stream_quorum(self): 575aca7063aSFam Zheng self.assertNotEqual(qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.children[0]), 576aca7063aSFam Zheng qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.backing[0]), 57748361afbSAlberto Garcia 'image file map matches backing file before streaming') 57848361afbSAlberto Garcia 57948361afbSAlberto Garcia self.assert_no_active_block_jobs() 58048361afbSAlberto Garcia 58148361afbSAlberto Garcia result = self.vm.qmp('block-stream', device='node0', job_id='stream-node0') 58248361afbSAlberto Garcia self.assert_qmp(result, 'return', {}) 58348361afbSAlberto Garcia 58448361afbSAlberto Garcia self.wait_until_completed(drive='stream-node0') 58548361afbSAlberto Garcia 58648361afbSAlberto Garcia self.assert_no_active_block_jobs() 58748361afbSAlberto Garcia self.vm.shutdown() 58848361afbSAlberto Garcia 58948361afbSAlberto Garcia self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', self.children[0]), 59048361afbSAlberto Garcia qemu_io('-f', iotests.imgfmt, '-c', 'map', self.backing[0]), 59148361afbSAlberto Garcia 'image file map does not match backing file after streaming') 59248361afbSAlberto Garcia 5932499a096SStefan Hajnocziclass TestSmallerBackingFile(iotests.QMPTestCase): 594774a8850SStefan Hajnoczi backing_len = 1 * 1024 * 1024 # MB 595774a8850SStefan Hajnoczi image_len = 2 * backing_len 596774a8850SStefan Hajnoczi 597774a8850SStefan Hajnoczi def setUp(self): 5982499a096SStefan Hajnoczi iotests.create_image(backing_img, self.backing_len) 599b66ff2c2SEric Blake qemu_img('create', '-f', iotests.imgfmt, 600b66ff2c2SEric Blake '-o', 'backing_file=%s' % backing_img, 601b66ff2c2SEric Blake '-F', 'raw', test_img, str(self.image_len)) 602774a8850SStefan Hajnoczi self.vm = iotests.VM().add_drive(test_img) 603774a8850SStefan Hajnoczi self.vm.launch() 604774a8850SStefan Hajnoczi 605774a8850SStefan Hajnoczi # If this hangs, then you are missing a fix to complete streaming when the 606774a8850SStefan Hajnoczi # end of the backing file is reached. 607774a8850SStefan Hajnoczi def test_stream(self): 608ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 609774a8850SStefan Hajnoczi 610774a8850SStefan Hajnoczi result = self.vm.qmp('block-stream', device='drive0') 611774a8850SStefan Hajnoczi self.assert_qmp(result, 'return', {}) 612774a8850SStefan Hajnoczi 6139974ad40SFam Zheng self.wait_until_completed() 614774a8850SStefan Hajnoczi 615ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 616774a8850SStefan Hajnoczi self.vm.shutdown() 617774a8850SStefan Hajnoczi 6182499a096SStefan Hajnocziclass TestErrors(iotests.QMPTestCase): 61990f0b711SPaolo Bonzini image_len = 2 * 1024 * 1024 # MB 62090f0b711SPaolo Bonzini 62190f0b711SPaolo Bonzini # this should match STREAM_BUFFER_SIZE/512 in block/stream.c 62290f0b711SPaolo Bonzini STREAM_BUFFER_SIZE = 512 * 1024 62390f0b711SPaolo Bonzini 62490f0b711SPaolo Bonzini def create_blkdebug_file(self, name, event, errno): 62590f0b711SPaolo Bonzini file = open(name, 'w') 62690f0b711SPaolo Bonzini file.write(''' 62790f0b711SPaolo Bonzini[inject-error] 62890f0b711SPaolo Bonzinistate = "1" 62990f0b711SPaolo Bonzinievent = "%s" 63090f0b711SPaolo Bonzinierrno = "%d" 63190f0b711SPaolo Bonziniimmediately = "off" 63290f0b711SPaolo Bonzinionce = "on" 63390f0b711SPaolo Bonzinisector = "%d" 63490f0b711SPaolo Bonzini 63590f0b711SPaolo Bonzini[set-state] 63690f0b711SPaolo Bonzinistate = "1" 63790f0b711SPaolo Bonzinievent = "%s" 63890f0b711SPaolo Bonzininew_state = "2" 63990f0b711SPaolo Bonzini 64090f0b711SPaolo Bonzini[set-state] 64190f0b711SPaolo Bonzinistate = "2" 64290f0b711SPaolo Bonzinievent = "%s" 64390f0b711SPaolo Bonzininew_state = "1" 6449a3a9a63SMax Reitz''' % (event, errno, self.STREAM_BUFFER_SIZE // 512, event, event)) 64590f0b711SPaolo Bonzini file.close() 64690f0b711SPaolo Bonzini 64790f0b711SPaolo Bonziniclass TestEIO(TestErrors): 64890f0b711SPaolo Bonzini def setUp(self): 64990f0b711SPaolo Bonzini self.blkdebug_file = backing_img + ".blkdebug" 6502499a096SStefan Hajnoczi iotests.create_image(backing_img, TestErrors.image_len) 65190f0b711SPaolo Bonzini self.create_blkdebug_file(self.blkdebug_file, "read_aio", 5) 65290f0b711SPaolo Bonzini qemu_img('create', '-f', iotests.imgfmt, 65390f0b711SPaolo Bonzini '-o', 'backing_file=blkdebug:%s:%s,backing_fmt=raw' 65490f0b711SPaolo Bonzini % (self.blkdebug_file, backing_img), 65590f0b711SPaolo Bonzini test_img) 65690f0b711SPaolo Bonzini self.vm = iotests.VM().add_drive(test_img) 65790f0b711SPaolo Bonzini self.vm.launch() 65890f0b711SPaolo Bonzini 65990f0b711SPaolo Bonzini def tearDown(self): 66090f0b711SPaolo Bonzini self.vm.shutdown() 66190f0b711SPaolo Bonzini os.remove(test_img) 66290f0b711SPaolo Bonzini os.remove(backing_img) 66390f0b711SPaolo Bonzini os.remove(self.blkdebug_file) 66490f0b711SPaolo Bonzini 66590f0b711SPaolo Bonzini def test_report(self): 666ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 66790f0b711SPaolo Bonzini 66890f0b711SPaolo Bonzini result = self.vm.qmp('block-stream', device='drive0') 66990f0b711SPaolo Bonzini self.assert_qmp(result, 'return', {}) 67090f0b711SPaolo Bonzini 67190f0b711SPaolo Bonzini completed = False 67290f0b711SPaolo Bonzini error = False 67390f0b711SPaolo Bonzini while not completed: 67490f0b711SPaolo Bonzini for event in self.vm.get_qmp_events(wait=True): 67590f0b711SPaolo Bonzini if event['event'] == 'BLOCK_JOB_ERROR': 67690f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 67790f0b711SPaolo Bonzini self.assert_qmp(event, 'data/operation', 'read') 67890f0b711SPaolo Bonzini error = True 67990f0b711SPaolo Bonzini elif event['event'] == 'BLOCK_JOB_COMPLETED': 68090f0b711SPaolo Bonzini self.assertTrue(error, 'job completed unexpectedly') 68190f0b711SPaolo Bonzini self.assert_qmp(event, 'data/type', 'stream') 68290f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 68390f0b711SPaolo Bonzini self.assert_qmp(event, 'data/error', 'Input/output error') 68490f0b711SPaolo Bonzini self.assert_qmp(event, 'data/offset', self.STREAM_BUFFER_SIZE) 68590f0b711SPaolo Bonzini self.assert_qmp(event, 'data/len', self.image_len) 68690f0b711SPaolo Bonzini completed = True 6871dac83f1SKevin Wolf elif event['event'] == 'JOB_STATUS_CHANGE': 6881dac83f1SKevin Wolf self.assert_qmp(event, 'data/id', 'drive0') 68990f0b711SPaolo Bonzini 690ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 69190f0b711SPaolo Bonzini self.vm.shutdown() 69290f0b711SPaolo Bonzini 69390f0b711SPaolo Bonzini def test_ignore(self): 694ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 69590f0b711SPaolo Bonzini 69690f0b711SPaolo Bonzini result = self.vm.qmp('block-stream', device='drive0', on_error='ignore') 69790f0b711SPaolo Bonzini self.assert_qmp(result, 'return', {}) 69890f0b711SPaolo Bonzini 69990f0b711SPaolo Bonzini error = False 70090f0b711SPaolo Bonzini completed = False 70190f0b711SPaolo Bonzini while not completed: 70290f0b711SPaolo Bonzini for event in self.vm.get_qmp_events(wait=True): 70390f0b711SPaolo Bonzini if event['event'] == 'BLOCK_JOB_ERROR': 7042c3b44daSJohn Snow error = True 70590f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 70690f0b711SPaolo Bonzini self.assert_qmp(event, 'data/operation', 'read') 70790f0b711SPaolo Bonzini result = self.vm.qmp('query-block-jobs') 7082c3b44daSJohn Snow if result == {'return': []}: 7092c3b44daSJohn Snow # Job finished too quickly 7102c3b44daSJohn Snow continue 71190f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/paused', False) 71290f0b711SPaolo Bonzini elif event['event'] == 'BLOCK_JOB_COMPLETED': 71390f0b711SPaolo Bonzini self.assertTrue(error, 'job completed unexpectedly') 71490f0b711SPaolo Bonzini self.assert_qmp(event, 'data/type', 'stream') 71590f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 71690f0b711SPaolo Bonzini self.assert_qmp(event, 'data/error', 'Input/output error') 71790f0b711SPaolo Bonzini self.assert_qmp(event, 'data/offset', self.image_len) 71890f0b711SPaolo Bonzini self.assert_qmp(event, 'data/len', self.image_len) 71990f0b711SPaolo Bonzini completed = True 7201dac83f1SKevin Wolf elif event['event'] == 'JOB_STATUS_CHANGE': 7211dac83f1SKevin Wolf self.assert_qmp(event, 'data/id', 'drive0') 72290f0b711SPaolo Bonzini 723ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 72490f0b711SPaolo Bonzini self.vm.shutdown() 72590f0b711SPaolo Bonzini 72690f0b711SPaolo Bonzini def test_stop(self): 727ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 72890f0b711SPaolo Bonzini 72990f0b711SPaolo Bonzini result = self.vm.qmp('block-stream', device='drive0', on_error='stop') 73090f0b711SPaolo Bonzini self.assert_qmp(result, 'return', {}) 73190f0b711SPaolo Bonzini 73290f0b711SPaolo Bonzini error = False 73390f0b711SPaolo Bonzini completed = False 73490f0b711SPaolo Bonzini while not completed: 73590f0b711SPaolo Bonzini for event in self.vm.get_qmp_events(wait=True): 73690f0b711SPaolo Bonzini if event['event'] == 'BLOCK_JOB_ERROR': 73701809194SJohn Snow error = True 73890f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 73990f0b711SPaolo Bonzini self.assert_qmp(event, 'data/operation', 'read') 74090f0b711SPaolo Bonzini 74190f0b711SPaolo Bonzini result = self.vm.qmp('query-block-jobs') 74290f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/paused', True) 74390f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/offset', self.STREAM_BUFFER_SIZE) 74490f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/io-status', 'failed') 74590f0b711SPaolo Bonzini 74690f0b711SPaolo Bonzini result = self.vm.qmp('block-job-resume', device='drive0') 74790f0b711SPaolo Bonzini self.assert_qmp(result, 'return', {}) 74890f0b711SPaolo Bonzini 74990f0b711SPaolo Bonzini result = self.vm.qmp('query-block-jobs') 75001809194SJohn Snow if result == {'return': []}: 75101809194SJohn Snow # Race; likely already finished. Check. 75201809194SJohn Snow continue 75390f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/paused', False) 75490f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/io-status', 'ok') 75590f0b711SPaolo Bonzini elif event['event'] == 'BLOCK_JOB_COMPLETED': 75690f0b711SPaolo Bonzini self.assertTrue(error, 'job completed unexpectedly') 75790f0b711SPaolo Bonzini self.assert_qmp(event, 'data/type', 'stream') 75890f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 75990f0b711SPaolo Bonzini self.assert_qmp_absent(event, 'data/error') 76090f0b711SPaolo Bonzini self.assert_qmp(event, 'data/offset', self.image_len) 76190f0b711SPaolo Bonzini self.assert_qmp(event, 'data/len', self.image_len) 76290f0b711SPaolo Bonzini completed = True 7631dac83f1SKevin Wolf elif event['event'] == 'JOB_STATUS_CHANGE': 7641dac83f1SKevin Wolf self.assert_qmp(event, 'data/id', 'drive0') 76590f0b711SPaolo Bonzini 766ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 76790f0b711SPaolo Bonzini self.vm.shutdown() 76890f0b711SPaolo Bonzini 76990f0b711SPaolo Bonzini def test_enospc(self): 770ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 77190f0b711SPaolo Bonzini 77290f0b711SPaolo Bonzini result = self.vm.qmp('block-stream', device='drive0', on_error='enospc') 77390f0b711SPaolo Bonzini self.assert_qmp(result, 'return', {}) 77490f0b711SPaolo Bonzini 77590f0b711SPaolo Bonzini completed = False 77690f0b711SPaolo Bonzini error = False 77790f0b711SPaolo Bonzini while not completed: 77890f0b711SPaolo Bonzini for event in self.vm.get_qmp_events(wait=True): 77990f0b711SPaolo Bonzini if event['event'] == 'BLOCK_JOB_ERROR': 78090f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 78190f0b711SPaolo Bonzini self.assert_qmp(event, 'data/operation', 'read') 78290f0b711SPaolo Bonzini error = True 78390f0b711SPaolo Bonzini elif event['event'] == 'BLOCK_JOB_COMPLETED': 78490f0b711SPaolo Bonzini self.assertTrue(error, 'job completed unexpectedly') 78590f0b711SPaolo Bonzini self.assert_qmp(event, 'data/type', 'stream') 78690f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 78790f0b711SPaolo Bonzini self.assert_qmp(event, 'data/error', 'Input/output error') 78890f0b711SPaolo Bonzini self.assert_qmp(event, 'data/offset', self.STREAM_BUFFER_SIZE) 78990f0b711SPaolo Bonzini self.assert_qmp(event, 'data/len', self.image_len) 79090f0b711SPaolo Bonzini completed = True 7911dac83f1SKevin Wolf elif event['event'] == 'JOB_STATUS_CHANGE': 7921dac83f1SKevin Wolf self.assert_qmp(event, 'data/id', 'drive0') 79390f0b711SPaolo Bonzini 794ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 79590f0b711SPaolo Bonzini self.vm.shutdown() 79690f0b711SPaolo Bonzini 79790f0b711SPaolo Bonziniclass TestENOSPC(TestErrors): 79890f0b711SPaolo Bonzini def setUp(self): 79990f0b711SPaolo Bonzini self.blkdebug_file = backing_img + ".blkdebug" 8002499a096SStefan Hajnoczi iotests.create_image(backing_img, TestErrors.image_len) 80190f0b711SPaolo Bonzini self.create_blkdebug_file(self.blkdebug_file, "read_aio", 28) 80290f0b711SPaolo Bonzini qemu_img('create', '-f', iotests.imgfmt, 80390f0b711SPaolo Bonzini '-o', 'backing_file=blkdebug:%s:%s,backing_fmt=raw' 80490f0b711SPaolo Bonzini % (self.blkdebug_file, backing_img), 80590f0b711SPaolo Bonzini test_img) 80690f0b711SPaolo Bonzini self.vm = iotests.VM().add_drive(test_img) 80790f0b711SPaolo Bonzini self.vm.launch() 80890f0b711SPaolo Bonzini 80990f0b711SPaolo Bonzini def tearDown(self): 81090f0b711SPaolo Bonzini self.vm.shutdown() 81190f0b711SPaolo Bonzini os.remove(test_img) 81290f0b711SPaolo Bonzini os.remove(backing_img) 81390f0b711SPaolo Bonzini os.remove(self.blkdebug_file) 81490f0b711SPaolo Bonzini 81590f0b711SPaolo Bonzini def test_enospc(self): 816ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 81790f0b711SPaolo Bonzini 81890f0b711SPaolo Bonzini result = self.vm.qmp('block-stream', device='drive0', on_error='enospc') 81990f0b711SPaolo Bonzini self.assert_qmp(result, 'return', {}) 82090f0b711SPaolo Bonzini 82190f0b711SPaolo Bonzini error = False 82290f0b711SPaolo Bonzini completed = False 82390f0b711SPaolo Bonzini while not completed: 82490f0b711SPaolo Bonzini for event in self.vm.get_qmp_events(wait=True): 82590f0b711SPaolo Bonzini if event['event'] == 'BLOCK_JOB_ERROR': 82690f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 82790f0b711SPaolo Bonzini self.assert_qmp(event, 'data/operation', 'read') 828dca9b6a2SMax Reitz error = True 82990f0b711SPaolo Bonzini 83090f0b711SPaolo Bonzini result = self.vm.qmp('query-block-jobs') 83190f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/paused', True) 83290f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/offset', self.STREAM_BUFFER_SIZE) 83390f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/io-status', 'nospace') 83490f0b711SPaolo Bonzini 83590f0b711SPaolo Bonzini result = self.vm.qmp('block-job-resume', device='drive0') 83690f0b711SPaolo Bonzini self.assert_qmp(result, 'return', {}) 83790f0b711SPaolo Bonzini 83890f0b711SPaolo Bonzini result = self.vm.qmp('query-block-jobs') 839dca9b6a2SMax Reitz if result == {'return': []}: 840dca9b6a2SMax Reitz # Race; likely already finished. Check. 841dca9b6a2SMax Reitz continue 84290f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/paused', False) 84390f0b711SPaolo Bonzini self.assert_qmp(result, 'return[0]/io-status', 'ok') 84490f0b711SPaolo Bonzini elif event['event'] == 'BLOCK_JOB_COMPLETED': 84590f0b711SPaolo Bonzini self.assertTrue(error, 'job completed unexpectedly') 84690f0b711SPaolo Bonzini self.assert_qmp(event, 'data/type', 'stream') 84790f0b711SPaolo Bonzini self.assert_qmp(event, 'data/device', 'drive0') 84890f0b711SPaolo Bonzini self.assert_qmp_absent(event, 'data/error') 84990f0b711SPaolo Bonzini self.assert_qmp(event, 'data/offset', self.image_len) 85090f0b711SPaolo Bonzini self.assert_qmp(event, 'data/len', self.image_len) 85190f0b711SPaolo Bonzini completed = True 8521dac83f1SKevin Wolf elif event['event'] == 'JOB_STATUS_CHANGE': 8531dac83f1SKevin Wolf self.assert_qmp(event, 'data/id', 'drive0') 85490f0b711SPaolo Bonzini 855ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 85690f0b711SPaolo Bonzini self.vm.shutdown() 857774a8850SStefan Hajnoczi 8582499a096SStefan Hajnocziclass TestStreamStop(iotests.QMPTestCase): 85937ce63ebSStefan Hajnoczi image_len = 8 * 1024 * 1024 * 1024 # GB 86037ce63ebSStefan Hajnoczi 86137ce63ebSStefan Hajnoczi def setUp(self): 86237ce63ebSStefan Hajnoczi qemu_img('create', backing_img, str(TestStreamStop.image_len)) 86390c9b167SKevin Wolf qemu_io('-f', 'raw', '-c', 'write -P 0x1 0 32M', backing_img) 864b66ff2c2SEric Blake qemu_img('create', '-f', iotests.imgfmt, 865b66ff2c2SEric Blake '-o', 'backing_file=%s' % backing_img, 866b66ff2c2SEric Blake '-F', 'raw', test_img) 86790c9b167SKevin Wolf qemu_io('-f', iotests.imgfmt, '-c', 'write -P 0x1 32M 32M', test_img) 868b59b3d57SFam Zheng self.vm = iotests.VM().add_drive("blkdebug::" + test_img) 86937ce63ebSStefan Hajnoczi self.vm.launch() 87037ce63ebSStefan Hajnoczi 87137ce63ebSStefan Hajnoczi def tearDown(self): 87237ce63ebSStefan Hajnoczi self.vm.shutdown() 87337ce63ebSStefan Hajnoczi os.remove(test_img) 87437ce63ebSStefan Hajnoczi os.remove(backing_img) 87537ce63ebSStefan Hajnoczi 87637ce63ebSStefan Hajnoczi def test_stream_stop(self): 877ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 87837ce63ebSStefan Hajnoczi 879b59b3d57SFam Zheng self.vm.pause_drive('drive0') 880db58f9c0SStefan Hajnoczi result = self.vm.qmp('block-stream', device='drive0') 88137ce63ebSStefan Hajnoczi self.assert_qmp(result, 'return', {}) 88237ce63ebSStefan Hajnoczi 8830fd05e8dSPaolo Bonzini time.sleep(0.1) 88437ce63ebSStefan Hajnoczi events = self.vm.get_qmp_events(wait=False) 8851dac83f1SKevin Wolf for e in events: 8861dac83f1SKevin Wolf self.assert_qmp(e, 'event', 'JOB_STATUS_CHANGE') 8871dac83f1SKevin Wolf self.assert_qmp(e, 'data/id', 'drive0') 88837ce63ebSStefan Hajnoczi 889b59b3d57SFam Zheng self.cancel_and_wait(resume=True) 89037ce63ebSStefan Hajnoczi 8912499a096SStefan Hajnocziclass TestSetSpeed(iotests.QMPTestCase): 89237ce63ebSStefan Hajnoczi image_len = 80 * 1024 * 1024 # MB 89337ce63ebSStefan Hajnoczi 89437ce63ebSStefan Hajnoczi def setUp(self): 89537ce63ebSStefan Hajnoczi qemu_img('create', backing_img, str(TestSetSpeed.image_len)) 89690c9b167SKevin Wolf qemu_io('-f', 'raw', '-c', 'write -P 0x1 0 32M', backing_img) 897b66ff2c2SEric Blake qemu_img('create', '-f', iotests.imgfmt, 898b66ff2c2SEric Blake '-o', 'backing_file=%s' % backing_img, 899b66ff2c2SEric Blake '-F', 'raw', test_img) 90090c9b167SKevin Wolf qemu_io('-f', iotests.imgfmt, '-c', 'write -P 0x1 32M 32M', test_img) 901b59b3d57SFam Zheng self.vm = iotests.VM().add_drive('blkdebug::' + test_img) 90237ce63ebSStefan Hajnoczi self.vm.launch() 90337ce63ebSStefan Hajnoczi 90437ce63ebSStefan Hajnoczi def tearDown(self): 90537ce63ebSStefan Hajnoczi self.vm.shutdown() 90637ce63ebSStefan Hajnoczi os.remove(test_img) 90737ce63ebSStefan Hajnoczi os.remove(backing_img) 90837ce63ebSStefan Hajnoczi 909e425306aSStefan Hajnoczi # This is a short performance test which is not run by default. 910e425306aSStefan Hajnoczi # Invoke "IMGFMT=qed ./030 TestSetSpeed.perf_test_throughput" 911e425306aSStefan Hajnoczi def perf_test_throughput(self): 912ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 91337ce63ebSStefan Hajnoczi 914db58f9c0SStefan Hajnoczi result = self.vm.qmp('block-stream', device='drive0') 91537ce63ebSStefan Hajnoczi self.assert_qmp(result, 'return', {}) 91637ce63ebSStefan Hajnoczi 917e425306aSStefan Hajnoczi result = self.vm.qmp('block-job-set-speed', device='drive0', speed=8 * 1024 * 1024) 91837ce63ebSStefan Hajnoczi self.assert_qmp(result, 'return', {}) 91937ce63ebSStefan Hajnoczi 9209974ad40SFam Zheng self.wait_until_completed() 92137ce63ebSStefan Hajnoczi 922ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 92337ce63ebSStefan Hajnoczi 924e425306aSStefan Hajnoczi def test_set_speed(self): 925ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 926e425306aSStefan Hajnoczi 927b59b3d57SFam Zheng self.vm.pause_drive('drive0') 928e425306aSStefan Hajnoczi result = self.vm.qmp('block-stream', device='drive0') 929e425306aSStefan Hajnoczi self.assert_qmp(result, 'return', {}) 930e425306aSStefan Hajnoczi 931e425306aSStefan Hajnoczi # Default speed is 0 932e425306aSStefan Hajnoczi result = self.vm.qmp('query-block-jobs') 933e425306aSStefan Hajnoczi self.assert_qmp(result, 'return[0]/device', 'drive0') 934e425306aSStefan Hajnoczi self.assert_qmp(result, 'return[0]/speed', 0) 935e425306aSStefan Hajnoczi 936e425306aSStefan Hajnoczi result = self.vm.qmp('block-job-set-speed', device='drive0', speed=8 * 1024 * 1024) 937e425306aSStefan Hajnoczi self.assert_qmp(result, 'return', {}) 938e425306aSStefan Hajnoczi 939e425306aSStefan Hajnoczi # Ensure the speed we set was accepted 940e425306aSStefan Hajnoczi result = self.vm.qmp('query-block-jobs') 941e425306aSStefan Hajnoczi self.assert_qmp(result, 'return[0]/device', 'drive0') 942e425306aSStefan Hajnoczi self.assert_qmp(result, 'return[0]/speed', 8 * 1024 * 1024) 943e425306aSStefan Hajnoczi 944b59b3d57SFam Zheng self.cancel_and_wait(resume=True) 945b59b3d57SFam Zheng self.vm.pause_drive('drive0') 946e425306aSStefan Hajnoczi 947e425306aSStefan Hajnoczi # Check setting speed in block-stream works 948e425306aSStefan Hajnoczi result = self.vm.qmp('block-stream', device='drive0', speed=4 * 1024 * 1024) 949e425306aSStefan Hajnoczi self.assert_qmp(result, 'return', {}) 950e425306aSStefan Hajnoczi 951e425306aSStefan Hajnoczi result = self.vm.qmp('query-block-jobs') 952e425306aSStefan Hajnoczi self.assert_qmp(result, 'return[0]/device', 'drive0') 953e425306aSStefan Hajnoczi self.assert_qmp(result, 'return[0]/speed', 4 * 1024 * 1024) 954e425306aSStefan Hajnoczi 955b59b3d57SFam Zheng self.cancel_and_wait(resume=True) 956e425306aSStefan Hajnoczi 957e425306aSStefan Hajnoczi def test_set_speed_invalid(self): 958ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 959e425306aSStefan Hajnoczi 960e425306aSStefan Hajnoczi result = self.vm.qmp('block-stream', device='drive0', speed=-1) 9611ef7d9d3SKevin Wolf self.assert_qmp(result, 'error/desc', "Parameter 'speed' expects a non-negative value") 962e425306aSStefan Hajnoczi 963ecc1c88eSStefan Hajnoczi self.assert_no_active_block_jobs() 964e425306aSStefan Hajnoczi 965dca9b6a2SMax Reitz self.vm.pause_drive('drive0') 966e425306aSStefan Hajnoczi result = self.vm.qmp('block-stream', device='drive0') 967e425306aSStefan Hajnoczi self.assert_qmp(result, 'return', {}) 968e425306aSStefan Hajnoczi 969e425306aSStefan Hajnoczi result = self.vm.qmp('block-job-set-speed', device='drive0', speed=-1) 9701ef7d9d3SKevin Wolf self.assert_qmp(result, 'error/desc', "Parameter 'speed' expects a non-negative value") 971e425306aSStefan Hajnoczi 972dca9b6a2SMax Reitz self.cancel_and_wait(resume=True) 973e425306aSStefan Hajnoczi 97437ce63ebSStefan Hajnocziif __name__ == '__main__': 975103cbc77SMax Reitz iotests.main(supported_fmts=['qcow2', 'qed'], 976103cbc77SMax Reitz supported_protocols=['file']) 977