From patchwork Tue Sep 28 18:24:03 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "McAllister, Colin" X-Patchwork-Id: 1534015 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: bilbo.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.a=rsa-sha256 header.s=20210112 header.b=QwM7Si0u; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2607:f8b0:4864:20::53f; helo=mail-pg1-x53f.google.com; envelope-from=swupdate+bncbdhnphwu6ijrbuf3zwfamgqexqwaxrq@googlegroups.com; receiver=) Received: from mail-pg1-x53f.google.com (mail-pg1-x53f.google.com [IPv6:2607:f8b0:4864:20::53f]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by bilbo.ozlabs.org (Postfix) with ESMTPS id 4HJnw52rylz9t0p for ; Wed, 29 Sep 2021 04:24:19 +1000 (AEST) Received: by mail-pg1-x53f.google.com with SMTP id j4-20020a654d44000000b00287a16a3519sf5989589pgt.9 for ; Tue, 28 Sep 2021 11:24:19 -0700 (PDT) ARC-Seal: i=3; a=rsa-sha256; t=1632853456; cv=pass; d=google.com; s=arc-20160816; b=CJ6FJsSXlRRqMZraG7Dch9o8lvHAVRAjiZvMVtWY7lVYsnKGhTmH35qyRwJ98CADx6 +k5cAkJa0iA5PzBzx/mAcRx2wF3qr9FPZTMjxID3I3vFdaDJ+6i/dQrOASkKabrpKaeV R551vmgdp09PJnVDsEQUqVk5fy02MfphMiXPxZyI5WUaeGVwYxbqJaK5N6GwQs0vSUQi E+i2WUVayYofUz81EAnlTQTkNgveNyF6GF1nsKxKYjWbCVOlLJ5S3TCITTqGkfTGG5Mo FwOgN4IONvWjk+Dl+i6wWlReiurX66pepvA+6HLktPg0VNUt6gu0ywDXG0nq5Af6Vfo/ PYlg== ARC-Message-Signature: i=3; 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:reply-to:mime-version:message-id :date:subject:cc:to:from:dkim-signature; bh=2H0I4txgmF6ImFzZvTPGguckuNWF7EfIlAp3EqMfguk=; b=d5ibqC/54n7S0KGCca6ypAcTsIl0Qv4YpCcDqZkI3Tli78+eZWDku6cCkRmdWEkiF5 YChgH259aNgihODf2flCCpH19Fh20EUPgoUOTHF2jnYsn5Soikxzywc7gCUjaf+D1JGV 8rYe7rP3guea6eBVsblVto+hlENBCyLe9eGi8S+Y6ZT8gPCagSK5AFWsMFt+hWYtyaZA KtIksgQWjJRhl45czhOvLi4UuZotG3L07NalSp69dF7brKWs+ZfqBjPUiexheZVyQ/43 UK4BZvtzl0HcAV70ixGzFFsS9hkVtQotIbAuBlmyWzLBxgnVbKdCzZYXBDUxcjdvi4YA 30UQ== ARC-Authentication-Results: i=3; gmr-mx.google.com; dkim=pass header.i=@garmin.com header.s=pps1 header.b=l1PHdoct; dkim=pass header.i=@garmin.onmicrosoft.com header.s=selector1-garmin-onmicrosoft-com header.b=Q23KcXOK; arc=pass (i=1 spf=pass spfdomain=garmin.com dmarc=pass fromdomain=garmin.com); spf=pass (google.com: domain of colin.mcallister@garmin.com designates 205.220.165.212 as permitted sender) smtp.mailfrom=Colin.McAllister@garmin.com; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=garmin.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version:x-original-sender :x-original-authentication-results:reply-to:precedence:mailing-list :list-id:list-post:list-help:list-archive:list-subscribe :list-unsubscribe; bh=2H0I4txgmF6ImFzZvTPGguckuNWF7EfIlAp3EqMfguk=; b=QwM7Si0u3x2noLrAy7DTrnTZLIjRxbs8aTXFPdqGAn+9tQVhIhvQx+LsGgFIK7QGN3 kkWAilWq9FAOOzabJzMx/9AnPWomDVX1KO2CTzqTN3q6ngwPpYQ17HdT8/8cSDDxcvaw sWmfs5GD3xD4bBTfTtmsxO7uLKLIa7cidLq5z3CG73dCmldjNnuMcPVHGWG5I3z0H/2p 1QNG1AJCailhFnbb5gp7MDUuT5SD0fUtEi7XB6aocWRd8rWP3tkcCLJ7XO7ywVrwV6tf Byd7SdKkRGN40hIvOeUmy3kmIJwKvz6Ve7fYcLkWSe3vQGWBpLRq6/OMHhCU3QolRWL3 dFWA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :x-original-sender:x-original-authentication-results:reply-to :precedence:mailing-list:list-id:x-spam-checked-in-group:list-post :list-help:list-archive:list-subscribe:list-unsubscribe; bh=2H0I4txgmF6ImFzZvTPGguckuNWF7EfIlAp3EqMfguk=; b=6af1YWdOlBvNL0HSZfAWkUCAGiSlVoGWmF49dnDhIqiJm8WKDRLjrpLdhO0MOLyNRO 4o7JCWdtvUetRFNVnmIFr+MLAm/1PRu0CFw4h/F/lq87zsL6/uM8gXg9OHbpehLoBR75 MPizRM+iYbes+IU3712gUQS1YNp4yukPRdWwxnHEToXq37x6Z7UKpHXS+7en+iAwJwzt Y7Q0C2xeKvIabE8o3ML1dCPRHTE0JEnOBGdtGdfZ4R/42UM10dy5Te4zhudPNmSYyZNd bfD/W0Qrg+nXLTYNpD7ZybvnQtRV0EYMIJr9BC4/SSxXb953sfXOzCgYbHsugHjnv95l OfRQ== X-Gm-Message-State: AOAM531vzWwnxPGIkG8paIEoRDeCOCg1nvrTwsqAPI2F/opghxfyWtIE CvHqnuoZy5AeKAoJvaREhqc= X-Google-Smtp-Source: ABdhPJydzvMIb4cv0yQBVpfwzEHdbhCogGg7IJYAkj0WFEM+pKWLWIMsHzUfFTaSnCYkygRC/ih15A== X-Received: by 2002:a17:902:708c:b0:13e:b42:88b5 with SMTP id z12-20020a170902708c00b0013e0b4288b5mr6482434plk.4.1632853456454; Tue, 28 Sep 2021 11:24:16 -0700 (PDT) X-BeenThere: swupdate@googlegroups.com Received: by 2002:a17:90b:1893:: with SMTP id mn19ls2163869pjb.2.gmail; Tue, 28 Sep 2021 11:24:15 -0700 (PDT) X-Received: by 2002:a17:90a:86:: with SMTP id a6mr1487774pja.190.1632853455560; Tue, 28 Sep 2021 11:24:15 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1632853455; cv=pass; d=google.com; s=arc-20160816; b=sEh0SVTcLTmpcpXVJcjzeqLmuZfmdvjOUrm+nD6O3x1wyKbBuaSzMQH+wTKvS/+yRu Ee3o8EUxuvzagPWHAHdIgcajJv7pRVXGiwEkPmEhIbZE4deHyJnePqs4kx1VhW3kHtos MaIBP7lqee7b6sCPgA4AINRHavORsjzU6+eAjDi5h++22GaF6UryUlwxg6PtgwVzbIzO rYh/iSTR8o5oRZJWT/+8/1/TBQTk0pz/LHz6wObkao/bmwlCTX+UEYYA52+LHboXz7wE BuyJuVIZQDThc/Yz3Qs5AX3p4qyYAAayoE4rD44EsRqTxbeOj7Tefx6F8kpPe68uSdiO E9cA== ARC-Message-Signature: i=2; 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:dkim-signature; bh=LVKbAJI9eDDkAnvyposjCx7/+vX+gHPc39qxSZEsbZI=; b=Hfdx4hgtLW/oTzzNib/rqGM2OJYYccaqZk/IzqwrL2jxgCyeprt9j+YA/8KD796K/q U0d+yB68DYH6mP+eFyknTpfDgfpBTFb7uwpm6zW71E0mJKW00HTQkxdRJgyQZwwd2z2n 9JXQ2rcmDO27SajOK/pdxX8qMvcq3KmzBX1tlpJMy6F0yisQYdUnnJSlVpE8+lmvHQhh tpN7IZT1KEaikLBcWow0NOahLj1mgo+v9aQiLdxf6JQWeaUUt6L4jP6J6ooGXSwQgI/a tsreSW9z/uiyEMaq1xKIctshSIx38DPsgod6eKpPOTMj72pHDYLe2MK90HiM0wZ2WUFV eQ3Q== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@garmin.com header.s=pps1 header.b=l1PHdoct; dkim=pass header.i=@garmin.onmicrosoft.com header.s=selector1-garmin-onmicrosoft-com header.b=Q23KcXOK; arc=pass (i=1 spf=pass spfdomain=garmin.com dmarc=pass fromdomain=garmin.com); spf=pass (google.com: domain of colin.mcallister@garmin.com designates 205.220.165.212 as permitted sender) smtp.mailfrom=Colin.McAllister@garmin.com; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=garmin.com Received: from mx0a-000eb902.pphosted.com (mx0a-000eb902.pphosted.com. [205.220.165.212]) by gmr-mx.google.com with ESMTPS id b15si413852pjp.1.2021.09.28.11.24.14 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Sep 2021 11:24:14 -0700 (PDT) Received-SPF: pass (google.com: domain of colin.mcallister@garmin.com designates 205.220.165.212 as permitted sender) client-ip=205.220.165.212; Received: from pps.filterd (m0220296.ppops.net [127.0.0.1]) by mx0a-000eb902.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 18SB8DPJ002075 for ; Tue, 28 Sep 2021 13:24:13 -0500 Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2174.outbound.protection.outlook.com [104.47.57.174]) by mx0a-000eb902.pphosted.com with ESMTP id 3bc1wnryf4-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 28 Sep 2021 13:24:12 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=GAChO5o+eoFLDiToqS8VZ8KT7Jz6/QJPR+LFHfDqwhsufRB/956/2rxfIur15yUKouvIdWlnIj9RYcdP9UosG5WUt6wIfq6L3acJnLBxDRE/Y65I5cn/CJueXknhgPLBd8QFjLPJXOx+73+phCoVxN3XPLyMeOzxSyegTgPBp5XHCMXXYsVepLXTP26Ftfy0b7Q4sNO5F/Kz1RFREA6Ozj0GUMhuaNnjKOF4p5sDjcth6K8vH660x9Lh5a5FBAznfuQ5f7Osjsysp/Gi4lQKU2gruZ8VVi6TUFmZeZBpB2ljNKD+SvCCdHX9SRcWxaFJ6smeJ1PFGOSKILqPNPPA8Q== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=LVKbAJI9eDDkAnvyposjCx7/+vX+gHPc39qxSZEsbZI=; b=ZmGvpk55JlFIvbVe7YnmG3J9lcZxvh74IZLUzhoc6cNtuQxNSIqHbRFvR5PYUXvGgPEBCBKpDnYMDWtJ2ajIPb2afa1RoDOqsBpBXY3c07odbTPWEnPP1VWbrVY2/UCD+ta8jDDS5xiLDsMX7iCXrabbPb5koROmqtPRz1L4PG0O3YyanUnYA2RoE5c8R/0Bgk+EtISAui1ahtKJuSIAJa+Zd3yNOmqPfzrOE3A3SblGnxlLO/r4KLrXWGCI5xGXy+PpibVpZqhpgk+QSS2hK0+a4dGl1a3h+rKdIqVSRtYyN9zhofV9gzF038SVSGlyIFvPsbdApRiIXqoGqD9Yog== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 204.77.163.244) smtp.rcpttodomain=googlegroups.com smtp.mailfrom=garmin.com; dmarc=pass (p=quarantine sp=quarantine pct=100) action=none header.from=garmin.com; dkim=none (message not signed); arc=none Received: from MW4PR04CA0081.namprd04.prod.outlook.com (2603:10b6:303:6b::26) by MN2PR04MB5661.namprd04.prod.outlook.com (2603:10b6:208:a0::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4544.18; Tue, 28 Sep 2021 18:24:09 +0000 Received: from MW2NAM10FT066.eop-nam10.prod.protection.outlook.com (2603:10b6:303:6b:cafe::e5) by MW4PR04CA0081.outlook.office365.com (2603:10b6:303:6b::26) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4566.14 via Frontend Transport; Tue, 28 Sep 2021 18:24:08 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 204.77.163.244) smtp.mailfrom=garmin.com; googlegroups.com; dkim=none (message not signed) header.d=none;googlegroups.com; dmarc=pass action=none header.from=garmin.com; Received-SPF: Pass (protection.outlook.com: domain of garmin.com designates 204.77.163.244 as permitted sender) receiver=protection.outlook.com; client-ip=204.77.163.244; helo=olawpa-edge4.garmin.com; Received: from olawpa-edge4.garmin.com (204.77.163.244) by MW2NAM10FT066.mail.protection.outlook.com (10.13.155.106) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4544.13 via Frontend Transport; Tue, 28 Sep 2021 18:24:08 +0000 Received: from OLAWPA-EXMB12.ad.garmin.com (10.5.144.16) by olawpa-edge4.garmin.com (10.60.4.228) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2106.2; Tue, 28 Sep 2021 13:24:03 -0500 Received: from OLAWPA-EXMB2.ad.garmin.com (10.5.144.24) by OLAWPA-EXMB12.ad.garmin.com (10.5.144.16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.1.2308.14; Tue, 28 Sep 2021 13:24:07 -0500 Received: from ola-jnrkg73.ad.garmin.com (10.5.209.17) by smtp.garmin.com (10.5.144.24) with Microsoft SMTP Server id 15.1.2308.14 via Frontend Transport; Tue, 28 Sep 2021 13:24:07 -0500 X-Patchwork-Original-From: "'Colin McAllister' via swupdate" From: "McAllister, Colin" To: CC: Colin McAllister Subject: [swupdate] [PATCH] Doc: Update building with Yocto Date: Tue, 28 Sep 2021 13:24:03 -0500 Message-ID: <20210928182403.13386-1-colin.mcallister@garmin.com> X-Mailer: git-send-email 2.33.0 MIME-Version: 1.0 X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: f91ca7a3-4ae5-4b95-caeb-08d982ad295a X-MS-TrafficTypeDiagnostic: MN2PR04MB5661: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:8273; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 0iBMP+s3NZeGu6Y8DkOZiMmeO3Xu51TjgUNTBlkpmKlLvJKGRYkc9bFhHFDsCAxuvKkVdYVmdngyF0ifn+jK1hstLgaSIux0Knm5GLRb4UhjKCW85o2vRtEAMhjgN/DWXQDfU8l8joMi8xNj1ZnmKYmMwigUInxO5DyER8Vl+XSYa8/ATmPozqGmEVS72hp7hqQMnbQ7FI1iMY12i2UhYYuXksPowhHC5GDeYjfKCgt7rNy0wR8dr2nO+NzDQnPJ9ENiioIVrKqc9+OsYVYoYWB5lfTBYquAs142cPP/QvMiSEBk466seg//uLlgsY2ONgLWmCxwtWUVMMiP77PDfIx+4eqymc4iSlHPrlcVSggp7L2ZzMv68PfQbcnPavYtznSbcSlMojONSWnZNw14584gWHDuXhHFVuBx+fBkqLUM/2fe/DwheBUN/m8Pg2xas9aYwHH77xWwAunPwu1yclP/R3JKiNn6BxjMFR/Xc+9zLoGRMMonBsrFPN6StxetOO6AqDnYk3QgjbsLuzj/lQRlJYEu7DZ9gSpfY85p/j81BK4Pq/LFhP6nLCivxPdgJvjKKYSHGBZu/MX7i27PDQVL3Dfynk1z/ISOYV7hISmB55CerCijQyTyOg57yWbEBTokbXdqCdluDklRfdxbqoNt28WgbUDPHMj3LM74+dqkqal3WBHu60rfHgQ2SR+CDxmdgaIgOoux/TRHznqZvA== X-Forefront-Antispam-Report: CIP:204.77.163.244;CTRY:US;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:olawpa-edge4.garmin.com;PTR:extedge.garmin.com;CAT:NONE;SFS:(36840700001)(46966006)(4326008)(8936002)(7636003)(7696005)(316002)(83380400001)(8676002)(15650500001)(36860700001)(508600001)(6666004)(336012)(1076003)(82310400003)(70586007)(107886003)(356005)(426003)(47076005)(2906002)(186003)(86362001)(26005)(70206006)(4744005)(36756003)(6916009)(5660300002)(2616005);DIR:OUT;SFP:1102; X-OriginatorOrg: garmin.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Sep 2021 18:24:08.2995 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: f91ca7a3-4ae5-4b95-caeb-08d982ad295a X-MS-Exchange-CrossTenant-Id: 38d0d425-ba52-4c0a-a03e-2a65c8e82e2d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=38d0d425-ba52-4c0a-a03e-2a65c8e82e2d;Ip=[204.77.163.244];Helo=[olawpa-edge4.garmin.com] X-MS-Exchange-CrossTenant-AuthSource: MW2NAM10FT066.eop-nam10.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR04MB5661 X-Proofpoint-ORIG-GUID: dXdn_rqbUokzU1kOqeiyxhzageA1hgCx X-Proofpoint-GUID: dXdn_rqbUokzU1kOqeiyxhzageA1hgCx X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.182.1,Aquarius:18.0.790,Hydra:6.0.391,FMLib:17.0.607.475 definitions=2021-09-28_05,2021-09-28_01,2020-04-07_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 bulkscore=0 malwarescore=0 mlxlogscore=642 adultscore=0 mlxscore=0 suspectscore=0 lowpriorityscore=0 clxscore=1015 spamscore=0 impostorscore=0 priorityscore=1501 phishscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2109230001 definitions=main-2109280108 X-Original-Sender: colin.mcallister@garmin.com X-Original-Authentication-Results: gmr-mx.google.com; dkim=pass header.i=@garmin.com header.s=pps1 header.b=l1PHdoct; dkim=pass header.i=@garmin.onmicrosoft.com header.s=selector1-garmin-onmicrosoft-com header.b=Q23KcXOK; arc=pass (i=1 spf=pass spfdomain=garmin.com dmarc=pass fromdomain=garmin.com); spf=pass (google.com: domain of colin.mcallister@garmin.com designates 205.220.165.212 as permitted sender) smtp.mailfrom=Colin.McAllister@garmin.com; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=garmin.com X-Original-From: Colin McAllister Reply-To: Colin McAllister 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: , Updated Yocto-related documentation to add information about using the hash of an image as the version. Change-Id: Ib43baeeab35a1f679176c9f1ad3b876a14dbf3eb Signed-off-by: Colin McAllister --- doc/source/building-with-yocto.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/doc/source/building-with-yocto.rst b/doc/source/building-with-yocto.rst index 42a379c..f357a69 100644 --- a/doc/source/building-with-yocto.rst +++ b/doc/source/building-with-yocto.rst @@ -162,6 +162,10 @@ For example, to add sha256 to the standard Yocto core-image-full-cmdline: The name of the file must be the same as in deploy directory. +Additionally, the sha256 hash placeholder can be used in place of the version. +This allows for an image to be installed only if the current image's hash does +not match the hash of the image contained within the update. + BitBake variable expansion in sw-description --------------------------------------------