From patchwork Wed Aug 16 10:25:39 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Roman Kalashnikov X-Patchwork-Id: 801977 X-Patchwork-Delegate: sbabic@denx.de Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (mailfrom) smtp.mailfrom=googlegroups.com (client-ip=2607:f8b0:400e:c00::237; helo=mail-pf0-x237.google.com; envelope-from=swupdate+bncbd7ivpnd34mbbi532dgakgqecjh7djq@googlegroups.com; receiver=) Authentication-Results: ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=googlegroups.com header.i=@googlegroups.com header.b="KPUMfFKP"; dkim=pass (2048-bit key; unprotected) header.d=gmail.com header.i=@gmail.com header.b="ARh1M8u+"; dkim-atps=neutral Received: from mail-pf0-x237.google.com (mail-pf0-x237.google.com [IPv6:2607:f8b0:400e:c00::237]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 3xXQTy3v9Kz9t42 for ; Wed, 16 Aug 2017 20:25:41 +1000 (AEST) Received: by mail-pf0-x237.google.com with SMTP id s86sf525721pfd.3 for ; Wed, 16 Aug 2017 03:25:41 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=googlegroups.com; s=20161025; h=sender:date:from:to:message-id:subject:mime-version :x-original-sender:precedence:mailing-list:list-id:list-post :list-help:list-archive:list-subscribe:list-unsubscribe; bh=rHszTNo6pfXgCCoXOek+HyHmkt18gOKcEyHnBFAgZKI=; b=KPUMfFKPBifUsF8MMWozvd+vSWrg5SaGLucRCPgKo3MRAykpAzSKZcS+YiO154+sTf SYe3yCLk3VRgFmPp8aSeuVGgf781QlNyvySm3VnZ/ng8sLtovVMtSXdiiw5OOGcpc3DC k1uvY7HpIur2fn83d9Ff47PnnLIrzf7cpYNA95L4vsBhrydn+AS46JF8ngl3i+2V0qhp 09p9gZaFvxcUGAdg7YqlATZIhRYMnvdbfXbQTlEHZOrhHg3CiKaYx1iQ0HDOGnh2cNLE AYUdeYejMK+WNzeaRgtPfTEU+YmPPXarXcyct9hROw/Ja/fy7lLVQbyaznuYenW44jgY Fepg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=date:from:to:message-id:subject:mime-version:x-original-sender :precedence:mailing-list:list-id:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=rHszTNo6pfXgCCoXOek+HyHmkt18gOKcEyHnBFAgZKI=; b=ARh1M8u+JsTckgnpzVCQc5dZuRgyJfMYYlP4YweN1/BIUVeDdU3tKAW7TPM0xJtCbO bXusOmo22nGoDtYzSkjcHVR6GUDjc/Y9OY+U5TeOLMoPrODmC23MydJYDGr/sw7Glt+f /IGZEXh3r1MnQW2g/F7eygI8cOD/b3iQICRfF5eREvY17tKJyhKRBjLSzvT9WDLI0IXN hidUV/zywsaGBXaOn6fGvWQjba7lQHfakyEgeYkCSBUB4qKLcQIV0SfU8/jcXDT022Os E5iSGGXLaFGKl2QmcYdvPTZu3QgKT0UewQkYGzGjuW9L2mgvUmR78BZq921r95wnBheL gbpQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=sender:x-gm-message-state:date:from:to:message-id:subject :mime-version:x-original-sender:precedence:mailing-list:list-id :x-spam-checked-in-group:list-post:list-help:list-archive :list-subscribe:list-unsubscribe; bh=rHszTNo6pfXgCCoXOek+HyHmkt18gOKcEyHnBFAgZKI=; b=XdELeJ2H1EfabB0u41RAqUVB7ZCEjhMa5Ns6b4LKvnYqn/L6RkAgmv9g5Me+YtEVz5 ay2uc2paSCzyT4BUv7XWK5M+b8LpDGjTBv3r0L01FXgnjNPwZVwduzTKhxRJC8A7snu0 ikfasKMWsPFCrTjO4SUnA6S4349kXbGtGk33qmHz7w3vAIaJCTuVBh7lv+3659eWeEJK SmZYKfDfhIM78Y6Rv8u6qdC4//gnbTwmNphI8VIbkxWEC5+tN7XovYS9DH9FqIP5CTbd 71E0UH/SIdD83Gduoc95DzvLqjig1qzLh5YRQgD6Ml98FUNyJ/7IAm/NoOOWtxcqjhOy EO4g== Sender: swupdate@googlegroups.com X-Gm-Message-State: AHYfb5gJFdBsfdfAuyqxrW0l7zSF30YRM7NLWpo4JbyZmJ4HGdkAG8Y4 0/oHRd2a2AQIIQ== X-Received: by 10.36.53.79 with SMTP id k76mr70436ita.1.1502879139752; Wed, 16 Aug 2017 03:25:39 -0700 (PDT) X-BeenThere: swupdate@googlegroups.com Received: by 10.107.132.233 with SMTP id o102ls849122ioi.2.gmail; Wed, 16 Aug 2017 03:25:39 -0700 (PDT) X-Received: by 10.31.191.67 with SMTP id p64mr14371vkf.4.1502879139483; Wed, 16 Aug 2017 03:25:39 -0700 (PDT) Date: Wed, 16 Aug 2017 03:25:39 -0700 (PDT) From: Roman Kalashnikov To: swupdate Message-Id: Subject: [swupdate] [PATCH] bootloader GRUB doc MIME-Version: 1.0 X-Original-Sender: lunix0x@gmail.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: , diff --git a/doc/source/sw-description.rst b/doc/source/sw-description.rst index 4a798ee..b4e8d75 100644 --- a/doc/source/sw-description.rst +++ b/doc/source/sw-description.rst @@ -548,6 +548,26 @@ that must be changed: SWUpdate will internally generate a script that will be passed to the bootloader handler for adjusting the environment. +For example to use GRUB environment - after update some of partition +and boot from it: + +:: + + bootenv: ( + { + name = "default"; + value = "1"; + }, + { + name = "fallback"; + value = "0"; + }, + ) + +Note the `value` must contain correct partition's number in +GRUB menuentry. Also `bootenv` can contains variable like `fallback` +for failsafe boot if the new default menu entry fails to boot. + For backward compatibility with previously built .swu images, "uboot "group name is still relevant (as an alias).