get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 2195186,
    "url": "http://patchwork.ozlabs.org/api/patches/2195186/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260210-colo_unit_test_multifd-v7-14-23bd32f36828@web.de/",
    "project": {
        "id": 14,
        "url": "http://patchwork.ozlabs.org/api/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": "",
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20260210-colo_unit_test_multifd-v7-14-23bd32f36828@web.de>",
    "list_archive_url": null,
    "date": "2026-02-10T14:26:26",
    "name": "[v7,14/18] 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/people/76468/?format=api",
        "name": "Lukas Straub",
        "email": "lukasstraub2@web.de"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260210-colo_unit_test_multifd-v7-14-23bd32f36828@web.de/mbox/",
    "series": [
        {
            "id": 491685,
            "url": "http://patchwork.ozlabs.org/api/series/491685/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/list/?series=491685",
            "date": "2026-02-10T14:26:13",
            "name": "migration: Add COLO multifd support and COLO migration unit test",
            "version": 7,
            "mbox": "http://patchwork.ozlabs.org/series/491685/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/patches/2195186/comments/",
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/2195186/checks/",
    "tags": {},
    "related": [],
    "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=DXdFdSSr;\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 4f9P6Q32Fcz1xtr\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 11 Feb 2026 01:27:42 +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 1vpohe-00059U-Bd; Tue, 10 Feb 2026 09:27:00 -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 1vpohV-00056V-On\n for qemu-devel@nongnu.org; Tue, 10 Feb 2026 09:26:50 -0500",
            "from mout.web.de ([212.227.15.3])\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 1vpohT-0005kS-N6\n for qemu-devel@nongnu.org; Tue, 10 Feb 2026 09:26:49 -0500",
            "from [127.0.1.1] ([141.58.43.188]) by smtp.web.de (mrweb005\n [213.165.67.108]) with ESMTPSA (Nemesis) id 1MHVen-1w2nFz0QaH-008BTT; Tue, 10\n Feb 2026 15:26:42 +0100"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=web.de;\n s=s29768273; t=1770733602; x=1771338402; i=lukasstraub2@web.de;\n bh=zZmWjHjQ6lItQ14ur7yHrRObdhRj00cj/OHH9WFRmcQ=;\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=DXdFdSSrHTmf5mdA9a/CZSJXGWIXtw5cfHRG0vWaCJZ2OG0YUdP0kmxpveMerNDs\n X3c+f1HdhgIyeLvpt1LcZzbAGCNQ7kkPbqtKtVQBhXBOfP7H/B/jY4rPpM48WuKn9\n hw5qobfbsbiFdh+nccmkbJw+8rQ2Ps9gYbkDwoOfgZ+TF8yYtek/jPpQDJEHOdtMl\n SeeGt5fb0OjwSUl1TlQcmqIx0brinB9dnpEjocFCNvrfOmzMW25fALsDv51fDUBKD\n cHHweOAmQ0FgEDv2J5EXmp83eLLjhlyF+7KA9tWOsmoon82tbbMpFbAM7XIAat3Ko\n F8tlCSNrmBa5mGKgow==",
        "X-UI-Sender-Class": "814a7b36-bfc1-4dae-8640-3722d8ec6cd6",
        "From": "Lukas Straub <lukasstraub2@web.de>",
        "Date": "Tue, 10 Feb 2026 15:26:26 +0100",
        "Subject": "[PATCH v7 14/18] 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": "<20260210-colo_unit_test_multifd-v7-14-23bd32f36828@web.de>",
        "References": "<20260210-colo_unit_test_multifd-v7-0-23bd32f36828@web.de>",
        "In-Reply-To": "<20260210-colo_unit_test_multifd-v7-0-23bd32f36828@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=l0keOMCpjfwRRBppboSoF5o5+YBX7iahZfhZmMFJqtU=;\n b=owEBbQKS/ZANAwAKATWrCyicXbJYAcsmYgBpi0AcfKULB/P6IpP4IVQ60eJlBQtPGydA/LbZj\n jdOmzAi5yKJAjMEAAEKAB0WIQSD+rFYoNm4+3Jij6Q1qwsonF2yWAUCaYtAHAAKCRA1qwsonF2y\n WEenD/4zfcRgF0kvz26M0//xRrM1//4xAjd79QY2hdBqyVq9ai8wXa1s1R67J9q91s67xEWCeNY\n hQqBkesy4BKYmy3Hu51Eb6YxDaxAMNHpUgT/+bNeue6MVfkSYx0IXJurox5g9NKphcXku7Jff01\n C7JMvNRBW60js+HtaDKLt39neLO2AJUz0iCZHBGwJ2o+047SA1OhceoYtUeuZMzodQRGeXUgBfA\n jCmdygIZ8Na0pGIJqJipiP5pvbm5oz5qZ7xwLi9X/IOt7JXe4fYtbU0sZPJymSd7Mi/Gypsq38Y\n WNHbsdogHWf4AAtzMcIT47a+Yxjb3Zx0bx5HBy90sIXxbddl8406bP6pceznJNWerLCHadVAHPn\n 2Ypjh3AGcVpFqLNOOzoPRdoOEviV56v1oAcNPvcgBfFQ0FnISTrTsl4syI46oRt4W2oMen2sMKU\n dtj0ue1lWi7IO4Qx0g8uukq+QsSJ746ghs5KSdPf1eKitCYdg53i6e1aHXB+jbMNGXiXL7UbFIj\n xFQFzVWcGvdh3sy8ss0MVwKbDRJJce89O+5De07T/KbBLe2SnqYUJvi/rjwD/uVzsPVO07AbaJ+\n lmd7h27D2hdleCzDWSqVwIdk5xyISPVA3Aamv2msmXQS/rR8cV1sbvSg6K0T2WhBCAv1l6NskaI\n tmRuKQNTa6e4NUQ==",
        "X-Developer-Key": "i=lukasstraub2@web.de; a=openpgp;\n fpr=83FAB158A0D9B8FB72628FA435AB0B289C5DB258",
        "X-Provags-ID": "V03:K1:hpyB3tkimoqeqfm9ufqQytwFU0dmO/uiFbUUGuM1MtoQpuTzvuP\n kHA0ub57dBxxdInPzVYyonAzFrYLAmVjaBltpReXiKP/9NXJd4DLpmDnzd88YZeJIHdom8b\n qHlNHC10HrNPKrhGLOw44VQEVouJPS90tWbOLTcoC3xikel0F4wTPR9TVBnzuWKaB2POR6S\n WaUNjuDTCouCwk7+hKECA==",
        "UI-OutboundReport": "notjunk:1;M01:P0:TJGNfslGWpI=;Z/Za60Hjh9jWU2pbnQj2QEA2Ar5\n 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",
        "Received-SPF": "pass client-ip=212.227.15.3; 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 e6e711ac8a333bb9bfa0d75c2c42dbe74b8523f2..fe6010929fc4cb83bc8a7686fbe537f1120f1eba 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -3862,6 +3862,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 dfb83650c643d884daad53a66034ab7aa8c45509..624f7744ec9bd81c8823075b966bc95f7750a667 100644\n--- a/tests/qtest/meson.build\n+++ b/tests/qtest/meson.build\n@@ -371,6 +371,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@@ -382,7 +387,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": [
        "v7",
        "14/18"
    ]
}