From patchwork Tue Sep 28 18:25:58 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "McAllister, Colin" X-Patchwork-Id: 1534016 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=taqiLWZ9; dkim-atps=neutral Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2607:f8b0:4864:20::63f; helo=mail-pl1-x63f.google.com; envelope-from=swupdate+bncbdhnphwu6ijrbyv4zwfamgqedkeb2ky@googlegroups.com; receiver=) Received: from mail-pl1-x63f.google.com (mail-pl1-x63f.google.com [IPv6:2607:f8b0:4864:20::63f]) (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 4HJnyr5PxVz9t0p for ; Wed, 29 Sep 2021 04:26:44 +1000 (AEST) Received: by mail-pl1-x63f.google.com with SMTP id n15-20020a170902e54f00b0013b7a095210sf8898051plf.15 for ; Tue, 28 Sep 2021 11:26:44 -0700 (PDT) ARC-Seal: i=3; a=rsa-sha256; t=1632853602; cv=pass; d=google.com; s=arc-20160816; b=ov9nu6GAy9ZgFhSAHo1znmFsEGCzaxZQgNEnfbb8wA8mZrImRQpvQf8AdXmTFk3eMm KdB+5oJk61j3HmiLrRhp9QeSxuz3zN3rfLeKQHYW7cVuJZIikFNI4RVwY3RoMTvyepJZ 8Mi8zoFPkYZccommmnAd7iZLMVRPnQJYpxXGvKHZNwSJ6RTK3qfT8O2qTJiQ/z1kZrt7 Qz3Oo52X0y5IObQoi4LGvg5vuH8TclVNtD/E2HMu4V9RI2QVxflavjr7i2aeyvE2Dy2B faqwEWa1EqmWT71GPpqypTOPU36An6YjuV6PnKYwBA+jpoUxXJzfv4rocGWTjcuRB8bI tkiw== 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=cG6DohpRLYW7PW17WX4FVPu1Z9vR2UPKijivCNHT1xk=; b=xmfaTleypw4bZBbx2ScgzufYqMFy49vEVuBwTCC4fuTcIe7rNr/PlzfxX1O9XvHFrd 1bNq7u+BtIIFlKu4+5nilPuyDli/MByuNa+MN+yVR7l/y+1J+2ImaD8mviLh/ayfa1rL S2pHDJs8K7rmzNxdmbp7QK2YMzKGTWIjhAtMmhxc30iWOzKQixYvO450sv8atnj2AYXx Havzf/WrbfPyuBjaGyXajGdmFXWu5xbu/hNG8/QUrxUCyOJqpos8dhkntohk79ZmnYxa 7tBYIQDypFDwOZCgoN5LDEQqYni0vT2gJNE42lTM67w8n5GTaTL8GT5/nMPEZo5XAl+i Z1Ug== ARC-Authentication-Results: i=3; gmr-mx.google.com; dkim=pass header.i=@garmin.com header.s=pps1 header.b=HYF2BWY4; dkim=pass header.i=@garmin.onmicrosoft.com header.s=selector1-garmin-onmicrosoft-com header.b=Q8zk3FaS; 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.177.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=cG6DohpRLYW7PW17WX4FVPu1Z9vR2UPKijivCNHT1xk=; b=taqiLWZ9yrYYZDqSHmyqGgQJrr7+dGb+c1MgxaQMtuLIeXiYbM3kFbf1PY7+94AbL/ pELQLAAW6wJ02Zj6YEgEQy12z05qPjgoGzMT2U7Iddw66HJGgKDW6j/VRwHmsUiXELNT klsqf/RZMJk941BGJ2S5+nYJCMvLJnGrSxj7S9GHW20RCxAUEZDxvazIkrHyO0YwxWLb juX5HLPEHQWnFF8kauTHkaV5kMte4vFUYdL0Y8cFOFJoRFIC+GFEcgucZPn9aaZJ8yoV +u8td+pelra3/6pEu0fTLNGiG0GsUGux1yBwq/3WBhJrmBWSFL4QLd2pyLjWRQhfOfBE R3aQ== 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=cG6DohpRLYW7PW17WX4FVPu1Z9vR2UPKijivCNHT1xk=; b=3GaAgqd+Pb7Mp+1F31SBXUdmHZCJhlionr1cBOYXw2NqFo2/+nvnpwADl3NetrWRAi C4nA50wsV+BY1LCKkNMNqNSueL92U2s88Own71uFC7UuB+CAt5KImqWvqlkLxNDVc2xq 0XpThoTSXGXSt81HYALUS/U/xorPWuLBEN8+2JQeOu2jOt8UphVBqlYwPC2F61cF2ZIo 7xpGJ4txafXm86o7bvVIxubyFISyKYEdT9gBdwLi5EiwbBRiKill2x8osY4n3ZxYVaLl ibRiWqzeS2tzEa56tyHDwunkjYRK4Gus1w1fZkPtkUqDUqK7s+0lkjoMLTuKrg4ROU7W mR7A== X-Gm-Message-State: AOAM533Y149WpWc7L2r4pOl9LgiBazCcxR81M4+HECyz5CS+HJhKiM55 2LN4i5ScHFYqTNyTXYR7FoE= X-Google-Smtp-Source: ABdhPJz6jGQDwB17yXU18eJMQlQh/2Lz+jR9ONZGVmzjQATapMYdFnK5lb5/z3ZCZi/FXqRpkffZOQ== X-Received: by 2002:a63:de41:: with SMTP id y1mr5964810pgi.93.1632853602680; Tue, 28 Sep 2021 11:26:42 -0700 (PDT) X-BeenThere: swupdate@googlegroups.com Received: by 2002:a17:90a:1d0f:: with SMTP id c15ls275820pjd.0.canary-gmail; Tue, 28 Sep 2021 11:26:42 -0700 (PDT) X-Received: by 2002:a17:902:6804:b0:13e:38d2:cdd8 with SMTP id h4-20020a170902680400b0013e38d2cdd8mr6107234plk.54.1632853601960; Tue, 28 Sep 2021 11:26:41 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1632853601; cv=pass; d=google.com; s=arc-20160816; b=Nb1y7zJe2Ad8pBylRq/qM3L5XIbNixhALDeDZzG27paTGvM6p91CWXyFUf4j0YnT7i 9Fg5Oy014j8K6jt8IcXiwrigtmtwZgUvkFr8afWBLns9vrK1iNKkeAsZKGfNujcXy9Yq OgvTgOCZqkXjDZ7/fIvsa5u5nT5VdImydScZo6LfuWmqRcIjQr8chkifsKcYb3Ql6fLO UYbnfVeGcTUiTanoh6jtuiiUBATedEKa538nDoxD+BBnZsBKNlhkw+WyetvxgHABnOo/ zVV4G0zrXH6IT00WLSJPsghgpl6Ts9UHHxMpTLqdsgNLFWHAEa3FJ6OpNGcnVwEqxJyd bs5w== 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=I2WicbwpzTa8Zq8U7ypTfrhKFUECqIv5mBXTnY9adIY=; b=grn+BtEOnOGmBBWazGQKdM5pPwXc6tIQ9i5/ETIwTsQtpLCDPywr/uUdtQasUC+k3r lPhKdcCatmGVqyXivoxvokRICMEJFa8qqkyRM2hgkxGqca94OBUunyBGmJspw8MzqPl/ mRHuZSzLi9n+C8HLLauPH0Z7QGxsRs3fAMHVdNPFyugmLOOnqVZ5/ZkYYtNmyW+h23fH +U/YY8Q6KyafzRdM2ZWBtS7TakTrUMvQXMCSzYvPORLJCbL3H40+cHz6M48fFXMzeRUo Bq/hT+m7Uarisf/rezlxd3TyT3S5T62+RCsC5f6I0z7OlMMljd+SW0FFxnljHkKbIClG wjlA== ARC-Authentication-Results: i=2; gmr-mx.google.com; dkim=pass header.i=@garmin.com header.s=pps1 header.b=HYF2BWY4; dkim=pass header.i=@garmin.onmicrosoft.com header.s=selector1-garmin-onmicrosoft-com header.b=Q8zk3FaS; 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.177.212 as permitted sender) smtp.mailfrom=Colin.McAllister@garmin.com; dmarc=pass (p=QUARANTINE sp=QUARANTINE dis=NONE) header.from=garmin.com Received: from mx0b-000eb902.pphosted.com (mx0b-000eb902.pphosted.com. [205.220.177.212]) by gmr-mx.google.com with ESMTPS id y2si668573pjp.2.2021.09.28.11.26.41 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 28 Sep 2021 11:26:41 -0700 (PDT) Received-SPF: pass (google.com: domain of colin.mcallister@garmin.com designates 205.220.177.212 as permitted sender) client-ip=205.220.177.212; Received: from pps.filterd (m0220297.ppops.net [127.0.0.1]) by mx0a-000eb902.pphosted.com (8.16.1.2/8.16.1.2) with SMTP id 18SFHmFp018110 for ; Tue, 28 Sep 2021 13:26:41 -0500 Received: from nam11-dm6-obe.outbound.protection.outlook.com (mail-dm6nam11lp2173.outbound.protection.outlook.com [104.47.57.173]) by mx0a-000eb902.pphosted.com with ESMTP id 3bc5jg8cqc-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Tue, 28 Sep 2021 13:26:40 -0500 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=XN+CNLGipQ11Dg5ko/+dhu+xgrZ/x7dReGf6TMuUU/y1BiRrt+XKucI9W5JTNftcyj+UObnnsRz25TjY0uuwPNGzxubPiP/Jxx0j5N0/bx/bYhez6d0IaUc/zYPWqjV7RZTjUB4KeW3icggGHVhIhmnEclTn8WPPHSuBgIOKfC/yvi2UJEBh/olv4wXP++M2Ka3pDPbKfOGoKhFr8VMKu/bOGhGw2q/q6N2a9QjvEMr2H+VqxBW5+SYL8rldnt+jW1QS+5cCmvE4FL74B3JR3jbXRC8YTq/DEoKuEzJ3o3xoOfez0pvJXNwr3XbnnP5LxthnfIRmVPhW/ksOzmUgTQ== 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=I2WicbwpzTa8Zq8U7ypTfrhKFUECqIv5mBXTnY9adIY=; b=k/sjADzo5i3F0Y3ZMfFZdi1yTOo71bdK0QKMC8krxsP6NbFGvn2774ysThRMmHhN5j1hDkKnyCy5zB04dXPtpk96AQSHGMfNWaDQc31mpc2UzA5faok1KtYKnQnBTbN3fyydS0KW9SH/dvrK7Pa11mLx9NrhcXuyNl+j2f0/g7oMSPD7UaAV1rvG/501zEBoetQ1tZhAdGpxH4SEIVdhNLm++HsvDHQqmmZ1dcnsll4c+IdU0VA8mnISlnBd5NIuPCKn3SuUUCPlyryJ1Why1SfgxtfkQrRw7/Hrx5l+3yfVBH2ZFRD+xg0R4bSkV/kVCFrcu2fTcBdqFJpX4cJ93A== 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 DM5PR19CA0052.namprd19.prod.outlook.com (2603:10b6:3:116::14) by SN6PR04MB4718.namprd04.prod.outlook.com (2603:10b6:805:b1::32) 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:26:39 +0000 Received: from DM6NAM10FT006.eop-nam10.prod.protection.outlook.com (2603:10b6:3:116:cafe::6d) by DM5PR19CA0052.outlook.office365.com (2603:10b6:3:116::14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4544.14 via Frontend Transport; Tue, 28 Sep 2021 18:26:39 +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-edge3.garmin.com; Received: from olawpa-edge3.garmin.com (204.77.163.244) by DM6NAM10FT006.mail.protection.outlook.com (10.13.153.14) 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:26:39 +0000 Received: from OLAWPA-EXMB11.ad.garmin.com (10.5.144.11) by olawpa-edge3.garmin.com (10.60.4.226) 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:26:35 -0500 Received: from OLAWPA-EXMB2.ad.garmin.com (10.5.144.24) by OLAWPA-EXMB11.ad.garmin.com (10.5.144.11) 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:26:38 -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:26:38 -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:25:58 -0500 Message-ID: <20210928182558.14336-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: 8603ed64-56e2-4903-820d-08d982ad8336 X-MS-TrafficTypeDiagnostic: SN6PR04MB4718: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:5797; X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: TLlqgSzogK11oDGP+AcCmpv7XWso+sGGMTAL4AbD8IGMSWSw7kPetEorNRbECnZo/AZ1cxDvX+WssONNgOCzFUEwQx9e9qXewlLo4xtFvdNMbHxkVAe2ZzwXNJCQScan/LfBHl4PQSFi8fRiT3+Bg41WI1OQDCN2nfxHkjSZaEfOGXMk9UH7fOBIMkBGuPaZvyQKC4u6jO9q8Skw/86EwOe0swjZjThd5xoNHNrOmSFgp99EtrB/3E1g2RR3X5s3gZdzuSID81FLSFjZe4ti9FeVFuvXnn8O0sl+j5SXbdwARNVa9o8FJlLtKFQlTa2+pVJE7TgZo67s12tA8gGDQ+3XTLgUWGGqSb87dcYVoByKLGs2zE5fHqmMWetcnW4XCl3A0N0cvJt+yGgTzAU5nJ4qNNnODVk2T/7y4BQHtpls+rgHXOeO+qjXVikfOF0/liK6fIu2gYtG9I6/dztZ/OPgEVz6vFe7OuakfkYe5TPdSJPXsoZ7kvmR3qen3wRs2ntuYFpYeggWqzsCA6RS1Yk0RX6cN5gQo8w1cw0Bcc95q7Ztztt7NbVh8J/qnIfyX+WZ+lw8vYDWbibgh6TZZ5Sy+ug1mF1ZG7/Jw+bikfATjNH8YK0MkGJ1rreUxC43+v0jdQR2BDmqcBHDJiqwHGCzLcrhjrAnILnlVbMZpjKvRmtnxuOlARLuDG2s158DdgnbNtZCG6K506TwUejiDg== X-Forefront-Antispam-Report: CIP:204.77.163.244;CTRY:US;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:olawpa-edge3.garmin.com;PTR:extedge.garmin.com;CAT:NONE;SFS:(46966006)(36840700001)(2616005)(2906002)(26005)(8676002)(7696005)(70206006)(6916009)(70586007)(1076003)(7636003)(36756003)(82310400003)(356005)(15650500001)(36860700001)(186003)(508600001)(8936002)(6666004)(4326008)(83380400001)(107886003)(426003)(316002)(336012)(5660300002)(86362001)(47076005);DIR:OUT;SFP:1102; X-OriginatorOrg: garmin.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 28 Sep 2021 18:26:39.0927 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 8603ed64-56e2-4903-820d-08d982ad8336 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-edge3.garmin.com] X-MS-Exchange-CrossTenant-AuthSource: DM6NAM10FT006.eop-nam10.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN6PR04MB4718 X-Proofpoint-ORIG-GUID: vUM_eCVcOui2umlsrZt_iCNAh7g133R3 X-Proofpoint-GUID: vUM_eCVcOui2umlsrZt_iCNAh7g133R3 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 suspectscore=0 lowpriorityscore=0 clxscore=1015 priorityscore=1501 mlxlogscore=837 adultscore=0 bulkscore=0 impostorscore=0 mlxscore=0 phishscore=0 malwarescore=0 spamscore=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=HYF2BWY4; dkim=pass header.i=@garmin.onmicrosoft.com header.s=selector1-garmin-onmicrosoft-com header.b=Q8zk3FaS; 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.177.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 | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/doc/source/building-with-yocto.rst b/doc/source/building-with-yocto.rst index 42a379c..7085bfb 100644 --- a/doc/source/building-with-yocto.rst +++ b/doc/source/building-with-yocto.rst @@ -218,6 +218,24 @@ Or combined with a different package name: ... version = "@SWU_AUTO_VERSION:u-boot@PKGV"; +Using checksum for version +-------------------------- + +It is possible to use the hash of an artifact as the version in order to use +"install-if-different". This allows versionless artifacts to be skipped if the +artifact in the update matches the currently installed artifact. + +In order to use the hash as the version, the sha256 hash file placeholder +described above in Automatic sha256 in sw-description must be used for version. + +Each artifact must have the attribute: + +:: + + version = "@artifact-file-name" + +The name of the file must be the same as in deploy directory. + Template for recipe using the class -----------------------------------