get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

GET /api/1.0/patches/2197917/?format=api
HTTP 200 OK
Allow: GET, PUT, PATCH, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 2197917,
    "url": "http://patchwork.ozlabs.org/api/1.0/patches/2197917/?format=api",
    "project": {
        "id": 14,
        "url": "http://patchwork.ozlabs.org/api/1.0/projects/14/?format=api",
        "name": "QEMU Development",
        "link_name": "qemu-devel",
        "list_id": "qemu-devel.nongnu.org",
        "list_email": "qemu-devel@nongnu.org",
        "web_url": "",
        "scm_url": "",
        "webscm_url": ""
    },
    "msgid": "<20260218-colo_unit_test_multifd-v9-13-d8dbdb0ca6f6@web.de>",
    "date": "2026-02-18T21:29:33",
    "name": "[v9,13/19] migration-test: Add COLO migration unit test",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "cc352b90351339dcee9a188d51bb00b9f9e7b869",
    "submitter": {
        "id": 76468,
        "url": "http://patchwork.ozlabs.org/api/1.0/people/76468/?format=api",
        "name": "Lukas Straub",
        "email": "lukasstraub2@web.de"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260218-colo_unit_test_multifd-v9-13-d8dbdb0ca6f6@web.de/mbox/",
    "series": [
        {
            "id": 492617,
            "url": "http://patchwork.ozlabs.org/api/1.0/series/492617/?format=api",
            "date": "2026-02-18T21:29:37",
            "name": "migration: Add COLO multifd support and COLO migration unit test",
            "version": 9,
            "mbox": "http://patchwork.ozlabs.org/series/492617/mbox/"
        }
    ],
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/2197917/checks/",
    "tags": {},
    "headers": {
        "Return-Path": "<qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org>",
        "X-Original-To": "incoming@patchwork.ozlabs.org",
        "Delivered-To": "patchwork-incoming@legolas.ozlabs.org",
        "Authentication-Results": [
            "legolas.ozlabs.org;\n\tdkim=pass (2048-bit key;\n secure) header.d=web.de header.i=lukasstraub2@web.de header.a=rsa-sha256\n header.s=s29768273 header.b=Gfo5EhGZ;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=nongnu.org\n (client-ip=209.51.188.17; helo=lists.gnu.org;\n envelope-from=qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org;\n receiver=patchwork.ozlabs.org)"
        ],
        "Received": [
            "from lists.gnu.org (lists.gnu.org [209.51.188.17])\n\t(using TLSv1.2 with cipher ECDHE-ECDSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fGV8530Dlz1xxQ\n\tfor <incoming@patchwork.ozlabs.org>; Thu, 19 Feb 2026 08:31:49 +1100 (AEDT)",
            "from localhost ([::1] helo=lists1p.gnu.org)\n\tby lists.gnu.org with esmtp (Exim 4.90_1)\n\t(envelope-from <qemu-devel-bounces@nongnu.org>)\n\tid 1vsp7W-0007Eq-EX; Wed, 18 Feb 2026 16:30:07 -0500",
            "from eggs.gnu.org ([2001:470:142:3::10])\n by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <lukasstraub2@web.de>)\n id 1vsp7L-000797-RB\n for qemu-devel@nongnu.org; Wed, 18 Feb 2026 16:29:56 -0500",
            "from mout.web.de ([212.227.15.4])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <lukasstraub2@web.de>)\n id 1vsp7H-0007Nw-7M\n for qemu-devel@nongnu.org; Wed, 18 Feb 2026 16:29:54 -0500",
            "from [127.0.1.1] ([84.133.37.84]) by smtp.web.de (mrweb005\n [213.165.67.108]) with ESMTPSA (Nemesis) id 1MpTxo-1vPEXR1MA0-00nIIR; Wed, 18\n Feb 2026 22:29:41 +0100"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=web.de;\n s=s29768273; t=1771450181; x=1772054981; i=lukasstraub2@web.de;\n bh=yDiaSK9OpxS8V2pxAHSs+oO9Yxg0bwU7fddiiz7QY1k=;\n h=X-UI-Sender-Class:From:Date:Subject:MIME-Version:Content-Type:\n Content-Transfer-Encoding:Message-Id:References:In-Reply-To:To:Cc:\n cc:content-transfer-encoding:content-type:date:from:message-id:\n mime-version:reply-to:subject:to;\n b=Gfo5EhGZVAILfzQOd0zwJ3ZaqBMcT49j9+/glmOU4tP9kaczyn+Ankwb4jMMwx4m\n gwGzglt6Yh7F7hYiCdHlsiUM/thChQNR89LbpmhFUJQc9eiWdYTonlbOMmrZl7PDv\n XYmfKNbxSkT6N/Y2stxd1DzpZ/O1h5ACnkgF9c5Qn3oOL92/EBwJsZL2ZNX9/aNyG\n butvIYNnp5kfFw6jU5zstOBnb6IG6vTi6kd7YI9yVFSW5CEuwUXYZaXNOi9wkWD3R\n 08tAbwPLdbiFFt05BIhh9H+6z4esHa11OinqbMwuAE/HUNfZSSAepL6/YeJ7kYKOt\n w8RpIJT7blcg+cmScA==",
        "X-UI-Sender-Class": "814a7b36-bfc1-4dae-8640-3722d8ec6cd6",
        "From": "Lukas Straub <lukasstraub2@web.de>",
        "Date": "Wed, 18 Feb 2026 22:29:33 +0100",
        "Subject": "[PATCH v9 13/19] migration-test: Add COLO migration unit test",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "quoted-printable",
        "Message-Id": "<20260218-colo_unit_test_multifd-v9-13-d8dbdb0ca6f6@web.de>",
        "References": "<20260218-colo_unit_test_multifd-v9-0-d8dbdb0ca6f6@web.de>",
        "In-Reply-To": "<20260218-colo_unit_test_multifd-v9-0-d8dbdb0ca6f6@web.de>",
        "To": "qemu-devel@nongnu.org",
        "Cc": "Peter Xu <peterx@redhat.com>, Fabiano Rosas <farosas@suse.de>,\n Laurent Vivier <lvivier@redhat.com>, Paolo Bonzini <pbonzini@redhat.com>,\n Zhang Chen <zhangckid@gmail.com>,\n Hailiang Zhang <zhanghailiang@xfusion.com>,\n Markus Armbruster <armbru@redhat.com>, Li Zhijian <lizhijian@fujitsu.com>,\n \"Dr. David Alan Gilbert\" <dave@treblig.org>,\n Lukas Straub <lukasstraub2@web.de>",
        "X-Mailer": "b4 0.14.2",
        "X-Developer-Signature": "v=1; a=openpgp-sha256; l=10668; i=lukasstraub2@web.de;\n h=from:subject:message-id;\n bh=825HURWaTdxx68arWBum9/F1NbVpsOOl8RFvbUAzHSM=;\n b=owEBbQKS/ZANAwAKATWrCyicXbJYAcsmYgBpli893tf0jIN1S6F0L+fZz+duMCdcItYCam4f6\n HAXDRzjizOJAjMEAAEKAB0WIQSD+rFYoNm4+3Jij6Q1qwsonF2yWAUCaZYvPQAKCRA1qwsonF2y\n WDI/D/0YVWuN8VMS+bZscTgjPRv7oc70GwdfyJ6axmvzLQOAaB59GlbNGEIvyGNwCewQHSJpHK1\n c3Jmd60WxFEOMZo+k44wgY9Cb/X7vTrZkwJnIdPn0p2bpu/dErVi4vyxNttWPXQpPsLTNDLTpjn\n xrgzzd7ZYKvii4pAJLNVuaM42PXUgDPn/vZblvZatLwH2PdwyNuAdwksmOlMMvHOfrly2OQa7XY\n o8w5qjpoAAibWQmiwgaca3FC4ydBRRqnlldLjg5qlzWFA6ZGAkw86WoF60LcZ+oGRQV1awm7YHM\n PGsG66KPWEmcJ/M/FO0/F0tkICcZDFaD7s1ZSU1O3RMwWJw3ARC8V8cnefj78Wn4ireyB28YvOe\n dsZE/st4e4d5Zpkksn8QVH+699lEujxBHi48ZYPZ0zq4CSjD8fVVjyCVpXCHqbCGd4LEDQydVUM\n FUxIs5Bn/mflkk+x3qcPz2S45He1zrcJGEWSiOmuqz/Oc9ayzZp134K4pjdaV5X9Ft39zJjVPn+\n FhuxkNFBVqPUEXS1CGJDfGui/ZH0EN8Vl/fDrXz24DhGPKOfPP1QLjBXjeZjSn3MSBwpEIxkah5\n +wWJZuXv0sP2VChhKufANvFXF88UKpbHvIIy7tF4UgKNO+ixavPXeWIA1CXJ7yLpd+Pux6DHbTK\n Bjdx+jEjueRWM1w==",
        "X-Developer-Key": "i=lukasstraub2@web.de; a=openpgp;\n fpr=83FAB158A0D9B8FB72628FA435AB0B289C5DB258",
        "X-Provags-ID": "V03:K1:D2PWOogeSI/G41xhbpI8zc5OZ/sYJH6yFmzD/rLj2lPD95/TlKK\n jsDMOhZg0mDNBB7g+wTQR9y73+xbHu33PBwUxD54PA4mjUhUVky/vgJWcgsPOnlwL5wHrFF\n AjExoZYon6d4JnMaM7pP8U9Rml4TJC/7jFPQCjegMnwntZFCFDAFLnPhKOOZ5gqy3h+xmRa\n 7lAJaW25lwWuTKh4uvUIg==",
        "UI-OutboundReport": "notjunk:1;M01:P0:Qku4Qpve0JI=;q47It8I5hlvyOIW5dQmEqYUHnHG\n 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",
        "Received-SPF": "pass client-ip=212.227.15.4; envelope-from=lukasstraub2@web.de;\n helo=mout.web.de",
        "X-Spam_score_int": "-24",
        "X-Spam_score": "-2.5",
        "X-Spam_bar": "--",
        "X-Spam_report": "(-2.5 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,\n DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,\n FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7,\n RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001,\n RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, RCVD_IN_VALIDITY_SAFE_BLOCKED=0.001,\n SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no",
        "X-Spam_action": "no action",
        "X-BeenThere": "qemu-devel@nongnu.org",
        "X-Mailman-Version": "2.1.29",
        "Precedence": "list",
        "List-Id": "qemu development <qemu-devel.nongnu.org>",
        "List-Unsubscribe": "<https://lists.nongnu.org/mailman/options/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=unsubscribe>",
        "List-Archive": "<https://lists.nongnu.org/archive/html/qemu-devel>",
        "List-Post": "<mailto:qemu-devel@nongnu.org>",
        "List-Help": "<mailto:qemu-devel-request@nongnu.org?subject=help>",
        "List-Subscribe": "<https://lists.nongnu.org/mailman/listinfo/qemu-devel>,\n <mailto:qemu-devel-request@nongnu.org?subject=subscribe>",
        "Errors-To": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org",
        "Sender": "qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org"
    },
    "content": "Add a COLO migration test for COLO migration and failover.\n\nReviewed-by: Fabiano Rosas <farosas@suse.de>\nTested-by: Fabiano Rosas <farosas@suse.de>\nReviewed-by: Peter Xu <peterx@redhat.com>\nSigned-off-by: Lukas Straub <lukasstraub2@web.de>\n---\n MAINTAINERS                        |   1 +\n tests/qtest/meson.build            |   7 +-\n tests/qtest/migration-test.c       |   1 +\n tests/qtest/migration/colo-tests.c | 198 +++++++++++++++++++++++++++++++++++++\n tests/qtest/migration/framework.h  |   5 +\n 5 files changed, 211 insertions(+), 1 deletion(-)",
    "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 5519ea4e163229a9bbc06318a0ee06d88ba6a8a1..a587a9233ac556a420f8784c4e3217e5c5b99f34 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -3871,6 +3871,7 @@ F: migration/colo*\n F: migration/multifd-colo.*\n F: include/migration/colo.h\n F: include/migration/failover.h\n+F: tests/qtest/migration/colo-tests.c\n F: docs/COLO-FT.txt\n \n COLO Proxy\ndiff --git a/tests/qtest/meson.build b/tests/qtest/meson.build\nindex 25fdbc798010b19e8ec9b6ab55e02d3fb5741398..6a46e2a767de12d978d910ddb6de175bce9810b8 100644\n--- a/tests/qtest/meson.build\n+++ b/tests/qtest/meson.build\n@@ -374,6 +374,11 @@ if gnutls.found()\n   endif\n endif\n \n+migration_colo_files = []\n+if get_option('replication').allowed()\n+  migration_colo_files = [files('migration/colo-tests.c')]\n+endif\n+\n qtests = {\n   'aspeed_hace-test': files('aspeed-hace-utils.c', 'aspeed_hace-test.c'),\n   'aspeed_smc-test': files('aspeed-smc-utils.c', 'aspeed_smc-test.c'),\n@@ -385,7 +390,7 @@ qtests = {\n                              'migration/migration-util.c') + dbus_vmstate1,\n   'erst-test': files('erst-test.c'),\n   'ivshmem-test': [rt, '../../contrib/ivshmem-server/ivshmem-server.c'],\n-  'migration-test': test_migration_files + migration_tls_files,\n+  'migration-test': test_migration_files + migration_tls_files + migration_colo_files,\n   'pxe-test': files('boot-sector.c'),\n   'pnv-xive2-test': files('pnv-xive2-common.c', 'pnv-xive2-flush-sync.c',\n                           'pnv-xive2-nvpg_bar.c'),\ndiff --git a/tests/qtest/migration-test.c b/tests/qtest/migration-test.c\nindex 08936871741535c926eeac40a7d7c3f461c72fd0..e582f05c7dc2673dbd05a936df8feb6c964b5bbc 100644\n--- a/tests/qtest/migration-test.c\n+++ b/tests/qtest/migration-test.c\n@@ -55,6 +55,7 @@ int main(int argc, char **argv)\n     migration_test_add_precopy(env);\n     migration_test_add_cpr(env);\n     migration_test_add_misc(env);\n+    migration_test_add_colo(env);\n \n     ret = g_test_run();\n \ndiff --git a/tests/qtest/migration/colo-tests.c b/tests/qtest/migration/colo-tests.c\nnew file mode 100644\nindex 0000000000000000000000000000000000000000..598a1d3821ed0a90318732702027cebad47352fd\n--- /dev/null\n+++ b/tests/qtest/migration/colo-tests.c\n@@ -0,0 +1,198 @@\n+/*\n+ * SPDX-License-Identifier: GPL-2.0-or-later\n+ *\n+ * QTest testcases for COLO migration\n+ *\n+ * Copyright (c) 2025 Lukas Straub <lukasstraub2@web.de>\n+ *\n+ * This work is licensed under the terms of the GNU GPL, version 2 or later.\n+ * See the COPYING file in the top-level directory.\n+ *\n+ */\n+\n+#include \"qemu/osdep.h\"\n+#include \"libqtest.h\"\n+#include \"migration/framework.h\"\n+#include \"migration/migration-qmp.h\"\n+#include \"migration/migration-util.h\"\n+#include \"qemu/module.h\"\n+\n+static int test_colo_common(MigrateCommon *args,\n+                            bool failover_during_checkpoint,\n+                            bool primary_failover)\n+{\n+    QTestState *from, *to;\n+    void *data_hook = NULL;\n+\n+    /*\n+     * For the COLO test, both VMs will run in parallel. Thus both VMs want to\n+     * open the image read/write at the same time. Using read-only=on is not\n+     * possible here, because ide-hd does not support read-only backing image.\n+     *\n+     * So use -snapshot, where each qemu instance creates its own writable\n+     * snapshot internally while leaving the real image read-only.\n+     */\n+    args->start.opts_source = \"-snapshot\";\n+    args->start.opts_target = \"-snapshot\";\n+\n+    /*\n+     * COLO migration code logs many errors when the migration socket\n+     * is shut down, these are expected so we hide them here.\n+     */\n+    args->start.hide_stderr = true;\n+\n+    /*\n+     * Test with yank with out of band capability since that is how it is\n+     * used in production.\n+     */\n+    args->start.oob = true;\n+    args->start.caps[MIGRATION_CAPABILITY_X_COLO] = true;\n+\n+    if (migrate_start(&from, &to, args->listen_uri, &args->start)) {\n+        return -1;\n+    }\n+\n+    migrate_set_parameter_int(from, \"x-checkpoint-delay\", 300);\n+\n+    if (args->start_hook) {\n+        data_hook = args->start_hook(from, to);\n+    }\n+\n+    migrate_ensure_converge(from);\n+    wait_for_serial(\"src_serial\");\n+\n+    migrate_qmp(from, to, args->connect_uri, NULL, \"{}\");\n+\n+    wait_for_migration_status(from, \"colo\", NULL);\n+    wait_for_resume(to, get_dst());\n+\n+    wait_for_serial(\"src_serial\");\n+    wait_for_serial(\"dest_serial\");\n+\n+    /* wait for 3 checkpoints */\n+    for (int i = 0; i < 3; i++) {\n+        qtest_qmp_eventwait(to, \"RESUME\");\n+        wait_for_serial(\"src_serial\");\n+        wait_for_serial(\"dest_serial\");\n+    }\n+\n+    if (failover_during_checkpoint) {\n+        qtest_qmp_eventwait(to, \"STOP\");\n+    }\n+    if (primary_failover) {\n+        qtest_qmp_assert_success(from, \"{'exec-oob': 'yank', 'id': 'yank-cmd', \"\n+                                            \"'arguments': {'instances':\"\n+                                                \"[{'type': 'migration'}]}}\");\n+        qtest_qmp_assert_success(from, \"{'execute': 'x-colo-lost-heartbeat'}\");\n+        wait_for_serial(\"src_serial\");\n+    } else {\n+        qtest_qmp_assert_success(to, \"{'exec-oob': 'yank', 'id': 'yank-cmd', \"\n+                                        \"'arguments': {'instances':\"\n+                                            \"[{'type': 'migration'}]}}\");\n+        qtest_qmp_assert_success(to, \"{'execute': 'x-colo-lost-heartbeat'}\");\n+        wait_for_serial(\"dest_serial\");\n+    }\n+\n+    if (args->end_hook) {\n+        args->end_hook(from, to, data_hook);\n+    }\n+\n+    migrate_end(from, to, !primary_failover);\n+\n+    return 0;\n+}\n+\n+static void test_colo_plain_common(MigrateCommon *args,\n+                                   bool failover_during_checkpoint,\n+                                   bool primary_failover)\n+{\n+    args->listen_uri = \"tcp:127.0.0.1:0\";\n+    test_colo_common(args, failover_during_checkpoint, primary_failover);\n+}\n+\n+static void *hook_start_multifd(QTestState *from, QTestState *to)\n+{\n+    return migrate_hook_start_precopy_tcp_multifd_common(from, to, \"none\");\n+}\n+\n+static void test_colo_multifd_common(MigrateCommon *args,\n+                                     bool failover_during_checkpoint,\n+                                     bool primary_failover)\n+{\n+    args->listen_uri = \"defer\";\n+    args->start_hook = hook_start_multifd;\n+    args->start.caps[MIGRATION_CAPABILITY_MULTIFD] = true;\n+    test_colo_common(args, failover_during_checkpoint, primary_failover);\n+}\n+\n+static void test_colo_plain_primary_failover(char *name, MigrateCommon *args)\n+{\n+    test_colo_plain_common(args, false, true);\n+}\n+\n+static void test_colo_plain_secondary_failover(char *name, MigrateCommon *args)\n+{\n+    test_colo_plain_common(args, false, false);\n+}\n+\n+static void test_colo_multifd_primary_failover(char *name, MigrateCommon *args)\n+{\n+    test_colo_multifd_common(args, false, true);\n+}\n+\n+static void test_colo_multifd_secondary_failover(char *name,\n+                                                 MigrateCommon *args)\n+{\n+    test_colo_multifd_common(args, false, false);\n+}\n+\n+static void test_colo_plain_primary_failover_checkpoint(char *name,\n+                                                        MigrateCommon *args)\n+{\n+    test_colo_plain_common(args, true, true);\n+}\n+\n+static void test_colo_plain_secondary_failover_checkpoint(char *name,\n+                                                          MigrateCommon *args)\n+{\n+    test_colo_plain_common(args, true, false);\n+}\n+\n+static void test_colo_multifd_primary_failover_checkpoint(char *name,\n+                                                          MigrateCommon *args)\n+{\n+    test_colo_multifd_common(args, true, true);\n+}\n+\n+static void test_colo_multifd_secondary_failover_checkpoint(char *name,\n+                                                            MigrateCommon *args)\n+{\n+    test_colo_multifd_common(args, true, false);\n+}\n+\n+void migration_test_add_colo(MigrationTestEnv *env)\n+{\n+    if (!env->full_set) {\n+        return;\n+    }\n+\n+    migration_test_add(\"/migration/colo/plain/primary_failover\",\n+                       test_colo_plain_primary_failover);\n+    migration_test_add(\"/migration/colo/plain/secondary_failover\",\n+                       test_colo_plain_secondary_failover);\n+\n+    migration_test_add(\"/migration/colo/multifd/primary_failover\",\n+                       test_colo_multifd_primary_failover);\n+    migration_test_add(\"/migration/colo/multifd/secondary_failover\",\n+                       test_colo_multifd_secondary_failover);\n+\n+    migration_test_add(\"/migration/colo/plain/primary_failover_checkpoint\",\n+                       test_colo_plain_primary_failover_checkpoint);\n+    migration_test_add(\"/migration/colo/plain/secondary_failover_checkpoint\",\n+                       test_colo_plain_secondary_failover_checkpoint);\n+\n+    migration_test_add(\"/migration/colo/multifd/primary_failover_checkpoint\",\n+                       test_colo_multifd_primary_failover_checkpoint);\n+    migration_test_add(\"/migration/colo/multifd/secondary_failover_checkpoint\",\n+                       test_colo_multifd_secondary_failover_checkpoint);\n+}\ndiff --git a/tests/qtest/migration/framework.h b/tests/qtest/migration/framework.h\nindex 40984d04930da2d181326d9f6a742bde49018103..80eef758932ce9c301ed6c0f6383d18756144870 100644\n--- a/tests/qtest/migration/framework.h\n+++ b/tests/qtest/migration/framework.h\n@@ -264,5 +264,10 @@ void migration_test_add_file(MigrationTestEnv *env);\n void migration_test_add_precopy(MigrationTestEnv *env);\n void migration_test_add_cpr(MigrationTestEnv *env);\n void migration_test_add_misc(MigrationTestEnv *env);\n+#ifdef CONFIG_REPLICATION\n+void migration_test_add_colo(MigrationTestEnv *env);\n+#else\n+static inline void migration_test_add_colo(MigrationTestEnv *env) {};\n+#endif\n \n #endif /* TEST_FRAMEWORK_H */\n",
    "prefixes": [
        "v9",
        "13/19"
    ]
}