Show a cover letter.

GET /api/1.2/covers/2221489/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "id": 2221489,
    "url": "http://patchwork.ozlabs.org/api/1.2/covers/2221489/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/cover/20260409141352.997844-1-akrowiak@linux.ibm.com/",
    "project": {
        "id": 14,
        "url": "http://patchwork.ozlabs.org/api/1.2/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": "<20260409141352.997844-1-akrowiak@linux.ibm.com>",
    "list_archive_url": null,
    "date": "2026-04-09T14:13:43",
    "name": "[v2,0/2] Enable live migration of vfio-ap devices",
    "submitter": {
        "id": 74509,
        "url": "http://patchwork.ozlabs.org/api/1.2/people/74509/?format=api",
        "name": "Anthony Krowiak",
        "email": "akrowiak@linux.ibm.com"
    },
    "mbox": "http://patchwork.ozlabs.org/project/qemu-devel/cover/20260409141352.997844-1-akrowiak@linux.ibm.com/mbox/",
    "series": [
        {
            "id": 499308,
            "url": "http://patchwork.ozlabs.org/api/1.2/series/499308/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/qemu-devel/list/?series=499308",
            "date": "2026-04-09T14:13:44",
            "name": "Enable live migration of vfio-ap devices",
            "version": 2,
            "mbox": "http://patchwork.ozlabs.org/series/499308/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/covers/2221489/comments/",
    "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 unprotected) header.d=ibm.com header.i=@ibm.com header.a=rsa-sha256\n header.s=pp1 header.b=Dn8s4aUI;\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 (lists1p.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 4fs24S4Lzxz1yD3\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 10 Apr 2026 00:14:32 +1000 (AEST)",
            "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 1wAq91-0008Ms-UK; Thu, 09 Apr 2026 10:14:08 -0400",
            "from eggs.gnu.org ([2001:470:142:3::10])\n by lists1p.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <akrowiak@linux.ibm.com>)\n id 1wAq8y-0008MC-1P; Thu, 09 Apr 2026 10:14:04 -0400",
            "from mx0b-001b2d01.pphosted.com ([148.163.158.5])\n by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)\n (Exim 4.90_1) (envelope-from <akrowiak@linux.ibm.com>)\n id 1wAq8w-0000hP-9o; Thu, 09 Apr 2026 10:14:03 -0400",
            "from pps.filterd (m0360072.ppops.net [127.0.0.1])\n by mx0a-001b2d01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id\n 639CB9RU2299314; Thu, 9 Apr 2026 14:13:59 GMT",
            "from ppma23.wdc07v.mail.ibm.com\n (5d.69.3da9.ip4.static.sl-reverse.com [169.61.105.93])\n by mx0a-001b2d01.pphosted.com (PPS) with ESMTPS id 4dcn2g4g6p-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n Thu, 09 Apr 2026 14:13:59 +0000 (GMT)",
            "from pps.filterd (ppma23.wdc07v.mail.ibm.com [127.0.0.1])\n by ppma23.wdc07v.mail.ibm.com (8.18.1.2/8.18.1.2) with ESMTP id\n 639Cx1PU013878;\n Thu, 9 Apr 2026 14:13:58 GMT",
            "from smtprelay07.dal12v.mail.ibm.com ([172.16.1.9])\n by ppma23.wdc07v.mail.ibm.com (PPS) with ESMTPS id 4dcmf4bvyw-1\n (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT);\n Thu, 09 Apr 2026 14:13:58 +0000",
            "from smtpav05.dal12v.mail.ibm.com (smtpav05.dal12v.mail.ibm.com\n [10.241.53.104])\n by smtprelay07.dal12v.mail.ibm.com (8.14.9/8.14.9/NCO v10.0) with ESMTP id\n 639EDv6w29295196\n (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK);\n Thu, 9 Apr 2026 14:13:57 GMT",
            "from smtpav05.dal12v.mail.ibm.com (unknown [127.0.0.1])\n by IMSVA (Postfix) with ESMTP id 6E0C858056;\n Thu,  9 Apr 2026 14:13:57 +0000 (GMT)",
            "from smtpav05.dal12v.mail.ibm.com (unknown [127.0.0.1])\n by IMSVA (Postfix) with ESMTP id AB40B58052;\n Thu,  9 Apr 2026 14:13:56 +0000 (GMT)",
            "from li-4c4c4544-004d-4810-8043-b7c04f423534.ibm.com.com (unknown\n [9.61.93.104]) by smtpav05.dal12v.mail.ibm.com (Postfix) with ESMTP;\n Thu,  9 Apr 2026 14:13:56 +0000 (GMT)"
        ],
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=ibm.com; h=cc\n :content-transfer-encoding:date:from:message-id:mime-version\n :subject:to; s=pp1; bh=XmwhI/+bp6xBgcb26bOsoNEpsyBXRkoa4vCt/Mxc5\n X4=; b=Dn8s4aUIzlTU67YYhAWWTmGa8Oy3p5AFp+EYfnBP8WZhzizKy0ARvHq9A\n K4vIKHQl3NzPW0k4OmgbGhYRKq6zL6KmL7kPFerb5/9Az1fiaNc/eTkpeKi9rv4N\n bpC0cUasEQt169NIxT5xQpeGuSJfEk9Fdhy1CQoyRkOxcyUgLF6i/H5jiAlKY8hN\n Q1Gb+lfON/NUJlSIl1Nq1xEIb58eAPRrj+VXHGV+lnSL0XxuGRzeUufBO4glJTV6\n 6H6UrnqwFPcuV9K5wTH6wrGwNZQwx02lwhzdYkbsWVcFcgqY+qFg4PauWD3gp6D1\n N+Ukkm3SuQLbOSgo7HqApE3xcx47g==",
        "From": "Anthony Krowiak <akrowiak@linux.ibm.com>",
        "To": "qemu-devel@nongnu.org",
        "Cc": "qemu-s390x@nongnu.org, mjrosato@linux.ibm.com, jjherne@linux.ibm.com,\n pasic@linux.ibm.com, clg@redhat.com, farman@linux.ibm.com,\n borntraeger@linux.ibm.com, alex@shazbot.org, cohuck@redhat.com,\n Anthony Krowiak <akrowiak@linux.ibm.com>",
        "Subject": "[PATCH v2 0/2] Enable live migration of vfio-ap devices",
        "Date": "Thu,  9 Apr 2026 10:13:43 -0400",
        "Message-ID": "<20260409141352.997844-1-akrowiak@linux.ibm.com>",
        "X-Mailer": "git-send-email 2.52.0",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "X-TM-AS-GCONF": "00",
        "X-Authority-Analysis": "v=2.4 cv=KeridwYD c=1 sm=1 tr=0 ts=69d7b427 cx=c_pps\n a=3Bg1Hr4SwmMryq2xdFQyZA==:117 a=3Bg1Hr4SwmMryq2xdFQyZA==:17\n a=A5OVakUREuEA:10 a=VkNPw1HP01LnGYTKEx00:22 a=RnoormkPH1_aCDwRdu11:22\n a=RzCfie-kr_QcCd8fBx8p:22 a=D19gQVrFAAAA:8 a=s1Sn9qFGmzIT4Zlq7skA:9\n a=W4TVW4IDbPiebHqcZpNg:22",
        "X-Proofpoint-ORIG-GUID": "qTMOa3XC8jTXLtnEfKi1UZOekzfHxBOF",
        "X-Proofpoint-GUID": "qTMOa3XC8jTXLtnEfKi1UZOekzfHxBOF",
        "X-Proofpoint-Spam-Details-Enc": "AW1haW4tMjYwNDA5MDEyNiBTYWx0ZWRfXyFyTFsFS+dvv\n nE7t+pQwsIgOQ22AIqdTbVI32PX9sTzIoM3PpMLgYqDnObF+ruiKtwGdXneLOd7fXqr8880c8r2\n H06eyFJy90gJ3mNDsGGMHDb25MlT4XIdKlH/Q7aOOZ3TYFzVFvhSO5vKI20D19uuHP/vShADXHr\n XwVmLYwa88vMkLUrSvk6IJyapX3ce185FTVV4A9LJcbnEw4r8Fp3XOONxXhTJ0ZhoLF523+O0oi\n dvnPp9NQm1QRqYTcmgPH7aKFqvzXTRHcepl83uGdFVs3/AUPxU05Xhme/ebtmN5D0DWprcxQYR5\n oK4JIFEss8fB3MneqrdPYvJKcf+SqmSh4yG6pFNMzE3f8UwuvINSLYC7yYjd6V8+YcBevwZ6wST\n KZGyfMgCgJ4QnPkEBkCGaG6svWmBUmJjJn50rXphXQln5q9vP2f5Dm1qWF8jyQbIl4mmcgN+20p\n af/7DC0Ve+DpbvP0rmQ==",
        "X-Proofpoint-Virus-Version": "vendor=baseguard\n engine=ICAP:2.0.293,Aquarius:18.0.1143,Hydra:6.1.51,FMLib:17.12.100.49\n definitions=2026-04-09_04,2026-04-09_02,2025-10-01_01",
        "X-Proofpoint-Spam-Details": "rule=outbound_notspam policy=outbound score=0\n suspectscore=0 malwarescore=0 lowpriorityscore=0 adultscore=0 impostorscore=0\n clxscore=1011 phishscore=0 priorityscore=1501 spamscore=0 bulkscore=0\n classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0\n reason=mlx scancount=1 engine=8.22.0-2604010000 definitions=main-2604090126",
        "Received-SPF": "pass client-ip=148.163.158.5;\n envelope-from=akrowiak@linux.ibm.com; helo=mx0b-001b2d01.pphosted.com",
        "X-Spam_score_int": "-26",
        "X-Spam_score": "-2.7",
        "X-Spam_bar": "--",
        "X-Spam_report": "(-2.7 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,\n DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, 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": "This patch series enables live guest migration for s390 guests using\nAP (Adjunct Processor) crypto devices passed through via the VFIO\nframework.\n\nThe s390 AP architecture provides cryptographic coprocessor and accelerator\nfunctions to guests. The vfio_ap device driver allows these AP devices to\nbe passed through to KVM guests, giving them access to the cryptographic \ncapabilities of CEXxS crypto cards.\n\nPreviously, guests using vfio-ap devices could not be migrated because the\ndevice was marked as unmigratable. This series implements the necessary\nQEMU-side support to enable migration by:\n\n* Removing the migration blocker and adding proper VMState infrastructure\n* Implementing the VFIO migration callbacks that coordinate with the kernel\n  vfio_ap driver to save and restore device state\n\nThe actual AP device state (queue configurations, crypto adapter\nassignments, etc.) is managed entirely by the kernel vfio_ap driver and\ntransferred via the VFIO migration protocol. QEMU's role is to coordinate\nthe migration process and ensure proper sequencing of state transfers.\n\nThis implementation follows the standard VFIO migration framework used by\nother VFIO device types (GPUs, network adapters, etc.) and integrates\ncleanly with QEMU's existing migration infrastructure.\n\nDependencies:\n------------\n* Requires corresponding kernel patches that implement the VFIO migration\n  protocol in the vfio_ap driver\n    - see kernel patch series at https://lkml.org/lkml/2026/4/7/1991\n* Kernel must support VFIO_DEVICE_FEATURE_MIGRATION for vfio-ap devices\n\nAnthony  Krowiak (1):\n  hw/vfio/ap: Callbacks for migration of guests with pass-through access\n    to AP devices\n\nAnthony Krowiak (1):\n  hw/vfio/ap: Extend vfio device state description to facilitate live\n    migration\n\n hw/vfio/ap.c | 60 ++++++++++++++++++++++++++++++++++++++++++----------\n 1 file changed, 49 insertions(+), 11 deletions(-)"
}