tests/qemu-iotests/030

   1 #!/usr/bin/env python
   2 #
   3 # Tests for image streaming.
   4 #
   5 # Copyright (C) 2012 IBM Corp.
   6 #
   7 # This program is free software; you can redistribute it and/or modify
   8 # it under the terms of the GNU General Public License as published by
   9 # the Free Software Foundation; either version 2 of the License, or
  10 # (at your option) any later version.
  11 #
  12 # This program is distributed in the hope that it will be useful,
  13 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  14 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15 # GNU General Public License for more details.
  16 #
  17 # You should have received a copy of the GNU General Public License
  18 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19 #
  20
  21 import time
  22 import os
  23 import iotests
  24 from iotests import qemu_img, qemu_io
  25
  26 backing_img = os.path.join(iotests.test_dir, 'backing.img')
  27 mid_img = os.path.join(iotests.test_dir, 'mid.img')
  28 test_img = os.path.join(iotests.test_dir, 'test.img')
  29
  30 class TestSingleDrive(iotests.QMPTestCase):
  31     image_len = 1 * 1024 * 1024 # MB
  32
  33     def setUp(self):
  34         iotests.create_image(backing_img, TestSingleDrive.image_len)
  35         qemu_img('create', '-f', iotests.imgfmt, '-o', 'backing_file=%s' % backing_img, mid_img)
  36         qemu_img('create', '-f', iotests.imgfmt, '-o', 'backing_file=%s' % mid_img, test_img)
  37         qemu_io('-f', 'raw', '-c', 'write -P 0x1 0 512', backing_img)
  38         qemu_io('-f', iotests.imgfmt, '-c', 'write -P 0x1 524288 512', mid_img)
  39         self.vm = iotests.VM().add_drive("blkdebug::" + test_img,
  40                                          "backing.node-name=mid," +
  41                                          "backing.backing.node-name=base")
  42         self.vm.launch()
  43
  44     def tearDown(self):
  45         self.vm.shutdown()
  46         os.remove(test_img)
  47         os.remove(mid_img)
  48         os.remove(backing_img)
  49
  50     def test_stream(self):
  51         self.assert_no_active_block_jobs()
  52
  53         result = self.vm.qmp('block-stream', device='drive0')
  54         self.assert_qmp(result, 'return', {})
  55
  56         self.wait_until_completed()
  57
  58         self.assert_no_active_block_jobs()
  59         self.vm.shutdown()
  60
  61         self.assertEqual(qemu_io('-f', 'raw', '-c', 'map', backing_img),
  62                          qemu_io('-f', iotests.imgfmt, '-c', 'map', test_img),
  63                          'image file map does not match backing file after streaming')
  64
  65     def test_stream_intermediate(self):
  66         self.assert_no_active_block_jobs()
  67
  68         self.assertNotEqual(qemu_io('-f', 'raw', '-rU', '-c', 'map', backing_img),
  69                             qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', mid_img),
  70                             'image file map matches backing file before streaming')
  71
  72         result = self.vm.qmp('block-stream', device='mid', job_id='stream-mid')
  73         self.assert_qmp(result, 'return', {})
  74
  75         self.wait_until_completed(drive='stream-mid')
  76
  77         self.assert_no_active_block_jobs()
  78         self.vm.shutdown()
  79
  80         self.assertEqual(qemu_io('-f', 'raw', '-c', 'map', backing_img),
  81                          qemu_io('-f', iotests.imgfmt, '-c', 'map', mid_img),
  82                          'image file map does not match backing file after streaming')
  83
  84     def test_stream_pause(self):
  85         self.assert_no_active_block_jobs()
  86
  87         self.vm.pause_drive('drive0')
  88         result = self.vm.qmp('block-stream', device='drive0')
  89         self.assert_qmp(result, 'return', {})
  90
  91         self.pause_job('drive0', wait=False)
  92         self.vm.resume_drive('drive0')
  93         self.pause_wait('drive0')
  94
  95         result = self.vm.qmp('query-block-jobs')
  96         offset = self.dictpath(result, 'return[0]/offset')
  97
  98         time.sleep(0.5)
  99         result = self.vm.qmp('query-block-jobs')
 100         self.assert_qmp(result, 'return[0]/offset', offset)
 101
 102         result = self.vm.qmp('block-job-resume', device='drive0')
 103         self.assert_qmp(result, 'return', {})
 104
 105         self.wait_until_completed()
 106
 107         self.assert_no_active_block_jobs()
 108         self.vm.shutdown()
 109
 110         self.assertEqual(qemu_io('-f', 'raw', '-c', 'map', backing_img),
 111                          qemu_io('-f', iotests.imgfmt, '-c', 'map', test_img),
 112                          'image file map does not match backing file after streaming')
 113
 114     def test_stream_no_op(self):
 115         self.assert_no_active_block_jobs()
 116
 117         # The image map is empty before the operation
 118         empty_map = qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', test_img)
 119
 120         # This is a no-op: no data should ever be copied from the base image
 121         result = self.vm.qmp('block-stream', device='drive0', base=mid_img)
 122         self.assert_qmp(result, 'return', {})
 123
 124         self.wait_until_completed()
 125
 126         self.assert_no_active_block_jobs()
 127         self.vm.shutdown()
 128
 129         self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', test_img),
 130                          empty_map, 'image file map changed after a no-op')
 131
 132     def test_stream_partial(self):
 133         self.assert_no_active_block_jobs()
 134
 135         result = self.vm.qmp('block-stream', device='drive0', base=backing_img)
 136         self.assert_qmp(result, 'return', {})
 137
 138         self.wait_until_completed()
 139
 140         self.assert_no_active_block_jobs()
 141         self.vm.shutdown()
 142
 143         self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', mid_img),
 144                          qemu_io('-f', iotests.imgfmt, '-c', 'map', test_img),
 145                          'image file map does not match backing file after streaming')
 146
 147     def test_device_not_found(self):
 148         result = self.vm.qmp('block-stream', device='nonexistent')
 149         self.assert_qmp(result, 'error/desc',
 150             'Cannot find device=nonexistent nor node_name=nonexistent')
 151
 152     def test_job_id_missing(self):
 153         result = self.vm.qmp('block-stream', device='mid')
 154         self.assert_qmp(result, 'error/desc', "Invalid job ID ''")
 155
 156     def test_read_only(self):
 157         # Create a new file that we can attach (we need a read-only top)
 158         with iotests.FilePath('ro-top.img') as ro_top_path:
 159             qemu_img('create', '-f', iotests.imgfmt, ro_top_path,
 160                      str(self.image_len))
 161
 162             result = self.vm.qmp('blockdev-add',
 163                                  node_name='ro-top',
 164                                  driver=iotests.imgfmt,
 165                                  read_only=True,
 166                                  file={
 167                                      'driver': 'file',
 168                                      'filename': ro_top_path,
 169                                      'read-only': True
 170                                  },
 171                                  backing='mid')
 172             self.assert_qmp(result, 'return', {})
 173
 174             result = self.vm.qmp('block-stream', job_id='stream',
 175                                  device='ro-top', base_node='base')
 176             self.assert_qmp(result, 'error/desc', 'Block node is read-only')
 177
 178             result = self.vm.qmp('blockdev-del', node_name='ro-top')
 179             self.assert_qmp(result, 'return', {})
 180
 181
 182 class TestParallelOps(iotests.QMPTestCase):
 183     num_ops = 4 # Number of parallel block-stream operations
 184     num_imgs = num_ops * 2 + 1
 185     image_len = num_ops * 4 * 1024 * 1024
 186     imgs = []
 187
 188     def setUp(self):
 189         opts = []
 190         self.imgs = []
 191
 192         # Initialize file names and command-line options
 193         for i in range(self.num_imgs):
 194             img_depth = self.num_imgs - i - 1
 195             opts.append("backing." * img_depth + "node-name=node%d" % i)
 196             self.imgs.append(os.path.join(iotests.test_dir, 'img-%d.img' % i))
 197
 198         # Create all images
 199         iotests.create_image(self.imgs[0], self.image_len)
 200         for i in range(1, self.num_imgs):
 201             qemu_img('create', '-f', iotests.imgfmt,
 202                      '-o', 'backing_file=%s' % self.imgs[i-1], self.imgs[i])
 203
 204         # Put data into the images we are copying data from
 205         odd_img_indexes = [x for x in reversed(range(self.num_imgs)) if x % 2 == 1]
 206         for i in range(len(odd_img_indexes)):
 207             # Alternate between 2MB and 4MB.
 208             # This way jobs will not finish in the same order they were created
 209             num_mb = 2 + 2 * (i % 2)
 210             qemu_io('-f', iotests.imgfmt,
 211                     '-c', 'write -P 0xFF %dM %dM' % (i * 4, num_mb),
 212                     self.imgs[odd_img_indexes[i]])
 213
 214         # Attach the drive to the VM
 215         self.vm = iotests.VM()
 216         self.vm.add_drive(self.imgs[-1], ','.join(opts))
 217         self.vm.launch()
 218
 219     def tearDown(self):
 220         self.vm.shutdown()
 221         for img in self.imgs:
 222             os.remove(img)
 223
 224     # Test that it's possible to run several block-stream operations
 225     # in parallel in the same snapshot chain
 226     def test_stream_parallel(self):
 227         self.assert_no_active_block_jobs()
 228
 229         # Check that the maps don't match before the streaming operations
 230         for i in range(2, self.num_imgs, 2):
 231             self.assertNotEqual(qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.imgs[i]),
 232                                 qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.imgs[i-1]),
 233                                 'image file map matches backing file before streaming')
 234
 235         # Create all streaming jobs
 236         pending_jobs = []
 237         for i in range(2, self.num_imgs, 2):
 238             node_name = 'node%d' % i
 239             job_id = 'stream-%s' % node_name
 240             pending_jobs.append(job_id)
 241             result = self.vm.qmp('block-stream', device=node_name, job_id=job_id, base=self.imgs[i-2], speed=512*1024)
 242             self.assert_qmp(result, 'return', {})
 243
 244         for job in pending_jobs:
 245             result = self.vm.qmp('block-job-set-speed', device=job, speed=0)
 246             self.assert_qmp(result, 'return', {})
 247
 248         # Wait for all jobs to be finished.
 249         while len(pending_jobs) > 0:
 250             for event in self.vm.get_qmp_events(wait=True):
 251                 if event['event'] == 'BLOCK_JOB_COMPLETED':
 252                     job_id = self.dictpath(event, 'data/device')
 253                     self.assertTrue(job_id in pending_jobs)
 254                     self.assert_qmp_absent(event, 'data/error')
 255                     pending_jobs.remove(job_id)
 256
 257         self.assert_no_active_block_jobs()
 258         self.vm.shutdown()
 259
 260         # Check that all maps match now
 261         for i in range(2, self.num_imgs, 2):
 262             self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', self.imgs[i]),
 263                              qemu_io('-f', iotests.imgfmt, '-c', 'map', self.imgs[i-1]),
 264                              'image file map does not match backing file after streaming')
 265
 266     # Test that it's not possible to perform two block-stream
 267     # operations if there are nodes involved in both.
 268     def test_overlapping_1(self):
 269         self.assert_no_active_block_jobs()
 270
 271         # Set a speed limit to make sure that this job blocks the rest
 272         result = self.vm.qmp('block-stream', device='node4', job_id='stream-node4', base=self.imgs[1], speed=1024*1024)
 273         self.assert_qmp(result, 'return', {})
 274
 275         result = self.vm.qmp('block-stream', device='node5', job_id='stream-node5', base=self.imgs[2])
 276         self.assert_qmp(result, 'error/desc',
 277             "Node 'node4' is busy: block device is in use by block job: stream")
 278
 279         result = self.vm.qmp('block-stream', device='node3', job_id='stream-node3', base=self.imgs[2])
 280         self.assert_qmp(result, 'error/desc',
 281             "Node 'node3' is busy: block device is in use by block job: stream")
 282
 283         result = self.vm.qmp('block-stream', device='node4', job_id='stream-node4-v2')
 284         self.assert_qmp(result, 'error/desc',
 285             "Node 'node4' is busy: block device is in use by block job: stream")
 286
 287         # block-commit should also fail if it touches nodes used by the stream job
 288         result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[4], job_id='commit-node4')
 289         self.assert_qmp(result, 'error/desc',
 290             "Node 'node4' is busy: block device is in use by block job: stream")
 291
 292         result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[1], top=self.imgs[3], job_id='commit-node1')
 293         self.assert_qmp(result, 'error/desc',
 294             "Node 'node3' is busy: block device is in use by block job: stream")
 295
 296         # This fails because it needs to modify the backing string in node2, which is blocked
 297         result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[0], top=self.imgs[1], job_id='commit-node0')
 298         self.assert_qmp(result, 'error/desc',
 299             "Node 'node2' is busy: block device is in use by block job: stream")
 300
 301         result = self.vm.qmp('block-job-set-speed', device='stream-node4', speed=0)
 302         self.assert_qmp(result, 'return', {})
 303
 304         self.wait_until_completed(drive='stream-node4')
 305         self.assert_no_active_block_jobs()
 306
 307     # Similar to test_overlapping_1, but with block-commit
 308     # blocking the other jobs
 309     def test_overlapping_2(self):
 310         self.assertLessEqual(9, self.num_imgs)
 311         self.assert_no_active_block_jobs()
 312
 313         # Set a speed limit to make sure that this job blocks the rest
 314         result = self.vm.qmp('block-commit', device='drive0', top=self.imgs[5], base=self.imgs[3], job_id='commit-node3', speed=1024*1024)
 315         self.assert_qmp(result, 'return', {})
 316
 317         result = self.vm.qmp('block-stream', device='node3', job_id='stream-node3')
 318         self.assert_qmp(result, 'error/desc',
 319             "Node 'node3' is busy: block device is in use by block job: commit")
 320
 321         result = self.vm.qmp('block-stream', device='node6', base=self.imgs[2], job_id='stream-node6')
 322         self.assert_qmp(result, 'error/desc',
 323             "Node 'node5' is busy: block device is in use by block job: commit")
 324
 325         result = self.vm.qmp('block-stream', device='node4', base=self.imgs[2], job_id='stream-node4')
 326         self.assert_qmp(result, 'error/desc',
 327             "Node 'node4' is busy: block device is in use by block job: commit")
 328
 329         result = self.vm.qmp('block-stream', device='node6', base=self.imgs[4], job_id='stream-node6-v2')
 330         self.assert_qmp(result, 'error/desc',
 331             "Node 'node5' is busy: block device is in use by block job: commit")
 332
 333         # This fails because block-commit currently blocks the active layer even if it's not used
 334         result = self.vm.qmp('block-stream', device='drive0', base=self.imgs[5], job_id='stream-drive0')
 335         self.assert_qmp(result, 'error/desc',
 336             "Node 'drive0' is busy: block device is in use by block job: commit")
 337
 338         result = self.vm.qmp('block-job-set-speed', device='commit-node3', speed=0)
 339         self.assert_qmp(result, 'return', {})
 340
 341         self.wait_until_completed(drive='commit-node3')
 342
 343     # Similar to test_overlapping_2, but here block-commit doesn't use the 'top' parameter.
 344     # Internally this uses a mirror block job, hence the separate test case.
 345     def test_overlapping_3(self):
 346         self.assertLessEqual(8, self.num_imgs)
 347         self.assert_no_active_block_jobs()
 348
 349         # Set a speed limit to make sure that this job blocks the rest
 350         result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[3], job_id='commit-drive0', speed=1024*1024)
 351         self.assert_qmp(result, 'return', {})
 352
 353         result = self.vm.qmp('block-stream', device='node5', base=self.imgs[3], job_id='stream-node6')
 354         self.assert_qmp(result, 'error/desc',
 355             "Node 'node5' is busy: block device is in use by block job: commit")
 356
 357         event = self.vm.event_wait(name='BLOCK_JOB_READY')
 358         self.assert_qmp(event, 'data/device', 'commit-drive0')
 359         self.assert_qmp(event, 'data/type', 'commit')
 360         self.assert_qmp_absent(event, 'data/error')
 361
 362         result = self.vm.qmp('block-job-set-speed', device='commit-drive0', speed=0)
 363         self.assert_qmp(result, 'return', {})
 364
 365         result = self.vm.qmp('block-job-complete', device='commit-drive0')
 366         self.assert_qmp(result, 'return', {})
 367
 368         self.wait_until_completed(drive='commit-drive0')
 369
 370     # In this case the base node of the stream job is the same as the
 371     # top node of commit job. Since this results in the commit filter
 372     # node being part of the stream chain, this is not allowed.
 373     def test_overlapping_4(self):
 374         self.assert_no_active_block_jobs()
 375
 376         # Commit from node2 into node0
 377         result = self.vm.qmp('block-commit', device='drive0',
 378                              top=self.imgs[2], base=self.imgs[0],
 379                              filter_node_name='commit-filter', speed=1024*1024)
 380         self.assert_qmp(result, 'return', {})
 381
 382         # Stream from node2 into node4
 383         result = self.vm.qmp('block-stream', device='node4', base_node='node2', job_id='node4')
 384         self.assert_qmp(result, 'error/desc',
 385             "Cannot freeze 'backing' link to 'commit-filter'")
 386
 387         result = self.vm.qmp('block-job-set-speed', device='drive0', speed=0)
 388         self.assert_qmp(result, 'return', {})
 389
 390         self.wait_until_completed()
 391         self.assert_no_active_block_jobs()
 392
 393     # In this case the base node of the stream job is the commit job's
 394     # filter node.  stream does not have a real dependency on its base
 395     # node, so even though commit removes it when it is done, there is
 396     # no conflict.
 397     def test_overlapping_5(self):
 398         self.assert_no_active_block_jobs()
 399
 400         # Commit from node2 into node0
 401         result = self.vm.qmp('block-commit', device='drive0',
 402                              top_node='node2', base_node='node0',
 403                              filter_node_name='commit-filter', speed=1024*1024)
 404         self.assert_qmp(result, 'return', {})
 405
 406         # Stream from node2 into node4
 407         result = self.vm.qmp('block-stream', device='node4',
 408                              base_node='commit-filter', job_id='node4')
 409         self.assert_qmp(result, 'return', {})
 410
 411         result = self.vm.qmp('block-job-set-speed', device='drive0', speed=0)
 412         self.assert_qmp(result, 'return', {})
 413
 414         self.vm.run_job(job='drive0', auto_dismiss=True, use_log=False)
 415         self.vm.run_job(job='node4', auto_dismiss=True, use_log=False)
 416         self.assert_no_active_block_jobs()
 417
 418     # Test a block-stream and a block-commit job in parallel
 419     # Here the stream job is supposed to finish quickly in order to reproduce
 420     # the scenario that triggers the bug fixed in 3d5d319e1221 and 1a63a907507
 421     def test_stream_commit_1(self):
 422         self.assertLessEqual(8, self.num_imgs)
 423         self.assert_no_active_block_jobs()
 424
 425         # Stream from node0 into node2
 426         result = self.vm.qmp('block-stream', device='node2', base_node='node0', job_id='node2')
 427         self.assert_qmp(result, 'return', {})
 428
 429         # Commit from the active layer into node3
 430         result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[3])
 431         self.assert_qmp(result, 'return', {})
 432
 433         # Wait for all jobs to be finished.
 434         pending_jobs = ['node2', 'drive0']
 435         while len(pending_jobs) > 0:
 436             for event in self.vm.get_qmp_events(wait=True):
 437                 if event['event'] == 'BLOCK_JOB_COMPLETED':
 438                     node_name = self.dictpath(event, 'data/device')
 439                     self.assertTrue(node_name in pending_jobs)
 440                     self.assert_qmp_absent(event, 'data/error')
 441                     pending_jobs.remove(node_name)
 442                 if event['event'] == 'BLOCK_JOB_READY':
 443                     self.assert_qmp(event, 'data/device', 'drive0')
 444                     self.assert_qmp(event, 'data/type', 'commit')
 445                     self.assert_qmp_absent(event, 'data/error')
 446                     self.assertTrue('drive0' in pending_jobs)
 447                     self.vm.qmp('block-job-complete', device='drive0')
 448
 449         self.assert_no_active_block_jobs()
 450
 451     # This is similar to test_stream_commit_1 but both jobs are slowed
 452     # down so they can run in parallel for a little while.
 453     def test_stream_commit_2(self):
 454         self.assertLessEqual(8, self.num_imgs)
 455         self.assert_no_active_block_jobs()
 456
 457         # Stream from node0 into node4
 458         result = self.vm.qmp('block-stream', device='node4', base_node='node0', job_id='node4', speed=1024*1024)
 459         self.assert_qmp(result, 'return', {})
 460
 461         # Commit from the active layer into node5
 462         result = self.vm.qmp('block-commit', device='drive0', base=self.imgs[5], speed=1024*1024)
 463         self.assert_qmp(result, 'return', {})
 464
 465         for job in ['drive0', 'node4']:
 466             result = self.vm.qmp('block-job-set-speed', device=job, speed=0)
 467             self.assert_qmp(result, 'return', {})
 468
 469         # Wait for all jobs to be finished.
 470         pending_jobs = ['node4', 'drive0']
 471         while len(pending_jobs) > 0:
 472             for event in self.vm.get_qmp_events(wait=True):
 473                 if event['event'] == 'BLOCK_JOB_COMPLETED':
 474                     node_name = self.dictpath(event, 'data/device')
 475                     self.assertTrue(node_name in pending_jobs)
 476                     self.assert_qmp_absent(event, 'data/error')
 477                     pending_jobs.remove(node_name)
 478                 if event['event'] == 'BLOCK_JOB_READY':
 479                     self.assert_qmp(event, 'data/device', 'drive0')
 480                     self.assert_qmp(event, 'data/type', 'commit')
 481                     self.assert_qmp_absent(event, 'data/error')
 482                     self.assertTrue('drive0' in pending_jobs)
 483                     self.vm.qmp('block-job-complete', device='drive0')
 484
 485         self.assert_no_active_block_jobs()
 486
 487     # Test the base_node parameter
 488     def test_stream_base_node_name(self):
 489         self.assert_no_active_block_jobs()
 490
 491         self.assertNotEqual(qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.imgs[4]),
 492                             qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.imgs[3]),
 493                             'image file map matches backing file before streaming')
 494
 495         # Error: the base node does not exist
 496         result = self.vm.qmp('block-stream', device='node4', base_node='none', job_id='stream')
 497         self.assert_qmp(result, 'error/desc',
 498             'Cannot find device= nor node_name=none')
 499
 500         # Error: the base node is not a backing file of the top node
 501         result = self.vm.qmp('block-stream', device='node4', base_node='node6', job_id='stream')
 502         self.assert_qmp(result, 'error/desc',
 503             "Node 'node6' is not a backing image of 'node4'")
 504
 505         # Error: the base node is the same as the top node
 506         result = self.vm.qmp('block-stream', device='node4', base_node='node4', job_id='stream')
 507         self.assert_qmp(result, 'error/desc',
 508             "Node 'node4' is not a backing image of 'node4'")
 509
 510         # Error: cannot specify 'base' and 'base-node' at the same time
 511         result = self.vm.qmp('block-stream', device='node4', base=self.imgs[2], base_node='node2', job_id='stream')
 512         self.assert_qmp(result, 'error/desc',
 513             "'base' and 'base-node' cannot be specified at the same time")
 514
 515         # Success: the base node is a backing file of the top node
 516         result = self.vm.qmp('block-stream', device='node4', base_node='node2', job_id='stream')
 517         self.assert_qmp(result, 'return', {})
 518
 519         self.wait_until_completed(drive='stream')
 520
 521         self.assert_no_active_block_jobs()
 522         self.vm.shutdown()
 523
 524         self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', self.imgs[4]),
 525                          qemu_io('-f', iotests.imgfmt, '-c', 'map', self.imgs[3]),
 526                          'image file map matches backing file after streaming')
 527
 528 class TestQuorum(iotests.QMPTestCase):
 529     num_children = 3
 530     children = []
 531     backing = []
 532
 533     def setUp(self):
 534         opts = ['driver=quorum', 'vote-threshold=2']
 535
 536         # Initialize file names and command-line options
 537         for i in range(self.num_children):
 538             child_img = os.path.join(iotests.test_dir, 'img-%d.img' % i)
 539             backing_img = os.path.join(iotests.test_dir, 'backing-%d.img' % i)
 540             self.children.append(child_img)
 541             self.backing.append(backing_img)
 542             qemu_img('create', '-f', iotests.imgfmt, backing_img, '1M')
 543             qemu_io('-f', iotests.imgfmt,
 544                     '-c', 'write -P 0x55 0 1024', backing_img)
 545             qemu_img('create', '-f', iotests.imgfmt,
 546                      '-o', 'backing_file=%s' % backing_img, child_img)
 547             opts.append("children.%d.file.filename=%s" % (i, child_img))
 548             opts.append("children.%d.node-name=node%d" % (i, i))
 549
 550         # Attach the drive to the VM
 551         self.vm = iotests.VM()
 552         self.vm.add_drive(path = None, opts = ','.join(opts))
 553         self.vm.launch()
 554
 555     def tearDown(self):
 556         self.vm.shutdown()
 557         for img in self.children:
 558             os.remove(img)
 559         for img in self.backing:
 560             os.remove(img)
 561
 562     def test_stream_quorum(self):
 563         if not iotests.supports_quorum():
 564             return
 565
 566         self.assertNotEqual(qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.children[0]),
 567                             qemu_io('-f', iotests.imgfmt, '-rU', '-c', 'map', self.backing[0]),
 568                             'image file map matches backing file before streaming')
 569
 570         self.assert_no_active_block_jobs()
 571
 572         result = self.vm.qmp('block-stream', device='node0', job_id='stream-node0')
 573         self.assert_qmp(result, 'return', {})
 574
 575         self.wait_until_completed(drive='stream-node0')
 576
 577         self.assert_no_active_block_jobs()
 578         self.vm.shutdown()
 579
 580         self.assertEqual(qemu_io('-f', iotests.imgfmt, '-c', 'map', self.children[0]),
 581                          qemu_io('-f', iotests.imgfmt, '-c', 'map', self.backing[0]),
 582                          'image file map does not match backing file after streaming')
 583
 584 class TestSmallerBackingFile(iotests.QMPTestCase):
 585     backing_len = 1 * 1024 * 1024 # MB
 586     image_len = 2 * backing_len
 587
 588     def setUp(self):
 589         iotests.create_image(backing_img, self.backing_len)
 590         qemu_img('create', '-f', iotests.imgfmt, '-o', 'backing_file=%s' % backing_img, test_img, str(self.image_len))
 591         self.vm = iotests.VM().add_drive(test_img)
 592         self.vm.launch()
 593
 594     # If this hangs, then you are missing a fix to complete streaming when the
 595     # end of the backing file is reached.
 596     def test_stream(self):
 597         self.assert_no_active_block_jobs()
 598
 599         result = self.vm.qmp('block-stream', device='drive0')
 600         self.assert_qmp(result, 'return', {})
 601
 602         self.wait_until_completed()
 603
 604         self.assert_no_active_block_jobs()
 605         self.vm.shutdown()
 606
 607 class TestErrors(iotests.QMPTestCase):
 608     image_len = 2 * 1024 * 1024 # MB
 609
 610     # this should match STREAM_BUFFER_SIZE/512 in block/stream.c
 611     STREAM_BUFFER_SIZE = 512 * 1024
 612
 613     def create_blkdebug_file(self, name, event, errno):
 614         file = open(name, 'w')
 615         file.write('''
 616 [inject-error]
 617 state = "1"
 618 event = "%s"
 619 errno = "%d"
 620 immediately = "off"
 621 once = "on"
 622 sector = "%d"
 623
 624 [set-state]
 625 state = "1"
 626 event = "%s"
 627 new_state = "2"
 628
 629 [set-state]
 630 state = "2"
 631 event = "%s"
 632 new_state = "1"
 633 ''' % (event, errno, self.STREAM_BUFFER_SIZE // 512, event, event))
 634         file.close()
 635
 636 class TestEIO(TestErrors):
 637     def setUp(self):
 638         self.blkdebug_file = backing_img + ".blkdebug"
 639         iotests.create_image(backing_img, TestErrors.image_len)
 640         self.create_blkdebug_file(self.blkdebug_file, "read_aio", 5)
 641         qemu_img('create', '-f', iotests.imgfmt,
 642                  '-o', 'backing_file=blkdebug:%s:%s,backing_fmt=raw'
 643                        % (self.blkdebug_file, backing_img),
 644                  test_img)
 645         self.vm = iotests.VM().add_drive(test_img)
 646         self.vm.launch()
 647
 648     def tearDown(self):
 649         self.vm.shutdown()
 650         os.remove(test_img)
 651         os.remove(backing_img)
 652         os.remove(self.blkdebug_file)
 653
 654     def test_report(self):
 655         self.assert_no_active_block_jobs()
 656
 657         result = self.vm.qmp('block-stream', device='drive0')
 658         self.assert_qmp(result, 'return', {})
 659
 660         completed = False
 661         error = False
 662         while not completed:
 663             for event in self.vm.get_qmp_events(wait=True):
 664                 if event['event'] == 'BLOCK_JOB_ERROR':
 665                     self.assert_qmp(event, 'data/device', 'drive0')
 666                     self.assert_qmp(event, 'data/operation', 'read')
 667                     error = True
 668                 elif event['event'] == 'BLOCK_JOB_COMPLETED':
 669                     self.assertTrue(error, 'job completed unexpectedly')
 670                     self.assert_qmp(event, 'data/type', 'stream')
 671                     self.assert_qmp(event, 'data/device', 'drive0')
 672                     self.assert_qmp(event, 'data/error', 'Input/output error')
 673                     self.assert_qmp(event, 'data/offset', self.STREAM_BUFFER_SIZE)
 674                     self.assert_qmp(event, 'data/len', self.image_len)
 675                     completed = True
 676                 elif event['event'] == 'JOB_STATUS_CHANGE':
 677                     self.assert_qmp(event, 'data/id', 'drive0')
 678
 679         self.assert_no_active_block_jobs()
 680         self.vm.shutdown()
 681
 682     def test_ignore(self):
 683         self.assert_no_active_block_jobs()
 684
 685         result = self.vm.qmp('block-stream', device='drive0', on_error='ignore')
 686         self.assert_qmp(result, 'return', {})
 687
 688         error = False
 689         completed = False
 690         while not completed:
 691             for event in self.vm.get_qmp_events(wait=True):
 692                 if event['event'] == 'BLOCK_JOB_ERROR':
 693                     error = True
 694                     self.assert_qmp(event, 'data/device', 'drive0')
 695                     self.assert_qmp(event, 'data/operation', 'read')
 696                     result = self.vm.qmp('query-block-jobs')
 697                     if result == {'return': []}:
 698                         # Job finished too quickly
 699                         continue
 700                     self.assert_qmp(result, 'return[0]/paused', False)
 701                 elif event['event'] == 'BLOCK_JOB_COMPLETED':
 702                     self.assertTrue(error, 'job completed unexpectedly')
 703                     self.assert_qmp(event, 'data/type', 'stream')
 704                     self.assert_qmp(event, 'data/device', 'drive0')
 705                     self.assert_qmp(event, 'data/error', 'Input/output error')
 706                     self.assert_qmp(event, 'data/offset', self.image_len)
 707                     self.assert_qmp(event, 'data/len', self.image_len)
 708                     completed = True
 709                 elif event['event'] == 'JOB_STATUS_CHANGE':
 710                     self.assert_qmp(event, 'data/id', 'drive0')
 711
 712         self.assert_no_active_block_jobs()
 713         self.vm.shutdown()
 714
 715     def test_stop(self):
 716         self.assert_no_active_block_jobs()
 717
 718         result = self.vm.qmp('block-stream', device='drive0', on_error='stop')
 719         self.assert_qmp(result, 'return', {})
 720
 721         error = False
 722         completed = False
 723         while not completed:
 724             for event in self.vm.get_qmp_events(wait=True):
 725                 if event['event'] == 'BLOCK_JOB_ERROR':
 726                     error = True
 727                     self.assert_qmp(event, 'data/device', 'drive0')
 728                     self.assert_qmp(event, 'data/operation', 'read')
 729
 730                     result = self.vm.qmp('query-block-jobs')
 731                     self.assert_qmp(result, 'return[0]/paused', True)
 732                     self.assert_qmp(result, 'return[0]/offset', self.STREAM_BUFFER_SIZE)
 733                     self.assert_qmp(result, 'return[0]/io-status', 'failed')
 734
 735                     result = self.vm.qmp('block-job-resume', device='drive0')
 736                     self.assert_qmp(result, 'return', {})
 737
 738                     result = self.vm.qmp('query-block-jobs')
 739                     if result == {'return': []}:
 740                         # Race; likely already finished. Check.
 741                         continue
 742                     self.assert_qmp(result, 'return[0]/paused', False)
 743                     self.assert_qmp(result, 'return[0]/io-status', 'ok')
 744                 elif event['event'] == 'BLOCK_JOB_COMPLETED':
 745                     self.assertTrue(error, 'job completed unexpectedly')
 746                     self.assert_qmp(event, 'data/type', 'stream')
 747                     self.assert_qmp(event, 'data/device', 'drive0')
 748                     self.assert_qmp_absent(event, 'data/error')
 749                     self.assert_qmp(event, 'data/offset', self.image_len)
 750                     self.assert_qmp(event, 'data/len', self.image_len)
 751                     completed = True
 752                 elif event['event'] == 'JOB_STATUS_CHANGE':
 753                     self.assert_qmp(event, 'data/id', 'drive0')
 754
 755         self.assert_no_active_block_jobs()
 756         self.vm.shutdown()
 757
 758     def test_enospc(self):
 759         self.assert_no_active_block_jobs()
 760
 761         result = self.vm.qmp('block-stream', device='drive0', on_error='enospc')
 762         self.assert_qmp(result, 'return', {})
 763
 764         completed = False
 765         error = False
 766         while not completed:
 767             for event in self.vm.get_qmp_events(wait=True):
 768                 if event['event'] == 'BLOCK_JOB_ERROR':
 769                     self.assert_qmp(event, 'data/device', 'drive0')
 770                     self.assert_qmp(event, 'data/operation', 'read')
 771                     error = True
 772                 elif event['event'] == 'BLOCK_JOB_COMPLETED':
 773                     self.assertTrue(error, 'job completed unexpectedly')
 774                     self.assert_qmp(event, 'data/type', 'stream')
 775                     self.assert_qmp(event, 'data/device', 'drive0')
 776                     self.assert_qmp(event, 'data/error', 'Input/output error')
 777                     self.assert_qmp(event, 'data/offset', self.STREAM_BUFFER_SIZE)
 778                     self.assert_qmp(event, 'data/len', self.image_len)
 779                     completed = True
 780                 elif event['event'] == 'JOB_STATUS_CHANGE':
 781                     self.assert_qmp(event, 'data/id', 'drive0')
 782
 783         self.assert_no_active_block_jobs()
 784         self.vm.shutdown()
 785
 786 class TestENOSPC(TestErrors):
 787     def setUp(self):
 788         self.blkdebug_file = backing_img + ".blkdebug"
 789         iotests.create_image(backing_img, TestErrors.image_len)
 790         self.create_blkdebug_file(self.blkdebug_file, "read_aio", 28)
 791         qemu_img('create', '-f', iotests.imgfmt,
 792                  '-o', 'backing_file=blkdebug:%s:%s,backing_fmt=raw'
 793                        % (self.blkdebug_file, backing_img),
 794                  test_img)
 795         self.vm = iotests.VM().add_drive(test_img)
 796         self.vm.launch()
 797
 798     def tearDown(self):
 799         self.vm.shutdown()
 800         os.remove(test_img)
 801         os.remove(backing_img)
 802         os.remove(self.blkdebug_file)
 803
 804     def test_enospc(self):
 805         self.assert_no_active_block_jobs()
 806
 807         result = self.vm.qmp('block-stream', device='drive0', on_error='enospc')
 808         self.assert_qmp(result, 'return', {})
 809
 810         error = False
 811         completed = False
 812         while not completed:
 813             for event in self.vm.get_qmp_events(wait=True):
 814                 if event['event'] == 'BLOCK_JOB_ERROR':
 815                     self.assert_qmp(event, 'data/device', 'drive0')
 816                     self.assert_qmp(event, 'data/operation', 'read')
 817                     error = True
 818
 819                     result = self.vm.qmp('query-block-jobs')
 820                     self.assert_qmp(result, 'return[0]/paused', True)
 821                     self.assert_qmp(result, 'return[0]/offset', self.STREAM_BUFFER_SIZE)
 822                     self.assert_qmp(result, 'return[0]/io-status', 'nospace')
 823
 824                     result = self.vm.qmp('block-job-resume', device='drive0')
 825                     self.assert_qmp(result, 'return', {})
 826
 827                     result = self.vm.qmp('query-block-jobs')
 828                     if result == {'return': []}:
 829                         # Race; likely already finished. Check.
 830                         continue
 831                     self.assert_qmp(result, 'return[0]/paused', False)
 832                     self.assert_qmp(result, 'return[0]/io-status', 'ok')
 833                 elif event['event'] == 'BLOCK_JOB_COMPLETED':
 834                     self.assertTrue(error, 'job completed unexpectedly')
 835                     self.assert_qmp(event, 'data/type', 'stream')
 836                     self.assert_qmp(event, 'data/device', 'drive0')
 837                     self.assert_qmp_absent(event, 'data/error')
 838                     self.assert_qmp(event, 'data/offset', self.image_len)
 839                     self.assert_qmp(event, 'data/len', self.image_len)
 840                     completed = True
 841                 elif event['event'] == 'JOB_STATUS_CHANGE':
 842                     self.assert_qmp(event, 'data/id', 'drive0')
 843
 844         self.assert_no_active_block_jobs()
 845         self.vm.shutdown()
 846
 847 class TestStreamStop(iotests.QMPTestCase):
 848     image_len = 8 * 1024 * 1024 * 1024 # GB
 849
 850     def setUp(self):
 851         qemu_img('create', backing_img, str(TestStreamStop.image_len))
 852         qemu_io('-f', 'raw', '-c', 'write -P 0x1 0 32M', backing_img)
 853         qemu_img('create', '-f', iotests.imgfmt, '-o', 'backing_file=%s' % backing_img, test_img)
 854         qemu_io('-f', iotests.imgfmt, '-c', 'write -P 0x1 32M 32M', test_img)
 855         self.vm = iotests.VM().add_drive("blkdebug::" + test_img)
 856         self.vm.launch()
 857
 858     def tearDown(self):
 859         self.vm.shutdown()
 860         os.remove(test_img)
 861         os.remove(backing_img)
 862
 863     def test_stream_stop(self):
 864         self.assert_no_active_block_jobs()
 865
 866         self.vm.pause_drive('drive0')
 867         result = self.vm.qmp('block-stream', device='drive0')
 868         self.assert_qmp(result, 'return', {})
 869
 870         time.sleep(0.1)
 871         events = self.vm.get_qmp_events(wait=False)
 872         for e in events:
 873             self.assert_qmp(e, 'event', 'JOB_STATUS_CHANGE')
 874             self.assert_qmp(e, 'data/id', 'drive0')
 875
 876         self.cancel_and_wait(resume=True)
 877
 878 class TestSetSpeed(iotests.QMPTestCase):
 879     image_len = 80 * 1024 * 1024 # MB
 880
 881     def setUp(self):
 882         qemu_img('create', backing_img, str(TestSetSpeed.image_len))
 883         qemu_io('-f', 'raw', '-c', 'write -P 0x1 0 32M', backing_img)
 884         qemu_img('create', '-f', iotests.imgfmt, '-o', 'backing_file=%s' % backing_img, test_img)
 885         qemu_io('-f', iotests.imgfmt, '-c', 'write -P 0x1 32M 32M', test_img)
 886         self.vm = iotests.VM().add_drive('blkdebug::' + test_img)
 887         self.vm.launch()
 888
 889     def tearDown(self):
 890         self.vm.shutdown()
 891         os.remove(test_img)
 892         os.remove(backing_img)
 893
 894     # This is a short performance test which is not run by default.
 895     # Invoke "IMGFMT=qed ./030 TestSetSpeed.perf_test_throughput"
 896     def perf_test_throughput(self):
 897         self.assert_no_active_block_jobs()
 898
 899         result = self.vm.qmp('block-stream', device='drive0')
 900         self.assert_qmp(result, 'return', {})
 901
 902         result = self.vm.qmp('block-job-set-speed', device='drive0', speed=8 * 1024 * 1024)
 903         self.assert_qmp(result, 'return', {})
 904
 905         self.wait_until_completed()
 906
 907         self.assert_no_active_block_jobs()
 908
 909     def test_set_speed(self):
 910         self.assert_no_active_block_jobs()
 911
 912         self.vm.pause_drive('drive0')
 913         result = self.vm.qmp('block-stream', device='drive0')
 914         self.assert_qmp(result, 'return', {})
 915
 916         # Default speed is 0
 917         result = self.vm.qmp('query-block-jobs')
 918         self.assert_qmp(result, 'return[0]/device', 'drive0')
 919         self.assert_qmp(result, 'return[0]/speed', 0)
 920
 921         result = self.vm.qmp('block-job-set-speed', device='drive0', speed=8 * 1024 * 1024)
 922         self.assert_qmp(result, 'return', {})
 923
 924         # Ensure the speed we set was accepted
 925         result = self.vm.qmp('query-block-jobs')
 926         self.assert_qmp(result, 'return[0]/device', 'drive0')
 927         self.assert_qmp(result, 'return[0]/speed', 8 * 1024 * 1024)
 928
 929         self.cancel_and_wait(resume=True)
 930         self.vm.pause_drive('drive0')
 931
 932         # Check setting speed in block-stream works
 933         result = self.vm.qmp('block-stream', device='drive0', speed=4 * 1024 * 1024)
 934         self.assert_qmp(result, 'return', {})
 935
 936         result = self.vm.qmp('query-block-jobs')
 937         self.assert_qmp(result, 'return[0]/device', 'drive0')
 938         self.assert_qmp(result, 'return[0]/speed', 4 * 1024 * 1024)
 939
 940         self.cancel_and_wait(resume=True)
 941
 942     def test_set_speed_invalid(self):
 943         self.assert_no_active_block_jobs()
 944
 945         result = self.vm.qmp('block-stream', device='drive0', speed=-1)
 946         self.assert_qmp(result, 'error/desc', "Invalid parameter 'speed'")
 947
 948         self.assert_no_active_block_jobs()
 949
 950         self.vm.pause_drive('drive0')
 951         result = self.vm.qmp('block-stream', device='drive0')
 952         self.assert_qmp(result, 'return', {})
 953
 954         result = self.vm.qmp('block-job-set-speed', device='drive0', speed=-1)
 955         self.assert_qmp(result, 'error/desc', "Invalid parameter 'speed'")
 956
 957         self.cancel_and_wait(resume=True)
 958
 959 if __name__ == '__main__':
 960     iotests.main(supported_fmts=['qcow2', 'qed'],
 961                  supported_protocols=['file'])