From patchwork Thu Dec 22 10:30:29 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Enric Balletbo i Serra X-Patchwork-Id: 1718860 X-Patchwork-Delegate: trini@ti.com Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.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: legolas.ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=redhat.com header.i=@redhat.com header.a=rsa-sha256 header.s=mimecast20190719 header.b=PU+m2Wc+; 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 ECDSA (P-384)) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4NdCJs2tQ9z1ydb for ; Fri, 23 Dec 2022 01:25:33 +1100 (AEDT) Received: from h2850616.stratoserver.net (localhost [IPv6:::1]) by phobos.denx.de (Postfix) with ESMTP id 81C1485465; Thu, 22 Dec 2022 15:24:49 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=redhat.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=redhat.com header.i=@redhat.com header.b="PU+m2Wc+"; dkim-atps=neutral Received: by phobos.denx.de (Postfix, from userid 109) id E8160852D0; Thu, 22 Dec 2022 11:30:52 +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=-2.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_MSPIKE_H2, SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no version=3.4.2 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits)) (No client certificate requested) by phobos.denx.de (Postfix) with ESMTPS id 5CDB2851D7 for ; Thu, 22 Dec 2022 11:30:50 +0100 (CET) Authentication-Results: phobos.denx.de; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: phobos.denx.de; spf=pass smtp.mailfrom=eballetb@redhat.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1671705049; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=n/9UCbMw0z8PNglSi3H2sQCTYL/ztko0ivOW2ChYxW0=; b=PU+m2Wc+RfM/pyFrrwsxRXiw9WhOgnT5szTwxsI+kvMeZOVcFcTeE1oOD4QBPcRe9yqN0w 6q9Vi9sHZdHbJyQOMtFtw/oljK2pdbbaGdoVIn7h1B3e0A899lKEFOZZ7ExizP5ucS1wIz gX30ZaUg1gWI01Chtu41mJ2zyGp2TFA= Received: from mail-wr1-f69.google.com (mail-wr1-f69.google.com [209.85.221.69]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_128_GCM_SHA256) id us-mta-435-PmqhT79gPzi4TrLLY0Aj2A-1; Thu, 22 Dec 2022 05:30:47 -0500 X-MC-Unique: PmqhT79gPzi4TrLLY0Aj2A-1 Received: by mail-wr1-f69.google.com with SMTP id u9-20020adfa189000000b00242121eebe2so296147wru.3 for ; Thu, 22 Dec 2022 02:30:47 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=n/9UCbMw0z8PNglSi3H2sQCTYL/ztko0ivOW2ChYxW0=; b=7wBP894RhlUXQjg7sJHH+R4h724JQxw575soF8o3InaGuqrphJDxJ0FvUYBUSPgUHc WGolj0sK3I/+KZvrgcaxBPD/tDu5bWtCXVt0cCwOCFm8TDKSjtb59MSs5Awinoosk25N lYwXglj0snK+7dQyiXlXrG2Oty5Ns/VYt/JZw9mN9nhvmUPbaht48hPStV8EcpfUL33h vrs5zcGfG3H+OYurtGnmPha1V19rc13komsBEI7j7xKBORcGk/X+qPnMv/UdyQatNHr6 62Tn4+yiKg7R/8dr+wp0mhZ41Ox2gSnTjEQxOr7YKCghmgpaVQ5NNz+yEVLxfQdbW5KB Q2yQ== X-Gm-Message-State: AFqh2kqsEzYZ/fX2NdU2Ch/dnvj8iwhFrzIs6/LiA7a+iKQVcCDJgQd4 dUOdymhAvl1zv3ui4RCabDVbrUpHYtpv9yUWM7VuLldJVVAVw1K9u3zoRGOPCAsVF0txWm7/eNE M0sz6s4Vn3QnkBM3GqgeG6tVH97kk6IOBtHJz99rPzaQ8F1/Q5X5Dsp15RBHkI58nTw== X-Received: by 2002:a05:600c:1e10:b0:3d3:404a:8a1a with SMTP id ay16-20020a05600c1e1000b003d3404a8a1amr6757802wmb.11.1671705045948; Thu, 22 Dec 2022 02:30:45 -0800 (PST) X-Google-Smtp-Source: AMrXdXug5lfNdfHzU21yDxb7JSBEdO7mYlaCtbSn0EVv0aYDP36W6fuKOZn77et6U7rK6APx9lh87g== X-Received: by 2002:a05:600c:1e10:b0:3d3:404a:8a1a with SMTP id ay16-20020a05600c1e1000b003d3404a8a1amr6757781wmb.11.1671705045644; Thu, 22 Dec 2022 02:30:45 -0800 (PST) Received: from localhost.localdomain ([109.167.21.147]) by smtp.gmail.com with ESMTPSA id q2-20020a1cf302000000b003d1cc0464a2sm581037wmq.8.2022.12.22.02.30.45 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 22 Dec 2022 02:30:45 -0800 (PST) From: Enric Balletbo i Serra X-Google-Original-From: Enric Balletbo i Serra To: u-boot@lists.denx.de Cc: trini@konsulko.com, xypron.glpk@gmx.de, Enric Balletbo i Serra Subject: [PATCH v2 1/4] doc: man-page for the part command Date: Thu, 22 Dec 2022 11:30:29 +0100 Message-Id: <20221222103032.149098-2-eballetbo@redhat.com> X-Mailer: git-send-email 2.38.1 In-Reply-To: <20221222103032.149098-1-eballetbo@redhat.com> References: <20221222103032.149098-1-eballetbo@redhat.com> MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com X-Mailman-Approved-At: Thu, 22 Dec 2022 15:24:36 +0100 X-BeenThere: u-boot@lists.denx.de X-Mailman-Version: 2.1.39 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.103.6 at phobos.denx.de X-Virus-Status: Clean Provide a man-page for the part command. Signed-off-by: Enric Balletbo i Serra Reviewed-by: Simon Glass --- Changes in v2: - New patch (1) in the series to fix a trivial type - New patch (2) in the series to introduce the documentation of the part type command - Fix typo s/partittion/partition/ in commit message - Add gpt test for the part type command - Add the man-page for part command in doc/usage/cmd doc/usage/cmd/part.rst | 97 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 97 insertions(+) create mode 100644 doc/usage/cmd/part.rst diff --git a/doc/usage/cmd/part.rst b/doc/usage/cmd/part.rst new file mode 100644 index 0000000000..be931e520f --- /dev/null +++ b/doc/usage/cmd/part.rst @@ -0,0 +1,97 @@ +.. SPDX-License-Identifier: GPL-2.0+: + +part command +=============== + +Synopis +------- + +:: + + part uuid : [varname] + part list [flags] [varname] + part start + part size + part number + part types + +Description +----------- + +The `part` command is used to manage disk partition related commands. + +The 'part uuid' command prints or sets an environment variable to partition UUID + + interface + interface for accessing the block device (mmc, sata, scsi, usb, ....) + dev + device number + part + partition number + varname + an optional environment variable to store the current partition UUID value into. + +The 'part list' command prints or sets an environment variable to the list of partitions + + interface + interface for accessing the block device (mmc, sata, scsi, usb, ....) + dev + device number + part + partition number + flags + -bootable + lists only bootable partitions + varname + an optional environment variable to store the list of partitions value into. + +The 'part start' sets an environment variable to the start of the partition (in blocks), +part can be either partition number or partition name. + + interface + interface for accessing the block device (mmc, sata, scsi, usb, ....) + dev + device number + part + partition number + varname + a variable to store the current start of the partition value into. + +The 'part size' sets an environment variable to the size of the partition (in blocks), +part can be either partition number or partition name. + + interface + interface for accessing the block device (mmc, sata, scsi, usb, ....) + dev + device number + part + partition number + varname + a variable to store the current size of the partition value into. + +The 'part number' sets an environment variable to the partition number using the partition name, +part must be specified as partition name. + + interface + interface for accessing the block device (mmc, sata, scsi, usb, ....) + dev + device number + part + partition number + varname + a variable to store the current partition number value into + +The 'part types' command list supported partition table types. + +Example +------- + +This example shows listing supported partition types:: + + U-Boot> part types + Supported partition tables: EFI, AMIGA, DOS, ISO, MAC + +Return value +------------ + +The return value $? is always 0 (true).