From patchwork Wed Dec 23 13:43:00 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefano Babic X-Patchwork-Id: 1420131 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2a00:1450:4864:20::43d; helo=mail-wr1-x43d.google.com; envelope-from=swupdate+bncbcxploxj6ikrb2usrx7qkgqeaxg3say@googlegroups.com; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=denx.de Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.a=rsa-sha256 header.s=20161025 header.b=C+JRoZba; dkim-atps=neutral Received: from mail-wr1-x43d.google.com (mail-wr1-x43d.google.com [IPv6:2a00:1450:4864:20::43d]) (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 ozlabs.org (Postfix) with ESMTPS id 4D1DtQ18XDz9sVH for ; Thu, 24 Dec 2020 00:43:09 +1100 (AEDT) Received: by mail-wr1-x43d.google.com with SMTP id j5sf12728897wro.12 for ; Wed, 23 Dec 2020 05:43:09 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1608730987; cv=pass; d=google.com; s=arc-20160816; b=aa9jP+0onw8MCm70PpHD8bX0ktsAOqPRfLLnDWCbLtdcFjif5zn3t+nI9mXfVkm+gn elrQRMHtlJAPBUO1rI0/s1amKE9PdC9PQhHqlrjaGsaH6e0jjWAjCnqZsQnqkvEWMqLd CZfWdE0wknl3hJdtDIfeWGRnV+utR5CMf4Q1EpDath3s1LUmuCzsgdLcUR+mSWB0QbYM WtG48bx8Vpx5Y7GMxs1VqT5GX5xuAqoFFWUlEiEwyGcBCF540cYE7ctDOVagLKkGvk3l zeFdaN/WoTUxRjoDVbO4TxjfB7wKk6cwGgA67tmvFiMsCLbanzAM3h1Eu7x4IzaGHjp9 nHhg== 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; bh=PUGSLLAMr55j5fzsDilWGPLSWtEyfUervHXXS5orxLQ=; b=UXcxPOhv3yGBGVGbppFDA9fL0YZwTJAeFyxDFS0CXW5byBMYA0oxCo73h1YBDH5nRV 0X7yoMl2HuJkrTDrTIQevYJELX2NasdvdWYnBjBpBjOMHOL/I3oeQBSD2JKVLCbHk2u4 Esqfv29chS/VOZFA3ortjEqXqUVDk6k6H9cHABeosa6D49qyvpibQE9VdeGFSPykFmGc yDCHEJbMYo9kdaVRvLvlxMtxJLD8QRcE19iIt+jPz6KpbyDEna0owNZO6VY16jrARsOn bb2UF/0FX4hUzAn+o/VsTRf2o873jSDoVQtRmxmhf2fVTkU9T/ENBlIkFsSivNJoiw6d RmCg== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=neutral (google.com: 212.18.0.9 is neither permitted nor denied by best guess record for domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:mime-version :x-original-sender:x-original-authentication-results:precedence :mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=PUGSLLAMr55j5fzsDilWGPLSWtEyfUervHXXS5orxLQ=; b=C+JRoZbaMPVVcCqBZ4Er6FbJF0QW09mLE0UDb2PjrjQHHf3XKM6DKePI4iCqN3Y1rX v65EAkXbXVWLcCdVoBcf3G2Tcvpmom7JW2C7Yntim4FxjSE7NksvWRdztN4i9COhFFHW WC7TjIRl4cz3gWu3IwicUTlPce1qVRhdy5tX1nh4Gc8+FF0ObpOGeCbeBqAav6fT+hIo puTL7LDbOPpaM9jtaGd8HXqsLlcCxZQbwH65gAM+BuWpt21xdCbCa2i3peiA3wpTBheW 4BVqBiGlgcSOtiyJh0mh2Fi9q3spGa5NdV40KtWCFLQ5fT6xONZnQM6zGrrOFT7TtQ7K BKwQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:x-spam-checked-in-group:list-post :list-help:list-archive:list-subscribe:list-unsubscribe; bh=PUGSLLAMr55j5fzsDilWGPLSWtEyfUervHXXS5orxLQ=; b=Uk+iToNTPyKsu2pZzkHYhwmIM/rJFNOdVmpGasFfFpjF2NLOJepxMbph3u2o/Esm8f 68YczwXdTEJR/WdDagGcSwi79pWxVuYdZhQl1V/OQFvKy8lX1jVSPSP9crdmBywQP+2Z zXnDmHkrv3cXlEytUnZJGDaANkYvAlqJBIr2fWcKuWdyxIcuKmLzq3qFuDNNqVaBN/3M FWvMVcvzS2xFC8o1SJgdEspfNVo59UDlFo6b6TwnjVNyhsePPOxBEfSJpx1qPJfA4AaB zMFtpPt1jJCxXhRzjHvXKbOMyQaGO5dd2sEHaW1Sc3hh7BbhRAbwoE/dgRSSkOfid3EG LtZw== Sender: swupdate@googlegroups.com X-Gm-Message-State: AOAM531bcisw+xBV5VqT57WH9DnqgjBVsRX4BXu/FVmUWPkPZ9JVpANG U7vYxvH8hjiEPtpqLFUT1EU= X-Google-Smtp-Source: ABdhPJxTTCF04tVjy405bCgHCJGPX2Xa1c2IyvFEpEUNEz0WPqRgYCow25AvjVwAozzm4EauuYVKmA== X-Received: by 2002:adf:f74e:: with SMTP id z14mr30334681wrp.146.1608730987126; Wed, 23 Dec 2020 05:43:07 -0800 (PST) X-BeenThere: swupdate@googlegroups.com Received: by 2002:a1c:a781:: with SMTP id q123ls12654358wme.1.canary-gmail; Wed, 23 Dec 2020 05:43:06 -0800 (PST) X-Received: by 2002:a1c:23d5:: with SMTP id j204mr27022789wmj.130.1608730986106; Wed, 23 Dec 2020 05:43:06 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1608730986; cv=none; d=google.com; s=arc-20160816; b=0fddTSZ5nUQAm1avmTSpvLzYNZi82Nc257ZxAA6SMBwndLYaDdAIlI67ghhrGzRSOX WbrlE0HUcgI64O9JMg4kNELnQN02SnwKZMNYfMYDAqncOoUm/mFBkcgO7S9ga0460nVB G/vi3kmDEqXz3JGbA1WDLc69R0Xee5AU9dovVbnZaecq0ymKySUhK1v2P/7IJwK9RIYg sQT8S8TKq7NkXqFy0DDLLbPslVBmlPbvwZWyIYTFmiKwsMqIT5bbES028h9UGk4EKm0U oaJvr6B2APVjyhoo/rZaRcyscn3dilstyInsZ90VDkC5jt5dAwL1CQ49F/Fz7HGfF97Z QhNg== 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; bh=otg/SwLPg9YuLPj25ZkQCy6DwYVrvNvLNjb7ZQ+xSBc=; b=ETv0h0OxatPJa+7jJ1TCtZryWms8D9+K1UbnEBFH5P2w2KTB3yCCHQ2AlW3f9xfsru pZpGYPE2iDnR50S0DSjueZErRzZTEwl1orcjvxf42sRLDmMr3fsQ2IDSoqSjDdUqW4ff xKRXG6rmSeAjqmBOHZrypcybweSl7TykC7sHkVDGB7JtxYzE3rLFuJsMVHLAE/c9+XPJ GT0aU5TLFuqgs8e6YLfbN6shEDBdyZGmJLBnWwzMXHxTICYz61PBkSu1S+Xrza1aRVjz SrvMINGTlhN5R/iYcPrs/T+V+GmlsqRvilaPDdv2V9lAkuICKDfAW4JS7mjyNo3KUIhh SbTA== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 212.18.0.9 is neither permitted nor denied by best guess record for domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de Received: from mail-out.m-online.net (mail-out.m-online.net. [212.18.0.9]) by gmr-mx.google.com with ESMTPS id x130si682893wmg.2.2020.12.23.05.43.06 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 23 Dec 2020 05:43:06 -0800 (PST) Received-SPF: neutral (google.com: 212.18.0.9 is neither permitted nor denied by best guess record for domain of sbabic@denx.de) client-ip=212.18.0.9; Received: from frontend01.mail.m-online.net (unknown [192.168.8.182]) by mail-out.m-online.net (Postfix) with ESMTP id 4D1DtK6Ztkz1qsbn; Wed, 23 Dec 2020 14:43:05 +0100 (CET) Received: from localhost (dynscan1.mnet-online.de [192.168.6.70]) by mail.m-online.net (Postfix) with ESMTP id 4D1DtK6FVBz1tSQp; Wed, 23 Dec 2020 14:43:05 +0100 (CET) X-Virus-Scanned: amavisd-new at mnet-online.de Received: from mail.mnet-online.de ([192.168.8.182]) by localhost (dynscan1.mail.m-online.net [192.168.6.70]) (amavisd-new, port 10024) with ESMTP id 5ZKaLtD54CpO; Wed, 23 Dec 2020 14:43:05 +0100 (CET) Received: from babic.homelinux.org (host-88-217-136-221.customer.m-online.net [88.217.136.221]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.mnet-online.de (Postfix) with ESMTPS; Wed, 23 Dec 2020 14:43:05 +0100 (CET) Received: from localhost (mail.babic.homelinux.org [127.0.0.1]) by babic.homelinux.org (Postfix) with ESMTP id BCC3F4540772; Wed, 23 Dec 2020 14:43:04 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at babic.homelinux.org Received: from babic.homelinux.org ([IPv6:::1]) by localhost (mail.babic.homelinux.org [IPv6:::1]) (amavisd-new, port 10024) with ESMTP id paH7FCDDksD2; Wed, 23 Dec 2020 14:43:02 +0100 (CET) Received: from paperino.fritz.box (paperino.fritz.box [192.168.178.64]) by babic.homelinux.org (Postfix) with ESMTP id 317EC4540559; Wed, 23 Dec 2020 14:43:02 +0100 (CET) From: Stefano Babic To: swupdate@googlegroups.com Cc: Stefano Babic Subject: [swupdate] [PATCH 1/2] doc: improve description how SWUpdate runs Date: Wed, 23 Dec 2020 14:43:00 +0100 Message-Id: <20201223134301.788137-1-sbabic@denx.de> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-Original-Sender: sbabic@denx.de X-Original-Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 212.18.0.9 is neither permitted nor denied by best guess record for domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de 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: Stefano Babic --- doc/source/swupdate.rst | 48 ++++++++++++++++++++++++++++++----------- 1 file changed, 35 insertions(+), 13 deletions(-) diff --git a/doc/source/swupdate.rst b/doc/source/swupdate.rst index fadc62b..a8144d1 100644 --- a/doc/source/swupdate.rst +++ b/doc/source/swupdate.rst @@ -328,29 +328,51 @@ Running SWUpdate What is expected from a SWUpdate run ------------------------------------ +The whole update process can be seen as a set of pipelines. The incoming stream +(the SWU file) is processed by each pipe and passed to the next step. +First, the SWU is streamed from one of the interfaces : local (USB, filesystem), Webserver, +suricatta (one of the backend), etc. The incoming SWU is forwarded to the installer to be examined +and installed. A run of SWUpdate consists mainly of the following steps: -- check for media (USB-pen) -- check for an image file. The extension must be .swu -- extracts sw-description from the image and verifies it +- extracts sw-description from the stream and verifies it It parses sw-description creating a raw description in RAM about the activities that must be performed. -- Reads the cpio archive and proofs the checksum of each single file - SWUpdate stops if the archive is not complete verified +- if Signed Images is activated, extracts sw-description.sig and + validate sw-description. - check for hardware-software compatibility, if any, reading hardware revision from hardware and matching with the table in sw-description. +- Parse sw-description to determine which artefacts in the incoming SWU + are required. Not required artifacts are simply skipped. + The meta file sw-description is declarative and executive. If "hooks" + are defined in sw-description, they are executed at parse time. Hooks + are executed before any artefact is evaluated and they are the best + way to implement pre install functions. + At the end of the parsing, SWUpdate builds an internal mapping for each artifact + to recognize which handler should be called for each of them. +- Reads the cpio archive and proofs the CPIO checksum of each single file + (this can be disabled in the configuration) and computes the sha256 sum if foreseen or if Signed Images + are activated. SWUpdate stops if the archive is not complete verified. - check that all components described in sw-description are really in the cpio archive. -- modify partitions, if required. This consists in a resize - of UBI volumes, not a resize of MTD partition. -- runs pre-install scripts -- iterates through all images and call the corresponding +- run the partitions handlers, if required. +- runs pre-install scripts, if any. Please note: if artifacts are streamed, a preinstall script cannot be + executed because it depends on the order the artifact (including the script) are packed into the CPIO archive. + In this case, please use the "embedded-script" feature in sw-description to execute functions before any + installation takes place. +- if an artifact is found in SWU and it is marked with "installed-directly", proceed with installation, + else extract it temporarily into TMPDIR. +- iterates through all `images` and call the corresponding handler for installing on target. -- runs post-install scripts -- update bootloader environment, if changes are specified - in sw-description. -- reports the status to the operator (stdout) +- iterates through all `files` and call the corresponding + handler for installing on target. +- iterates through all `scripts` and call the corresponding + handler for post-install scripts +- iterates through all `bootenv` and updates the bootloader environment. +- reports the status to the operator through the notification interface + (logging, traces) and through the progress interface. +- if a postinstall command is foreseen (for example to reboot the device), call it. The first step that fails, stops the entire procedure and an error is reported. From patchwork Wed Dec 23 13:43:01 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefano Babic X-Patchwork-Id: 1420132 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=googlegroups.com (client-ip=2a00:1450:4864:20::138; helo=mail-lf1-x138.google.com; envelope-from=swupdate+bncbcxploxj6ikrb24srx7qkgqeizcepqa@googlegroups.com; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=denx.de Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.a=rsa-sha256 header.s=20161025 header.b=OrkIJih2; dkim-atps=neutral Received: from mail-lf1-x138.google.com (mail-lf1-x138.google.com [IPv6:2a00:1450:4864:20::138]) (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 ozlabs.org (Postfix) with ESMTPS id 4D1DtS3fynz9sVH for ; Thu, 24 Dec 2020 00:43:11 +1100 (AEDT) Received: by mail-lf1-x138.google.com with SMTP id x187sf18128601lfa.3 for ; Wed, 23 Dec 2020 05:43:11 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1608730988; cv=pass; d=google.com; s=arc-20160816; b=Ie+2i7kPAbBV2Qnj27ROI6M4sUNr3k5tnjnKeHb8JV+G8bUSFc8A2IJhFjXl/+dhrk qMZQ6sGJ2O63T8FmnH2Vk91tXb5hkOaxFBSgFRO6S6TV0VtpC9plIeS+pFqZ5EivYbaT GkmKEeRC+dLfl4/Ik4PlyerebkvOp+OVLfrbc4f1AP6AybTpYY/QYSjEzv9AQr4k9sJC xn7ZvJBuADq153KlWX0ZJrxs7R0usdugdTRZ97eX/VU0MgZSNDEc+rhNdh8HbV/1H4gg Vnc3jfX1YOq65/9j8jH4fiBhmjcRdkgzTQocUWVrjxN18azZARYmpVIMMsX67FO7iASI ekaA== 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:references:in-reply-to :message-id:date:subject:cc:to:from:sender:dkim-signature; bh=fqojDSG8nHHrVJZk+ierwe6qHZt5GgpnOsTuISh07/g=; b=StlsKUQXrAkZYiqQWEQfVLDrwA1GxkcHHJ2I8QgMN+DZDYvuo4CZ93fYajJyAXHifd wgWYMg8gm5GnBE2vhQS8OVdHbgiQ+pwO5Cq/VNQHIN1iQ9YpSPV/LSjKt8xNnVcW0Dnr SsAgwhrkRQYNiTUrjBfh40JQtprmi1T8LnyOlTX3RRw0WhwB7pEMMatemHUbrhW9e+Ak njUvkjYR3vLdHW8rrH2FupVz5jR62gAOH6pt0ZfWeiBKED4kGzzFJxWTMAbZqClU7jZn UY66wT+yZXFFhLY/9nuctKPAVnn6+DXSSmRoqJ8/RY0lFglsNEvG9hZqMo4hi7ALKZR/ /LEA== ARC-Authentication-Results: i=2; gmr-mx.google.com; spf=neutral (google.com: 2001:a60:0:28:0:1:25:1 is neither permitted nor denied by best guess record for domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:x-original-sender:x-original-authentication-results :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=fqojDSG8nHHrVJZk+ierwe6qHZt5GgpnOsTuISh07/g=; b=OrkIJih2Bq/54c2C+PFGJ4rmew8AkIDgO+G3BO33sALF/GWfn/BCgRYsg/i+JaCd/8 96uI3SOrZdzATbo84bW+wBLm/UexhQ+B5QuSVFMEyn8RRgTeCClH/kZ5HtErTsqZxU8e HxhnPSSZRvPXnsvl1W2Nh31owTimAdr7M+0ZLiqPQoUFUJlkE2fWlIa1HTrTgwQxKsWt K2OJyysQwLX42WT1hO0U8m0sNfXyq2xE1qgouiPHnbWIrfcncVVtfeRRUstgT4i8b4aY jbGoJKsnkex3gVwW5WCHmlYW0ZIyNETe6vAeAP2H7fmRfTjFttGUZckDuQFtf1cA8cxr N2bQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:from:to:cc:subject:date:message-id :in-reply-to:references:mime-version:x-original-sender :x-original-authentication-results:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=fqojDSG8nHHrVJZk+ierwe6qHZt5GgpnOsTuISh07/g=; b=gfRwH/WnFo0ooKUxL+/VapmEg++o5bxokOob6njayK/+r86VSEanVCDSwrRLBxZnva oC1ORrbjnU6mPsNuz7SzxS9fa94tiy5Swg1kQ/+DL4YSVi/rnuafj69VJRt8GdrN+4La /l2tYk3d3TGQ0ckwGFtLb6hz7/aI8DFxdzLNh23L0gIgVF373sr1gNM7VZKv4owfSpvr i1I5yhjotIS5qtJ/orGMPw1bUAIgxlqzG8shY2IzWnLqwk2KmhnnMvBpqr8fYRZjIK51 zgDFkL5xpAS+bzTC+h5hyAzB57ez0lZnywtOGdJkjv03sBg7jKNW8DP9kgOR9uXJ7/Ph udSA== Sender: swupdate@googlegroups.com X-Gm-Message-State: AOAM532warPZL/uLyTo4H1qBQReembtjo6xB3TOSsgG/PTXPT6KqPcIF vzx+UhNTt4suKvluhmJkbEY= X-Google-Smtp-Source: ABdhPJzZSLFUuqSzLqlAzMpRxAjSEXGoaDLz2FYNXnZk/8ZorE7rolqsGMsW9IcDtyc3FQRyDmrOFQ== X-Received: by 2002:a19:c3cb:: with SMTP id t194mr10219652lff.599.1608730988313; Wed, 23 Dec 2020 05:43:08 -0800 (PST) X-BeenThere: swupdate@googlegroups.com Received: by 2002:a05:6512:10d4:: with SMTP id k20ls4256920lfg.3.gmail; Wed, 23 Dec 2020 05:43:07 -0800 (PST) X-Received: by 2002:a19:804a:: with SMTP id b71mr10380437lfd.504.1608730986961; Wed, 23 Dec 2020 05:43:06 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1608730986; cv=none; d=google.com; s=arc-20160816; b=vnXSwAtrkkBiLbAq1/Ns6q6XFFUrBTopQQ2KToDiyN5a5WXyaBot3IxeH0RsKgBfNJ VIhr/xJhaVRNMrsInP4hYwVIqjwOQmEsMbZe8D+HuKTDJLMo1cP+7fmNLjo74Q6l0Z/a kSFaWfx0/rSvoBh8BglKbzxw+4KhzCAcYznrWcAwhtr+InSw3JxmUDQf34w5qZ7IUGci VYIF+zwDPERqSoStcjy3nYPJ42TDek9HBKGrA1Ww8qDtTpwoGaydAfu79P6eXuOdo6RL tbLpJI6eJAYjl/z2nevJ8o4XDCg4mLgfgFp31aOq8sIsCh48XLwafiS9JpBtXUrecB/R KNGw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from; bh=9I9d4Gq1oiH+HOUoaMSsqaHJYDCA+TReGIFE025k3N4=; b=UxOgMvXofm69n8c+R6lx9p52VcJWS/hpILbYvDgyyt7vHfJmIqWkV7ivyTChOdHAqB 96oppiWsD8edZtzorzZvo+g/D+6zXRSu6U86k5Nc+KKle5+EaDVKiL/2UWYgmFAmqWnt T2M/gJ2jXu+SrhEk+qSy78gG1FDAnwx4lPsHufFmib9MrN7xlPL1znAMjt44ZkHjDmy3 FKvzOvwl6C8StYe/9Y59ylwVGSocgovLgi3nJyPOpwZnOijq0Kv8kHWRCHiQWr2tJGeM Z9xIkZSvJhCZWi/1Ucb+GN5MPEhZcoYGwAOaimngc8W/LT0HdXXisOaIJkAHFj6yXEqD X6JQ== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=neutral (google.com: 2001:a60:0:28:0:1:25:1 is neither permitted nor denied by best guess record for domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de Received: from mail-out.m-online.net (mail-out.m-online.net. [2001:a60:0:28:0:1:25:1]) by gmr-mx.google.com with ESMTPS id t65si425594lff.3.2020.12.23.05.43.06 for (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 23 Dec 2020 05:43:06 -0800 (PST) Received-SPF: neutral (google.com: 2001:a60:0:28:0:1:25:1 is neither permitted nor denied by best guess record for domain of sbabic@denx.de) client-ip=2001:a60:0:28:0:1:25:1; Received: from frontend01.mail.m-online.net (unknown [192.168.8.182]) by mail-out.m-online.net (Postfix) with ESMTP id 4D1DtL2724z1rxMh; Wed, 23 Dec 2020 14:43:06 +0100 (CET) Received: from localhost (dynscan1.mnet-online.de [192.168.6.70]) by mail.m-online.net (Postfix) with ESMTP id 4D1DtL1vcNz1tSQl; Wed, 23 Dec 2020 14:43:06 +0100 (CET) X-Virus-Scanned: amavisd-new at mnet-online.de Received: from mail.mnet-online.de ([192.168.8.182]) by localhost (dynscan1.mail.m-online.net [192.168.6.70]) (amavisd-new, port 10024) with ESMTP id VxKY3m7vmTx1; Wed, 23 Dec 2020 14:43:05 +0100 (CET) Received: from babic.homelinux.org (host-88-217-136-221.customer.m-online.net [88.217.136.221]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.mnet-online.de (Postfix) with ESMTPS; Wed, 23 Dec 2020 14:43:05 +0100 (CET) Received: from localhost (mail.babic.homelinux.org [127.0.0.1]) by babic.homelinux.org (Postfix) with ESMTP id 3A9E24540559; Wed, 23 Dec 2020 14:43:05 +0100 (CET) X-Virus-Scanned: Debian amavisd-new at babic.homelinux.org Received: from babic.homelinux.org ([127.0.0.1]) by localhost (mail.babic.homelinux.org [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id e7RtIVUUztRX; Wed, 23 Dec 2020 14:43:02 +0100 (CET) Received: from paperino.fritz.box (paperino.fritz.box [192.168.178.64]) by babic.homelinux.org (Postfix) with ESMTP id 5ADDE4540700; Wed, 23 Dec 2020 14:43:02 +0100 (CET) From: Stefano Babic To: swupdate@googlegroups.com Cc: Stefano Babic Subject: [swupdate] [PATCH 2/2] doc: improve roadmap Date: Wed, 23 Dec 2020 14:43:01 +0100 Message-Id: <20201223134301.788137-2-sbabic@denx.de> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201223134301.788137-1-sbabic@denx.de> References: <20201223134301.788137-1-sbabic@denx.de> MIME-Version: 1.0 X-Original-Sender: sbabic@denx.de X-Original-Authentication-Results: gmr-mx.google.com; spf=neutral (google.com: 2001:a60:0:28:0:1:25:1 is neither permitted nor denied by best guess record for domain of sbabic@denx.de) smtp.mailfrom=sbabic@denx.de 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: Stefano Babic --- doc/source/roadmap.rst | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/doc/source/roadmap.rst b/doc/source/roadmap.rst index 0f728b9..26f2cd0 100644 --- a/doc/source/roadmap.rst +++ b/doc/source/roadmap.rst @@ -48,6 +48,25 @@ small changes, and it is not a general solution between two generic releases. A general approach could be to integrate SWUpdate with a storage to allow one a delta upgrade from any release. +Support for OpenWRT +=================== + +OpenWRT is used on many routers and has its own way for updating that is not power-cut safe. + +Selective downloading +===================== + +Bandwidth can be saved not only via delta, but identifying which part of the SWu must be +loaded and skipping the rest. For example, SWUpdate can detect the versions for artifact before +downloading them and ask the servers to send just the relevant artifacts. + +Support for BTRFS snapshot +========================== + +BTRFS supports subvolume and delta backup for volumes - supporting subvolumes is a way +to move the delta approach to filesystems, while SWUpdate should apply the deltas +generated by BTRFS utilities. + Parser ====== @@ -75,6 +94,14 @@ a sort of software compatibility check. For example, SWUpdate verifies if a comp (like an application) is compatible with a runningOS and reject the update in case of mismatch. +Lua +=== + +- API between SWUpdate and Lua is poorly documented. +- Add further interfaces to extend the interface, for example to + get inside a Lua handler or script how SWUpdate was staretd (which selction, + which board revision, etc.) + Handlers: =========