From patchwork Wed Jul 31 19:57:13 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jan Vermaete X-Patchwork-Id: 1967277 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.a=rsa-sha256 header.s=20230601 header.b=uiEeyYpF; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.a=rsa-sha256 header.s=20230601 header.b=DM375HWt; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2a00:1450:4864:20::23e; helo=mail-lj1-x23e.google.com; envelope-from=swupdate+bncbdripn7u2aibbjnovk2qmgqekai3pai@googlegroups.com; receiver=patchwork.ozlabs.org) Received: from mail-lj1-x23e.google.com (mail-lj1-x23e.google.com [IPv6:2a00:1450:4864:20::23e]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4WZ2tz39ySz1ybX for ; Thu, 1 Aug 2024 05:57:30 +1000 (AEST) Received: by mail-lj1-x23e.google.com with SMTP id 38308e7fff4ca-2ef2018bb2dsf58966341fa.0 for ; Wed, 31 Jul 2024 12:57:30 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1722455847; cv=pass; d=google.com; s=arc-20160816; b=d9LNK+U2XE+K2waCY1Wo8U1UR2fxIt/azMQe59o3fcvPs+HYZGCSPUI92u/t+jEAVr KiCriGD534eSnB6wO+xnt7RvAjPmR4iWvS2n7iTqavS6S61OfS/G+GQ4PUUIZMSOeod+ edRQLy0qkHgMf1PREQ2WfH5TRaSD1pila4Q24FxRsevSVQoWj39plCTJRTHS9d2nnDge iCw2PoZPJ57Grm1Buenj+CD/TThIYFi+oUADF+XWiw9p9DqBn3HH/td+9z+8KKX3GiPM emZPduvplwDha/GhiPISF4ZSZ70ye5zsQgY2S1RldxFgjwGUFLgQBgt6nTH8Lr0ktGM6 M9aQ== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:mime-version:message-id:date :subject:cc:to:from:sender:dkim-signature:dkim-signature; bh=b31L5t6vRPLjLXjJqAT0UXbp7lxI+gAlZHyfyUT9DtU=; fh=6FYn2TQg5n4zNpeIcc94o9N8dkoAPq95CPNJgZgmh5o=; b=iUaacsgorgFLBpyyEQAU8MZvEG90wiIu+VxiacyAbI8on0x8CnU5RYeG5kMM4WT7nQ SgAh/Gt3Y3BYchVD+5GRo2duCE5F6TZZOLJPb2qa3SBKzKYlp6NS/Mp0ttaezESy84b7 Gt6uvYR4KTxFLxGSgPdlwBfpRQKwevbg9cPBFLm8r/b1vBq68SxCyKLXhRwBXfUIiMqt giejPE6798Ko1Hu0mCkrY9SDZ/ItrALZapAdGCDAB2/TjisAlCMCYZvqAhBIfp21oRGq /QOXW+Zf28Ohf0WlineabcKyVx+cI/NFHMLvHr/KfTsh4idOj/JY0xlXv2VHmGCilRHy X4QQ==; darn=patchwork.ozlabs.org ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b="nceHB/tG"; spf=pass (google.com: domain of jan.vermaete@gmail.com designates 2a00:1450:4864:20::335 as permitted sender) smtp.mailfrom=jan.vermaete@gmail.com; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com; dara=pass header.i=@googlegroups.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20230601; t=1722455847; x=1723060647; darn=patchwork.ozlabs.org; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:x-original-authentication-results :x-original-sender:mime-version:message-id:date:subject:cc:to:from :sender:from:to:cc:subject:date:message-id:reply-to; bh=b31L5t6vRPLjLXjJqAT0UXbp7lxI+gAlZHyfyUT9DtU=; b=uiEeyYpFkNEGuWjko2k7zJVofnawh3A+5Ch75mRivuujtQg7nm77k1E2DhgwMeEPw5 pbm9Wh/kTSycej+RntwjigDbpZgKQSblJvWGX9ErMSrTQmXYTiYxVb2cAfX5L1wOIC53 v3bp28YmS0LaEDZ7/21ob7YrjKAM/Ma5i8CUFwqoh3fIaInjqW2MnNu11mG9j7F+/mjh AD1l/t1V/AuqnXm8EO4bw2XdjHUE3XsrGm4OzNjXLxY7kGGTYGb+XoMoc2PBraHIaHtN noclhFBGzTJUcwQSy2n0WeBAg64cs0DDD2LG26Qf3SMpockZGvV5rU8UtAy2q2TYDdN6 Hl5g== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1722455847; x=1723060647; darn=patchwork.ozlabs.org; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :list-id:mailing-list:precedence:x-original-authentication-results :x-original-sender:mime-version:message-id:date:subject:cc:to:from :from:to:cc:subject:date:message-id:reply-to; bh=b31L5t6vRPLjLXjJqAT0UXbp7lxI+gAlZHyfyUT9DtU=; b=DM375HWtocCvhq609POJfmIgXqh9BC3ldrXDsWqDXsQbYtQI3MaugxCFeLJ19Fu3A7 /feDFm9Z4ppfrzesLu7U9DsgmSt7NGs5dhvP9xpYmnbw8N6+Spbc3aOcgVnSr1R6Q1iY 5U556C4nNMgIgMs0FiDDF2kfhVQqgClLkWi3mRukJbLQS3ZtY04H8NZMjb4o/9IHGSev zG9qXQS/MhHOUE5tGwNfsydbMPoAY5UZL3+RFTNObV3OpkPdGxMkfnoqCD1va37gYWYJ uEB2D+gZqU9g2jNZtP/G0A6kKRbzn3bXVwM7j21LAhnk6Sa+CcZB9WeEae36qdzcuvlr dvCQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1722455847; x=1723060647; h=list-unsubscribe:list-subscribe:list-archive:list-help:list-post :x-spam-checked-in-group:list-id:mailing-list:precedence :x-original-authentication-results:x-original-sender:mime-version :message-id:date:subject:cc:to:from:x-beenthere:x-gm-message-state :sender:from:to:cc:subject:date:message-id:reply-to; bh=b31L5t6vRPLjLXjJqAT0UXbp7lxI+gAlZHyfyUT9DtU=; b=tyla99jyedPrlHvbN3GU07v/I3eQ/tZAr80/xe6CRfYvNmdGsOtyvKus7mrBRyo/8e CmvESsN7ClpZGHeseCL9Ez2nKGO9YmYu4dciiWDaZSHqYNDNCYx09rnIN7PR7PGYG4Ap XwBtIr6+4wMYKMrVgDZ5ZkMkIlTC5DvZVVfwN6JVROOFz3xzrKJHAVAMSRZooXyie8ZH Op8V7CEkgCnPyDpSphnZlUl7RJXz+wcOoJqNQUATI2GTiaecjp961eDEO9I/viX4Khrx hBCgfX2Yw1oohR/UAryRygDW3PVKvfR9BYI5qbE4dJN8ZJP/uIjNnC0kCDKBdcnKZv0I VwFQ== Sender: swupdate@googlegroups.com X-Forwarded-Encrypted: i=2; AJvYcCVCNDFTmsPkXu6aHK0jaVv92pNLRrth3pzmskiAUK9TeBN9pm1f1e+aWI2t2s4BSP6+Hf+2B2lqaxQSuSL5sjq+HBtM3MZgm+v/gmwYWQ== X-Gm-Message-State: AOJu0Yy3u3j8Q5Yp8mvbrdhLaOsdVRWQt2BNjAESD467BJh+0dNxH/kM XV5whvqmalzeGVeUmFuJAYQuAJkrnrXlyNCCQ+IdTMHpkxWzeFd9 X-Google-Smtp-Source: AGHT+IELvy0h7IsQd5Eb7UIdhW0HG5ugudo1AsVVsQHSERWWoBuHtQGtRb/xfOUBM9Q9bQGpw7c2GQ== X-Received: by 2002:a2e:9d84:0:b0:2ef:7fef:3b27 with SMTP id 38308e7fff4ca-2f1532db603mr2922491fa.35.1722455846003; Wed, 31 Jul 2024 12:57:26 -0700 (PDT) X-BeenThere: swupdate@googlegroups.com Received: by 2002:a2e:bc0a:0:b0:2ef:256c:a25e with SMTP id 38308e7fff4ca-2f03aa87bb7ls35155891fa.2.-pod-prod-03-eu; Wed, 31 Jul 2024 12:57:23 -0700 (PDT) X-Received: by 2002:a2e:9b1a:0:b0:2ef:2b1f:6c4a with SMTP id 38308e7fff4ca-2f1532daef3mr2848281fa.30.1722455842750; Wed, 31 Jul 2024 12:57:22 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1722455842; cv=none; d=google.com; s=arc-20160816; b=qy0Cou0/svbUxuxSo8+mbbIG6Gm1YJPgYT1MGKWt4pKcx1RMEL4O+gplHKIWQz4s6C hL7moKON3bEnH2/tAhcZMNrbHjMe4xK7P6fW1tT6qxGtq22V1g7vqg5rOl3URYOvv5c2 6NPpS+b4xoir1MjHhtjX39b1kjXJSnJX8Nvf2m5enh2IVUaVgWcqlsfuiO3NAKJOhISg 9Bc1/bA/G6ZEp9LSfV97ZIKP0PX4wI3iNLdB9b/ZCGPlsNa7u3rOUikusanxc6RgbFrw ot/R7SHyG5tFwcCdJYvIH43KCl+YhtLj7jBVoEPvI/3eea//+okVwOSCo2pdB/w7haVA dCwA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:dkim-signature; bh=2jy/Vy6ITgWp+D45N8u8tCFpr/Mbp3Zkr8uB42ucS9Y=; fh=sTkoT2Z4dfX+jxmzlIMqEU4YHqfrOjFJUnMHKfxZihE=; b=SsMI6ZspYQWGKX8Ki20I6IdK7GwDD735ko2cBjNiquQjAY55xEh450BnLkvS6eiA04 Qqh9+eJCLm3Bon4Yu5C9CclH3NwJM8hvmP7hG8MPWuftglU5R79Y3B/iRzxi3Q0A2oLe e/TaYavqKrqyebXtl/L6LPWw0QJsL3lr/W0Y2h0glSClTG4V649s+xLfGnw7QZgcYmxV Qp2txzxXDkpT3Qx43RtMzmhalXdc2b2yAmcIBMZP0rpR2RuPPzjF5RwnULDfRN9AUwe+ D0o7SBfJoFCZUpS5exUeorOBYzsHLTGqCIOgUKpcQAZ/TsL+uZTaKwATKAvCMFY7zO3k ItIg==; dara=google.com ARC-Authentication-Results: i=1; gmr-mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b="nceHB/tG"; spf=pass (google.com: domain of jan.vermaete@gmail.com designates 2a00:1450:4864:20::335 as permitted sender) smtp.mailfrom=jan.vermaete@gmail.com; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com; dara=pass header.i=@googlegroups.com Received: from mail-wm1-x335.google.com (mail-wm1-x335.google.com. [2a00:1450:4864:20::335]) by gmr-mx.google.com with ESMTPS id 5b1f17b1804b1-4282412a934si3851235e9.0.2024.07.31.12.57.22 for (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Wed, 31 Jul 2024 12:57:22 -0700 (PDT) Received-SPF: pass (google.com: domain of jan.vermaete@gmail.com designates 2a00:1450:4864:20::335 as permitted sender) client-ip=2a00:1450:4864:20::335; Received: by mail-wm1-x335.google.com with SMTP id 5b1f17b1804b1-428243f928cso18396675e9.3 for ; Wed, 31 Jul 2024 12:57:22 -0700 (PDT) X-Received: by 2002:a7b:cb53:0:b0:426:60e4:c691 with SMTP id 5b1f17b1804b1-428a9bdb97dmr3240875e9.11.1722455841690; Wed, 31 Jul 2024 12:57:21 -0700 (PDT) Received: from localhost.localdomain (ptr-fij45qxtdobqrxrcewr.18120a2.ip6.access.telenet.be. [2a02:1812:512:2c00:6021:e9a4:5aa0:257b]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4282b89a862sm32618225e9.4.2024.07.31.12.57.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 31 Jul 2024 12:57:21 -0700 (PDT) From: Jan Vermaete To: swupdate@googlegroups.com Cc: Jan Vermaete Subject: [swupdate] [PATCH] doc: code formatting was not rendered correct Date: Wed, 31 Jul 2024 21:57:13 +0200 Message-Id: <20240731195713.773489-1-jan.vermaete@gmail.com> X-Mailer: git-send-email 2.39.2 MIME-Version: 1.0 X-Original-Sender: jan.vermaete@gmail.com X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b="nceHB/tG"; spf=pass (google.com: domain of jan.vermaete@gmail.com designates 2a00:1450:4864:20::335 as permitted sender) smtp.mailfrom=jan.vermaete@gmail.com; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com; dara=pass header.i=@googlegroups.com Precedence: list Mailing-list: list swupdate@googlegroups.com; contact swupdate+owners@googlegroups.com List-ID: X-Spam-Checked-In-Group: swupdate@googlegroups.com X-Google-Group-Id: 605343134186 List-Post: , List-Help: , List-Archive: , List-Unsubscribe: , Signed-off-by: Jan Vermaete Reviewed-by: Stefano Babic --- doc/source/signed_images.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/source/signed_images.rst b/doc/source/signed_images.rst index 3010776a..88cb97de 100644 --- a/doc/source/signed_images.rst +++ b/doc/source/signed_images.rst @@ -172,11 +172,13 @@ Generating a new keypair First, a primary keypair needs to be generated :: + gpg --gen-key The generated keys can be listed as follows :: + gpg -k Check the documentation for more information about parameters. @@ -187,6 +189,7 @@ How to sign with gpg Signing the image is very simple: :: + gpg --batch --output sw-description.sig --detach-sig sw-description @@ -195,6 +198,7 @@ the following can be used to specify. In this example, the GnuPG home directory is in GPG_HOMEDIR, while the signing key is found in GPG_KEY. :: + gpg --batch --homedir "${GPG_HOMEDIR}" --default-key "${GPG_KEY}" --output sw-description.sig --detach-sig sw-description @@ -286,20 +290,24 @@ need to be imported to the device's GnuPG home directory. To do this, the key will need to be exported: :: + gpg --export --output You can then copy it onto the device and import it into your public keyring: :: + gpg --import To verify that the key has been imported successfully: :: + gpg --list-keys SWUpdate will need need to be configured with the following parameters: :: + GnuPG Home directory: gpg-home-dir in swupdate.cfg GPGME Protocol: gpgme-protocol in swupdate.cfg: openpgp or cms