{"id":2225978,"url":"http://patchwork.ozlabs.org/api/1.2/patches/2225978/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/patch/20260421231126.597390-4-sjg@chromium.org/","project":{"id":18,"url":"http://patchwork.ozlabs.org/api/1.2/projects/18/?format=json","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":"<20260421231126.597390-4-sjg@chromium.org>","list_archive_url":null,"date":"2026-04-21T23:11:18","name":"[3/3] binman: Flesh out the softhsm2-util bintool docstring","commit_ref":null,"pull_url":null,"state":"new","archived":false,"hash":"993767db0e59f7ae1d3dc652b45f680719498097","submitter":{"id":6170,"url":"http://patchwork.ozlabs.org/api/1.2/people/6170/?format=json","name":"Simon Glass","email":"sjg@chromium.org"},"delegate":null,"mbox":"http://patchwork.ozlabs.org/project/uboot/patch/20260421231126.597390-4-sjg@chromium.org/mbox/","series":[{"id":500902,"url":"http://patchwork.ozlabs.org/api/1.2/series/500902/?format=json","web_url":"http://patchwork.ozlabs.org/project/uboot/list/?series=500902","date":"2026-04-21T23:11:15","name":"binman: Tidy up some missing bintool docs","version":1,"mbox":"http://patchwork.ozlabs.org/series/500902/mbox/"}],"comments":"http://patchwork.ozlabs.org/api/patches/2225978/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/2225978/checks/","tags":{},"related":[],"headers":{"Return-Path":"","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=SFIIGSBx;\n\tdkim-atps=neutral","legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=lists.denx.de\n (client-ip=85.214.62.61; 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=\"SFIIGSBx\";\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 [85.214.62.61])\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 4g0dR70yVQz1yGs\n\tfor ; Wed, 22 Apr 2026 09:12:03 +1000 (AEST)","from h2850616.stratoserver.net (localhost [IPv6:::1])\n\tby phobos.denx.de (Postfix) with ESMTP id CF15C842B7;\n\tWed, 22 Apr 2026 01:11:47 +0200 (CEST)","by phobos.denx.de (Postfix, from userid 109)\n id BA8CA83AC5; Wed, 22 Apr 2026 01:11:46 +0200 (CEST)","from mail-qt1-x82c.google.com (mail-qt1-x82c.google.com\n [IPv6:2607:f8b0:4864:20::82c])\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 52ECA8429E\n for ; Wed, 22 Apr 2026 01:11:44 +0200 (CEST)","by mail-qt1-x82c.google.com with SMTP id\n d75a77b69052e-506362ac5f7so39939961cf.1\n for ; Tue, 21 Apr 2026 16:11:44 -0700 (PDT)","from chromium.org ([174.51.25.52]) by smtp.gmail.com with ESMTPSA id\n d75a77b69052e-50e6123c3d7sm56551551cf.12.2026.04.21.16.11.38\n (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\n Tue, 21 Apr 2026 16:11:40 -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.1 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=1776813102; x=1777417902; 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=QLYHOEZrP4DsLhYsidxl2FF86XZtPk37WxDN7G9Fo5o=;\n b=SFIIGSBxG+FEpsM2BNrX9uWpRFPhI02cSBOuKvfqn4bnU3BH9quKwBnIGEN2TINjsN\n aI19bahurrqFCTJIaYBPlyoM7GG7YM/PVp2RiZ3Z1nZEF5sL/DIIcbYJVcmVlHY9D2BX\n mt0roN8GbgFtF71UBX6Qk27c6cNNdz1sqFNwA=","X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n d=1e100.net; s=20251104; t=1776813102; x=1777417902;\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=QLYHOEZrP4DsLhYsidxl2FF86XZtPk37WxDN7G9Fo5o=;\n b=bofgaOAueWSXokXBwXPR9rmNiZUNoz57YqEHh1TLdKvqXdn8PQYlhYMYnKBN5qBSti\n /zMN+XOlPHqhDze80JZnq1H4GNsF/mfVQQth3CFQ6AE22HD4NHHEhwXofkzg/xC7DFMU\n +kipy0P8v5jMyRKdRR/h+KoARcuRYtlVRcLFPjpQC92rWpZ8k37jJp59n9vd5oIk3R9+\n m5xJ1tZ39AKVkkMINdy+mZcK3f+NnYtYp7HNNjzPl8rJi6CHlp6VUZBzjZJNUiJRzt1Z\n F9JgyeO5+26hM5tiAQM6Dfa32GH/UcVi01cy5qmbZxp4pwooc5/85h6cvWoMmhfSRQVO\n ejjg==","X-Gm-Message-State":"AOJu0Yyf4f5l2QgJU3XOTeGTwRLsIlHojmfyOdDf7eNafBjb5nc4Cp7g\n gwgASIL+kp6ZKS9qM2sZJKRkEpQnuYYKFoHgU1zqbYVMFuoya0QcFweb6yDGj2L6h3izHBDXT6F\n glaN3Rw==","X-Gm-Gg":"AeBDietTTd74akUNCneB8MZIY1id84rXxlWrgCJ/dxa/DcgGBsKy/hNLmDGARY9xj7y\n LZ0DM1a0CP8hlASlNvEp6Fh+JT6QCBQrCjlkA4wK5ic6gHD16DrmpMZ90FK+0uHulMcbFmwe77Z\n v4mmIo71aV7OIz2zZWTBeOiFaynOv3xTHExNPS60h2CyN0KXDYtea0ol4kRRorNsX4dc2RQUDF2\n 9fG28JGCoSEdqMwDpBITEOwYzpQ8tVEF2k2hFUJ9AS57haNOJhDtVkAFmDIEUQznGUKR9fTrERc\n 238NrrZR72Ws4EPtH1AISAO/pJlzcnqYutgZ88LomHeXoaHY1MbJgrQddDPBL89f/Pa6ShuQFNA\n HA49Js5HCaFmzkjY6YP1tKrq1oI8PgM7fXdzHxIdhtfDuxY3zPTWD2jiy89i5jB1BaT+4CIYqzj\n 8ks8TuFVbVO2QdKuCZ2A5IIL5bcxWp","X-Received":"by 2002:a05:622a:1884:b0:50d:a644:69b1 with SMTP id\n d75a77b69052e-50e36ba3f1fmr282967401cf.25.1776813102614;\n Tue, 21 Apr 2026 16:11:42 -0700 (PDT)","From":"Simon Glass ","To":"u-boot@lists.denx.de","Cc":"Heinrich Schuchardt , Simon Glass ,\n Alper Nebi Yasak ,\n Neha Malcom Francis , Peng Fan ,\n Philippe Reynes ,\n Quentin Schulz ,\n Stefan Herbrechtsmeier ,\n Tom Rini ","Subject":"[PATCH 3/3] binman: Flesh out the softhsm2-util bintool docstring","Date":"Tue, 21 Apr 2026 17:11:18 -0600","Message-ID":"<20260421231126.597390-4-sjg@chromium.org>","X-Mailer":"git-send-email 2.43.0","In-Reply-To":"<20260421231126.597390-1-sjg@chromium.org>","References":"<20260421231126.597390-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 ","List-Unsubscribe":",\n ","List-Archive":"","List-Post":"","List-Help":"","List-Subscribe":",\n ","Errors-To":"u-boot-bounces@lists.denx.de","Sender":"\"U-Boot\" ","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 \nSigned-off-by: Simon Glass \n---\n\n tools/binman/btool/softhsm2_util.py | 11 ++++++++++-\n 1 file changed, 10 insertions(+), 1 deletion(-)","diff":"diff --git a/tools/binman/btool/softhsm2_util.py b/tools/binman/btool/softhsm2_util.py\nindex 869221d841d..e79584da11d 100644\n--- a/tools/binman/btool/softhsm2_util.py\n+++ b/tools/binman/btool/softhsm2_util.py\n@@ -7,7 +7,16 @@ 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 supports running `softhsm2-util`, the command-line utility\n+ shipped with SoftHSMv2 (a software implementation of a PKCS#11 token).\n+ Binman uses it to initialise a token so that keys can be imported and used\n+ to sign FIT images or capsules via the PKCS#11 interface, without requiring\n+ real hardware.\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":["3/3"]}