From patchwork Thu Dec 31 22:48:52 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Sean Anderson X-Patchwork-Id: 1421623 X-Patchwork-Delegate: trini@ti.com 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=lists.denx.de (client-ip=2a01:238:438b:c500:173d:9f52:ddab:ee01; helo=phobos.denx.de; envelope-from=u-boot-bounces@lists.denx.de; receiver=) Authentication-Results: ozlabs.org; dmarc=fail (p=none dis=none) header.from=seco.com Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=secospa.onmicrosoft.com header.i=@secospa.onmicrosoft.com header.a=rsa-sha256 header.s=selector2-secospa-onmicrosoft-com header.b=sEASGiIS; dkim-atps=neutral Received: from phobos.denx.de (phobos.denx.de [IPv6:2a01:238:438b:c500:173d:9f52:ddab:ee01]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 4D6Ng751kxz9s1l for ; Fri, 1 Jan 2021 09:51:15 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 423AF8267A; Thu, 31 Dec 2020 23:49:54 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=fail (p=none dis=none) header.from=seco.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=u-boot-bounces@lists.denx.de Authentication-Results: phobos.denx.de; dkim=pass (1024-bit key; unprotected) header.d=secospa.onmicrosoft.com header.i=@secospa.onmicrosoft.com header.b="sEASGiIS"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id BA80582645; Thu, 31 Dec 2020 23:49:34 +0100 (CET) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on phobos.denx.de X-Spam-Level: X-Spam-Status: No, score=-1.6 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,FORGED_SPF_HELO,MSGID_FROM_MTA_HEADER,RCVD_IN_DNSWL_LOW, SPF_HELO_PASS autolearn=no autolearn_force=no version=3.4.2 Received: from EUR04-VI1-obe.outbound.protection.outlook.com (mail-vi1eur04on061a.outbound.protection.outlook.com [IPv6:2a01:111:f400:fe0e::61a]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id A66EF82644 for ; Thu, 31 Dec 2020 23:49:30 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=seco.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=sean.anderson@seco.com ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=I8tJumovdU1lLK18cyL1KnqpYuVVw5Xx3Az+wqT8uZndBYrwjTNoiG+HG9mveHDu8ZmhA9H62+pzsuaq/gf+Jia2ecUazCM6ArGoUNTTjqbUQ5dqyQ9oqhaJVPWoKwOq6+ZHnWEImZM7+udK2iuQ7ZmV1ufRTno3Ow/jgjKpr8jIeT3bRliar2iNKVYXb3Pz5Tovg8eIE2jbGy0tLut6T0kM/EBiMTxqVxVVTNdOwCdXmRGb6XUIGrx2KaOM45kWiH++U2Xv2reokAGdE1MCNX2QM+Ddrx64qZbZGEcKrBWtVmI9NV8I0f1kmCezlQfyXO013zKN8guzd+0AVgXTVw== 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:X-MS-Exchange-SenderADCheck; bh=w/vVo5Jcc+dINVYgM5C4+4JUTVhcB6kL/CcfRnn1AQs=; b=UEbLj1dQvCql2idb/9i8bPMnme4s8lWDm3qMXyQ7yUx8bVpwgCOOzYZEMZJP5Qv8H/JQnzpcuYPr7IraLUZWpsTahmqrspbmhgyMjXzDa8eyh2heHtqEwN4BhdRXmEcg+eKF5/kuIW0WnbxAxWtT2GHTtS0tCtBtweDrDFE2sHbCKdipqkwkFsb5ZeU0sUJ1JmHGN85bvXksNSLu1HcIRaZyh9b0k9iw6OC7YIiDCSu0rjQe+9oT6CjsmJgXuGuIibzlTP6QTTSjc4s8ocgpyoqUVnSsclze2BDMnGHNOxIn9W7Fw+iBkDt+H9dzpAXvnOj5E9qPL1GqqjRNVO1vYw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=seco.com; dmarc=pass action=none header.from=seco.com; dkim=pass header.d=seco.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=secospa.onmicrosoft.com; s=selector2-secospa-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=w/vVo5Jcc+dINVYgM5C4+4JUTVhcB6kL/CcfRnn1AQs=; b=sEASGiISfLHcrtX4QamjPGjQcGn+asdChR3VCd+jMI2oZyKmuCWAb+ZiK2X85EBjnKFra+MskrRMEUqIqNYSqTiNW/U7b+cpn/1svkD3+fgFI8RhDjVo3ipbEisAZfZ2kl+QdrSY+GkDNxHEoxGDFUXf0cVcYIAvgRH7TYCBTJ8= Authentication-Results: lists.denx.de; dkim=none (message not signed) header.d=none;lists.denx.de; dmarc=none action=none header.from=seco.com; Received: from AM9PR03MB7251.eurprd03.prod.outlook.com (20.182.235.144) by AM0PR03MB5812.eurprd03.prod.outlook.com (10.255.28.81) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3721.20; Thu, 31 Dec 2020 22:49:29 +0000 Received: from AM9PR03MB7251.eurprd03.prod.outlook.com ([fe80::c800:6bd1:64e4:6644]) by AM9PR03MB7251.eurprd03.prod.outlook.com ([fe80::c800:6bd1:64e4:6644%7]) with mapi id 15.20.3700.031; Thu, 31 Dec 2020 22:49:29 +0000 From: Sean Anderson To: u-boot@lists.denx.de Cc: Simon Glass , Sean Anderson , Filip Brozovic , Lokesh Vutla , Sam Protsenko , mingming lee Subject: [PATCH 9/9] fastboot: Document alternate partition names Date: Thu, 31 Dec 2020 17:48:52 -0500 Message-Id: <20201231224853.1431364-10-sean.anderson@seco.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20201231224853.1431364-1-sean.anderson@seco.com> References: <20201231224853.1431364-1-sean.anderson@seco.com> X-Originating-IP: [50.195.82.171] X-ClientProxiedBy: BLAPR03CA0128.namprd03.prod.outlook.com (2603:10b6:208:32e::13) To AM9PR03MB7251.eurprd03.prod.outlook.com (2603:10a6:20b:26e::16) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from plantagenet.inhand.com (50.195.82.171) by BLAPR03CA0128.namprd03.prod.outlook.com (2603:10b6:208:32e::13) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3721.20 via Frontend Transport; Thu, 31 Dec 2020 22:49:28 +0000 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: bf54794a-5f6e-4f7a-7564-08d8adde5558 X-MS-TrafficTypeDiagnostic: AM0PR03MB5812: X-MS-Exchange-Transport-Forked: True X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:1303; X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: zv2Alms9nFPaGWo6dn9zICcor+1fDL6yy90UODmCqUKa9ANpJPKz59qqaaas+gm9EzyCgIDsVP87nP5DMDB/Lq8rRh1FGVTQc50JnOr95SpxKWsmUb+6fUbMWsKlGOv0fjtEZXMsRd8z4ZwTii2V1SVvN4ODSGqUvK6wEfmrWY0Avpuf+hmE8fkBTcSWUVRJoqvOh1QprR2lDapYAI7DVpoqSExEDkG5cLYa9SJW3tskOjsChnL4GgrmEYbOShhaUaRtXTRpTBg/5ZSqksIUw3LZlbRq+BHLam7+f/wzFhL+cbP4bATyUvPuFyOwNRNvAEFGVHTLEuUw/qWxh5KYeivffFDgvP7S6ANoFrZ8kj6L/6AYpUUqBrZncFX/I1o+T7MSejwCDe6t6ZG7j26Clw== X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM9PR03MB7251.eurprd03.prod.outlook.com; PTR:; CAT:NONE; SFS:(39840400004)(136003)(396003)(376002)(366004)(346002)(36756003)(66476007)(66556008)(956004)(26005)(52116002)(8936002)(44832011)(316002)(54906003)(478600001)(2616005)(6486002)(16526019)(1076003)(4326008)(186003)(5660300002)(6916009)(6512007)(2906002)(6506007)(66946007)(8676002)(86362001)(6666004); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData: ZwTfoqfpryg96u/GbwLjsPnL3JgRKPbz2hrFmHAWOnNcmPWV96+8X//183iYZ0sWO0cLxobhNZT1Loli3vwXlSOUVVxjGP26UG55V56otE6f5G+17vwfcE2oRTItJKB9lpwoOoKJ2PNzjM49N+4Ck4i5F74XqFKu/6/jdQszczLZFdmbJmHGe0WhbXxQvGypBrRHgNI6U9ufLqxBQiuAMTZDKus1zSWTFpyVJCSPTh5ZpZ1rts75IOKClyQRj/bocpObY+uqCt60esytqJpKsdz5P0gzClak27efXemUWpu3mUJ+6ssrcBddWEzk+YFFyvQvcNkAmqJ6yabWtoIzVgjozLqLmV5uP1Pkqru3nnWexIaHZXBfpiV4qHRsXn2Qvi0AuCEVDL58fq+dJ6qaPfABl/EywAheseQu0hMzem0q1Ea2Mt/p6hpoBOzW1Z615DWtKU40sJtd3axvunK6ub4VlxxBK+PfyqxiuuJ7kr/nePIVxz7flRj5ewz83N4WG3Bj4IW2KhGz3PzsR23OxAJdCI0JlAwwRbjHmbe+EAnXU9LPX0QZEVNuv5PtE0U0uVam4is9K9ef2yrxZnQQ87FP/B8hyg9+gEiwTJs577GM/NrkeXbUtWOCaBxIxxa7T6Kzi0ZrL1PmNbtXJ9MoHeR0RfgIxjWjRAVQHGqUhXewVvluPTRCvoFmwHnCen6RNVfywL+CDt90GDxlhTcGCTR1kMPrcz/EyqMlUZaxN+7/yatmq2fCXYOT0MgABNLRR2mB+XToq7EPVUOuKXrXALxdcJyr0Pwg4CCGkKyuFhK0fsub3VqNKpEKYBUhcB9vBiu254gJ4o7JdeJpSwNLiazG+A+G7JR5UenwXiCTV8kL3GYUIiCXw2bqTBDqQUF6LzBTbj4mGTR37qFUqPHAlX/39tdjzLkdSjv3xmy/Z+KDPY9CLUUdTtN+YSEIb81qeFR9tJbgAuT2/jwSpRn7mT36ht7WC5J3cZdFOl+NY9lGM45hrBuFcZk2q53hNph8 X-OriginatorOrg: seco.com X-MS-Exchange-CrossTenant-AuthSource: AM9PR03MB7251.eurprd03.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 31 Dec 2020 22:49:29.8224 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: bebe97c3-6438-442e-ade3-ff17aa50e733 X-MS-Exchange-CrossTenant-Network-Message-Id: bf54794a-5f6e-4f7a-7564-08d8adde5558 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: JxZfhn6By+JB1I4FtPKDOlfhCAV7eW4/oYluVC7XoNZGp8QiR7PKfxtplc78FAectFNE4t9MyF75emT7qO1RRA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR03MB5812 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.34 Precedence: list List-Id: U-Boot discussion List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: u-boot-bounces@lists.denx.de Sender: "U-Boot" X-Virus-Scanned: clamav-milter 0.102.3 at phobos.denx.de X-Virus-Status: Clean This documents the new partition names added in the previous commit. Signed-off-by: Sean Anderson Reviewed-by: Simon Glass --- doc/android/fastboot.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/doc/android/fastboot.rst b/doc/android/fastboot.rst index 2877c3cbaa..2ca80ae844 100644 --- a/doc/android/fastboot.rst +++ b/doc/android/fastboot.rst @@ -151,6 +151,34 @@ The device index starts from ``a`` and refers to the interface (e.g. USB controller, SD/MMC controller) or disk index. The partition index starts from ``1`` and describes the partition number on the particular device. + +Alternate Partition Names +^^^^^^^^^^^^^^^^^^^^^^^^^ + +Partitions may also be specified like:: + + devnum.hwpartnum#partname + +or like:: + + devnum.hwpartnum:partnum + +Where + + * ``devnum`` is the MMC device number. This defaults to 0. + * ``hwpartnum`` is the hardware partition number. This defaults to 0 (the user + partition on eMMC devices). + * ``partname`` is the partition name on GPT devices. Partitions do not have + names on MBR devices. + * ``partnum`` is the partition number, starting from 1. The partition number 0 + is special, and specifies that the whole device is to be used as one + "partition." + +If neither ``partname`` nor ``partnum`` is specified and there is a partition +table, then partition 1 is used. If there is no partition table, then the whole +device is used as one "partion." Examples of alternate partition names include +``0.1``, ``0#boot``, and ``:3``. + Writing Partition Table -----------------------