{"id":801977,"url":"http://patchwork.ozlabs.org/api/1.2/patches/801977/?format=json","web_url":"http://patchwork.ozlabs.org/project/swupdate/patch/ca969106-c6a0-4fa1-9e6d-ffb26044a3de@googlegroups.com/","project":{"id":58,"url":"http://patchwork.ozlabs.org/api/1.2/projects/58/?format=json","name":"swupdate development","link_name":"swupdate","list_id":"swupdate.googlegroups.com","list_email":"swupdate@googlegroups.com","web_url":"https://github.com/sbabic/swupdate","scm_url":"git://github.com/sbabic/swupdate","webscm_url":"","list_archive_url":"","list_archive_url_format":"","commit_url_format":""},"msgid":"","list_archive_url":null,"date":"2017-08-16T10:25:39","name":"bootloader GRUB doc","commit_ref":null,"pull_url":null,"state":"changes-requested","archived":false,"hash":"b1b35fc9195acf072ce785cef5de191c18529eab","submitter":{"id":72171,"url":"http://patchwork.ozlabs.org/api/1.2/people/72171/?format=json","name":"Roman Kalashnikov","email":"lunix0x@gmail.com"},"delegate":{"id":1693,"url":"http://patchwork.ozlabs.org/api/1.2/users/1693/?format=json","username":"sbabic","first_name":"Stefano","last_name":"Babic","email":"sbabic@denx.de"},"mbox":"http://patchwork.ozlabs.org/project/swupdate/patch/ca969106-c6a0-4fa1-9e6d-ffb26044a3de@googlegroups.com/mbox/","series":[],"comments":"http://patchwork.ozlabs.org/api/patches/801977/comments/","check":"pending","checks":"http://patchwork.ozlabs.org/api/patches/801977/checks/","tags":{},"related":[],"headers":{"Return-Path":"","X-Original-To":"incoming@patchwork.ozlabs.org","Delivered-To":"patchwork-incoming@bilbo.ozlabs.org","Authentication-Results":["ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=googlegroups.com\n\t(client-ip=2607:f8b0:400e:c00::237;\n\thelo=mail-pf0-x237.google.com;\n\tenvelope-from=swupdate+bncbd7ivpnd34mbbi532dgakgqecjh7djq@googlegroups.com;\n\treceiver=)","ozlabs.org; dkim=pass (2048-bit key;\n\tunprotected) header.d=googlegroups.com header.i=@googlegroups.com\n\theader.b=\"KPUMfFKP\"; dkim=pass (2048-bit key;\n\tunprotected) header.d=gmail.com header.i=@gmail.com\n\theader.b=\"ARh1M8u+\"; dkim-atps=neutral"],"Received":["from mail-pf0-x237.google.com (mail-pf0-x237.google.com\n\t[IPv6:2607:f8b0:400e:c00::237])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128\n\tbits)) (No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 3xXQTy3v9Kz9t42\n\tfor ;\n\tWed, 16 Aug 2017 20:25:41 +1000 (AEST)","by mail-pf0-x237.google.com with SMTP id s86sf525721pfd.3\n\tfor ;\n\tWed, 16 Aug 2017 03:25:41 -0700 (PDT)","by 10.107.132.233 with SMTP id o102ls849122ioi.2.gmail; Wed, 16 Aug\n\t2017 03:25:39 -0700 (PDT)"],"DKIM-Signature":["v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=googlegroups.com; s=20161025;\n\th=sender:date:from:to:message-id:subject:mime-version\n\t:x-original-sender:precedence:mailing-list:list-id:list-post\n\t:list-help:list-archive:list-subscribe:list-unsubscribe;\n\tbh=rHszTNo6pfXgCCoXOek+HyHmkt18gOKcEyHnBFAgZKI=;\n\tb=KPUMfFKPBifUsF8MMWozvd+vSWrg5SaGLucRCPgKo3MRAykpAzSKZcS+YiO154+sTf\n\tSYe3yCLk3VRgFmPp8aSeuVGgf781QlNyvySm3VnZ/ng8sLtovVMtSXdiiw5OOGcpc3DC\n\tk1uvY7HpIur2fn83d9Ff47PnnLIrzf7cpYNA95L4vsBhrydn+AS46JF8ngl3i+2V0qhp\n\t09p9gZaFvxcUGAdg7YqlATZIhRYMnvdbfXbQTlEHZOrhHg3CiKaYx1iQ0HDOGnh2cNLE\n\tAYUdeYejMK+WNzeaRgtPfTEU+YmPPXarXcyct9hROw/Ja/fy7lLVQbyaznuYenW44jgY\n\tFepg==","v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=gmail.com; s=20161025;\n\th=date:from:to:message-id:subject:mime-version:x-original-sender\n\t:precedence:mailing-list:list-id:list-post:list-help:list-archive\n\t:list-subscribe:list-unsubscribe;\n\tbh=rHszTNo6pfXgCCoXOek+HyHmkt18gOKcEyHnBFAgZKI=;\n\tb=ARh1M8u+JsTckgnpzVCQc5dZuRgyJfMYYlP4YweN1/BIUVeDdU3tKAW7TPM0xJtCbO\n\tbXusOmo22nGoDtYzSkjcHVR6GUDjc/Y9OY+U5TeOLMoPrODmC23MydJYDGr/sw7Glt+f\n\t/IGZEXh3r1MnQW2g/F7eygI8cOD/b3iQICRfF5eREvY17tKJyhKRBjLSzvT9WDLI0IXN\n\thidUV/zywsaGBXaOn6fGvWQjba7lQHfakyEgeYkCSBUB4qKLcQIV0SfU8/jcXDT022Os\n\tE5iSGGXLaFGKl2QmcYdvPTZu3QgKT0UewQkYGzGjuW9L2mgvUmR78BZq921r95wnBheL\n\tgbpQ=="],"X-Google-DKIM-Signature":"v=1; a=rsa-sha256; c=relaxed/relaxed;\n\td=1e100.net; s=20161025;\n\th=sender:x-gm-message-state:date:from:to:message-id:subject\n\t:mime-version:x-original-sender:precedence:mailing-list:list-id\n\t:x-spam-checked-in-group:list-post:list-help:list-archive\n\t:list-subscribe:list-unsubscribe;\n\tbh=rHszTNo6pfXgCCoXOek+HyHmkt18gOKcEyHnBFAgZKI=;\n\tb=XdELeJ2H1EfabB0u41RAqUVB7ZCEjhMa5Ns6b4LKvnYqn/L6RkAgmv9g5Me+YtEVz5\n\tay2uc2paSCzyT4BUv7XWK5M+b8LpDGjTBv3r0L01FXgnjNPwZVwduzTKhxRJC8A7snu0\n\tikfasKMWsPFCrTjO4SUnA6S4349kXbGtGk33qmHz7w3vAIaJCTuVBh7lv+3659eWeEJK\n\tSmZYKfDfhIM78Y6Rv8u6qdC4//gnbTwmNphI8VIbkxWEC5+tN7XovYS9DH9FqIP5CTbd\n\t71E0UH/SIdD83Gduoc95DzvLqjig1qzLh5YRQgD6Ml98FUNyJ/7IAm/NoOOWtxcqjhOy\n\tEO4g==","Sender":"swupdate@googlegroups.com","X-Gm-Message-State":"AHYfb5gJFdBsfdfAuyqxrW0l7zSF30YRM7NLWpo4JbyZmJ4HGdkAG8Y4\n\t0/oHRd2a2AQIIQ==","X-Received":["by 10.36.53.79 with SMTP id k76mr70436ita.1.1502879139752;\n\tWed, 16 Aug 2017 03:25:39 -0700 (PDT)","by 10.31.191.67 with SMTP id p64mr14371vkf.4.1502879139483;\n\tWed, 16 Aug 2017 03:25:39 -0700 (PDT)"],"X-BeenThere":"swupdate@googlegroups.com","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","Content-Type":"multipart/mixed; \n\tboundary=\"----=_Part_7266_1765166556.1502879139064\"","X-Original-Sender":"lunix0x@gmail.com","Precedence":"list","Mailing-list":"list swupdate@googlegroups.com;\n\tcontact swupdate+owners@googlegroups.com","List-ID":"","X-Spam-Checked-In-Group":"swupdate@googlegroups.com","X-Google-Group-Id":"605343134186","List-Post":",\n\t","List-Help":",\n\t","List-Archive":",\n\t","List-Unsubscribe":",\n\t"},"content":"","diff":"diff --git a/doc/source/sw-description.rst b/doc/source/sw-description.rst\nindex 4a798ee..b4e8d75 100644\n--- a/doc/source/sw-description.rst\n+++ b/doc/source/sw-description.rst\n@@ -548,6 +548,26 @@ that must be changed:\n SWUpdate will internally generate a script that will be passed to the\n bootloader handler for adjusting the environment.\n \n+For example to use GRUB environment - after update some of partition\n+and boot from it:\n+\n+::\n+\n+ bootenv: (\n+ {\n+ name = \"default\";\n+ value = \"1\";\n+ },\n+ {\n+ name = \"fallback\";\n+ value = \"0\";\n+ },\n+ )\n+\n+Note the `value` must contain correct partition's number in\n+GRUB menuentry. Also `bootenv` can contains variable like `fallback`\n+for failsafe boot if the new default menu entry fails to boot.\n+\n For backward compatibility with previously built .swu images, \"uboot \n\"group name\n is still relevant (as an alias).\n","prefixes":[]}