get:
Show a patch.

patch:
Update a patch.

put:
Update a patch.

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

{
    "id": 2233136,
    "url": "http://patchwork.ozlabs.org/api/1.2/patches/2233136/?format=api",
    "web_url": "http://patchwork.ozlabs.org/project/uboot/patch/20260505181300.223439-4-sjg@chromium.org/",
    "project": {
        "id": 18,
        "url": "http://patchwork.ozlabs.org/api/1.2/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": "<20260505181300.223439-4-sjg@chromium.org>",
    "list_archive_url": null,
    "date": "2026-05-05T18:12:54",
    "name": "[v2,3/4] binman: Flesh out the softhsm2-util bintool docstring",
    "commit_ref": null,
    "pull_url": null,
    "state": "new",
    "archived": false,
    "hash": "f11da4510ab809337247e2b40069b04caed6d668",
    "submitter": {
        "id": 6170,
        "url": "http://patchwork.ozlabs.org/api/1.2/people/6170/?format=api",
        "name": "Simon Glass",
        "email": "sjg@chromium.org"
    },
    "delegate": {
        "id": 3184,
        "url": "http://patchwork.ozlabs.org/api/1.2/users/3184/?format=api",
        "username": "sjg",
        "first_name": "Simon",
        "last_name": "Glass",
        "email": "sjg@chromium.org"
    },
    "mbox": "http://patchwork.ozlabs.org/project/uboot/patch/20260505181300.223439-4-sjg@chromium.org/mbox/",
    "series": [
        {
            "id": 502878,
            "url": "http://patchwork.ozlabs.org/api/1.2/series/502878/?format=api",
            "web_url": "http://patchwork.ozlabs.org/project/uboot/list/?series=502878",
            "date": "2026-05-05T18:12:51",
            "name": "binman: Tidy up some missing bintool docs",
            "version": 2,
            "mbox": "http://patchwork.ozlabs.org/series/502878/mbox/"
        }
    ],
    "comments": "http://patchwork.ozlabs.org/api/patches/2233136/comments/",
    "check": "pending",
    "checks": "http://patchwork.ozlabs.org/api/patches/2233136/checks/",
    "tags": {},
    "related": [],
    "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 (1024-bit key;\n unprotected) header.d=chromium.org header.i=@chromium.org header.a=rsa-sha256\n header.s=google header.b=CYt06s3B;\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=none dis=none) header.from=chromium.org",
            "phobos.denx.de;\n spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de",
            "phobos.denx.de;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=chromium.org header.i=@chromium.org\n header.b=\"CYt06s3B\";\n\tdkim-atps=neutral",
            "phobos.denx.de;\n dmarc=pass (p=none dis=none) header.from=chromium.org",
            "phobos.denx.de;\n spf=pass smtp.mailfrom=sjg@chromium.org"
        ],
        "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)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4g968N5822z1yJV\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 06 May 2026 04:13:40 +1000 (AEST)",
            "from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id 516CC849E5;\n\tTue,  5 May 2026 20:13:21 +0200 (CEST)",
            "by phobos.denx.de (Postfix, from userid 109)\n id AED81849E5; Tue,  5 May 2026 20:13:19 +0200 (CEST)",
            "from mail-oi1-x243.google.com (mail-oi1-x243.google.com\n [IPv6:2607:f8b0:4864:20::243])\n (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits))\n (No client certificate requested)\n by phobos.denx.de (Postfix) with ESMTPS id 59665849DF\n for <u-boot@lists.denx.de>; Tue,  5 May 2026 20:13:17 +0200 (CEST)",
            "by mail-oi1-x243.google.com with SMTP id\n 5614622812f47-479d593a0c3so139651b6e.0\n for <u-boot@lists.denx.de>; Tue, 05 May 2026 11:13:17 -0700 (PDT)",
            "from chromium.org ([174.51.25.52]) by smtp.gmail.com with ESMTPSA id\n 586e51a60fabf-434549540b2sm14585754fac.6.2026.05.05.11.13.14\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Tue, 05 May 2026 11:13:14 -0700 (PDT)"
        ],
        "X-Spam-Checker-Version": "SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de",
        "X-Spam-Level": "",
        "X-Spam-Status": "No, score=-2.5 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,\n DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,\n RCVD_IN_DNSWL_BLOCKED,SPF_HELO_NONE,SPF_PASS autolearn=ham\n autolearn_force=no version=3.4.2",
        "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=chromium.org; s=google; t=1778004795; x=1778609595; darn=lists.denx.de;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:from:to:cc:subject:date\n :message-id:reply-to;\n bh=HONVGuKf5guEfYq2KSRhjxVfWh5NUoLDywU+0rnoz0w=;\n b=CYt06s3BoeG0uQHeSU6UlOplY3NnmfL0dM+IdaJJ4RTlxNsoSnVETJIOnS5D2Ofnk5\n G6smMZ544F+U7cucmYLh/KNIB5e2+2n1w2o9ysh/8vjTrZ2F9ruqXfG03Jgg+D16sCNh\n phKp85A183M2pnq2Qk7fs4y1wSXys5R1yef9E=",
        "X-Google-DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1778004795; x=1778609595;\n h=content-transfer-encoding:mime-version:references:in-reply-to\n :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from\n :to:cc:subject:date:message-id:reply-to;\n bh=HONVGuKf5guEfYq2KSRhjxVfWh5NUoLDywU+0rnoz0w=;\n b=fUBujiXAkD1ZPkhOW4mXYJ4389X0OtA1ny2Zwc/VLAjyeHQNJQ80tkDAew1MIXzWTJ\n vWHXC2yvm9UULq/nq62kqAbn5LL07Ri2aiy8qIV8ufTib4tKiyR5PBM/a9NvkESU9ye3\n If9dyaSCObGXtTaXK6zJf+DYcA0/KQsCwN5zkg2DqWDBIK0FzKKv5nWZSYxVv/iPEk/1\n M6MTJv02J5tq/RDYPY3e46Wj24h+yJF4k83lw68mEeYF3JAgYNzX9QMKJtHzVugI2rOP\n RYWd4gzRk7Xsi1epGu2oPPTmhVthfpXR1BPalSDnOlBms5fGpC6tZDqvAwjVrVdkgKG+\n rFMg==",
        "X-Gm-Message-State": "AOJu0Ywl4LqWTf8XTktYUoVLGk9iaMK4mPTU1yrnmhQs7ArRWt93jQr+\n 9T6NtRZazHy14a5F340aAnuwuIKeenpiSES2D/2wOpD6U/AVkV07iw1Udq0KosjCk4snQrKGT5X\n lBYofHqHS",
        "X-Gm-Gg": "AeBDievRaRJhO/8iSYKs8aWeoBupCmSL4FDvOVys8duRDvV9nqV4zWiL8QJg2ERlFrx\n wQUvDafFLs97GU7NI/nlLpzSKgHsiGGLNm6WNvAwE0w7IBglPL8BdVio2KR7jdszcZKDYkC7bz9\n fl7gNyBgsfztrXjh6eZKnmKVVHIijjwEHR8DnVu5I2NQdJi6uD6vYlAiW78FDFW9eHOVHTeqzQ4\n vAqqdYC/RaUuox2KNA9XJP+PVwNNnbSH1RHhi3d5Qm09hiti0XJCs0BICG7J2kpUWaz194zL8jg\n 06Qo1DewRzOa0Ad280WTKu2lmD8b6ITrGWdH4K3cNtIH2P6ddKIB5qDpYbUSckMRxcs6G2I/3zY\n zYylOZ7sZlnTpvOJ5IohFRdv2YIoaEs4kW6dVA1RcxwLSLfag9nusPowBnIw5zYxqoE8RtVgVYs\n j3+1udcnwj9PeMjtc+XlFs5QRxyddCBuOxKRuH1G4=",
        "X-Received": "by 2002:a05:6808:4fe2:b0:479:fca7:4650 with SMTP id\n 5614622812f47-47d3660a591mr2299018b6e.31.1778004795444;\n Tue, 05 May 2026 11:13:15 -0700 (PDT)",
        "From": "Simon Glass <sjg@chromium.org>",
        "To": "u-boot@lists.denx.de",
        "Cc": "Heinrich Schuchardt <xypron.glpk@gmx.de>, Simon Glass <sjg@chromium.org>,\n Alper Nebi Yasak <alpernebiyasak@gmail.com>,\n Neha Malcom Francis <n-francis@ti.com>, Peng Fan <peng.fan@nxp.com>,\n Philippe Reynes <philippe.reynes@softathome.com>,\n Quentin Schulz <quentin.schulz@cherry.de>,\n Stefan Herbrechtsmeier <stefan.herbrechtsmeier@weidmueller.com>,\n Tom Rini <trini@konsulko.com>",
        "Subject": "[PATCH v2 3/4] binman: Flesh out the softhsm2-util bintool docstring",
        "Date": "Tue,  5 May 2026 12:12:54 -0600",
        "Message-ID": "<20260505181300.223439-4-sjg@chromium.org>",
        "X-Mailer": "git-send-email 2.43.0",
        "In-Reply-To": "<20260505181300.223439-1-sjg@chromium.org>",
        "References": "<20260505181300.223439-1-sjg@chromium.org>",
        "MIME-Version": "1.0",
        "Content-Transfer-Encoding": "8bit",
        "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": "The Sphinx-generated bintools.rst currently produces an empty section\nfor this bintool, since its class docstring is only a single line and\nso the body under the heading is blank.\n\nExtend the docstring with a short description of what softhsm2-util\ndoes and how binman uses it, so the generated documentation has useful\ncontent.\n\nSuggested-by: Heinrich Schuchardt <xypron.glpk@gmx.de>\nSigned-off-by: Simon Glass <sjg@chromium.org>\n---\n\nChanges in v2:\n- Reword the docstring per Quentin's review: binman uses this bintool\n  only as an availability check, not for runtime PKCS#11 operations\n\n tools/binman/btool/softhsm2_util.py | 12 +++++++++++-\n 1 file changed, 11 insertions(+), 1 deletion(-)",
    "diff": "diff --git a/tools/binman/btool/softhsm2_util.py b/tools/binman/btool/softhsm2_util.py\nindex 869221d841d..fd2ff2d6473 100644\n--- a/tools/binman/btool/softhsm2_util.py\n+++ b/tools/binman/btool/softhsm2_util.py\n@@ -7,7 +7,17 @@ from binman import bintool\n \n \n class Bintoolsofthsm2_util(bintool.Bintool):\n-    \"\"\"SoftHSMv2 -- support tool for libsofthsm2\"\"\"\n+    \"\"\"SoftHSMv2 -- support tool for libsofthsm2\n+\n+    This bintool wraps the `softhsm2-util` command shipped with SoftHSMv2 (a\n+    software implementation of a PKCS#11 token). Binman uses this wrapper only\n+    to check that softhsm2-util is installed (and to fetch it if missing); any\n+    actual token initialisation or key import for signing FIT images or\n+    capsules is done outside binman, typically via mkimage and the OpenSSL\n+    PKCS#11 engine.\n+\n+    See https://www.opendnssec.org/softhsm/ for more details.\n+    \"\"\"\n     def __init__(self, name):\n         super().__init__('softhsm2-util',\n                          'SoftHSMv2 support tool for libsofthsm2',\n",
    "prefixes": [
        "v2",
        "3/4"
    ]
}