Re: [Buildroot] [PATCH 3/8] docs/manual: update documentation about partition-type-uuid convention in genimage.cfg

From: "Yann E. MORIN" <yann.morin.1998@free.fr>
To: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
Cc: Giulio Benetti <giulio.benetti@benettiengineering.com>,
	Thomas De Schampheleire <thomas.de_schampheleire@nokia.com>,
	Buildroot List <buildroot@buildroot.org>
Subject: Re: [Buildroot] [PATCH 3/8] docs/manual: update documentation about partition-type-uuid convention in genimage.cfg
Date: Sat, 23 Jul 2022 15:38:04 +0200	[thread overview]
Message-ID: <20220723133804.GB2641@scaer> (raw)
In-Reply-To: <20220722202151.76235-4-thomas.petazzoni@bootlin.com>

Thomas,, Giulio, All,

On 2022-07-22 22:21 +0200, Thomas Petazzoni via buildroot spake thusly:
> Whenever possible, we want to use the "shortcuts" provided by genimage
> for the partition-type-uuid values:
> 
>  - U for the EFI System Partition
>  - F for FAT32 partitions
>  - L for root filesystem partitions and other Linux filesystems
> 
> In follow-up commits, we will convert existing genimage.cfg to this
> convention, except for the root filesystem, if the existing
> genimage.cfg specifies a partition-type-uuid that doesn't match the
> one that "L" would imply. In this case, we will things as-is to not

*we will _keep_ things...

Fixed when applying.

Regards,
Yann E. MORIN.

> break existing setups. However, for all future genimage.cfg files, we
> recommend to use "L" for the root filesystem.
> 
> Signed-off-by: Thomas Petazzoni <thomas.petazzoni@bootlin.com>
> ---
>  docs/manual/writing-rules.txt | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
> diff --git a/docs/manual/writing-rules.txt b/docs/manual/writing-rules.txt
> index 84d8f76431..758965d80a 100644
> --- a/docs/manual/writing-rules.txt
> +++ b/docs/manual/writing-rules.txt
> @@ -198,6 +198,18 @@ image sdimage.img {
>    chance, the byte count.  In comments instead use +GB+, +MB+, +KB+
>    (not +kb+) in place of +G+, +M+, +K+.
>  
> +* For GPT partitions, the +partition-type-uuid+ value must be +U+ for
> +  the EFI System Partition (expanded to
> +  +c12a7328-f81f-11d2-ba4b-00a0c93ec93b+ by _genimage_), +F+ for a FAT
> +  partition (expanded to +ebd0a0a2-b9e5-4433-87c0-68b6b72699c7+ by
> +  _genimage_) or +L+ for the root filesystem or other filesystems
> +  (expanded to +0fc63daf-8483-4772-8e79-3d69d8477de4+ by
> +  _genimage_). Even though +L+ is the default value of _genimage_, we
> +  prefer to have it explicitly specified in our +genimage.cfg+
> +  files. Finally, these shortcuts should be used without double
> +  quotes, e.g +partition-type-uuid = U+. If an explicit GUID is
> +  specified, lower-case letters should be used.
> +
>  The +genimage.cfg+ files are the input for the genimage tool used in
>  Buildroot to generate the final image file(i.e. sdcard.img). For further
>  details about the _genimage_ language, refer to
> -- 
> 2.37.1
> 
> _______________________________________________
> buildroot mailing list
> buildroot@buildroot.org
> https://lists.buildroot.org/mailman/listinfo/buildroot

-- 
.-----------------.--------------------.------------------.--------------------.
|  Yann E. MORIN  | Real-Time Embedded | /"\ ASCII RIBBON | Erics' conspiracy: |
| +33 662 376 056 | Software  Designer | \ / CAMPAIGN     |  ___               |
| +33 561 099 427 `------------.-------:  X  AGAINST      |  \e/  There is no  |
| http://ymorin.is-a-geek.org/ | _/*\_ | / \ HTML MAIL    |   v   conspiracy.  |
'------------------------------^-------^------------------^--------------------'
_______________________________________________
buildroot mailing list
buildroot@buildroot.org
https://lists.buildroot.org/mailman/listinfo/buildroot