get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 2234475,
    "url": "http://patchwork.ozlabs.org/api/1.2/patches/2234475/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/linux-mtd/patch/20260507-winbond-v6-18-rc1-spi-nor-swp-v5-22-93453e1a9597@bootlin.com/",
    "project": {
        "id": 3,
        "url": "http://patchwork.ozlabs.org/api/1.2/projects/3/?format=api",
        "name": "Linux MTD development",
        "link_name": "linux-mtd",
        "list_id": "linux-mtd.lists.infradead.org",
        "list_email": "linux-mtd@lists.infradead.org",
        "web_url": null,
        "scm_url": null,
        "webscm_url": null,
        "list_archive_url": "",
        "list_archive_url_format": "",
        "commit_url_format": ""
    },
    "msgid": "<20260507-winbond-v6-18-rc1-spi-nor-swp-v5-22-93453e1a9597@bootlin.com>",
    "list_archive_url": null,
    "date": "2026-05-07T16:47:03",
    "name": "[v5,22/28] mtd: spi-nor: Add steps for testing locking with CMP",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "2062a1e910967a74403e5c1f80b199494226a676",
    "submitter": {
        "id": 73368,
        "url": "http://patchwork.ozlabs.org/api/1.2/people/73368/?format=api",
        "name": "Miquel Raynal",
        "email": "miquel.raynal@bootlin.com"
    },
    "delegate": null,
    "mbox": "http://patchwork.ozlabs.org/project/linux-mtd/patch/20260507-winbond-v6-18-rc1-spi-nor-swp-v5-22-93453e1a9597@bootlin.com/mbox/",
    "series": [
        {
            "id": 503226,
            "url": "http://patchwork.ozlabs.org/api/1.2/series/503226/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/linux-mtd/list/?series=503226",
            "date": "2026-05-07T16:46:51",
            "name": "mtd: spi-nor: Enhance software protection",
            "version": 5,
            "mbox": "http://patchwork.ozlabs.org/series/503226/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/patches/2234475/comments/",
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/2234475/checks/",
    "tags": {},
    "related": [],
    "headers": {
        "Return-Path": "\n <linux-mtd-bounces+incoming=patchwork.ozlabs.org@lists.infradead.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=lists.infradead.org header.i=@lists.infradead.org\n header.a=rsa-sha256 header.s=bombadil.20210309 header.b=0/9C2LNG;\n\tdkim=fail reason=\"signature verification failed\" (2048-bit key;\n unprotected) header.d=bootlin.com header.i=@bootlin.com header.a=rsa-sha256\n header.s=dkim header.b=V79yClZ0;\n\tdkim-atps=neutral",
            "legolas.ozlabs.org;\n spf=none (no SPF record) smtp.mailfrom=lists.infradead.org\n (client-ip=2607:7c80:54:3::133; helo=bombadil.infradead.org;\n envelope-from=linux-mtd-bounces+incoming=patchwork.ozlabs.org@lists.infradead.org;\n receiver=patchwork.ozlabs.org)"
        ],
        "Received": [
            "from bombadil.infradead.org (bombadil.infradead.org\n [IPv6:2607:7c80:54:3::133])\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 4gBJ8L0zZ0z1y04\n\tfor <incoming@patchwork.ozlabs.org>; Fri, 08 May 2026 02:47:46 +1000 (AEST)",
            "from localhost ([::1] helo=bombadil.infradead.org)\n\tby bombadil.infradead.org with esmtp (Exim 4.99.1 #2 (Red Hat Linux))\n\tid 1wL1sz-00000004Njl-3pFs;\n\tThu, 07 May 2026 16:47:41 +0000",
            "from smtpout-02.galae.net ([185.246.84.56])\n\tby bombadil.infradead.org with esmtps (Exim 4.99.1 #2 (Red Hat Linux))\n\tid 1wL1sv-00000004NZQ-09Rm\n\tfor linux-mtd@lists.infradead.org;\n\tThu, 07 May 2026 16:47:39 +0000",
            "from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233])\n\tby smtpout-02.galae.net (Postfix) with ESMTPS id A4F0A1A355C;\n\tThu,  7 May 2026 16:47:35 +0000 (UTC)",
            "from mail.galae.net (mail.galae.net [212.83.136.155])\n\tby smtpout-01.galae.net (Postfix) with ESMTPS id 7A4BB605CF;\n\tThu,  7 May 2026 16:47:35 +0000 (UTC)",
            "from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon)\n with ESMTPSA id 31299108194ED;\n\tThu,  7 May 2026 18:47:33 +0200 (CEST)"
        ],
        "DKIM-Signature": [
            "v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed;\n\td=lists.infradead.org; s=bombadil.20210309; h=Sender:\n\tContent-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post:\n\tList-Archive:List-Unsubscribe:List-Id:Cc:To:In-Reply-To:References:Message-Id\n\t:MIME-Version:Subject:Date:From:Reply-To:Content-ID:Content-Description:\n\tResent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:\n\tList-Owner; bh=VG8whYbD8wEqLX+ZoBjoEOlEKxVhm4yNbY/tJPofX68=; b=0/9C2LNGGoOjuf\n\tHfCUSQz2GMEyTSNh/oL1gvM9sT7le/oJlame7qEt36SnufvoaPLPORTmvuqxGmRyR5+g20qUw4NXV\n\t7FvY7louJwfgK23iWzzITTZBKfZGYMGyinaAYWREx/Ips4iiZZnS9gf9isjt/EdUjaZFpVF2tOimc\n\thIg7d0I33fw4zsS54zVPQYYjkpf9GKM2P67GbzMbSznWy69NiMkW0D909HY0eeLUeGRizhzBNKkKW\n\ttAnCYMvViUnpVRs4Qlo68IJzk2CCFIlS+B6ajtyEaaDledpppDmmrdpQjwLVg1BGmsAR7RFN0Cggc\n\tJ69GrsQdCRv9uo1CiRIg==;",
            "v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim;\n\tt=1778172454; h=from:subject:date:message-id:to:cc:mime-version:content-type:\n\t content-transfer-encoding:in-reply-to:references;\n\tbh=yhA+2VgT+o8G4u2gJrAlTlAd70E3ujcNCL/mf5Wc020=;\n\tb=V79yClZ0ondZxWahZNR19BLo5lhNx3GWoRvbgMVf/jShRbtdrsRPvYz08hI6AxCxdwZL8k\n\txDAoSKO7TIC3LMrVA6I1NyRXRKKRVLYVm/nS+RT0S0n+n1kqQ+x5qWNe9Fh1B93PGWldmR\n\t/CrAVfZTMWi0K2S+XrDdC3cOloI+exKo6uHuBdqPWD2o2ogyewJnBqalQ1qr5Nj7bLqvtF\n\tRZUHyuyrQVBEIt5k8Yssc95AiHFA0UbN+v8qHXDw/GmSAwrVyKe2wz0W5I24kg7hV/HRv5\n\twT7I+7GqSkvww4OtQZj1F9rnEaYiOudQafbykExnPYbQ6ZxczcZKqpvK66AYKg=="
        ],
        "From": "Miquel Raynal <miquel.raynal@bootlin.com>",
        "Date": "Thu, 07 May 2026 18:47:03 +0200",
        "Subject": "[PATCH v5 22/28] mtd: spi-nor: Add steps for testing locking with\n CMP",
        "MIME-Version": "1.0",
        "Message-Id": "\n <20260507-winbond-v6-18-rc1-spi-nor-swp-v5-22-93453e1a9597@bootlin.com>",
        "References": "\n <20260507-winbond-v6-18-rc1-spi-nor-swp-v5-0-93453e1a9597@bootlin.com>",
        "In-Reply-To": "\n <20260507-winbond-v6-18-rc1-spi-nor-swp-v5-0-93453e1a9597@bootlin.com>",
        "To": "Pratyush Yadav <pratyush@kernel.org>, Michael Walle <mwalle@kernel.org>,\n Takahiro Kuwano <takahiro.kuwano@infineon.com>,\n Richard Weinberger <richard@nod.at>, Vignesh Raghavendra <vigneshr@ti.com>,\n Jonathan Corbet <corbet@lwn.net>, Tudor Ambarus <tudor.ambarus@linaro.org>,\n Shuah Khan <skhan@linuxfoundation.org>",
        "Cc": "Sean Anderson <sean.anderson@linux.dev>,\n Thomas Petazzoni <thomas.petazzoni@bootlin.com>,\n Steam Lin <STLin2@winbond.com>, linux-mtd@lists.infradead.org,\n linux-kernel@vger.kernel.org, linux-doc@vger.kernel.org,\n Miquel Raynal <miquel.raynal@bootlin.com>",
        "X-Mailer": "b4 0.14.3",
        "X-Last-TLS-Session-Version": "TLSv1.3",
        "X-CRM114-Version": "20100106-BlameMichelson ( TRE 0.9.0 (BSD) ) MR-646709E3 ",
        "X-CRM114-CacheID": "sfid-20260507_094737_412435_25A36649 ",
        "X-CRM114-Status": "GOOD (  10.17  )",
        "X-Spam-Score": "-2.1 (--)",
        "X-Spam-Report": "Spam detection software,\n running on the system \"bombadil.infradead.org\",\n has NOT identified this incoming email as spam.  The original\n message has been attached to this so you can view it or label\n similar future email.  If you have any questions, see\n the administrator of that system for details.\n Content preview:  Extend the test coverage by giving guidelines to verify the\n    CMP bit acts according to our expectations. Signed-off-by: Miquel Raynal\n   <miquel.raynal@bootlin.com> --- The instructions listed in this file target\n    people adding support for new chips,\n however here are below extra steps that\n    I also ran with th [...]\n Content analysis details:   (-2.1 points, 5.0 required)\n  pts rule name              description\n ---- ----------------------\n --------------------------------------------------\n -0.0 SPF_HELO_PASS          SPF: HELO matches SPF record\n -0.0 SPF_PASS               SPF: sender matches SPF record\n -0.1 DKIM_VALID_EF          Message has a valid DKIM or DK signature from\n                             envelope-from domain\n -0.1 DKIM_VALID             Message has at least one valid DKIM or DK\n signature\n -0.1 DKIM_VALID_AU          Message has a valid DKIM or DK signature from\n author's\n                             domain\n  0.1 DKIM_SIGNED            Message has a DKIM or DK signature,\n not necessarily valid\n -1.9 BAYES_00               BODY: Bayes spam probability is 0 to 1%\n                             [score: 0.0000]\n -0.0 DMARC_PASS             DMARC pass policy",
        "X-BeenThere": "linux-mtd@lists.infradead.org",
        "X-Mailman-Version": "2.1.34",
        "Precedence": "list",
        "List-Id": "Linux MTD discussion mailing list <linux-mtd.lists.infradead.org>",
        "List-Unsubscribe": "<http://lists.infradead.org/mailman/options/linux-mtd>,\n <mailto:linux-mtd-request@lists.infradead.org?subject=unsubscribe>",
        "List-Archive": "<http://lists.infradead.org/pipermail/linux-mtd/>",
        "List-Post": "<mailto:linux-mtd@lists.infradead.org>",
        "List-Help": "<mailto:linux-mtd-request@lists.infradead.org?subject=help>",
        "List-Subscribe": "<http://lists.infradead.org/mailman/listinfo/linux-mtd>,\n <mailto:linux-mtd-request@lists.infradead.org?subject=subscribe>",
        "Content-Type": "text/plain; charset=\"us-ascii\"",
        "Content-Transfer-Encoding": "7bit",
        "Sender": "\"linux-mtd\" <linux-mtd-bounces@lists.infradead.org>",
        "Errors-To": "linux-mtd-bounces+incoming=patchwork.ozlabs.org@lists.infradead.org"
    },
    "content": "Extend the test coverage by giving guidelines to verify the CMP bit acts\naccording to our expectations.\n\nSigned-off-by: Miquel Raynal <miquel.raynal@bootlin.com>\n---\nThe instructions listed in this file target people adding support for\nnew chips, however here are below extra steps that I also ran with the\nsame W25H512NWxxAM chip. They are here to prove core correctness.\n\n    $ flash_lock -u /dev/mtd0\n    $ flash_lock -l /dev/mtd0 0 1008\n    $ show_sectors\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-03efffff |   locked | 1008\n     03f00000-03ffffff | unlocked | 16\n    $ flash_lock -l /dev/mtd0 0 1009\n    $ show_sectors # should not change\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-03efffff |   locked | 1008\n     03f00000-03ffffff | unlocked | 16\n    $ flash_lock -l /dev/mtd0 0 1015\n    $ show_sectors # should not change\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-03efffff |   locked | 1008\n     03f00000-03ffffff | unlocked | 16\n    $ flash_lock -l /dev/mtd0 0 1016\n    $ show_sectors # should cover more\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-03f7ffff |   locked | 1016\n     03f80000-03ffffff | unlocked | 8\n    $ flash_lock -u /dev/mtd0 $((1015 * $bs)) 1\n    $ show_sectors # should not change\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-03f7ffff |   locked | 1016\n     03f80000-03ffffff | unlocked | 8\n    $ flash_lock -u /dev/mtd0 $((1009 * $bs)) 7\n    $ show_sectors # should not change\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-03f7ffff |   locked | 1016\n     03f80000-03ffffff | unlocked | 8\n    $ flash_lock -u /dev/mtd0 $((1008 * $bs)) 8\n    $ show_sectors # range should reduce down to initial value\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-03efffff |   locked | 1008\n     03f00000-03ffffff | unlocked | 16\n\n    [Similar situations, on the other side of the device]\n\n    $ flash_lock -u /dev/mtd0\n    $ flash_lock -l /dev/mtd0 $((16 * $bs)) 1008\n    $ show_sectors\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-000fffff | unlocked | 16\n     00100000-03ffffff |   locked | 1008\n    $ flash_lock -l /dev/mtd0 $((15 * $bs)) 1009\n    $ show_sectors # should not change\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-000fffff | unlocked | 16\n     00100000-03ffffff |   locked | 1008\n    $ flash_lock -l /dev/mtd0 $((9 * $bs)) 1015\n    $ show_sectors # should not change\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-000fffff | unlocked | 16\n     00100000-03ffffff |   locked | 1008\n    $ flash_lock -l /dev/mtd0 $((8 * $bs)) 1016\n    $ show_sectors # should cover more\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-0007ffff | unlocked | 8\n     00080000-03ffffff |   locked | 1016\n    $ flash_lock -u /dev/mtd0 $((8 * $bs)) 1\n    $ show_sectors # should not change\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-0007ffff | unlocked | 8\n     00080000-03ffffff |   locked | 1016\n    $ flash_lock -u /dev/mtd0 $((8 * $bs)) 7\n    $ show_sectors # should not change\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-0007ffff | unlocked | 8\n     00080000-03ffffff |   locked | 1016\n    $ flash_lock -u /dev/mtd0 $((8 * $bs)) 8\n    $ show_sectors # range should reduce down to initial value\n    software locked sectors\n     region (in hex)   | status   | #sectors\n     ------------------+----------+---------\n     00000000-000fffff | unlocked | 16\n     00100000-03ffffff |   locked | 1008\n---\n Documentation/driver-api/mtd/spi-nor.rst | 37 ++++++++++++++++++++++++++++++++\n 1 file changed, 37 insertions(+)",
    "diff": "diff --git a/Documentation/driver-api/mtd/spi-nor.rst b/Documentation/driver-api/mtd/spi-nor.rst\nindex b42de32c6eba..896cff9c7675 100644\n--- a/Documentation/driver-api/mtd/spi-nor.rst\n+++ b/Documentation/driver-api/mtd/spi-nor.rst\n@@ -335,3 +335,40 @@ section, after the ``---`` marker.\n      ------------------+----------+---------\n      00000000-0000ffff |   locked | 1\n      00010000-03ffffff | unlocked | 1023\n+\n+   If the flash features a Complement (CMP) bit, we can protect with\n+   more granularity above half of the capacity. Let's lock all but one\n+   block, then unlock one more block::\n+\n+    root@1:~# all_but_one=$((($size / $bs) - ($ss / $bs)))\n+\n+    root@1:~# flash_lock -u /dev/mtd0\n+    root@1:~# flash_lock -l /dev/mtd0 $ss $all_but_one # all but the first\n+    root@1:~# show_sectors\n+    software locked sectors\n+     region (in hex)   | status   | #sectors\n+     ------------------+----------+---------\n+     00000000-0000ffff | unlocked | 1\n+     00010000-03ffffff |   locked | 1023\n+    root@1:~# flash_lock -u /dev/mtd0 $ss $(($ss / $bs)) # all but the two first\n+    root@1:~# show_sectors\n+    software locked sectors\n+     region (in hex)   | status   | #sectors\n+     ------------------+----------+---------\n+     00000000-0001ffff | unlocked | 2\n+     00020000-03ffffff |   locked | 1022\n+    root@1:~# flash_lock -u /dev/mtd0\n+    root@1:~# flash_lock -l /dev/mtd0 0 $all_but_one # same from the other side\n+    root@1:~# show_sectors\n+    software locked sectors\n+     region (in hex)   | status   | #sectors\n+     ------------------+----------+---------\n+     00000000-03feffff |   locked | 1023\n+     03ff0000-03ffffff | unlocked | 1\n+    root@1:~# flash_lock -u /dev/mtd0 $(($size - (2 * $ss))) $(($ss / $bs)) # all but two\n+    root@1:~# show_sectors\n+    software locked sectors\n+     region (in hex)   | status   | #sectors\n+     ------------------+----------+---------\n+     00000000-03fdffff |   locked | 1022\n+     03fe0000-03ffffff | unlocked | 2\n",
    "prefixes": [
        "v5",
        "22/28"
    ]
}