Show a cover letter.

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

{
    "id": 2196896,
    "url": "http://patchwork.ozlabs.org/api/covers/2196896/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/uboot/cover/20260216-feature_fwumdata-v3-0-9ecc5b10456d@bootlin.com/",
    "project": {
        "id": 18,
        "url": "http://patchwork.ozlabs.org/api/projects/18/?format=api",
        "name": "U-Boot",
        "link_name": "uboot",
        "list_id": "u-boot.lists.denx.de",
        "list_email": "u-boot@lists.denx.de",
        "web_url": null,
        "scm_url": null,
        "webscm_url": null,
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20260216-feature_fwumdata-v3-0-9ecc5b10456d@bootlin.com>",
    "list_archive_url": null,
    "date": "2026-02-16T13:35:30",
    "name": "[v3,0/6] Add support for fwumdata",
    "submitter": {
        "id": 80520,
        "url": "http://patchwork.ozlabs.org/api/people/80520/?format=api",
        "name": "Kory Maincent",
        "email": "kory.maincent@bootlin.com"
    },
    "mbox": "http://patchwork.ozlabs.org/project/uboot/cover/20260216-feature_fwumdata-v3-0-9ecc5b10456d@bootlin.com/mbox/",
    "series": [
        {
            "id": 492310,
            "url": "http://patchwork.ozlabs.org/api/series/492310/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/uboot/list/?series=492310",
            "date": "2026-02-16T13:35:30",
            "name": "Add support for fwumdata",
            "version": 3,
            "mbox": "http://patchwork.ozlabs.org/series/492310/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/covers/2196896/comments/",
    "headers": {
        "Return-Path": "<u-boot-bounces@lists.denx.de>",
        "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=bootlin.com header.i=@bootlin.com header.a=rsa-sha256\n header.s=dkim header.b=gLdihYWu;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de\n (client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; helo=phobos.denx.de;\n envelope-from=u-boot-bounces@lists.denx.de; receiver=patchwork.ozlabs.org)",
            "phobos.denx.de;\n dmarc=pass (p=reject dis=none) header.from=bootlin.com",
            "phobos.denx.de;\n spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de",
            "phobos.denx.de;\n\tdkim=pass (2048-bit key;\n unprotected) header.d=bootlin.com header.i=@bootlin.com header.b=\"gLdihYWu\";\n\tdkim-atps=neutral",
            "phobos.denx.de;\n dmarc=pass (p=reject dis=none) header.from=bootlin.com",
            "phobos.denx.de;\n spf=pass smtp.mailfrom=kory.maincent@bootlin.com"
        ],
        "Received": [
            "from phobos.denx.de (phobos.denx.de\n [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4fF3h10TTkz1xpY\n\tfor <incoming@patchwork.ozlabs.org>; Tue, 17 Feb 2026 00:36:00 +1100 (AEDT)",
            "from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id 3B19283AAB;\n\tMon, 16 Feb 2026 14:35:58 +0100 (CET)",
            "by phobos.denx.de (Postfix, from userid 109)\n id 8B72383C6C; Mon, 16 Feb 2026 14:35:56 +0100 (CET)",
            "from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116])\n (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))\n (No client certificate requested)\n by phobos.denx.de (Postfix) with ESMTPS id 8F32B80FA1\n for <u-boot@lists.denx.de>; Mon, 16 Feb 2026 14:35:53 +0100 (CET)",
            "from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233])\n by smtpout-04.galae.net (Postfix) with ESMTPS id 0F36CC17858;\n Mon, 16 Feb 2026 13:36:04 +0000 (UTC)",
            "from mail.galae.net (mail.galae.net [212.83.136.155])\n by smtpout-01.galae.net (Postfix) with ESMTPS id DE410606CF;\n Mon, 16 Feb 2026 13:35:52 +0000 (UTC)",
            "from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon)\n with ESMTPSA id 14E2410369131; Mon, 16 Feb 2026 14:35:43 +0100 (CET)"
        ],
        "X-Spam-Checker-Version": "SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de",
        "X-Spam-Level": "",
        "X-Spam-Status": "No, score=-2.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,\n DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_BLOCKED,\n RCVD_IN_VALIDITY_CERTIFIED_BLOCKED,RCVD_IN_VALIDITY_RPBL_BLOCKED,\n SPF_HELO_PASS,SPF_PASS autolearn=ham autolearn_force=no version=3.4.2",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim;\n t=1771248951; h=from:subject:date:message-id:to:cc:mime-version:content-type:\n content-transfer-encoding; bh=etat9lP7rW9Gl7Jn6TftKzj7b2B8HYIRUdk/vU1Y9jE=;\n b=gLdihYWuq1j4bfwBsagMQzI4YE3FEO16OuqD8TZftEoYXidf1ngCG8muaJF8rEy/5K3jYP\n agaZB9tIjUNV9DCCMqqy/O4NYSIlG9j+53Iaxp6EavYX/6PsChbzIBZhTffqpeY8KCtRlR\n L73hz49OaukFZUEgkgWk29Tccs3Qhjs7XD6OuHcnxQQSwmHcOPCMBn4u63GKl1Pb4nm08M\n Mr4lhsSz2kd2fy245r9uTcBqCBx4jTZZInc6pX6uPUcHPA0mn94nue+pHCFichB9TGgZts\n /jHHA08EDtb+rD6Aj7xawEaCtJU/iLlS5s2SZ1dVzfHkzb1IdHpGV7DxiOnwHA==",
        "From": "Kory Maincent <kory.maincent@bootlin.com>",
        "Subject": "[PATCH v3 0/6] Add support for fwumdata",
        "Date": "Mon, 16 Feb 2026 14:35:30 +0100",
        "Message-Id": "<20260216-feature_fwumdata-v3-0-9ecc5b10456d@bootlin.com>",
        "MIME-Version": "1.0",
        "Content-Type": "text/plain; charset=\"utf-8\"",
        "Content-Transfer-Encoding": "8bit",
        "X-B4-Tracking": "v=1; b=H4sIACIdk2kC/23NwQ6CMAyA4VchOzuzDibIyfcwxgzWyRJhZhtTQ\n 3h3B140emnyN+nXiXh0Bj2ps4k4jMYbO6TINxlpOzlckBqVmnDGBQArqUYZRodnfR97JYOkohK\n sUjtAUDlJZzeH2jxW8nhK3RkfrHuuHyIs2zeWxi8WgTKqhABRKCyA5YfG2nA1w7a1PVm4yD8I+\n EfwREiViJLrBsv9NzHP8wvfp6U99QAAAA==",
        "To": "u-boot@lists.denx.de",
        "Cc": "Thomas Petazzoni <thomas.petazzoni@bootlin.com>,\n  Tom Rini <trini@konsulko.com>,\n  Patrice Chotard <patrice.chotard@foss.st.com>,\n  Paul HENRYS <paul.henrys_ext@softathome.com>,\n  Sughosh Ganu <sughosh.ganu@arm.com>, Greg Malysa <malysagreg@gmail.com>,\n  Arturs Artamonovs <arturs.artamonovs@analog.com>,\n  Vasileios Bimpikas <vasileios.bimpikas@analog.com>,\n  Utsav Agarwal <utsav.agarwal@analog.com>,\n  Nathan Barrett-Morrison <nathan.morrison@timesys.com>,\n  Peng Fan <peng.fan@nxp.com>, Simon Glass <sjg@chromium.org>, =?utf-8?q?Duj?=\n\t=?utf-8?q?e_Mihanovi=C4=87?= <duje@dujemihanovic.xyz>,\n  Stefan Roese <stefan.roese@mailbox.org>,\n  Mattijs Korpershoek <mkorpershoek@kernel.org>,\n  Sumit Garg <sumit.garg@kernel.org>, Heiko Schocher <hs@nabladev.com>,\n  Alif Zakuan Yuslaimi <alif.zakuan.yuslaimi@altera.com>,\n  E Shattow <e@freeshell.de>, Raymond Mao <raymondmaoca@gmail.com>,\n  Jan Kiszka <jan.kiszka@siemens.com>, Shiji Yang <yangshiji66@outlook.com>,\n  Daniel Golle <daniel@makrotopia.org>,\n  Heinrich Schuchardt <xypron.glpk@gmx.de>,\n  Ilias Apalodimas <ilias.apalodimas@linaro.org>,\n  Leonard Anderweit <l.anderweit@phytec.de>,\n  Kory Maincent <kory.maincent@bootlin.com>, Yao Zi <me@ziyao.cc>",
        "X-Mailer": "b4 0.14-dev-d4707",
        "X-Last-TLS-Session-Version": "TLSv1.3",
        "X-BeenThere": "u-boot@lists.denx.de",
        "X-Mailman-Version": "2.1.39",
        "Precedence": "list",
        "List-Id": "U-Boot discussion <u-boot.lists.denx.de>",
        "List-Unsubscribe": "<https://lists.denx.de/options/u-boot>,\n <mailto:u-boot-request@lists.denx.de?subject=unsubscribe>",
        "List-Archive": "<https://lists.denx.de/pipermail/u-boot/>",
        "List-Post": "<mailto:u-boot@lists.denx.de>",
        "List-Help": "<mailto:u-boot-request@lists.denx.de?subject=help>",
        "List-Subscribe": "<https://lists.denx.de/listinfo/u-boot>,\n <mailto:u-boot-request@lists.denx.de?subject=subscribe>",
        "Errors-To": "u-boot-bounces@lists.denx.de",
        "Sender": "\"U-Boot\" <u-boot-bounces@lists.denx.de>",
        "X-Virus-Scanned": "clamav-milter 0.103.8 at phobos.denx.de",
        "X-Virus-Status": "Clean"
    },
    "content": "Add a new fwumdata tool to allows users to read, display, and modify FWU\n(Firmware Update) metadata from Linux userspace. It provides functionality\nsimilar to fw_printenv/fw_setenv but for FWU metadata. Users can view\nmetadata, change active/previous bank indices, modify bank states, and set\nimage acceptance flags. Configuration is done via fwumdata.config file.\n\nMade a few change to mkfwumdata tool along the way.\n\nHere is an output example\n\n$ ./fwumdata -l\nFWU Metadata:\n\tVersion:            2\n\tActive Index:       0\n\tPrevious Index:     1\n\tCRC32:              0x1f21ff7b\n\tMetadata Size:      120 bytes\n\tDescriptor Offset:  32\n\tBank States:\n\t\tBank 0: accepted (0xfc)\n\t\tBank 1: accepted (0xfc)\n\n\tFirmware Store Descriptor:\n\t\tNumber of Banks:       2\n\t\tNumber of Images:      1\n\t\tImage Entry Size:      80\n\t\tBank Info Entry Size:  24\n\n\tImages:\n\t\tImage 0:\n\t\t\tImage Type GUID:  65ae85ad-1fb3-0b46-8c5d-285543aa6eab\n\t\t\tLocation GUID:    51513491-da07-2a4f-9bea-375ea53b1b5c\n\t\t\tBanks:\n\t\t\t\tBank 0:\n\t\t\t\t\tImage GUID:  cb2df442-f929-6a44-a374-672d92eb2aa7\n\t\t\t\t\tAccepted:    yes (1)\n\t\t\t\tBank 1:\n\t\t\t\t\tImage GUID:  a839a18f-395c-484f-83b8-0354077c8f9f\n\t\t\t\t\tAccepted:    yes (1)\nChanges in v3:\n- Rebase on master.\n- Link to v2: https://lore.kernel.org/r/20251212-feature_fwumdata-v2-0-ad51572fbe79@bootlin.com\n\nChanges in v2:\n- Fix a small offset mistake in last patch\n\nSigned-off-by: Kory Maincent <kory.maincent@bootlin.com>\n---\nKory Maincent (6):\n      tools: gitignore: Add mkfwumdata to the git ignore file\n      tools: Reorganize mkfwumdata tool into fwumdata_src directory\n      tools: mkfwumdata: Improve error message specificity\n      tools: mkfwumdata: Add bank count validation for FWU metadata v2\n      tools: Add support for fwumdata tool\n      tools: mkfwumdata: Remove dependency on fwu_mdata.h header\n\n MAINTAINERS                           |   7 +-\n doc/develop/uefi/fwu_updates.rst      |   4 +-\n doc/fwumdata.1                        | 222 +++++++++\n tools/.gitignore                      |   2 +\n tools/Kconfig                         |   9 +-\n tools/Makefile                        |   4 +-\n tools/fwumdata_src/Kconfig            |  19 +\n tools/fwumdata_src/fwumdata.c         | 854 ++++++++++++++++++++++++++++++++++\n tools/fwumdata_src/fwumdata.config    |  33 ++\n tools/fwumdata_src/fwumdata.h         | 138 ++++++\n tools/fwumdata_src/fwumdata.mk        |  10 +\n tools/{ => fwumdata_src}/mkfwumdata.c | 106 ++---\n 12 files changed, 1315 insertions(+), 93 deletions(-)\n---\nbase-commit: f9ffeec4bdcf1da655a0ffea482062adde78fee8\nchange-id: 20251107-feature_fwumdata-58508d61e1d3\n\nBest regards,"
}