get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 2195187,
    "url": "http://patchwork.ozlabs.org/api/patches/2195187/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/patch/20260210-colo_unit_test_multifd-v7-9-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-9-23bd32f36828@web.de>",
    "list_archive_url": null,
    "date": "2026-02-10T14:26:21",
    "name": "[v7,09/18] multifd: Add COLO support",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "1e56f4b5c7f580a1cb5f34435e1639435748457c",
    "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-9-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/2195187/comments/",
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/2195187/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=YnzrhIgP;\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 4f9P6V0r00z1xtr\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 11 Feb 2026 01:27:46 +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 1vpohj-0005Do-8j; Tue, 10 Feb 2026 09:27:03 -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 1vpohR-00055l-7B\n for qemu-devel@nongnu.org; Tue, 10 Feb 2026 09:26:47 -0500",
            "from mout.web.de ([212.227.15.14])\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 1vpohO-0005ip-Hg\n for qemu-devel@nongnu.org; Tue, 10 Feb 2026 09:26:44 -0500",
            "from [127.0.1.1] ([141.58.43.188]) by smtp.web.de (mrweb005\n [213.165.67.108]) with ESMTPSA (Nemesis) id 1MHEXc-1w34Er06wC-007uUY; Tue, 10\n Feb 2026 15:26:41 +0100"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=web.de;\n s=s29768273; t=1770733601; x=1771338401; i=lukasstraub2@web.de;\n bh=EAb9TsMuWPPA3CZIfZr/ezHEKFwjsBr7eMTjDjKG9rc=;\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=YnzrhIgPT5lmTv/QYqBPRH929kZkIBgiUJ+UvzQ1XbgoWugXWoNRk8AKMlxfzqLX\n fQTHBQ+ls+wuP7OELDV8WrO7FRkvaJKHXZM6faTnhO/YwjMIsLG0dTqr1pQTQnZAG\n OZPyCS3LVcdS2G3w8keiq+QwgtXy2GZcl6FO83FugBUali0wXtqxSJtnexHAP4UCd\n pOW3Hv3xNUpl1QnBxME+tpsRw0EzDP9w4BQc1r968/udNwQHUhOCYESyEYz6ZgJou\n DZXPxhdjzkTdl/v2zOiWegVQ/iZq9dbHS9YkPK8RfdxzPF6d4yDzCaS4aGpzdducU\n kY+9mQekowCuYfBQXA==",
        "X-UI-Sender-Class": "814a7b36-bfc1-4dae-8640-3722d8ec6cd6",
        "From": "Lukas Straub <lukasstraub2@web.de>",
        "Date": "Tue, 10 Feb 2026 15:26:21 +0100",
        "Subject": "[PATCH v7 09/18] multifd: Add COLO support",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "quoted-printable",
        "Message-Id": "<20260210-colo_unit_test_multifd-v7-9-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>, Juan Quintela <quintela@trasno.org>",
        "X-Mailer": "b4 0.14.2",
        "X-Developer-Signature": "v=1; a=openpgp-sha256; l=7788; i=lukasstraub2@web.de;\n h=from:subject:message-id; bh=Abosr+xKE1nTrw2cz/Hd1u4moj2pYzHV7m3+DIZpG0A=;\n b=owEBbQKS/ZANAwAKATWrCyicXbJYAcsmYgBpi0AcRfRJt/Ru42BRI97V9T2XEllQJ+mYK8OgN\n rbTOXlvRgaJAjMEAAEKAB0WIQSD+rFYoNm4+3Jij6Q1qwsonF2yWAUCaYtAHAAKCRA1qwsonF2y\n WBwnD/9BoPYIGTHA703NY00M1f1NdcZ/GtKpkHPkVxvsTH9z2SZo4FeccSG+3pD1B/0h/+VMqZW\n +prwRwoYEyyS5GGhcXEygjbbIo/U6/Bi9fSUiSlafXLOBJ6h3vP6ibKpaaEk/3ZXHCmvCr+FCV/\n 15951eTZr5NlWMeeqfV26JDgAw0l+4ae/0l6/1ibaoUbGef3JbQBnH9cUHipjqTGRqiN42N65mu\n ggvi/2ExM1kEHR4S9iZOqtIcj+HLeNfJ2zCSLt8hSmkflLRrpZxM4Ov9Y1IwkAYU94Q3EyfPxAr\n umhq6wtvST3EQDl9XAH5wxy0X6WRAZYkMbjCHkDK4E0aPVjcV73ZbLHKP7rzAUaT+Y9zS9v2oBk\n dscOJzbuP8u2h+uDnmamSk9JPE+zUyjRJyl5ukOLLa1jYXIF+ZoZUFCWSDkLzwy/f3SJsTEuTfI\n 9JeUginFk+CRkoUdo77X6NgSxM+/Z39hM1fBzfag0uLtmweCnZ9YSD4aYaylDIVWjxtS0LwX587\n zMC+CC/ybf0gh9IcfbrvN2jIpZgtYbZGE9v0EWH2xUrVhLLpWKvfh3gIEGVvZlGTBgIi3kQV2b9\n 2UJpYMRAjIf5bw9DTpjm9+2BSBfMQ3prtFbMOr95iMr83cmWXVb1acX3Jtdb3MhilRL7VRtLBu5\n 2/atPnIEC9sFy3A==",
        "X-Developer-Key": "i=lukasstraub2@web.de; a=openpgp;\n fpr=83FAB158A0D9B8FB72628FA435AB0B289C5DB258",
        "X-Provags-ID": "V03:K1:UCxpkXHPJRO+kUhAU09EFDbQ8NK+qv1R+rgD49oPfjeg7pVcYxA\n zcztr8NnjkpJbs7ILkWR67gJ9Ba/DsiougDtycedFyBPdvzNZUtqrTabh+O8w2one117Rid\n cugNBs3l6uPphvmpqECDYPpMgsTVyl1gx3KykESYd8JyoLeNTIRC+wNjkmPFWxf2+855m5h\n xI3AqUarvnWpDI2VUFKXA==",
        "UI-OutboundReport": "notjunk:1;M01:P0:i8Cip7sevqY=;jp7S3A23NKIbeaDTZv1KA4q2Oqu\n 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\n rVngFpPU=",
        "Received-SPF": "pass client-ip=212.227.15.14; 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_H4=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": "Like in the normal ram_load() path, put the received pages into the\ncolo cache and mark the pages in the bitmap so that they will be\nflushed to the guest later.\n\nMultifd with COLO is useful to reduce the VM pause time during checkpointing\nfor latency sensitive workloads. In such workloads the worst-case latency\nis especially important.\n\nAlso, this is already worth it for the precopy phase as it helps with\nconverging. Moreover, multifd migration is the preferred way to do migration\nnowadays and this allows to use multifd compression with COLO.\n\nBenchmark:\nCluster nodes\n - Intel Xenon E5-2630 v3\n - 48Gb RAM\n - 10G Ethernet\nGuest\n - Windows Server 2016\n - 6Gb RAM\n - 4 cores\nWorkload\n - Upload a file to the guest with SMB to simulate moderate\n   memory dirtying\n - Measure the memory transfer time portion of each checkpoint\n - 600ms COLO checkpoint interval\n\nResults\nPlain\n idle mean: 4.50ms 99per: 10.33ms\n load mean: 24.30ms 99per: 78.05ms\nMultifd-4\n idle mean: 6.48ms 99per: 10.41ms\n load mean: 14.12ms 99per: 31.27ms\n\nEvaluation\nWhile multifd has slightly higher latency when the guest idles, it is\n10ms faster under load and more importantly it's worst case latency is\nless than 1/2 of plain under load as can be seen in the 99. Percentile.\n\nSigned-off-by: Juan Quintela <quintela@redhat.com>\nReviewed-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 migration/meson.build      |  2 +-\n migration/multifd-colo.c   | 44 ++++++++++++++++++++++++++++++++++++++++++++\n migration/multifd-colo.h   | 26 ++++++++++++++++++++++++++\n migration/multifd-nocomp.c | 10 +++++++++-\n migration/multifd.c        |  8 ++++++++\n migration/multifd.h        |  5 ++++-\n 7 files changed, 93 insertions(+), 3 deletions(-)",
    "diff": "diff --git a/MAINTAINERS b/MAINTAINERS\nindex 356e3a7889f9ab45f002f165112322e6fb5a1967..e6e711ac8a333bb9bfa0d75c2c42dbe74b8523f2 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -3859,6 +3859,7 @@ COLO Framework\n M: Lukas Straub <lukasstraub2@web.de>\n S: Maintained\n F: migration/colo*\n+F: migration/multifd-colo.*\n F: include/migration/colo.h\n F: include/migration/failover.h\n F: docs/COLO-FT.txt\ndiff --git a/migration/meson.build b/migration/meson.build\nindex c7f39bdb55239ecb0e775c77b90a1aa9e6a4a9ce..c9f0f5f9f2137536497e53e960ce70654ad1b394 100644\n--- a/migration/meson.build\n+++ b/migration/meson.build\n@@ -39,7 +39,7 @@ system_ss.add(files(\n ), gnutls, zlib)\n \n if get_option('replication').allowed()\n-  system_ss.add(files('colo-failover.c', 'colo.c'))\n+  system_ss.add(files('colo-failover.c', 'colo.c', 'multifd-colo.c'))\n else\n   system_ss.add(files('colo-stubs.c'))\n endif\ndiff --git a/migration/multifd-colo.c b/migration/multifd-colo.c\nnew file mode 100644\nindex 0000000000000000000000000000000000000000..f160c6543414d3e157a444d613c96df4c5f0e602\n--- /dev/null\n+++ b/migration/multifd-colo.c\n@@ -0,0 +1,44 @@\n+/*\n+ * SPDX-License-Identifier: GPL-2.0-or-later\n+ *\n+ * multifd colo implementation\n+ *\n+ * Copyright (c) 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+#include \"qemu/osdep.h\"\n+#include \"multifd.h\"\n+#include \"multifd-colo.h\"\n+#include \"migration/colo.h\"\n+#include \"system/ramblock.h\"\n+\n+void multifd_colo_prepare_recv(MultiFDRecvParams *p)\n+{\n+    /*\n+     * While we're still in precopy state (not yet in colo state), we copy\n+     * received pages to both guest and cache. No need to set dirty bits,\n+     * since guest and cache memory are in sync.\n+     */\n+    if (migration_incoming_in_colo_state()) {\n+        colo_record_bitmap(p->block, p->normal, p->normal_num);\n+        colo_record_bitmap(p->block, p->zero, p->zero_num);\n+    }\n+}\n+\n+void multifd_colo_process_recv(MultiFDRecvParams *p)\n+{\n+    if (!migration_incoming_in_colo_state()) {\n+        for (int i = 0; i < p->normal_num; i++) {\n+            void *guest = p->block->host + p->normal[i];\n+            void *cache = p->host + p->normal[i];\n+            memcpy(guest, cache, multifd_ram_page_size());\n+        }\n+        for (int i = 0; i < p->zero_num; i++) {\n+            void *guest = p->block->host + p->zero[i];\n+            memset(guest, 0, multifd_ram_page_size());\n+        }\n+    }\n+}\ndiff --git a/migration/multifd-colo.h b/migration/multifd-colo.h\nnew file mode 100644\nindex 0000000000000000000000000000000000000000..82eaf3f48c47de2f090f9de52f9d57a337d4754a\n--- /dev/null\n+++ b/migration/multifd-colo.h\n@@ -0,0 +1,26 @@\n+/*\n+ * SPDX-License-Identifier: GPL-2.0-or-later\n+ *\n+ * multifd colo header\n+ *\n+ * Copyright (c) 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+#ifndef QEMU_MIGRATION_MULTIFD_COLO_H\n+#define QEMU_MIGRATION_MULTIFD_COLO_H\n+\n+#ifdef CONFIG_REPLICATION\n+\n+void multifd_colo_prepare_recv(MultiFDRecvParams *p);\n+void multifd_colo_process_recv(MultiFDRecvParams *p);\n+\n+#else\n+\n+static inline void multifd_colo_prepare_recv(MultiFDRecvParams *p) {}\n+static inline void multifd_colo_process_recv(MultiFDRecvParams *p) {}\n+\n+#endif\n+#endif\ndiff --git a/migration/multifd-nocomp.c b/migration/multifd-nocomp.c\nindex 9be79b3b8e00371ebff9e112766c225bec260bf7..9f7a792fa761b3bc30b971b35f464103a61787f0 100644\n--- a/migration/multifd-nocomp.c\n+++ b/migration/multifd-nocomp.c\n@@ -16,6 +16,7 @@\n #include \"file.h\"\n #include \"migration-stats.h\"\n #include \"multifd.h\"\n+#include \"multifd-colo.h\"\n #include \"options.h\"\n #include \"migration.h\"\n #include \"qapi/error.h\"\n@@ -269,7 +270,6 @@ int multifd_ram_unfill_packet(MultiFDRecvParams *p, Error **errp)\n         return -1;\n     }\n \n-    p->host = p->block->host;\n     for (i = 0; i < p->normal_num; i++) {\n         uint64_t offset = be64_to_cpu(packet->offset[i]);\n \n@@ -294,6 +294,14 @@ int multifd_ram_unfill_packet(MultiFDRecvParams *p, Error **errp)\n         p->zero[i] = offset;\n     }\n \n+    if (migrate_colo()) {\n+        multifd_colo_prepare_recv(p);\n+        assert(p->block->colo_cache);\n+        p->host = p->block->colo_cache;\n+    } else {\n+        p->host = p->block->host;\n+    }\n+\n     return 0;\n }\n \ndiff --git a/migration/multifd.c b/migration/multifd.c\nindex 332e6fc58053462419f3171f6c320ac37648ef7b..220ed8564960fdabc58e4baa069dd252c8ad293c 100644\n--- a/migration/multifd.c\n+++ b/migration/multifd.c\n@@ -29,6 +29,7 @@\n #include \"qemu-file.h\"\n #include \"trace.h\"\n #include \"multifd.h\"\n+#include \"multifd-colo.h\"\n #include \"options.h\"\n #include \"qemu/yank.h\"\n #include \"io/channel-file.h\"\n@@ -1258,6 +1259,13 @@ static int multifd_ram_state_recv(MultiFDRecvParams *p, Error **errp)\n     int ret;\n \n     ret = multifd_recv_state->ops->recv(p, errp);\n+    if (ret != 0) {\n+        return ret;\n+    }\n+\n+    if (migrate_colo()) {\n+        multifd_colo_process_recv(p);\n+    }\n \n     return ret;\n }\ndiff --git a/migration/multifd.h b/migration/multifd.h\nindex 89a395aef2b09a6762c45b5361e0ab63256feff6..fbc35702b062fdc3213ce92baed35994f5967c2b 100644\n--- a/migration/multifd.h\n+++ b/migration/multifd.h\n@@ -279,7 +279,10 @@ typedef struct {\n     uint64_t packets_recved;\n     /* ramblock */\n     RAMBlock *block;\n-    /* ramblock host address */\n+    /*\n+     * Normally, it points to ramblock's host address.  When COLO\n+     * is enabled, it points to the mirror cache for the ramblock.\n+     */\n     uint8_t *host;\n     /* buffers to recv */\n     struct iovec *iov;\n",
    "prefixes": [
        "v7",
        "09/18"
    ]
}