qtest/migration/framework.h

2  * Copyright (c) 2016-2018 Red Hat, Inc. and/or its affiliates
3  *   based on the vhost-user-test.c that is:
7  * See the COPYING file in the top-level directory.
15 #include <qapi/qapi-types-migration.h>
40  * created, but before the migration is started. This can
41  * be used to set migration parameters and capabilities.
50  * A hook that runs after the migration has finished,
52  * before QEMU has terminated (unless it self-terminated
53  * due to migration error)
63  * Our goal is to ensure that we run a single full migration
67  * We can't directly synchronize with the start of a migration
71  * Initially we set the migration bandwidth to an insanely
73  * guarantees migration will never complete.
75  * This will result in a test that is unacceptably slow though,
76  * so we can't let the entire migration pass run at this speed.
81  * Before migration starts, we write a 64-bit magic marker
85  * proof that start_address -> MAGIC_OFFSET_BASE has been
90  * is proof that start_address -> MAGIC_OFFSET_BASE
93  * IOW, we're guaranteed at least a 2nd migration pass
96  * We can now let migration run at full speed to finish
97  * the test
118      * size is plugged in.  If omitted, "-m %s" is used.
126      * Migration capabilities to be set in both source and
136      * cases must be >0 to make sure they trigger by a "if" test.
160      * Optional: JSON-formatted list of src QEMU URIs. If a port is
166     /* Optional: the cpr migration channel, in JSON or dotted keys format */
169     /* Optional: callback to run at start to set migration parameters */
175      * Optional: normally we expect the migration process to complete.
182      * QEMU is expected to stay running and accept future migration
186      * migration stream, then MIG_TEST_FAIL_DEST_QUIT_ERR will indicate
187      * that the dst QEMU is expected to quit with non-zero exit status
190         /* This test should succeed, the default */
192         /* This test should fail, dest qemu should keep alive */
194         /* This test should fail, dest qemu should fail with abnormal status */
196         /* The QMP command for this migration should fail with an error */
201      * Optional: set number of migration passes to wait for, if live==true.
208      * migration test.  We used to always run with live but it took much
210      * reason to be tested live-only.  For each of the new test cases for